Mohammad, If I may explain the Qualify macro for you in my way.
Just as the <<now>> macro returns the time and date eg: 10:21, 6th July 2018 The <<qualify>> macro returns a "unique number" eg: -85796999 and as Jeremy Described "in a way that is unique to the place in the widget tree that it is rendered" which I may add includes the title, change the title and the result changes. Now looking at the result returned you can see it is prefixed with a hyphen, this is a clue that you can add another value <<qualify "mykeyword">> gives us mykeyword-85796999 Basically it generates on the fly a unique number based on its context which you can use with prefixs to generate more than one for the current context. It does not matter if the number changes (Like as the title changes) because it reliably returns the same number in the current wiki everywhere it is used. I suggest when using the <<qualify>> macro to create temp tiddlers <<qualify "$:/temp/mykeyword">> The world makes a lot of sense (in English), when you think about it, you are asking it to Qualify mykeyword so it is unique in this time and place, so you will not accidentally overwrite or use a temporary tiddler from something else. Of course this use of the word Qualify may be unfamiliar to many. Now you may be able to see why it is commonly used for the title of State Tiddlers, this is possibly the only use, however someone may use it in other ways. Regards Tony On Friday, July 6, 2018 at 1:46:16 AM UTC+10, Mohammad wrote: > > Thank you Mark! Thank you Jeremy! > > Yes, the name is confusing! I would rather call it getNewState, genState > or something like that! > > Anyway, I learned know what it is. It generate unique state tiddlers! > > /Mohammad > > > > On Thursday, July 5, 2018 at 7:40:13 PM UTC+4:30, Mark S. wrote: >> >> >> >> On Thursday, July 5, 2018 at 6:58:34 AM UTC-7, AlexHough wrote: >>> >>> Jeremy, >>> >>> To see the difference you have to open up the tiddler. >>> >>> I think the docuemntation example is possibly a bit confusing. >>> >>> For learning I think that perhaps the "try it" feature kind of gets in >>> the way of opening the tiddler and seeing inside. >>> >>> >> Yes. I agree with this. I want to see (and maybe borrow) the real code, >> not carefully orchestrated code where I can't see what's really going on. >> Also, some of the "try this" examples are broken, because they depended on >> data relations that no longer exist. >> >> "Qualify" can also mean something like "to define more carefully", So the >> qualify macro helps create state tiddlers that won't be confused with each >> other. Or at least that was my interpretation. >> >> -- Mark >> > -- 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 [email protected]. To post to this group, send email to [email protected]. 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/06763568-60df-46fd-b7b4-91668025f364%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
