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/870a9da8-f952-4860-ab36-933c879bb6e9%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
