Thanks for this Mat! Its very helpful and I think essential to the new user experience!
On Saturday, December 2, 2017 at 6:49:25 PM UTC-6, Mat wrote: > > I hope to get the following "Introductions to Lists" into tiddlywiki.com. > The text is intentionally brief - it is just an overview of the relevant > concepts collect in one place. > > This could/should perhaps be posted on TiddlyWikiDocs > <https://groups.google.com/forum/#!forum/tiddlywikidocs>... but I figured > this forum is more likely to give feedback, especially from noobs. I'm also > hoping the Wizards here will point out if anything is missing or wrong. > > Note: If you don't like the wikitext formatting below, you can paste the > text right into a tiddler on tiddlywiki.com to read it more easily and > with working links. > > <:-) > > --------------------------- > > title: Introduction to Lists > > > tags: Learning > > > text: > > Lists play a central role in TiddlyWiki and there are several aspects of > lists worth understanding. The following is a brief run-through of some of > the more common techniques associated with lists. > > Note that lists often don’t have the typical one-item-per-row appearance. > This is especially true for //generated// lists (see below). > > !Static lists > > !!~WikiText > > WikiText lists are explicitly typed lists where special characters are > parsed to show special styling. Examples include bullet lists created with > asterisks (*) and numbered lists (#). Behind the scenes, WikiText lists are > based on the simple `<ul>` and `<li>` html-elements. For more, see [[Lists > in WikiText]] > > !Generated lists > > Generated lists center around [[filters|Filters]] in which [[filter > operators|Filter Operators]] define which are the concerned tiddlers and > which parts of these tiddlers, such as their titles or their texts, that > are desired for the output. > > !!~ListWidget > > This widget is the most powerful tool for creating lists. It allows the > filter output to be manipulated and styled within the ListWidget - also > into many forms that don't resemble lists at all, for example tables or > complex texts. > > ''Side note'': Even tiddlers themselves are made with a ListWidget. The > [[tiddler template|$:/core/ui/ViewTemplate]] lists the templates for each > constituting field of the tiddler such as the title, the tags, the text and > more. > > !!Filtered transclusion > > The short form for filtered transclusion (`{{{...}}}`) takes a filter as > argument and outputs a line-broken but otherwise unstyled list, unless a > template is applied to the output. For example `{{{ [tag[HelloThere]] || > $:/core/ui/TagTemplate }}}` lists all tiddlers tagged HelloThere and > presents them as tags. > > !!list-links Macro > > The [[list-links|list-links Macro]] macro was created to let you quickly > and easily get a preformatted list, typically a bullet list. Behind the > scenes it really is a ListWidget with some styling. > > !Other “list related” commands > > [[list|ListField]], [[list-before|Order of Tagged Tiddlers]] and > [[list-after|Order of Tagged Tiddlers]] are all //field names// to control > the position of tiddlers in a list. > > [[list|list Operator]] and [[listed|listed Operator]] are //filter > operators// that operate on the [[list field|ListField]]. ([[listed|listed > Operator]] can also operator on other fields.) > > > > > -- 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/12145cc8-8e41-4457-b90f-5d1d9ab84a78%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
