Vorlage:JASeintrag

Aus Shadowhelix
Version vom 2. Mai 2013, 13:53 Uhr von LokiBot (Diskussion | Beiträge) (Vorlagen-Kategorie umbenannt)
Zur Navigation springen Zur Suche springen

|- class="eintrag" id="" valign="top" |

| | align="left" style="display:none; font-size:80%; border-top:1px dashed black;" class="sortierung" id="zeit" | 13-xx | align="left" style="display:none; font-size:80%; border-top:1px dashed black;" class="sortierung" id="ort" | ~Zzz

Die Vorlage:JASeintrag (JAS ist eine Abkürzung für Jahresartikelsortierung) bildet eine Einheit mit Vorlage:JASanfang und Vorlage:JASende, zusammen erzeugen sie eine Übersicht für die sogenannten Jahresartikel (Artikel 1991-207x) mit deren Hilfe die Artikel nach zwei Kriterien Ort und Zeit sortiert werden können. Genauer kann man die Liste von Einträgen in einem Jahresartikel so neuordnen, dass sie zeitlich oder nach geographischer Nähe sortiert sind.

Verwendung

JASeintrag ist das Mittelstück der drei Vorlagen, das von JASanfang und JASende eingeklammert wird. Jeder einzelne Eintrag in einem der Jahresartikel erfordert eine eigene Instanz von JASeintrag. Wenn man die ausführliche Erläuterung zunächst überspringen will, sollte man einen Blick auf das Gesamtbeispiel und die Wertübersicht werfen.

Eintragstext und Thema-IDs

Der eigentliche Eintragstext wird der Variable EINTRAG als Wert übergeben:

|EINTRAG = Dies ist der Eintragstext. Auch Referenzen sind möglich.<ref>Beispielreferenz</ref>

Für eine spezielle thematische Displayfunktion, die über ein Javascript realisiert wird, werden der Variable ID ggf. mehrere kurzen Thema-IDs übergeben siehe Wertübersicht.

Die IDs werden mit einem Semikolon (;) abgetrennt.

|ID = Thema1; Thema2;

Sortierung

Die Sortierung wird über drei weitere Variablen realisiert ORT, ZEIT und ZEIT_SORTKEY, denen man Sortierschlüssel als Wert übergibt. Man sollte sich zunächst klar machen, dass diese Sortierung immer relativ zu allen anderen Werten ist. Außerdem wird immer von vorne nach hinten verglichen, zwei unterschiedliche Schlüssel sind nur so ähnlich, wie sie vom ersten Zeichen an gemeinsame Zeichen besitzen, selbst wenn sie nach einer Reihe von unterschiedlichen Zeichen im hinteren Bereich völlig identisch sind. Wenn man die Standardsortierung einhält, wird es meistens keine Probleme geben. Außerdem kann jeder der drei Werte leergelassen werden, wodurch der entsprechende Eintrag immer am Ende der Liste landet bzw. am Anfang, wenn man die Sortierreihenfolge umkehrt.

Zeit

Für die Zeitsortierung gibt es zwei Variablen. Einerseits ZEIT: Dieer Variable kann im Prinzip eine beliebige Form der Zeitangabe übergeben werden, bei der nicht auf die Sortierreihenfolge geachtet werden muss. Aus Gründen der Übersichtlichkeit wird nach Konvention bei regulären Zeitangaben aber der Monatsname ausgeschrieben und der Tag als Ziffer mit Komma abgetrennt dahinter angegeben. Werte wie "Mitte des Jahres" oder "Anfang September" sind aber genauso möglich. Die zweite Variable ist ZEIT_SORTKEY, hier sollte die Sortierreihenfolge beachtet werden. Der Wert von ZEIT_SORTKEY ist im Gegensatz zum Wert von ZEIT nicht sichtbar. Zur Reihenfolge: Zunächst wird der Monat dann der Tag als zweistellige Ziffer angegeben, getrennt durch einen Bindestrich. Kennt man nur den Monat sollte der Tag mit xx angegeben werden. Kennt man auch den Monat nicht, sollte "|ZEIT_SORTKEY=" komplett entfernt werden. Alternativ bei ungenauen Zeitangaben wie etwa "Sommer" oder "Anfang Januar" kann man mit Blick auf die anderen Einträge ein passendes Datum wählen. Selbst wenn der Wert nicht ganz stimmt, wird die Sortierung dadurch verbessert.

|ZEIT_SORTKEY = 10-29
|ZEIT = Oktober, 29

Ort

ORT hat typischerweise die Reihenfolge Kontinent, Land, Stadt aber es sind verschiedenste Abweichungen möglich. Das Kriterium soll nach geograpischer Nähe sortieren, was natürlich nur eine Annäherung ist. Sortiert man zum Beispiel die Tir Tairngire-Städte die von Norden nach Süden die Abfolge Astoria, Salem, und Eugene aufweisen, bekäme man die Astoria, Eugene, Salem, allerdings liegen Astoria und Eugene von den drei Städten am weitesten voneinander entfernt. Würde man eine weitere Ebene einführen zum Beispiel "Tir Tairngire, Nordosten" und "Tir Tairngire, Osten" könnte man die geographischen Verhältnisse besser abbilden. Es ist bei ORT besonders wichtig auf die anderen Einträge zu achten. Ein weiteres Beispiel, wenn man in einem Jahr zwei Ereignisse hat, die im Seattle Metroplex stattfinden, aber dem einen Ereignis den ORT-Wert "Nordamerika, Seattle", dem anderen "Nordamerika, UCAS, Seattle" gibt, werden sie in der Sortierung (abhängig von den anderen Einträgen) womöglich getrennt, obwohl sie geographisch eng zusammen gehören. Das gleiche gilt für die Verwendung unterschiedlicher Bezeichnungen zum Beispiel einmal "Bayern" und dann "Freistaat Bayern". Ausschlaggebend sollte außerdem immer die zum Zeitpunkt des Ereignis gültige Geographie sein und nicht frühere oder spätere geographische Verhältnisse. Für Ereignisse außerhalb der Erde sollte man zunächst "Weltraum" angeben.

Die Ortswerte werden mit einem Komma (,) abgetrennt.

|ORT = Australien, Melbourne 

Gesamtbeispiel

{{JASanfang}}
{{JASeintrag
|ID      = katastrophen;
|EINTRAG = 14. März, Xianning, China: Ein Sack Reis fällt um.
|ZEIT_SORTKEY = 03-14
|ZEIT    = März, 14
|ORT     = Asien, China, Hubei, Xianning
}}
{{JASende}}

erzeugt:


Eintrag
 
  • 14. März, Xianning, China: Ein Sack Reis fällt um.


Vorlagen-Schablone

{{JASeintrag
|ID      = 
|EINTRAG = 
|ZEIT_SORTKEY = 
|ZEIT    = 
|ORT     = 
}}

Wertübersicht

ID IDs für Javascript, mögliche Werte: [critter, drachen, katastrophen, kultur, konzerne, kriege, magie, matrix, metamenschen, persönlichkeiten, politik, raumfahrt, religion, schatten, sport, technologie, terror, unterwelt, vernunftbegabte, wissenschaft]
EINTRAG Text des Eintrags
ZEIT_SORTKEY Zeitpunkt des Ereignis
ZEIT Zeitpunkt des Ereignis in Textform
ORT Ort des Ereignis