View source for Help:Timeline format/de

{{Result format (de)
| format name=timeline
| authors=Markus Krötzsch, Jeroen De Dauw
| minimum version=1.4.0
| maximum version=aktuell unterstützt
| further reqs=keine
| component=Semantic Result Formats
| categories=Zeit
| description=Gibt die Ergebnisse auf einer Zeitleiste in Form von Zeitstrahlen aus
}}
<div style="border:2px solid #ABA000; padding:0.5em 1em 0.3em 0.5em; color:#ABA000; width:60%;">'''Hinweis:''' Für dieses Ergebnisformat wird ein neuer Programmierer gesucht. Kontaktieren Sie [[Jeroen De Dauw]] auf Englisch für diesbezügliche Informationen.</div>

Das [[Help:Ergebnisformate|Ergebnisformat]] '''timeline''' wird dazu eingesetzt [[Help:Browsen und Suchen|Abfrageergebnisse]] ([[Help:Spezialseite Semantische Suche|Spezial:Semantische Suche]], [[Help:Eingebettete Abfrage|eingebettete Abfragen]]) auf einer Zeitleiste in Form von Zeitstrahlen auszugeben. Es können dabei nur Attribute mit dem Datentyp [[Help:Datentyp Datum|Datum]] dargestellt werden. Hierzu muss im Browser zudem JavaScript aktiviert sein. Diesem Ergebnisformat sehr ähnlich ist das Ergebnisformat [[Help:Ergebnisformat eventline|eventline]].

Bis zur Version 1.3.0 wurde dieses Ergebnisformat von [[Semantic MediaWiki – Startseite|Semantic MediaWiki]] bereitgestellt. Seit Version 1.4.0 erfolgt dies durch die Softwareerweiterung [[Semantic Result Formats (de)|Semantic Result Formats]].

== Anwendung ==
Mit diesem Ergebnisformat können nur Attribute mit dem Datentyp [[Help:Datentyp Datum|Datum]] angezeigt werden. Sofern auf der Zeitleiste nichts angezeigt wird, obwohl über die [[Help:Seitenauswahl|Abfrageanweisung]] Ergebnisseiten ermittelt wurden, dann liegt das dran, dass mit der [[Help:Informationsanzeige|Ausgabeanweisung]] kein Attribut dieses Datentyps angegeben wurde, zu dem auf diesen Seiten befindliche Werte angezeigt werden sollen.

Das erste Datum zu einem Eintrag und, sofern vorhanden das zweite Datum, werden zu Darstellung herangezogen. Sofern nur ein Datum vorhanden ist, wird der Eintrag als Zeitpunkt angezeigt, im Fall von zwei Datumsangaben als Zeitstrahl zwischen dem ersten und dem zweiten Datum. Alle anderen auszugebenden Angaben werden als Schnellinformation angezeigt, sofern man auf den Eintrag klickt.

== Parameter ==
Die folgende Tabelle gibt einen Überblick über die verfügbaren Parameter, beschreibt sie kurz und gibt deren Standardwerte mitsamt dem zugehörigen Eingabetyp an. 

{{#smwdoc:timeline|language=de}}

Verfügbare Parameterwerte:
* <tt>timelinebands</tt>: Verfügbare Zeitleisten sind <tt>DECADE</tt> (Dekade), <tt>YEAR</tt> (Jahr), <tt>MONTH</tt> (Monat), <tt>WEEK</tt> (Woche), <tt>DAY</tt> (Tag),  <tt>HOUR</tt> (Stunde) und <tt>MINUTE</tt> (Minute). Die Zeitleisten sollten dabei von der Engeren zur Weiteren, jeweils durch Kommata getrennt, angegeben werden.
* <tt>timelineposition</tt>: Mögliche Werte sind <tt>start</tt> (erster Eintrag), <tt>middle</tt> (mittlerer Eintrag), <tt>end</tt> (letzer Eintrag), <tt>today</tt> (heute).

== Beispiel ==
<pre>{{#ask: [[Hat Datum der Neuigkeit::+]] [[Ist in Sprache::de]]
| ?Hat Datum der Neuigkeit
| sort=Hat Datum der Neuigkeit
| order=descending
| format=timeline
| timelinebands=MONTH,YEAR,DECADE
| timelineposition=end
| limit=150
}}</pre>

'''Ergebnis:'''
{{#ask: [[News date::+]] [[language code::de]]
| ?news date
| sort=news date
| order=descending
| format=timeline
| timelinebands=MONTH,YEAR,DECADE
| timelineposition=end
| limit=150
}}

== Hinweise ==
Die Ladezeit einer Seite kann aufgrund dieses Ergebnisformats reduziert werden, insbesondere dann, wenn eine große Anzahl von Einträgen angezeigt werden soll. Daher ist es sinnvoll ggf. mit dem Parameter <tt>limit</tt> eine niedrigere Anzahl von anzuzeigenden Einträgen festzulegen.

Eine Ergebnissortierung hat keinen Einfluss auf die Anzeige auf einer Zeitleiste, da die Einträge stets chronologisch angezeigt werden. Dennoch kann eine Sortierung dann sinnvoll sein, wenn die zehn aktuellsten anstatt zehn beliebiger Einträge angezeigt werden sollen.

{{DEFAULTSORTKEY:Timeline}}
{{docinfo
| master page = Help:Timeline format
| master rev  = 25102
| master link = internal
| status   = effective
| progress = 100
| priority = 3
| category =
| author = Kghbln
| editor = {{REVISIONUSER}}
| support = Kghbln
| minversion = 1.4.0
| lang = de
| desc =
| return =
| nowarn
}}
{{Interlanguage}}