Kara Plugin: First Public Release

As these are special cases, they need custom treatments!
To address your raised issue

create a tiddler tagged with $:/tags/Stylesheet with below content

.kk-kara-done-item .refcls{
text-decoration: line-through;
}

Note that the links are active!

1 Like

For me Kara is suitable for single line few words todos like the one we use for daily shopping with Google Keep!

@Mohammad,

I was wondering if it were possible without too much effort to allow the default text field to be overridden with another fieldname?

We could then have a tasks or journal field on any tiddler in which the todoā€™s or journaling was placed. This allows either the todos or the text field be separately addressable and transcludable.

  • It seems like a rich source of possibilities but all it needs is the ability to nominate a different field.

Cool stuff, @Mohammad!
If you still would like to improve the styling, maybe you could get some inspiration from https://github.com/tgrosinger/tw5-checklist

All the best
Thomas

Thank you Thomas! Sure I will!

1 Like

Kara just got an update. It works with Tiddlywiki 5.2.3

Release 0.6.1

  • Aug 3rd, 2022
  • [NEW] Now each of checkbox and interstitial note uses meaningful placeholder message

Release 0.6.0

  • Aug 2nd, 2022
  • [NEW] Updated to Tiddlywiki 5.2.3
  • [NEW] List all items macro to list todo items and interstitial notes from all tiddlers
  • [NEW] FAQs added
  • [FIXED] Documentation improved

Release 0.5.1

1 Like

Thanks @Mohammad again for a wonderful and well developed solution with wide ranging usability.

I noted I can add this to the top my journal tiddler template as an example.

<<interstitial>>
@@.interstitial

@@

But also I have a small EditorTool bar button that allows me to insert macros into any tiddler eg <<interstitial>> or <<checklist>>.

  • Is it possible to change the ā€œplace holderā€ for these?
    • Currently they both say add new ... so there is not clue which is in use, until you make an entry.
    • eg add new log ... or add new item ...

For now I am doing this;

; New items
<<checklist>>

;Log
<<interstitial>>
@@.interstitial

@@


;Getting started
[ ] Getting Started timer (focus)
[ ] Focus wiki first
[ ] Break taker timers
[ ] time panic
  • Note how I am also using the tw5-checklist plugin as well to create named separate sections - they are complementary in this case.

Looking something like this;

Love your work!

Yes, the previous version uses add new item, I removed item., as the input UI is shared between two. But I will correct this at the cost of a little complexity!

1 Like

Done!
Kara 0.6.1 uses dedicated message and can be hacked!

2 Likes

Thanks heaps @Mohammad.

In my above example I can then remove the two headings ; New items and ;Log,

Trying out Kara, and itā€™s really cool!

2 things though,

first is, if added to a tiddler to be used in the sidebar, trying to add tasks to the .todo wonā€™t apply it.

second, would there be a way to add labels for the todo? maybe something like:

[ ] {High}  todo list item
[x] {Weekly} complete todo item 

and in styles, .kara-high {color:red;} but {Weekly} being a user made one, would need to have itā€™s own style added by the user into styles, so maybe a default label could just use <<color primary>> ?

This is not related to Kara! Using Tabs has a little trick with currentTiddler. See Official docs for Tabs

But for your quick solution, call checklist or interstitial with explicit tiddler name, do not use the default tiddler (e.g. currentTiddler) !
So, if your sidebar tab tiddler has a title like $:/mysidebar/todos call checklist like below

<<checklist tiddler:"$:/mysidebar/todos">>

If you need a full-fledged Todo manager check Todolist.

Kara is simple checklist. It is a plain todo list!
You can add macros see Todolist for example. You can use those macros in Kara!

If checklist and interstitial exist in the same tiddler, the input area of interstitial will auto focus after adding item to check list.

Step to reproduce

@@.todo

@@

<<checklist>>

@@.interstitial

@@

<<interstitial>>
  • After saving, the cursor is focusing on interstitial.
  • Click on checklist and add a new task. Press Enter or click + to save it.
  • The cursor is focusing on interstitial.

This behaviour also happens under

  • Click the checkbox of checklist
  • Edit a system tiddler after saving if a tiddler with interstitial or checklist input area is open

That is true! Please see documentation for this. The reason is the host tiddler is refreshed on adding removing items and the last edit box with focus=yes will win!

The macros have attribute to turn off autofocus. See checklist/interstitial macros.

It seems there is no simple solution using wikitext. BTW I welcome if you or other users can propose a better approach

1 Like

Thanks. I have updated the new version and disable the auto focus for all checklist list.

Great plugin @Mohammad !

Some users may want the checklist display to show completed (checked off) items at the bottom automatically. This can be accomplished with a very simple mod in $:/plugins/kookma/kara/macros/disp-items-checklist by adding a sort[] filter operator (taking advantage of the fact [ ] is before [x] syntaxically)

\define kara-disp-items()
<ul class="kk-kara-checklist">
<$list filter="[<dblock>splitregexp[\n]!is[blank]]" variable=row>
<li class="kk-kara-row">
<div class="kk-kara-desc"><<disp-single-item>></div>
<div class="kk-kara-delete"><<delete-single-item>></div>
</li>
</$list>
</ul>
\end

becomes:

\define kara-disp-items()
<ul class="kk-kara-checklist">
<$list filter="[<dblock>splitregexp[\n]!is[blank]sort[]]" variable=row>
<li class="kk-kara-row">
<div class="kk-kara-desc"><<disp-single-item>></div>
<div class="kk-kara-delete"><<delete-single-item>></div>
</li>
</$list>
</ul>
\end

The behaviour then mimics that of checklistdemo ā€” a demo of the Checklist plugin for TiddlyWiki5.

With a bit more work, it could even become a configurable option in Kara.

Cheers!

4 Likes

Good hack! :sweat_smile: :clap: :clap:
I add it as option in next release.

1 Like

Itā€™s my first day working seriously w/ Kara (v.0.6.4) -serious enough to look into the docs- and i just love that Idea and Todo List tiddler at bottom of your docs page -the way it works in that instance.

In my instance, where iā€™ve created an exact copy of that tiddler, it mostly works -except tiddlers spawned via the ā€˜New Taskā€™ button are created with those two buttons ā€˜Doneā€™ and ā€˜Tasks Explorerā€™ NOT present in the View Template. Moreover: even when i add a ā€˜doneā€™ tag manually to the ā€˜New Taskā€™ tiddler, it still doesnā€™t appear flagged as ā€˜completeā€™ in the Status column of Task Explorer tableā€¦ So i feel like i must be missing some code somewhere.

So @Mohammad , iā€™m wondering if- with a freshly installed copy of Kara v.0.6.4, whose only additional code is whatā€™s contained in that Idea and Todo List tiddler as it now appears in bottom position on your docs site, is there something else that must be done to make it work as it does in that demo?

It is actually not related to Kara :wink:
You see that Ideas and Tools in all plugins doc! if you press alt+D it creates a new tasks on the fly.

There is a plan to use that Task Explorer with Kara! but I need to find free time to integrate them.

Ideas and Tools is part of Mehregan!

Maybe for now, the quick way is to download Mehregan and drop your wiki on it!

2 Likes