Template:Wikidata list/doc
This manual might be out of date, please check with the master copy!
Usage
editThis template defines a bot-generated list based on Wikidata (original blog post). It must be "closed" with {{Wikidata list end}}; the text between these two templates will be periodically (once every 24h) replaced by the bot-generated list. At this moment, only one list per page is possible. Example:
{{Wikidata list |sparql=SELECT ?item WHERE { ?item wdt:P31 wd:Q39715 . ?item (wdt:P131)* wd:Q55 } |columns=label:Article,description,p131:Place,P580,P582,p625,P18 |section=131 |min_section=3 |sort=label |links=text |thumb=128 |autolist=fallback |wdedit=yes }} ... (This will be overwritten by ListeriaBot) ... {{Wikidata list end}}
Parameters:
- sparql
- A SPARQL SELECT query. Needs to return
?item
as the item number. You can use a conversion tool to convert WDQ to SPARQL, but always check your query to make sure it works. Mandatory.
See SPARQL query service examples suitable for Listeria - wdq
- A WikiDataQuery query string. The resulting items will be used to build the list. Try your query out here. Deprecated, use SPARQL. The WDQ query service will be shut down some point in the future.
- columns
- Defines the columns of the list table. Allowed values are :
number
, a serial row number (per section), increasing from 1, according to the initial sortinglabel
, the wiki-language-based label of the item, linked to the local article (where exists), or the Wikidata itemlabel/de
, the wiki-language-based label of the item, using the given language (here, "de"), as plain textalias/xx
, the wiki-language-based list of aliases for the item, using the given language code (here, "xx"), as plain text. Use e.g. alias:en in the row_template.description
, the manual, or auto-generated descriptionitem
, the Q item numberPxxx
a Wikidata propertyPxxx/Pzzz
, qualifier properties; for Pxxx linking to an item Qyyy and having a Pzzz qualifier, the Qxxx linked label and the value of PzzzPxxx/Qyyy/Pzzz
, qualifier properties; for Pxxx linking to an item Qyyy and having a Pzzz qualifier, the value of Pzzz. This is a version of the above, specific for a single item; e.g., "p553/q866/p554" to get YouTube account names.?fieldname
, a SPARQL result field name. For SPARQL-based lists only.
- Values marked as "deprecated" are not shown. Every column can optionally have a ":Titel", otherwise the Wikidata property name is used. Mandatory
- sort
- The initial sort key for the table. Valid values are:
label
, the label of the itemfamily_name
, tries to find, and sort by, the family (last) name from the label, assuming items are people. This is a heuristic and may not work properly in all cases. If possible, try to sort by P734 (family name).Pxxx
, a Wikidata property
- Optional
- sort_order
- DESC will reverse the sort order, any other value leaves it ascending.
- section
- The list can be sectioned by a Wikidata property. Optional
- min_section
- The minimum number of entries to generate a section when used together with
section
. All other entries will be put under section "misc". Default:2. Optional - autolist
- If description is a column but no description exists on Wikidata, "autolist=fallback" uses AutoDesc to generate one. Optional
- language
- Label/description language, if different from site language. Optional
- thumb
- The thumbnail width for images (e.g. column P18). Default:128. Optional
- links
- How to render links not in the local Wikipedia. Valid values are:
all
to link to Wikidata. Default.local
to remove entries for which there exists no local article (the opposite ofred_only
).red
to generate red links based on label and item.red_only
to remove entries for which there exists a local article (the opposite oflocal
).text
to generate blue links for existing pages, and plain text otherwise.reasonator
to generate blue links for existing pages, and links to Reasonator otherwise.
- Optional
- row_template
- Generates a template call rather than a table row; the template must then generate the table row in turn or the table header/footer need to be surpressed using
skip_table
parameter. Parameters passed to the template are the lower-case keys from thecolumns
parameter, e.g.label
orp18
. Optional - skip_table
- Suppresses the table markup completely when using
row_template
. Any value will work. - wdedit
- Generates information that allows Wikidata editing from Wikipedia using this JavaScript. Value needs to be
yes
. Does not work whenrow_template
is used. Caution: This will result in larger wikitext than normal, and updates may fail because of that. Optional - references
- Add references. Allowed value is
all
. Requires {{Reflist}} or similar somewhere in the page. Optional - freq
- Numerical value X; wait at least X days before an automatic update. Does not affect updates via web interface. Optional
- summary
- Comma-separated list of keys to add as a summary underneath all other content. Optional
itemnumber
The total number of items (rows) in this list.