Vorlage:JASeintrag: Unterschied zwischen den Versionen

Aus Shadowhelix
Zur Navigation springen Zur Suche springen
Keine Bearbeitungszusammenfassung
Keine Bearbeitungszusammenfassung
Zeile 6: Zeile 6:
| <span style="display:none">{{#if:{{{KONTEXT|}}}|{{{KONTEXT}}}|zzz}}</span>
| <span style="display:none">{{#if:{{{KONTEXT|}}}|{{{KONTEXT}}}|zzz}}</span>
<noinclude>
<noinclude>
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 [[:Kategorie:Jahre|Jahresartikel]] (Artikel 1991-207x) mit deren Hilfe die Artikel nach drei Kriterien Ort, Zeit und Kontext sortiert werden können. Genauer kann man die Liste von Einträgen in einem Jahresartikel so neuordnen, dass sie zeitlich, nach geographischer Nähe oder nach einem besonderen Kontext sortiert sind.


erzeugt
==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|Gesamtbeispiel]] und die [[#Wertübersicht|Wertübersicht]] werfen.


==Beispiel==
===Eintragstext und Thema-IDs===
Der eigentliche Eintragstext wird der Variable EINTRAG als Wert übergeben:
 
<pre>|EINTRAG = Dies ist der Eintragstext. Auch Referenzen sind möglich.<ref>Beispielreferenz</ref></pre>
 
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|Wertübersicht]].
 
Die IDs werden mit einem Semikolon (;) abgetrennt.
 
<pre>|ID = Thema1; Thema2;</pre>
 
===Sortierung===
Die Sortierung wird über drei weitere Variablen realisiert ORT, ZEIT und KONTEXT, 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 ZEIT ist die Reihenfolge ''Monat'', ''Tag'' vorgesehen (kleinere Zeiteinheiten sind meist überflüssig). Der Monat sollte als Zahlenwert angegeben werden. Wenn man zwei Einträge hat, die im gleichen Monat ("mm") stattgefunden haben und von denen man genau weiß, welches Ereignis zuerst aufgetreten ist, ohne allerdings den Tag zu kennen, kann man einfach dem ersten Ereignis "mm/00/1" und dem zweiten "mm/00/2" als ZEIT-Wert geben. Genauso wenn man nicht einmal den Monat kennt nimmt man "00/00/x". Auch ungenaue Zeitangaben wie etwa "Sommer" können verwendet werden, hier könnte man sich zum Beispiel zwischen Juni, Juli oder August entscheiden. Selbst wenn der Wert nicht ganz stimmt, wird die Sortierung dadurch meist trotzdem verbessert.
 
Die Zeitwerte werden mit einem Slash (/) abgetrennt.
 
<pre>|ZEIT = 10/29 </pre>
 
====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". Für Ereignisse außerhalb der Erde sollte man zunächst "Z Weltraum" angeben, Ereignisse auf oder in einem der Weltozeane sollten mit einem "Z Meer" beginnen.
 
Die Ortswerte werden mit einem Komma (,) abgetrennt.
 
<pre>|ORT = Australien, Melbourne </pre>
 
====Kontext====
KONTEXT ist das am wenigsten streng definierte Sortierkriterium und wird bei vielen Einträgen ohne Wert bleiben. Es ist für Ereignisse vorgesehen, die einen engen thematischen Kontext aufweisen, insbesondere auch im Bezug auf das Jahr, in dem sie auftreten. Die thematische Sortierung der Einträge ist schwierig, da sie nicht in klar abzugrenzende Klassen fallen. Man könnte zum Beispiel zwei Einträge zum Thema Magie haben, wobei der eine aber Magie und Sport, der andere Magie und Politik betrifft. Mit einer linearen Sortierung wird man diesem Problem nicht gerecht, deshalb gibt es neben den JAS-Vorlagen ein Javascript, das die Jahresartikel-Benutzung unterstützt und die Einträge zu unterschiedlichen Klassen zusammenfügen kann.
 
KONTEXT ist nun aber für thematische Zusammenhänge gedacht, die sich einerseits zwingend ergeben, andererseits aber zu spezifisch sind, um von den allgemeinen Themenfeldern entweder voll erfasst und/oder eng genug geklammert zu werden. Ein typisches Beispiel ist die VITAS-Krise von 2010, alle Einträge des Jahres die VITAS betreffen, stehen in einem offensichtlichen engen Kontext. Die meisten dieser Einträge werden vermutlich durch das Themenfeld "Katastrophen" abgedeckt, darunter können aber auch andere Ereignisse fallen, die nichts mit VITAS zu tun haben. Außerdem sind nicht zwangsläufig alle VITAS-Einträge auch unter Katastrophen zu finden, würde etwa beschrieben, wie Wissenschaftler eine Testreihe mit VITAS durchführen, um ein Heilmittel zu finden, bekäme dieser Eintrag eventuell nicht diese Einstufung sondern zum Beispiel "Wissenschaft". KONTEXT mit dem Wert "VITAS" ermöglicht aber alle diese Einträge zu diesem wichtigen Gesamtereignis zu bündeln.
 
Natürlich kann auch KONTEXT mehrere Sortierebenen aufweisen. Hat man in einem Jahr zum Beispiel mehrere Kriege könnte man den ihnen zugeordneten Ereignissen zunächst den KONTEXT-Wert "Krieg" zuweisen, bevor man genauer spezifiziert, um welche Kriege es sich handelt. Dadurch werden sie auch insgesamt als Kriegsereignisse gebündelt und von anderen Kontextzusammenfassungen abgesetzt.
 
Außerdem kann auch innerhalb der mit KONTEXT zusammengefassten Ereignisse nochmals eine zusätzliche Ordnung vorgenommen werden etwas durch Werte wie "Kontext-1", "Kontext-2" usw. Normalerweise sollte darauf verzichtet werden und stattdessen für die interne Ordnung mittels der ZEIT-Werte gesorgt werden, aber manchmal stellt sich das vielleicht als zu kompliziert heraus.
 
Hat man mehrere Kontextwerte, werden sie mit einem Komma (,) abgetrennt.
 
<pre>|KONTEXT = Marsexpedition </pre>
 
===Gesamtbeispiel===


<pre>
<pre>
Zeile 46: Zeile 89:
}}
}}
</pre>
</pre>
==Wertübersicht==
{| style="background-color:transparent; width:30%;"
|ID
|IDs für Javascript, mögliche Wert: [drachen, katastrophen, konzerne, kriege, kultur, magie, matrix, metamenschen, politik, raumfahrt, religion, sport, technologie, unterwelt, wissenschaft]
|-
|EINTRAG
|Text des Eintrags
|-
|ZEIT
|Zeitpunkt des Ereignis
|-
|ORT
|Ort des Ereignis
|-
|KONTEXT
|Übergeordneter Kontext
|}


[[Kategorie:!InfoVorlagen|JASeintrag]]
[[Kategorie:!InfoVorlagen|JASeintrag]]

Version vom 21. Juni 2010, 20:24 Uhr

|- | id="" |

| 13 | zzz | 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 drei Kriterien Ort, Zeit und Kontext sortiert werden können. Genauer kann man die Liste von Einträgen in einem Jahresartikel so neuordnen, dass sie zeitlich, nach geographischer Nähe oder nach einem besonderen Kontext 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 KONTEXT, 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 ZEIT ist die Reihenfolge Monat, Tag vorgesehen (kleinere Zeiteinheiten sind meist überflüssig). Der Monat sollte als Zahlenwert angegeben werden. Wenn man zwei Einträge hat, die im gleichen Monat ("mm") stattgefunden haben und von denen man genau weiß, welches Ereignis zuerst aufgetreten ist, ohne allerdings den Tag zu kennen, kann man einfach dem ersten Ereignis "mm/00/1" und dem zweiten "mm/00/2" als ZEIT-Wert geben. Genauso wenn man nicht einmal den Monat kennt nimmt man "00/00/x". Auch ungenaue Zeitangaben wie etwa "Sommer" können verwendet werden, hier könnte man sich zum Beispiel zwischen Juni, Juli oder August entscheiden. Selbst wenn der Wert nicht ganz stimmt, wird die Sortierung dadurch meist trotzdem verbessert.

Die Zeitwerte werden mit einem Slash (/) abgetrennt.

|ZEIT = 10/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". Für Ereignisse außerhalb der Erde sollte man zunächst "Z Weltraum" angeben, Ereignisse auf oder in einem der Weltozeane sollten mit einem "Z Meer" beginnen.

Die Ortswerte werden mit einem Komma (,) abgetrennt.

|ORT = Australien, Melbourne 

Kontext

KONTEXT ist das am wenigsten streng definierte Sortierkriterium und wird bei vielen Einträgen ohne Wert bleiben. Es ist für Ereignisse vorgesehen, die einen engen thematischen Kontext aufweisen, insbesondere auch im Bezug auf das Jahr, in dem sie auftreten. Die thematische Sortierung der Einträge ist schwierig, da sie nicht in klar abzugrenzende Klassen fallen. Man könnte zum Beispiel zwei Einträge zum Thema Magie haben, wobei der eine aber Magie und Sport, der andere Magie und Politik betrifft. Mit einer linearen Sortierung wird man diesem Problem nicht gerecht, deshalb gibt es neben den JAS-Vorlagen ein Javascript, das die Jahresartikel-Benutzung unterstützt und die Einträge zu unterschiedlichen Klassen zusammenfügen kann.

KONTEXT ist nun aber für thematische Zusammenhänge gedacht, die sich einerseits zwingend ergeben, andererseits aber zu spezifisch sind, um von den allgemeinen Themenfeldern entweder voll erfasst und/oder eng genug geklammert zu werden. Ein typisches Beispiel ist die VITAS-Krise von 2010, alle Einträge des Jahres die VITAS betreffen, stehen in einem offensichtlichen engen Kontext. Die meisten dieser Einträge werden vermutlich durch das Themenfeld "Katastrophen" abgedeckt, darunter können aber auch andere Ereignisse fallen, die nichts mit VITAS zu tun haben. Außerdem sind nicht zwangsläufig alle VITAS-Einträge auch unter Katastrophen zu finden, würde etwa beschrieben, wie Wissenschaftler eine Testreihe mit VITAS durchführen, um ein Heilmittel zu finden, bekäme dieser Eintrag eventuell nicht diese Einstufung sondern zum Beispiel "Wissenschaft". KONTEXT mit dem Wert "VITAS" ermöglicht aber alle diese Einträge zu diesem wichtigen Gesamtereignis zu bündeln.

Natürlich kann auch KONTEXT mehrere Sortierebenen aufweisen. Hat man in einem Jahr zum Beispiel mehrere Kriege könnte man den ihnen zugeordneten Ereignissen zunächst den KONTEXT-Wert "Krieg" zuweisen, bevor man genauer spezifiziert, um welche Kriege es sich handelt. Dadurch werden sie auch insgesamt als Kriegsereignisse gebündelt und von anderen Kontextzusammenfassungen abgesetzt.

Außerdem kann auch innerhalb der mit KONTEXT zusammengefassten Ereignisse nochmals eine zusätzliche Ordnung vorgenommen werden etwas durch Werte wie "Kontext-1", "Kontext-2" usw. Normalerweise sollte darauf verzichtet werden und stattdessen für die interne Ordnung mittels der ZEIT-Werte gesorgt werden, aber manchmal stellt sich das vielleicht als zu kompliziert heraus.

Hat man mehrere Kontextwerte, werden sie mit einem Komma (,) abgetrennt.

|KONTEXT = Marsexpedition 

Gesamtbeispiel

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

erzeugt:


Eintrag
 
  • 14. März, Xianning, China: Ein Sack Reis fällt um.
03/14 Asien, China, Hubei, Xianning Nahrungsmittel


Vorlagen-Schablone

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

Wertübersicht

ID IDs für Javascript, mögliche Wert: [drachen, katastrophen, konzerne, kriege, kultur, magie, matrix, metamenschen, politik, raumfahrt, religion, sport, technologie, unterwelt, wissenschaft]
EINTRAG Text des Eintrags
ZEIT Zeitpunkt des Ereignis
ORT Ort des Ereignis
KONTEXT Übergeordneter Kontext