Editing Template:List/doc

{{TOCright}}
This template lists the contents of the category given as its first argument, e.g. to list all pages in the category [[:Category: Fabric]], use:

    <nowiki>{{List|Fabric}}</nowiki>

== Result Order and Number ==
Optionally, you can limit the number of pages listed, sort the list and order it. For example, to list the two most expensive fabrics, breaking ties by ease to work with them, you could use ('''NB: Whitespace and captitalization matter'''):

    <nowiki>{{List|Fabric|limit=2|sort=Market Value Base,Work To Make Factor|order=desc,asc}}</nowiki>

This gives:

<div style='border: 1px solid #aaa; margin: 1em 0; padding: 1em'>
{{List|Fabric|limit=2|sort=Market Value Base,Work To Make Factor|order=desc,asc|item=Ask/Item Light}}
</div>

== Customizing Result Appearance ==
The list template calls the template [[Template:Ask/Item]] for every page. You can override this with its item parameter. It passes the following parameters to the item template:

{| {{STDT|c_01}}
|-
! Parameter !! Description
|-
|<nowiki>{{{?Name}}}</nowiki> || Name of the page
|-
|<nowiki>{{{?Image}}}</nowiki> || Name of the icon for the page
|-
|<nowiki>{{{?Description}}}</nowiki> || Description of the page (from XML)
|-
|<nowiki>{{{?Note}}}</nowiki> || Description of the page (user-set, usually the first paragraph of the page content)
|-
|<nowiki>{{{?Tags}}}</nowiki> || Name of the template that can produce the tags for the page
|-
|<nowiki>{{{userparam}}}</nowiki> || Value passed to ''param='' in the list template
|}

== How does the template work? ==
The template uses the Semantic MediaWiki (SMW) extension to get its data. In particular, it uses the <nowiki>{{#ask: ... }}</nowiki> parser function. You can get the full details about how it works in [http://semantic-mediawiki.org/wiki/Help:Inline_queries its official documentation], but here are the basics:

Let's return to above example:

    <nowiki>{{List|Fabric|limit=2|sort=Market Value Base,Work To Make Factor|order=desc,asc}}</nowiki>

When MediaWiki expands that template, it becomes:

    <nowiki>{{#ask: [[Category: Fabric]]
    | ?# = Name
    | ?Image
    | ?Description
    | ?Note
    | ?Tags
    | format     = template
    | named args = yes
    | link       = none
    | template   = Ask/Item
    | limit      = 2
    | sort       = Market Value Base,Work To Make Factor
    | order      = desc,asc
    }}</nowiki>

The first line tells SMW to look for all pages in the [[:Category: Fabric]] category. The new five lines start with ? and tell it which data to select from those pages (more about that below). The "?# = Name" means "take the page title and refer to it as ?Name". After that, the template tells SMW to called the [[Template:Ask/Item]] template for every result (format = template and template = Ask/Item), to pass along the data as named arguments, and to use only page names instead of links (e.g. "Devilstrand" instead of "<nowiki>[[Devilstrand]]</nowiki>").

Thus, the above template call becomes:

    <nowiki>{{Ask/Item|?Name=Hyperweave|?Image=File:Hyperweave.png|?Description=High-tech nano-fibers...|?Note=Top-of-the-shelf, incredibly tough...|?Tags=Template:Textile/Tags}}</nowiki>
    <nowiki>{{Ask/Item|?Name=Devilstrand|?Image=File:Devilstrand.png|?Description=Fabric spun...|?Note=Devilstrand is obtained...|?Tags=Template:Textile/Tags}}</nowiki>

These are then substituted normally again.

(NB: Template:Textile/Tags does not exist yet, so the ?Tags parameter above is empty at the moment. This will change soon.)

== Where does the data come from? ==
SMW know about, say, the description of Devilstrand, because on the [[Devilstrand]] page there is a [[Template:Define]] template, which executes the following:

   <nowiki>{{#set: Description = {{{description|}}} }}</nowiki>

The <nowiki>{{#set: ... }}</nowiki> parser function is the opposite of <nowiki>{{#ask: ... }}</nowiki>, it tells SMW that the page in question has one or more properties or relations. For the full description, see again [http://semantic-mediawiki.org/wiki/Help:Properties_and_types the official documentation].

You can browse the data available about a page by using the "Browse Properties" link under "Tools" in the menu on the left side of the screen. You can browse all page/value pairs for a property by visiting its page in the Property: namespace, e.g. [[Property:Market_Value_Base]].