@PMario, I'm hoping we can improve the Introductory part of the TiddlerWidget docs <http://tiddlywiki.com/#TiddlerWidget>. That part of widget docs is typically brief - a sentence or two. So, while I agree a greater sense of understanding would require more context, like what you describe, I'm thinking we should still aim to keep it limited to only what the very TiddlerWidget does. But, still, maybe an off-handed mention about what the current tiddler is can pass;
The TiddlerWidget <http://tiddlywiki.com/#TiddlerWidget> is used to set a > value for the current tiddler <http://tiddlywiki.com/#Current%20Tiddler> > variable, valid within the scope of the TiddlerWidget. > Better? Maybe we shouldn't even call "current tiddler" that but instead "currentTiddler" which at least to me more clearly shows what it is, i.e a variable (...or is there a conceptual difference between "current tiddler" and "currentTiddler" ? I don't recall ever seeing "current tiddler" used in actual wikitext?) <:-) your reply seem to be more about what "current tiddler" is than what the TiddlerWidget does - ? On Thursday, February 16, 2017 at 10:55:34 PM UTC+1, PMario wrote: > > On Thursday, February 16, 2017 at 9:12:42 PM UTC+1, Mat wrote: >> >> >> IMO this phrase is not easily understood. I'm wondering if the following >> is a clearer (and accurate) description: >> >> The TiddlerWidget <http://tiddlywiki.com/#TiddlerWidget> sets a title to >>> be the regarded as current tiddler >>> <http://tiddlywiki.com/#Current%20Tiddler> within the scope of the >>> TiddlerWidget. >>> >> >> > I'm sorry, but this doesn't make more sense. At least not for me. IMO we > can't explain it on one sentence. > > currentTiddler is a *variable*, that is used by various core functions > and the UI, to show widgets, what's the current "scope" to work with. > > So functions like {{!!tags}} which is the same as: <$/transclusion > <http://tiddlywiki.com/#TranscludeWidget>field=tags/> know what's the > default tiddler to use, if there is no tiddler=xxx parameter. > > The list-widget would need to look like this: <$list filter="a b c" > variable=currentTiddler> ... scope ... </$list> everytime you use it. ... > This isn't convenient and very error prone. That's why there is a default > for many parameters, that widgets use. In the example, the list-widget > basically is a loop where currentTiddler is set to a, b and c > sequentially. > > The tiddler widget does the same thing, without the loop. It sets > currentTddler within the scope. > > <$tiddler tiddler=test> ... scope ... </$tiddler> > > That's it. > > -mario > -- 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 tiddlywiki@googlegroups.com. Visit this group at https://groups.google.com/group/tiddlywiki. To view this discussion on the web visit https://groups.google.com/d/msgid/tiddlywiki/da272515-6f2e-43a4-b5a0-a02bf2a7865f%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
