Vorlage:Abfrage Briefspieltexte Ort/Doku
Die ist die Dokumentation für die Vorlage:Abfrage Briefspieltexte Ort. Sie wird dort ebenfalls angezeigt, weil die Dokumentation wie eine eigene Vorlage funktioniert und daher einfach eingebunden werden kann.
Was macht diese Vorlage?
Mit dieser Vorlage werden zu einem Artikel die jeweiligen Briefspieltexte inklusive Gliederung angezeigt. Sie ist ein Koscher Ersatz für Vorlage:Abfrage Briefspieltexte, der für Geographie (insbesondere Orte, Lehen und Höfe) verwendet werden kann.
Wesentliche Unterschiede:
- Sollte es doppelt oder falsch gesetzte Attribute geben, werden diese separat angezeigt - zusammen mit dem Hinweis, sie zu ändern und wie das geht.
- Sollte es zu keinem Treffer kommen, bleibt der jeweilige Teil der Abfrage unsichtbar.
Die Vorlage
- ruft die Vorlage Vorlage:Abfrage Briefspieltexte Kosch auf
- listet die Ergebnisse von vier Abfragen auf, wobei nach dem aventurischen Datum absteigend sortiert wird und die Abfragen auf die letzten 24 bzw. 6 Texte beschränkt werden.
- Mit Hilfe von weiteren Parametern können sowohl die Sortierreihenfolge als auch die Anzahl der Texte angepasst werden.
Wie verwendet man diese Vorlage?
Die Vorlage verwendet Parameter, welche mit Standardwerten versehen werden, falls man nichts weiter angibt.
Im einfachsten Fall reicht es also aus, folgenden Code in eine Seite einzufügen:
{{Abfrage Briefspieltexte Ort}}
Ein Beispiel für den umgekehrten Extremfall, dass alle Parameter angegeben werden:
{{Abfrage Briefspieltexte Ort|Maximale Anzahl Handlungsort=60|Maximale Anzahl Ortsnennung=12|Maximale Anzahl Fehler=3|Maximale Anzahl Doppelt=3|Sortierung=aufsteigend}}
- Man kann jeden Parameter unabhängig von den anderen verwenden, also auch nur einen oder zwei angeben und den Rest weglassen.
- Es spielt keine Rolle, in welcher Reihenfolge man die Parameter angibt.
Parameter:
- Maximale Anzahl Handlungsort - maximale Anzahl der Briefspieltexte, in denen das Attribut "Handlungsort ist::" mit dem Artikel gesetzt wurde. Standardwert beträgt 24. Gibt es mehr als diese maximale Anzahl von Briefspieltexten, erscheint in der letzten Zeile der Tabelle unten rechts ein Link auf (… weitere Ergebnisse). Die Idee dahinter: In vielen Fällen reichen zwei Dutzend Einträge aus. Liegt die Anzahl der gefundenen Briefspieltexte knapp darüber, ist es praktisch, die Grenze anpassen zu können. Ohne eine automatische Grenze wäre es gefährlich, die Vorlage auszuprobieren, weil das Ergebnis dann aus Hunderten von Briefspieltexten bestehen könnte, was die Seite sehr lang machen und deren Ladezeit ernorm in die Höhe treiben würde.
- Maximale Anzahl Ortsnennung - analog zu Maximale Anzahl Handlungsort, nur dass hier das Attribut "Ortsnennung ist::" abgefragt wird und die maximale Anzahl der Ergebnisse auf 6 beschränkt wird.
- Maximale Anzahl Fehler - analog zu Maximale Anzahl Handlungsort, nur dass hier alle anderen möglichen Attribute abgefragt werden (deren Setzung immer ein Fehler ist) und die maximale Anzahl der Ergebnisse auf 6 beschränkt wird.
- Maximale Anzahl Doppelt - analog zu Maximale Anzahl Handlungsort, nur dass hier sowohl "Handlungsort ist::" als auch "Ortsnennung ist::" abgefragt werden (deren gleichzeitige Setzung für denselben Artikel in einem Text immer ein Fehler ist) und die maximale Anzahl der Ergebnisse auf 6 beschränkt wird.
- Sortierung Optionen: asc/desc/aufsteigend/absteigend - Standardwert ist "desc". Damit wird eingestellt, ob die Suchergebnisse nach aventurischer Zeit aufsteigend oder absteigend sortiert werden sollen und ob gleichzeitig durch den Filter die ältesten oder jüngsten Texte ausgegeben werden sollen. Dabei sind asc und aufsteigend bzw. desc und absteigend gleichwertig.
Einsatzzweck
Am besten nur indirekt über den Einsatz der Automatik-Vorlagen für Geographie-Artikel:
Der Artikel Neuvaloor dient als Beispiel dafür, wie eine der Automatik-Vorlagen eingebunden wird und alle möglichen Parameter gesetzt werden.
Verwandte Vorlagen:
- Vorlage:Abfrage Briefspieltexte Darsteller für Personen
- Vorlage:Abfrage Briefspieltexte Akteur für Akteure (insbesondere Familien und Gruppierungen)
- Vorlage:Abfrage Briefspieltexte Rest für alles andere
Technische Dokumentation
Absolut unwichtig für normale Benutzer, nur relevant für Vorlagen-Programmierer. Daher folgt reichlich technisches Vokabular!
Die Vorlage besteht grob aus zwei Teilen:
- Definition von Variablen, die Abfragen enthalten
- bedingte Anzeige der Ergebnisse
Zunächst werden vier Variablen namens Handlungsort, Ortsnennung, Mitort und Doppelt definiert, deren Inhalt jeweils über einen Aufruf der Vorlage Vorlage:Abfrage Briefspieltexte Kosch bestimmt wird. Für den Parameter Abfrage wird dabei gefiltert auf Attribute mit dem vollen Seitennamen, von dem diese Vorlage aufgerufen wird. Die Attribute sind "Handlungsort ist::", "Ortsnennung ist::", alle anderen besonderen Attribute bzw. beide Attribute.
Die ersten beiden Fälle sind das, was in einem Briefspieltext gesetzt werden muss für einen Geographie-Artikel. Entsprechend ist jedes andere Attribut ein Fehler, so dass auf alle anderen Attribute für die Fehlerauswertung abgefragt wird. Beide gleichzeitig zu setzen ist ebenfalls ein Fehler, so dass auf beide zusammen für die Auswertung über doppelt gesetzte Attribute abgefragt wird.
Hierbei wird der Wert des Parameters Sortierung ausgewertet - oder desc verwendet, falls dieser nicht gesetzt wurde. Als Begrenzung für die Abfragen wird entweder die Zahl verwendet, die in der Variable Maximale Anzahl Handlungsort, Maximale Anzahl Ortsnennung, Maximale Anzahl Fehler bzw. Maximale Anzahl Doppelt festgelegt wurde, oder 24 (Handlungsort) bzw. 6 (alle anderen drei).
Falls mindestens eine der ersten drei Variablen mit Inhalt gefüllt wurde, es also mindestens einen Treffer insgesamt gab, wird entsprechend die Überschrift zweiter Ordnung Briefspieltexte gesetzt zusammen mit den Knöpfen, mit denen die Anzahl der Ergebnisspalten vom jeweiligen Leser flexibel zwischen eins und drei umgeschaltet werden kann. (Dass die vierte Variable hier nicht berücksichtigt wird, ist Absicht: Sie fügt keine neuen Fälle hinzu, weil sie nur befüllt ist, wenn es die beiden ersten Variablen ebenfalls sind.)
Falls es mindestens einen Handlungsort, eine Ortsnennung, einen Fehler oder eine doppelte Setzung gab, wird das jeweilige Ergebnis ausgegeben zusammen mit der Formatierung, die notwendig ist, um die Anzahl der Ergebnisspalten verändern zu können. Bei falsch bzw. doppelt gesetzten Attributen gibt es außerdem noch jeweils eine Überschrift dritter Ordnung, die auf bestehende Fehler hinweist und wie man sie ändern kann.