Ergebnisformat „list“
List format/de | |
---|---|
Gibt die Ergebnisse, durch Trennzeichen voneinander abgegrenzt, als gereihte Liste aus | |
Weitere Informationen | |
Software: | Semantic MediaWiki |
Verfügbar seit: | 0.7 |
Verfügbar bis: | aktuell unterstützt |
Voraussetzungen: | keine |
Name: | list |
Standardmäßig aktiviert:Gibt an, ob das Ergebnisformat standardmäßig mit Installation der betreffenden Softwareerweiterung aktiviert ist. | ja |
Autoren: | Markus Krötzsch |
Kategorie(n): | Sonstige |
Inhaltsverzeichnis | |
Contents |
Das Ergebnisformat list wird dazu eingesetzt Abfrageergebnisse (Spezial:Semantische Suche, eingebettete Abfragen), durch Trennzeichen voneinander abgegrenzt, als gereihte Liste auszugeben. Zusätzliche Abfrageergebnisse werden dem Hauptergebnis in Klammern beigefügt. Diesem Ergebnisformat sehr ähnlich sind die Ergebnisformate ol und ul.
Dieses Ergenbisformat ist das Standardergebnisformat eingebetteter Abfragen, sofern lediglich ein Ergebniswert abgefragt wird und dabei keine Ausgabeanweisung vorgegeben wird.
Parameter[edit]
Die folgende Tabelle gibt einen Überblick über die verfügbaren Parameter, beschreibt sie kurz und gibt deren Standardwerte mitsamt dem zugehörigen Eingabetyp an.
Parameter | Aliasse | Typ | Standard | Beschreibung |
---|---|---|---|---|
propsep | - | Text | , | Legt fest, welches Trennzeichen zwischen den Attributen der Ergebnisse genutzt werden soll |
valuesep | - | Text | , | Legt fest, welches Trennzeichen zwischen den Attributwerten der Ergebnisse genutzt werden soll |
template | - | Text | leer | Legt fest, welche Vorlage zum Anzeigen der Abfrageergebnisse verwendet werden soll |
named args | namedargs | ja/nein | no | Legt fest, ob Bezeichnungen für die Parameter an die Vorlage bei der Ausgabe der Abfrageergebnisse weitergegeben werden sollen |
userparam | - | Text | leer | Legt fest, welcher Wert jedem Vorlagenaufruf übergeben wird, sofern eine Vorlage genutzt wird |
class | - | Text | leer | Legt fest, welche zusätzliche CSS-Klasse genutzt werden soll |
introtemplate | - | Text | leer | Legt fest, welche Vorlage vor der Ausgabe von Abfrageergebnissen eingefügt werden soll |
outrotemplate | - | Text | leer | Legt fest, welche Vorlage nach der Ausgabe von Abfrageergebnissen eingefügt werden soll |
sep | - | Text | , | Legt fest, welches Trennzeichen bei der Ausgabe der Abfrageergebnisse genutzt werden soll |
- sep: Sofern ein Leerzeichen angegeben wird, wird dieses in einen Unterstrich („_“) umgewandelt.
- template: Hier wird der Name der Vorlage angegeben, sofern eine Vorlage die Ergebnisse aufnehmen soll.
Beispiele[edit]
{{#ask: [[Kategorie:Stadt]] [[Liegt in::Deutschland]] }}
Ergebnis: Berlin, Cologne, Frankfurt, Munich, Stuttgart, Würzburg
Sofern weiter Ausgabeanweisungen gemacht werden, muss das Ergebnisformat list explizit angegeben werden.
{{#ask: [[Kategorie:Stadt]] [[Liegt in::Deutschland]] | ?Bevölkerungszahl | ?Fläche#km² = Größe in km² | format=list }}
Ergebnis: Berlin (BevölkerungszahlThe number of inhabitants of some geographical place.: 3,520,061, Größe in km²: 891.85 km²344.34 sqmi <br />), Cologne (BevölkerungszahlThe number of inhabitants of some geographical place.: 1,080,394, Größe in km²: 405.02 km²156.38 sqmi <br />), Frankfurt (BevölkerungszahlThe number of inhabitants of some geographical place.: 679,664, Größe in km²: 248.31 km²95.87 sqmi <br />), Munich (BevölkerungszahlThe number of inhabitants of some geographical place.: 1,353,186, Größe in km²: 310.43 km²119.86 sqmi <br />), Stuttgart (BevölkerungszahlThe number of inhabitants of some geographical place.: 606,588, Größe in km²: 207.35 km²80.06 sqmi <br />), Würzburg (BevölkerungszahlThe number of inhabitants of some geographical place.: 126,635, Größe in km²: 87.63 km²33.83 sqmi <br />)
Eine Bezeichnung kann ausgeblendet werden, indem man eine „leere“ Bezeichnung angibt:
{{#ask: [[Kategorie:Stadt]] [[Liegt in::Deutschland]] | ?Bevölkerungszahl = | ?Fläche#km² = | format=list }}
Ergebnis: Berlin (3,520,061, 891.85 km²344.34 sqmi <br />), Cologne (1,080,394, 405.02 km²156.38 sqmi <br />), Frankfurt (679,664, 248.31 km²95.87 sqmi <br />), Munich (1,353,186, 310.43 km²119.86 sqmi <br />), Stuttgart (606,588, 207.35 km²80.06 sqmi <br />), Würzburg (126,635, 87.63 km²33.83 sqmi <br />)
Alternativ kann dasselbe Ergebnis mit dem Parameter headers=hide erzielt werden.
Es kann auch ein alternatives Trennzeichen zu einem Komma („,“), bspw. „ und “ genutzt werden, ohne dass man dabei auf ein Zeichen beschränkt ist. Dies wird mit dem Parameter sep angegeben:
{{#ask: [[Kategorie:Stadt]] [[Liegt in::Deutschland]] | sep = und }}
Ergebnis: Berlin und Cologne und Frankfurt und Munich und Stuttgart und Würzburg
Der HTML-Code (nicht umschaltbares Leerzeichen) dient dazu zu verhindern, das Media Wiki Leerzeichen beim Verarbeiten des Parameters entfernt.
Hinweis[edit]
Das Ergebnisformat list im Zusammenhang mit Vorlagen einzusetzen birgt den Vorteil der richtigen Anzahl an Trennzeichen, z. B. einem Komma („,“), zwischen den Ergebnissen. Bspw. kann man eine Vorlage dazu nutzen E-Mail-Listen zu formatieren, die so einfach in das E-Mail-Programm kopiert werden können, wo jeder Eintrag das Format
Max Muster <max.muster@beispiel.de>
hat. In diesem Fall ist es sinnvoll den Parameter für das Trennzeichen mit sep=, festzulegen, um eine kommagetrennte Liste zu erhalten, die zum letzten Ergebnis kein „und“ ausgibt.