Ergebnisformat „list“

From semantic-mediawiki.org
< Help:List format
List formatErgebnisformat „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


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. „&nbsp;und&nbsp;“ 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 = &nbsp;und&nbsp; }}

Ergebnis: Berlin und Cologne und Frankfurt und Munich und Stuttgart und Würzburg

Der HTML-Code &nbsp; (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=,&nbsp; festzulegen, um eine kommagetrennte Liste zu erhalten, die zum letzten Ergebnis kein „und“ ausgibt.



Diese Dokumentationsseite gilt für alle SMW-Versionen von 1.7.0 bis zur aktuellsten Version.
Andere Versionen: 0.7 – 1.6.2       Andere Sprachen: frzh-hans

Help:List format de 1.7.0