https://moasspedia.org/w/index.php?action=history&feed=atom&title=Template%3AWikidata_list%2FdocTemplate:Wikidata list/doc - Revision history2026-04-13T09:08:24ZRevision history for this page on the wikiMediaWiki 1.37.2https://moasspedia.org/w/index.php?title=Template:Wikidata_list/doc&diff=39358&oldid=prevWikipedia>Pppery: /* Use in mainspace */ Rewrite to reflect the current truth; it baffles me that nobody updated this section back in April 20202021-08-22T01:34:58Z<p><span dir="auto"><span class="autocomment">Use in mainspace: </span> Rewrite to reflect the current truth; it baffles me that nobody updated this section back in April 2020</span></p>
<p><b>New page</b></p><div>{{Documentation subpage}}<br />
<!-- Please place categories where indicated at the bottom of this page and interwikis at Wikidata (see [[Wikipedia:Wikidata]]) --><br />
<br />
== Usage ==<br />
<br />
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. <br />
<br />
The query '''MUST''' include the <code>?item</code> variable - do not rename it.<br />
<br />
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]].<br />
<br />
=== Use in mainspace ===<br />
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.<br />
<br />
=== Example ===<br />
{{tlf|{{BASEPAGENAME}}<br />
|'''sparql'''{{=}}<br/><br />
{{pad}}{{code|2=sparql|SELECT ?item WHERE {}}<br/><br />
{{pad|2em}}{{code|2=sparql|?item wdt:P31 wd:Q39715 .}}<br/><br />
{{pad|2em}}{{code|2=sparql|?item (wdt:P131)* wd:Q55 }}<br/><br />
{{pad}}<code>}</code><br/><br />
|'''columns'''{{=}}label:Article,description,p131:Place,P580,P582,p625,P18<br/><br />
|'''section'''{{=}}<br/><br />
|'''min_section'''{{=}}<br/><br />
|'''sort'''{{=}}label<br/><br />
|'''links'''{{=}}text<br/><br />
|'''thumb'''{{=}}128<br/><br />
|'''autolist'''{{=}}fallback<br/><br />
|'''references'''{{=}}all<br/><br />
|'''summary'''{{=}}itemnumber<br/><br />
|'''freq'''{{=}}7<br/><br />
|'''wdedit'''{{=}}yes<br/><br />
}}<br />
... (This will be overwritten by ListeriaBot) ...<br />
{{tl|Wikidata list end}}<br />
<br />
===Parameters===<br />
;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><br />
;columns:Defines the columns of the list table. Allowed values are :<br />
:* <code>number</code>, a serial row number (per section), increasing from 1, according to the initial sorting<br />
:* <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<br />
:* <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<br />
:* <code>alias/xx</code>, the wiki-language-based list of aliases for the item, using the given language code (here, "xx"), as plain text.<br />
:* <code>description</code>, the manual, or auto-generated description<br />
:* <code>item</code>, the Q item number<br />
:* <code>Pxxx</code> a Wikidata property<br />
:* <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<br />
:* <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.<br />
:* <code>?fieldname</code>, a SPARQL result field name (variable).<br />
: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).<br />
;sort:The initial sort key for the table. Valid values are:<br />
:* <code>label</code>, the label of the item<br />
:* <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).<br />
:* <code>Pxxx</code>, a Wikidata property<br />
: ''Optional''<br />
;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>.<br />
;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''<br />
;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''<br />
;language:Label/description language, if different from site language. ''Optional''<br />
;thumb:The thumbnail width for images (e.g. column P18). Default:128. ''Optional''<br />
;links:How to render links (properties with datatype ''item'') not in the local Wikipedia. Valid values are:<br />
:* <code>all</code> to link to Wikidata. Default.<br />
:* <code>local</code> to remove entries for which there exists no local article (the opposite of <code>red_only</code>).<br />
:* <code>red</code> to generate red links based on label and item.<br />
:* <code>red_only</code> to remove entries for which there exists a local article (the opposite of <code>local</code>).<br />
:* <code>text</code> to generate blue links for existing pages, and plain text otherwise.<br />
:* <code>reasonator</code> to generate blue links for existing pages, and links to [https://tools.wmflabs.org/reasonator/ Reasonator] otherwise.<br />
:''Optional''<br />
;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''<br />
;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''<br />
;skip_table:Suppresses the table markup completely when using <code>row_template</code>. Any value will work.<br />
;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''<br />
;references:Add references. Allowed value is <code>all</code>. Requires {{tl|reflist}} or similar somewhere in the page. ''Optional''<br />
;freq:Numerical value X; wait at least X days before an automatic update. Default 1. Does not affect updates via web interface. ''Optional''<br />
;summary:Comma-separated list of keys to add as a summary underneath all other content. ''Optional''<br />
:* <code>itemnumber</code> The total number of items (rows) in this list.<br />
;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''<br />
<br />
=== Bug reports ===<br />
Report issues or propose new ideas [//github.com/magnusmanske/listeria_rs/issues on GitHub]<br />
<br />
===References===<br />
{{Reflist}}<br />
<br />
<includeonly>{{Sandbox other||<br />
<!-- Categories below this line, please; interwikis at Wikidata --><br />
[[Category:Wikidata list templates]]<br />
[[Category:Wikidata templates]]<br />
}}</includeonly></div>Wikipedia>Pppery