> > What do you think if use the left bar for table of contents? >
Sounds like a good idea, but I have not done it yet. > There are some stuffs prepared by others like Tobias Beer, Jed carty, > Dave Graford, what do you think if you merge part of them here, those part > are useful? > You mean similar documentation?, at the moment I will use all I can find to improve mine, but would like to write it in my words/structure Any community resource would of course reference them all > Is it possible to invite others to help and have a community to prepare, > edit and review the contents? > Yes, I am working on that and can already with Yammer, if you are Mohammad Rahmani you are a member already visit this document to collaborate on it https://www.yammer.com/tiddlywiki/#/files/140794632 if not visit https://www.yammer.com/tiddlywiki to request an invite Thank you too Mohammad Tony > On Tuesday, July 3, 2018 at 2:48:20 AM UTC+4:30, TonyM wrote: >> >> Mohammad, >> >> I will build this document here https://tiddlywiki.psat.com.au in the >> tiddler TiddlyWiki code structure >> Published later today >> >> Regards >> Tony >> >> On Monday, July 2, 2018 at 9:58:08 PM UTC+10, Mohammad wrote: >>> >>> Hi Tony! >>> This is great and helpful, worth to put somewhere to be accessible >>> later. In this forum is hard to find and follow stuffs later. >>> >>> Cheers >>> Mohammad >>> >>> On Monday, July 2, 2018 at 3:56:41 PM UTC+4:30, TonyM wrote: >>>> >>>> Folks, >>>> >>>> Here is a dump of my draft document, it is in no way finished, but will >>>> give you a feel for what I am trying to document. Please tell me what we >>>> should include. >>>> >>>> I will try and show if then else while until etc.. in the long run >>>> >>>> Regards >>>> Tony >>>> >>>> 1. SequenceOne step following anotherWith sequence it commonly stops >>>> when you reach the bottom of a tiddler >>>> >>>> - 1.1 Left to right, Top then down the wiki text, the first item is >>>> displayed above the next etc... down the page >>>> >>>> Note new line vs paragraphs >>>> >>>> - 1.2 Using list and a filter to get a sequence of items displayed >>>> or acted on >>>> >>>> Using a list for sequence it commonly stops when the members of the >>>> list finish/are exhausted, it then moves to the next line of the current >>>> tiddler until you reach the bottom of a tiddlerThis can be impacted by >>>> "Includes" see below.2. IterationRepeat for each item in a set, ending >>>> when no more items are in the set or some condition is true/false >>>> >>>> - 2.1 Using the list widget with a filter that has 0 or more >>>> members >>>> - 2.2 An iteration can be ordered using sorting >>>> - 2.3 There are many ways to re-iterate, and you can re-iterate >>>> Macros, with transclusions and a lot more, most iterations will end >>>> with no >>>> more members in a list or some other condition. >>>> >>>> 3. SortingChoosing the order in which more than one item is listed >>>> >>>> - 3.1 Filtered lists permit the addition of the sort[fieldname] >>>> filter operator which can be used to sort the final list >>>> >>>> Default is title or for tagged items the order in which they appear in >>>> the tags list field!sort[fieldname] will reverse the order >>>> >>>> - 3.2 Used with iteration to support the order in which the items >>>> are acted on >>>> >>>> 4. Selection/Decisionusing some condition to determine whether to >>>> display something or not >>>> >>>> - 4.1 A list field will list is membership if there are members. >>>> otherwise will not >>>> - 4.2 If you need to determine if there are one or more (not Zero >>>> members), or any other number of something >>>> >>>> You can use the limit[n] filter operator so that limit[1] will display >>>> only once if there is one or more members?Limit[0] works??Use ? >>>> starting line for a different class >>>> >>>> - 4.3 If you want to test there is no members? >>>> >>>> The emptyMessage is available on the list widget and emptyValue on the >>>> set widget >>>> >>>> - 4.4 What if you want to list the non-members >>>> >>>> Using the ! with the filter operatorsNote default set all regular >>>> tiddlers so perhaps filter based on another condition first >>>> >>>> - 4.5 The reveal widget allows a section to be displayed according >>>> to a match including comparisons >>>> >>>> Reveal widgets can also be nested >>>> >>>> - 4.6 Simple Comparisons >>>> - 4.7 Inclusion/exclusion and other selection tests >>>> - The do nothing case or filter but exclude >>>> - A tiddler but not those it is the prefix of >>>> >>>> [prefix[tiddlername]suffix[tiddlername]] is both its prefix and its >>>> suffix >>>> >>>> - 4.8 Selection and decisions can be made based on values that are >>>> in variables, Tiddlers, fields and more >>>> >>>> so review *Using Values and variables* or *Setting Values and >>>> variables*5. NestingThis is the process where one set of actions occur >>>> within another set of actions, With tiddlywiki nesting can occur for many >>>> levels "deep"This is how Case and Recursion below, amongst other >>>> structures are possible. >>>> >>>> - 5.1 One implicit example of nesting is a Single ListWidget >>>> <http://127.0.0.1:8084/TW5Reference#ListWidget> in a particular >>>> tiddler, it is in fact nesting its result in the existing tiddler >>>> - 5.2 In most cases anything you write can be nested within >>>> something else, and as many deep as you choose. >>>> >>>> However if you nest your current tiddler in the current tiddler you >>>> *may* face infinite recursion (like between two mirrors)See 7.x >>>> Recursion for intentional use of this ability >>>> >>>> - 5.3 Example Nesting list widgets >>>> >>>> >>>> <$list filter="filter1"> >>>> Do this for each filter1 case >>>> <$list filter="filter2"> >>>> Do this for each filter2 case >>>> <$list filter="filter3"> >>>> Do this for each filter3 case >>>> <$list filter="filter4"> >>>> Do this for each filter4 case >>>> </$list> >>>> </$list> >>>> </$list> >>>> </$list> >>>> >>>> *Notes:* >>>> >>>> - If the number of levels of nesting can vary or is large or >>>> unknown using *recursion* may be a better solution. >>>> - If transclusion or macro are used to *include* additional content >>>> these are in effect nested where they are included, and may contain >>>> other >>>> nesting themselves. >>>> - Each filter applies to the CurrentTiddler >>>> <http://127.0.0.1:8084/TW5Reference#CurrentTiddler> as determined >>>> by the previous ListWidget >>>> <http://127.0.0.1:8084/TW5Reference#ListWidget> unless a variable= >>>> *variablename* is set. >>>> - Each filter starts with an assumption you are filtering from all >>>> tiddlers, so use a variable or currentTiddler value from the previous >>>> List >>>> widget for logically nested lists. >>>> >>>> 6. CaseWhen you want something to occur differently for each case or >>>> member in a set6.1 A simple list allows you to do something for each >>>> member in a list which is a simple example of the "Case" structure.In >>>> the following example each member of the set becomes the current tiddler >>>> and everything in "Do this for this case" will be applied to each tiddler. >>>> >>>> <$list filter="yourfilter"> >>>> Do this for each case >>>> </$list> >>>> >>>> 6.2 Treating specific cases differentlynote in the below skeleton that >>>> the "specific case" tests are nested at the same level within the >>>> "yourfilter" outer listWidget >>>> >>>> <$list filter="yourfilter"> >>>> Do this for each case >>>> <$list filter="specificcase1filter"> >>>> Do this for each specificcase >>>> </$list> >>>> <$list filter="specificcase2filter"> >>>> Do this for each specificcase2 >>>> </$list> >>>> </$list> >>>> >>>> >>>> very sophisticated case structures can be built with the power of each >>>> list filter, emptyMessageexamples to follow >>>> >>>> - One statement for a subgroup or list of values >>>> - Multiple actions for each case >>>> >>>> 7. RecursionA process calling itself >>>> >>>> - 7.1 Using ListWidgets >>>> <http://127.0.0.1:8084/TW5Reference#ListWidgets> in a tiddler or >>>> macro to call itself allows you to perform recursive loops >>>> >>>> For example building a TableOfContents >>>> <http://127.0.0.1:8084/TW5Reference#TableOfContents> which list the >>>> tiddlers tagging the top tiddler, then all tiddlers tagging those, then >>>> all >>>> tiddlers tagging those...The advantage of the list widget is it >>>> typically finishes after the last item in the list is processed, ensuring >>>> you eventually exit all recursion levels See WikiPedia on Recursion >>>> <http://en.wikipedia.org/wiki/Recursion>8. Includesincluding content >>>> in one location that is found in another >>>> >>>> - 8.1 Macros >>>> - 8.2 Transclusion >>>> >>>> 9. Using Values and variablesSet/Vars/ParamsEmptyValue >>>> <http://127.0.0.1:8084/TW5Reference#EmptyValue>/EmptyMessage >>>> <http://127.0.0.1:8084/TW5Reference#EmptyMessage>Auto seting in >>>> liststitles >>>> of tiddlers vs pseudo titles from lists10 Setting Values and >>>> variablesOften >>>> values and variables can be set in the context they are used as seen in >>>> *Using >>>> Values and variables*, however we often want the user to supply >>>> information for our Values and Variables >>>> >>>> - Select >>>> - Checkbox >>>> - Edit >>>> - >>>> >>>> 11. Accessing last or previous values >>>> >>>> >>>> On Monday, July 2, 2018 at 9:05:52 PM UTC+10, TonyM wrote: >>>>> >>>>> Evan of formulas fame has also provided logical operators you can use >>>>> but it can be achived with a set of listwidgets and filters with the else >>>>> handled buy using the same filter with negation using ! >>>>> >>>>> Even using the emptyMessage in list and emptyVale in set widgets helps. >>>>> >>>>> You can nest list widgets in any combination you want. I have half >>>>> written a guide on this, tw equivalents to normal code structures, I can >>>>> share the draft. >>>>> >>>>> It takes a little to learn the filter equivalent of if tests but once >>>>> mastered they can be more powerful because they are not only logical >>>>> operators but act on sets of titles (which can be litteral values not >>>>> just >>>>> tiddler titles). >>>>> >>>>> One difference is tw does not favor simple true false test as much >>>>> because what it offers is designed to respond to tiddlers, tags and >>>>> fields >>>>> and is thus much richer. >>>>> >>>>> Providing some simpler tests may assist users. >>>>> >>>>> Regards >>>>> Tony >>>>> >>>>> -- 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/7a95315c-cfd2-418f-95d4-7466c403bf31%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.