The next tiddler type to consider is the meeting. If you stop and think about it, we probably already have a meeting, we just haven't created a tiddler for it yet: Jane met with our fearless wiki-writing protagonist to help her set up her computer, according to the journal entry we wrote. So let's create a meeting tiddler.
Excising a meeting
It's common in TiddlyWiki to write something in a tiddler and then realize it should be its own smaller tiddler. In fact, it's so common there's a special button on the edit toolbar for this operation, called excising. Let's excise the line about Jane welcoming our protagonist from our journal entry. To do this, edit the journal tiddler, select the sentence, and click the appropriate button on the editor toolbar (just a little bit to the right of the heading icons). Let's call the new tiddler EmployeeProfileSetupMeeting
.
You can see there's a choice for what we want to replace the excised text with: link, transclusion, or macro. Transclusions and macros are kind of fancy, so let's stick with the basic and easy-to-understand link for now; we'll explore transclusions and macros in detail later on. Click Perform excision, and the selected text will be replaced with a link. Save the tiddler and click the link, and we're looking at our new meeting tiddler, containing the text we originally selected.
Adding metadata
Let's edit our new meeting tiddler and give it a tag of Meeting
, to start with. We're also going to want to add some other metadata: we said in our requirements that we wanted to be able to find meeting notes based on (1) when the meeting happened and (2) who attended.
Let's start with who attended. We have at least two obvious options here. One is to simply make sure that we link to everyone involved in the meeting somewhere within the text of the tiddler. Another is to explicitly list out the participants in a field. The former option is probably easier, but you're more likely to forget someone, and you won't be able to distinguish between people who were at the meeting and people who were merely discussed at the meeting. Let's be a bit more precise and create a field, called participants
, and set its value to JaneDoe
. (We'd be more precise to add ourselves too; but most people do not often take notes on meetings they're not at, so this likely isn't necessary unless you frequently receive meeting notes from others that you'd like to import into your wiki.)
The other way we wanted to be able to slice our meetings is by when they happened. One straightforward way to handle this would be to use the created time on the tiddler, which TiddlyWiki fills in automatically whenever you create one. However, this means that if we start our meeting notes prior to the meeting (to stub out an agenda if we're running the meeting), or fill them in afterwards (because we didn't have our laptop at the meeting), the time will be wrong. So for the sake of demonstration, let's create our own date/time field.
TiddlyWiki uses an awkward format for dates and times: the four-digit year, the two-digit month, the two-digit day, the two-digit 24-hour hour, the two-digit minute, the two-digit second, and the three-digit milliseconds, all run together, in the UTC timezone (colloquially known as Greenwich Mean Time). So if it's 8:31:41 PM my time on May 30, 2024 right now, Central Daylight Time (UTC-5), the time according to TiddlyWiki is 20240531013141000 (it's on the 31st at 1am because I have to add 5 hours to get to UTC).
This can be a little irritating to work with, but there are several ways we can make it easier: plugins are available that can create a special date/time picker we can include on our meeting tiddlers, or we can autofill the time when we create the tiddler, thus making it easier to make any minor adjustments necessary. Let's do it manually for the moment so you learn how it works. (In an exercise in chapter 5, we'll improve this using the autofill approach.) Create a new field called at
, work out your current date and time in TiddlyWiki's date format, as described in the preceding paragraph, fill that in as the value of the at
field, and click the add button.
To check your work, paste the following magic snippet into the text of the tiddler and have a peek at the live preview, which should show the date you've entered in a nice human-readable format. We'll learn what exactly this snippet does in Working with Dates.
<$view field="at" format="date" template="DD MMM YYYY hh12:0mm:0ss pm"/>
Save this tiddler, and we've got our first meeting.