Tiddlywiki provides a built-in language for extending Tiddlywiki itself, and Notedeck takes advantage of this to provide a few additional pieces of functionality. The Notedeck Wiki is really just a Tiddlywiki with some additional macros added. It adds three new functions to Tiddlywiki.
By tagging an tiddler with the
Log tag, you can transform a normal tiddler into a log tiddler. This adds a text box at the top that you can type into, and when you press Ctrl-Enter, it will create a new tiddler, tag it with the current tiddler, and the content will appear at the top of the log tiddler. This approach blurs the line between an "edit" mode and a "view" mode by embedding input directly into the view. It's a simple mechanism that supports several use cases.
Use Case: Daily Logs
Notedeck adds a "today log" button, which automatically creates a new tiddler with a title formatted as YYYY-MM-DD and tags it with both
Log tags. This formatting allows sorting by title to produce a chronological (or reverse chronological) ordering. It also makes way more sense than the date system used in most countries.
This forms the foundation of what I call my "worklog". If I take notes during the day that I don't have another place for, they go here.
Notedeck logs are structured as aggregations of tiddlers tagged with the name of the log. This means that even if I type a note into the "today log", I can rename it, link to it from other tiddlers, and include it in other logs by simply tagging it with the name of the log. This means notes can simultaneously be part of multiple logs.
Logs, as the name suggests, are automatically timestamped and sorted in reverse chronological order.
To create a tiddler that will automatically generate and aggregate log entries, simply tag it with
Use Case: Project Notes
Anything can be a log, not just the daily logs. Got a project? Create a new tiddler, name it, tag it with
Log and you're all set. It turns into a notebook for the project that you can reference on a moment's notice, and because each entry is a tiddler, aspects of the project can be addressed well from other parts of the wiki.
Use Case: Recurring Meetings
At work in particular, I sometimes find that folks get value from scheduling recurring meetings to discuss a topic. I try to minimize these sorts of meetings, but there are usually at least a couple. Because they only happen once a week or month, picking up the thread from the last meeting is much easier when notes from last time are logged. Most folks keep notes in a dedicated, shared document, but I keep my personal notes in Notedeck because they are easy to find and reference from elsewhere in my notes (Tiddlywiki imbues Notedeck with instant full text search since everything is stored in RAM).
Notedeck provides another level of aggregation on top of logs, in the form of Log Tabs. I came up with log tabs when I realized I wanted to be able to quickly "thumb through" the last several days of logs easily. The use of tabs on the side to navigate between logs was a natural way to approach this.
To create a tiddler that aggregates logs into tabs, insert a call to the
logtabs macro into the wiki, passing in the name of a tag that all the logs you want to aggregate share. For example, if you want to create a tiddler called
Worklogs that aggregates all the
Journal tiddlers, simply place this text into a new tiddler titled
Of course, the title of the actual tiddler doesn't have to be
Worklogs, it could be called
Recent, or anything else you like.
Tiddlywiki natively supports backlinks. Notedeck takes this a step further and modifies the default view template to include a section at the bottom of every tiddler that lists all the backlinks. This makes navigating the reference graph fast and easy.