Lihimi Tɛmplet:Wikidata list/doc ni yi shɛli na

{{Documentation subpage}}
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) -->

== Usage ==

This template defines a bot-generated list based on Wikidata ([http://magnusmanske.de/wordpress/?p=301 original blog post]). It must be "closed" with {{tl|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. 

The query '''MUST''' include the <code>?item</code> variable - do not rename it.

It is also possible to combine usage with the Mbabel tool, for Wikipedia article drafts based on a particular Wikidata query - see [[Wikipedia:Mbabel/Collections]].

=== Use in mainspace ===
There is no consensus to use this template and {{u|ListeriaBot}} to maintain lists in article space per [[Wikipedia:Bots/Noticeboard/Archive 13#Re-examination of ListeriaBot]]. Any uses of this template in mainspace will produce an error message ({{error|There is no consensus to use [[Template:Wikidata list]] in articles}}) and populate [[:Category:Pages with templates in the wrong namespace]], and will not be updated.

=== Example ===
 {{tlf|{{BASEPAGENAME}}
 |'''sparql'''{{=}}<br/>
    {{pad}}{{code|2=sparql|SELECT ?item WHERE {}}<br/>
    {{pad|2em}}{{code|2=sparql|?item wdt:P31 wd:Q39715 .}}<br/>
    {{pad|2em}}{{code|2=sparql|?item (wdt:P131)* wd:Q55 }}<br/>
    {{pad}}<code>}</code><br/>
 |'''columns'''{{=}}label:Article,description,p131:Place,P580,P582,p625,P18<br/>
 |'''section'''{{=}}<br/>
 |'''min_section'''{{=}}<br/>
 |'''sort'''{{=}}label<br/>
 |'''links'''{{=}}text<br/>
 |'''thumb'''{{=}}128<br/>
 |'''autolist'''{{=}}fallback<br/>
 |'''references'''{{=}}all<br/>
 |'''summary'''{{=}}itemnumber<br/>
 |'''freq'''{{=}}7<br/>
 |'''wdedit'''{{=}}yes<br/>
 }}
 ... (This will be overwritten by ListeriaBot) ...
 {{tl|Wikidata list end}}

===Parameters===
;sparql:A [[:mw:Wikidata query service/User Manual#Basics - Understanding SPO (Subject, Predicate, Object) also known as a Semantic Triple|SPARQL ''SELECT'' query]]. See [[d:Wikidata:SPARQL query service/queries/examples/advanced#Listeria|SPARQL query service examples ]] where many are suitable for Listeria. Needs to return <code>?item</code> as the item number. Double curly brackets (for example "<nowiki>}}</nowiki>") should be avoided, for example by inserting a space between them ("<nowiki>} }</nowiki>"). '''Mandatory'''. <br>
;columns:Defines the columns of the list table. Allowed values are :
:* <code>number</code>, a serial row number (per section), increasing from 1, according to the initial sorting
:* <code>label</code>, the wiki-language-based label of the item, linked to the local article (where exists), or the Wikidata item. Labels without values for the wiki-language will show the english label as a fallback
:* <code>label/xx</code>, the wiki-language-based label of the item, using the given language code (here, "xx"), as plain text. Labels without values for the requested language will show the english label as a fallback
:* <code>alias/xx</code>, the wiki-language-based list of aliases for the item, using the given language code (here, "xx"), as plain text.
:* <code>description</code>, the manual, or auto-generated description
:* <code>item</code>, the Q item number
:* <code>Pxxx</code> a Wikidata property
:* <code>Pxxx/Pzzz</code>, qualifier properties; for Pxxx linking to an item Qyyy and having a Pzzz qualifier, the Qxxx linked label and the value of Pzzz
:* <code>Pxxx/Qyyy/Pzzz</code>, 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.
:* <code>?fieldname</code>, a SPARQL result field name (variable).
:A column header is specified by adding ":Header" suffix to the column definition, otherwise the Wikidata property (language) name is used. For quantities (numerical properties) where lower and upper bounds are indicated as ''nominal value'' +/- ''tolerance'' (for example 15 +/- 5), only the nominal value (15) is shown. Case sensitive. Since the release of May 2021 single quotes are not supported (causes the query to fail with a "not edited" message).
;sort:The initial sort key for the table. Valid values are:
:* <code>label</code>, the label of the item
:* <code>family_name</code>, 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).
:* <code>Pxxx</code>, a Wikidata property
: ''Optional''
;section:The list can be sectioned by a Wikidata property. ''Optional''. Can be a property number (preferably prefixed by P), or a <code>?fieldname</code>.
;min_section:The minimum number of entries to generate a section when used together with <code>section</code>. 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 [https://tools.wmflabs.org/autodesc/ 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 (properties with datatype ''item'') not in the local Wikipedia. Valid values are:
:* <code>all</code> to link to Wikidata. Default.
:* <code>local</code> to remove entries for which there exists no local article (the opposite of <code>red_only</code>).
:* <code>red</code> to generate red links based on label and item.
:* <code>red_only</code> to remove entries for which there exists a local article (the opposite of <code>local</code>).
:* <code>text</code> to generate blue links for existing pages, and plain text otherwise.
:* <code>reasonator</code> to generate blue links for existing pages, and links to [https://tools.wmflabs.org/reasonator/ 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 suppressed using  <code>skip_table</code> parameter. Parameters passed to the template are the lower-case keys from the <code>columns</code> parameter, e.g. <code><nowiki>label</nowiki></code> or <code><nowiki>p18</nowiki></code>. ''Optional''
;header_template:Generates a template call rather than a table header; the template must then generate the table header. No parameters are passed to this template. Recommended to be used with <code>row_template</code>. ''Optional''
;skip_table:Suppresses the table markup completely when using <code>row_template</code>. Any value will work.
;wdedit:Generates information that allows Wikidata editing from Wikipedia using [https://www.wikidata.org/w/index.php?title=User:Magnus_Manske/wd_edit.js this JavaScript]. Value needs to be <code>yes</code>. Does not work when <code>row_template</code> 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 <code>all</code>. Requires {{tl|reflist}} or similar somewhere in the page. ''Optional''
;freq:Numerical value X; wait at least X days before an automatic update. Default 1. Does not affect updates via web interface. ''Optional''
;summary:Comma-separated list of keys to add as a summary underneath all other content. ''Optional''
:* <code>itemnumber</code> The total number of items (rows) in this list.
;one_row_per_item: Set to <code>no</code> if the SPARQL has multiple results for the same item, and you want them in in separate list rows (since V2). ''Optional''

=== Bug reports ===
Report issues or propose new ideas [//github.com/magnusmanske/listeria_rs/issues on GitHub]

===References===
{{Reflist}}

<includeonly>{{Sandbox other||
<!-- Categories below this line, please; interwikis at Wikidata -->
[[Category:Wikidata list templates]]
[[Category:Wikidata templates]]
}}</includeonly>