Quelltext der Seite Vorlage:Wikidata list/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{Achtung|Hintergrund=#FCC|Diese Vorlage bitte nicht im [[Hilfe:Namensräume#Artikelnamensraum (ANR)|Artikelnamensraum]] einsetzen, da sie dort blockiert ist, weil ihre Verwendung in Artikeln umstritten ist.}}
<div style='text-align:center;font-weight:bold;border-bottom:1px solid #DDD;margin-bottom:10px'>Diese Dokumentation ist eine sporadisch gepflegte Übersetzung. Bitte im Zweifel das [https://en.wikipedia.org/wiki/Template:Wikidata_list Original] nutzen!</div>

== Verwendung ==

Diese Vorlage definiert eine Bot-generierte Liste, basierend auf Wikidata ([http://magnusmanske.de/wordpress/?p=301 ursprünglicher Blog-Post]). Sie muss mit {{tl|Wikidata list end}} beendet werden. Der Bereich dazwischen wird regelmäßig vom Bot ersetzt. Momentan kann es nur eine solche Liste pro Seite geben. 

Die Query '''MUSS''' die Variable <code>?item</code> enthalten - benenne sie nicht um.

=== Beispiel ===

Das folgende Beispiel zeigt nur die Einträge für die gilt <small>(in originaler und übersetzter Form angeführt)</small>:
* "instance of" (P31) hat den Wert "lighthouse" (Q39715)
: ''("Instanz von" (P31) hat den Wert "Leuchtturm" (Q39715))''
und
* "located in the administrative territorial entity" (P131) kann alles sein, solange es Teil von "Netherlands" (Q55) ist
: ''("lokalisiert in der administrativen territorialen Einheit" (P131) kann alles sein, solange es Teil der "Niederlande" (Q55) ist)''.
Im Ergebnis der Abfrage soll die Spalte 'label' mit "Artikel" und die Spalte 'description' mit "Beschreibung" bezeichnet werden,
sowie die Spalte 'P131' anstatt ihrem Defaultwert "located in the administrative territorial entity" mit "Ort" benannt werden.

<syntaxhighlight lang="sparql">{{Wikidata list
|sparql=
   SELECT ?item WHERE {
      ?item wdt:P31 wd:Q39715 .
      ?item (wdt:P131)* wd:Q55 
   }
|columns=label:Artikel,description:Beschreibung,P131:Ort,P580,P582,P625,P18
|section=
|min_section=
|sort=label
|links=text
|thumb=128
|autolist=fallback
|wdedit=yes
|summary=itemnumber
|freq=7
}}

… (Dies wird durch ListeriaBot ersetzt) …

{{Wikidata list end}}</syntaxhighlight>

=== Parameter ===
;sparql: Eine Anfrage der Form [[:mw:Wikidata query service/User Manual#Basics - Understanding SPO (Subject, Predicate, Object) also known as a Semantic Triple|SPARQL ''SELECT'' Query]]. Sie muss  <code>?item</code> als Wikidata-Elementnummer zurückgeben. Bestehende WDQueries können [https://tools.wmflabs.org/wdq2sparql/w2s.php nach SPARQL konvertiert] werden. Bitte alle [https://query.wikidata.org/ SPARQL-Queries prüfen].  '''Pflichtfeld'''<br>Siehe auch [[d:Wikidata:SPARQL query service/queries/examples#Listeria|SPARQL query service Beispiele für Listeria]].
;wdq: <s>Eine Anfrage der Form [https://wdq.wmflabs.org WikiDataQuery]. Die Resultate der Anfrage werden als Liste angezeigt. '''Pflichtfeld'''</s> &nbsp; ''WDQ wird nicht mehr unterstützt.''
;columns: Definiert die Spalten der Tabelle. Zulässige Werte sind:
:* <code>number</code>, laufende Nummer (je Kapitel), beginnt mit 1, aufsteigend entsprechend der ersten Sortierung.
:* <code>label</code>, verlinkter Bezeichner in Wikidata in der Sprache des Wikis (siehe links).
:* <code>label/nds</code>, unverlinkter Bezeichner in Wikidata in einer spezifischen Sprache (hier in Plattdeutsch "nds").
:* <code>description</code>, Beschreibung aus Wikidata oder autogeneriert (siehe autolist).
:* <code>item</code>, Wikidata-Elementnummer, verlinkt nach Wikidata.
:* <code>Pxxx</code>, eine Wikidata-Property des Elements (z.B. P17 für Staat).
:* <code>Pxxx/Pzzz</code>, Qualifier-Properties; für Pxxx, das mit einem Item Qyyy verlinkt ist und einen Qualifier Pzzz hat, das verlinkte Label Qyyy und der Wert von Pzzz.
:* <code>Pxxx/Qyyy/Pzzz</code>, Qualifier-Properties; für Pxxx, verlinkte mit einem Item Qyyy und einem Qualifier Pzzz, der Wert von Pzzz. Das ist eine Version des obigen, speziell für ein einzelnes Item; z.B., "P553/Q866/P554" um YouTube-Accountnamen zu erhalten.
:* <code>?fieldname</code>, ein SPARQL-Ergebnisfeldname.
: Werte, die mit "deprecated" markiert sind, werden nicht angezeigt.
: Jede Spalte kann optional einen Titel bekommen, indem man ":" und direkt daran anschließend den Titel (also ':Titel') hinzufügt, anderenfalls wird der Wikidata-Property-Name verwendet. '''Pflichtfeld'''
;sort: Der initial verwendete Sortierschlüssel für die Tabelle. Zulässige Werte sind:
:* <code>label</code>, Label des Items
:* <code>family_name</code>, versucht aus dem Label den Nachnamen zu raten und danach zu sortieren, dabei annehmend, dass es sich um Personen handelt. Das ist heuristisch und funktioniert vielleicht nicht richtig. Wenn möglich besser nach P734 (Nachname) sortieren.
:* <code>Pxxx</code>, eine Wikidata-Property
: ''Optional''
;section: Die Liste kann nach einer Wikidata-Property in Sektionen aufgeteilt werden. Der Wert ist die Nummer der Property, z.B. <code>section=31</code> für P31. ''Optional''
;min_section: Die Mindestanzahl von Einträgen, um eine Sektion zu generieren, wenn es zusammen mit <code>section</code> verwendet wird. Alle anderen Einträge werden in die Sektion "misc" einsortiert. Standard: 2. ''Optional''
;autolist: Wenn ''description'' eine Spalte ist, aber in Wikidata keine Beschreibung (engl. description) existiert, verwendet "autolist=fallback" [https://tools.wmflabs.org/autodesc/ AutoDesc] um eine zu generieren. ''Optional''
;language: Sprache des Labels oder der Beschreibung, wenn sie sich von der Websitesprache unterscheidet. ''Optional''
;thumb: Die Thumbnailbreite für Bilder (z.B. Spalte P18). Standard: 128. ''Optional''
;links: Wie Links gerendert werden sollen, die nicht in die lokale Wikipedia führen. Zugelassene Werte sind:
:* <code>all</code> um nach Wikidata zu verlinken. Standard.
:* <code>local</code> um Einträge zu entfernen, für die es keine lokalen Artikel gibt (das Gegenteil von <code>red_only</code>).
:* <code>red</code> um Rotlinks basierend auf Label und Item zu generieren.
:* <code>red_only</code> um Einträge zu entfernen, für die es lokale Artikel gibt (das Gegenteil von <code>local</code>).
:* <code>text</code> um Blaulinks für existierende Artikel oder anderenfalls reinen Text zu generieren.
:* <code>reasonator</code> um Blaulinks für existierende Artikel oder anderenfalls Links zum [https://tools.wmflabs.org/reasonator/ Reasonator] zu generieren.
:''Optional''
;row_template: Generiert einen Vorlagenaufruf statt einer Tabellenzeile; die Vorlage muss dann die Tabellenzeile generieren oder der Tabellenkopf oder -fuß wird mit dem <code>skip_table</code>-Parameter unterdrückt. Parameter, die an die Vorlage weitergegeben werden sind die kleingeschriebenen Keys des <code>columns</code>-Parameters, z.B. <code><nowiki>label</nowiki></code> oder <code><nowiki>p18</nowiki></code> (für P18). ''Optional''
;header_template: Generiert einen Vorlagenaufruf statt eines Tabellenkopfes; die Vorlage muss dann einen Tabellenkopf generieren. An diese Vorlage werden keine Parameter weitergegeben. Es wird empfohlen, das zusammen mit <code>row_template</code> zu verwenden. ''Optional''
;skip_table: Unterdrückt das Tabellen-Markup vollständig, wenn <code>row_template</code> verwendet wird. Jeder Wert funktioniert.
;wdedit: Generiert Informationen, die es erlauben, Wikidata von Wikipedia aus mit [https://www.wikidata.org/w/index.php?title=User:Magnus_Manske/wd_edit.js diesem JavaScript] zu bearbeiten. Der Wert muss <code>yes</code> sein. Funktioniert nicht, wenn <code>row_template</code> verwendet wird. Achtung: Das resultiert in größerem Wikitext als normal und Updates könnten deswegen fehlschlagen. ''Optional''
;references: Fügt Fußnoten ein. Erlaubter Wert ist <code>all</code>. Setzt {{tl|reflist}} oder ähnliches irgendwo auf der Seite voraus. ''Optional''
;freq: Numerischer Wert X; warte mindestens X Tage bis zum nächsten automatischen Update. Hat keinen Effekt auf Updates über die Weboberfläche. ''Optional''
;summary: Kommaseparierte Liste von Keys, die als Zusammenfassung unter den gesamten Inhalt geschrieben werden. ''Optional''
:* <code>itemnumber</code> Gesamtzahl der Einträge (Zeilen) in der Liste.

<includeonly>
[[Kategorie:Wikipedia:Wikidata]]
</includeonly>