> In the old TW, if I remember rightly, there was a tiddler called
> 'Title' - if you changed the content of the 'Title' tiddler to 'Joes
> Blog' - then the TW would magically be named 'Joe Blog’.
It was called “SiteTitle” in TiddlyWiki Classic.
> This is easily to explain and demonstrate - but even this might be
> perceived as difficult by a total beginner - taking the first step is
> always the most difficult.
> In TW5 'Title' is called '/$SiteTitle' - I can imagine very good
> reasons for this - one might accidentally choose the word 'Title' and
> change it with rather puzzling results (if you didn't know what you
> were doing)
That’s exactly the reason for the change. The “$:/” prefix identifies a “system
tiddler”, which means that it will be omitted from most of the sidebar lists
and searches. It’s a simple way to hide the scaffolding of a TiddlyWiki so that
those tiddlers don’t fill up the lists.
> It wasn't exactly obvious to me that the tiddler '/$SiteTile' was the
> thing to change. So this needs some explanation.
> I want to make an explanation that starts with empty.html (the empty
> TW from https://tiddlywiki.com/
I think the quickest route is:
* Click the cog icon in the right hand sidebar to open the control panel
* Locate the text box labelled “Title of this TiddlyWiki” and type the title
for this TiddlyWiki
* Optionally, click on the label “Title of this TiddlyWiki” itself to open the
tiddler titled “$:/SiteTitle” and see that it is the underlying value, and can
be edited just like any other tiddler
In fact, the “GettingStarted” shadow tiddler in empty.html includes a prompt
for the site title and subtitle.
> But If I close it it vanishes.
> So click on the 'Recent' tab.
> Is this *obvious* to a total beginner?
A good question. The goal is to have few enough things going on in empty.html
that a user might be induced after a while to explore the interface (tooltips
etc) driven by “what is this thing here?” rather than “how do I?” questions.
Perhaps it’s the principle of old fashioned “Adventure” games: if you find
yourself in a cabin in the snow with only a plus sign, a cog, and a down arrow,
then eventually you’ll click them to see what happens.
> Step 3)
> Make the page I just created appear in a 'Contents' tab
> as in https://tiddlywiki.com/
> How do I do this????
The “Contents” tab is currently not present by default in an empty tiddlywiki.
There’s probably a strong case that we should incorporate it, but the present
situation means that users need to learn some TiddlyWiki basics to get a table
* How to create a new tiddler
* How to invoke a macro
* How to tag tiddlers to thread the TOC together
> Show the amazing power of list transclusion (is this the correct term)
The docs call it “filtered transclusion” (ie where we transclude all the
tiddlers identified by a filter), but we could do with a better term.
> Step 5a) Create a page called ToDo
> Add the single line
> <<list-links "[tag[todo]]">>
> Step 5b) Create any page and add the tab 'todo'
> Step 5c) Go to the ToDo page and magically the page you just added
Perhaps this is the point to introduce the TOC macro; it’s an extension of this
simple one dimension list.
> Is this a good order? - Is there an event simpler ordering of concepts????
I’m also compelled by the idea that there exists an optimal ordering, at least
for the basic internal concept and UI. We probably need a multiplicity of
step-by-step tutorials for different audiences — imagine how one would teach
TiddlyWiki to a Lisp programmer.
> Now to the subject of "magic" (shadow tiddlers)
> I want to introduce TW5 to a complete beginner who is not a programmer
> Certain tiddlers (like '/$SiteTitle') have an immediate effect on the
> site and are easy to understand. Others are far more difficult to understand.
> So in what order would you introduce the shadow tiddlers - I'm assuming
> '$/SiteTitle' is #1 - or is there an even easier and more direct tiddler
> (say to change the background color)
The most visceral characteristic of a shadow tiddler is that if you modify one
you can always revert by “deleting” your overridden value and thus restoring
the underlying shadow. So, I like to show that, and then only much, much later
start to talk about how shadow tiddlers are actually the payload tiddlers of
> How about tags with side effects. I discovered the tag 'TableOfContents'
> caused the tiddler in question to appear in the 'Contents' tab
> of the sidebar - What are the most important tags that one would introduce to
> a beginner????
The “TableOfContents” tag is only special in that it is referenced by the
“TableOfContents” tiddler in tiddlywiki.com. The special tags built into the
core can be seen in the docs: https://tiddlywiki.com/#SystemTags
> You received this message because you are subscribed to the Google Groups
> "TiddlyWiki" group.
> To unsubscribe from this group and stop receiving emails from it, send an
> email to tiddlywiki+unsubscr...@googlegroups.com
> To post to this group, send email to firstname.lastname@example.org
> Visit this group at https://groups.google.com/group/tiddlywiki
> To view this discussion on the web visit
> For more options, visit https://groups.google.com/d/optout
You received this message because you are subscribed to the Google Groups
To unsubscribe from this group and stop receiving emails from it, send an email
To post to this group, send email to email@example.com.
Visit this group at https://groups.google.com/group/tiddlywiki.
To view this discussion on the web visit
For more options, visit https://groups.google.com/d/optout.