list macro

The <<list>> macro creates a list of tiddlers of a given type. It takes the following parameters:

<<list {type} [template:<templateTiddlerName>] [emptyMessage:"<message for when the list is empty>"]>>

The template tiddlers allows you to customise the text that is displayed about each tiddler. If it is not provided, then the default of "<<view title link>>" is used, which just includes the title of the tiddler as a link. You could add the author to each entry in the list by setting the template to a tiddler with the text "<<view title link>> by <<view modified link>>".

The empty message parameter allows you to specify text to be displayed if the list of tiddlers is empty.

The following types are supported:

all

To list all tiddlers

<<list all>>

filter

List tiddlers that match a certain filter. The following example lists all plugins.

<<list filter [tag[systemConfig]]>>

Missing

To list tiddlers that have links to them but are not defined:

<<list missing>>

Orphans

To list tiddlers that are not linked to from any other tiddlers:

<<list orphans>>

Shadowed

To list tiddlers shadowed with default contents:

<<list shadowed>>

Touched

Show tiddlers that have been modified locally:

<<list touched>>
14 December 2011 (created 11 February 2011)
inserted by FC2 system