Vorlage:Phönix: Unterschied zwischen den Versionen

Aus KoschWiki
Zur Navigation springen Zur Suche springen
Kunar (D | B)
Kunar (D | B)
Zeile 43: Zeile 43:
  
 
==Wie verwendet man diese Vorlage?==
 
==Wie verwendet man diese Vorlage?==
Im einfachsten Fall muss nichts weiter angegeben werden. Es reicht also aus, folgenden Code einzufügen:
+
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:
  
 
<nowiki>{{</nowiki>{{PAGENAME}}<nowiki>}}</nowiki>
 
<nowiki>{{</nowiki>{{PAGENAME}}<nowiki>}}</nowiki>
  
'''Optionen:'''
+
Ein Beispiel für den umgekehrten Extremfall, dass alle Parameter angegeben werden:
* Kategorie
+
* Untergegangen (Ja/Nein)
+
<nowiki>{{</nowiki>{{PAGENAME}}|Kategorie=Handel und Handwerk|Untergegangen=Egal|Maximale Anzahl=10<nowiki>}}</nowiki>
* Maximale Anzahl
+
 
 +
* 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:'''
 +
* '''Kategorie''' -  Standardwert ist der Name der Seite, auf der die Vorlage eingebunden wird. Muss in jedem Fall der Name einer existierenden Kategorie sein. Ein logisches "ODER" ist möglich, indem man die einzelnen Kategorien durch <nowiki>{{!!}}</nowiki> voneinander trennt. Beispiel: ''Kategorie=Außerkosch<nowiki>{{!!}}</nowiki>Böse'' filtert auf alle Familien, die im Außerkosch oder böse sind.
 +
 
 +
* '''Untergegangen''' ''Optionen: Nein/Ja/Egal'' - Standardwert ist "Nein". Damit wird auf existierende / untergegangene Familien gefiltert - oder gar nicht. Die Idee dahinter: Fürs aktuelle Briefspiel sind existierende Häuser relevanter. Falls ein Filter zum Einsatz kommt, wird darauf unterhalb der Tabelle hingewiesen. ( ''Es werden nur lebende Familien angezeigt.'' / ''Hinweis: Es werden nur ausgestorbene Familien angezeigt.'')
 +
 
 +
* '''Maximale Anzahl''' - Standardwert beträgt 12. Gibt es mehr als diese maximale Anzahl von Familien, erscheint in der letzten Zeile der Tabelle unten rechts ein Link auf ''… weitere Ergebnisse''. Die Idee dahinter: In vielen Fällen reicht ein Dutzend Einträge aus. Liegt die Anzahl der gefundenen Familien 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 Familien bestehen könnte, was die Seite sehr lang machen und deren Ladezeit ernorm in die Höhe treiben würde.
 +
 
 +
==Einsatzzweck==
 +
 
 +
Wann immer es darum geht, alle Familien aus einer bestimmten Kategorie zu bekommen! Einige Ideen:
  
Ein logisches "ODER" ist möglich, indem man die einzelnen Kategorien durch <nowiki>{{!!}}</nowiki> voneinander trennt.
+
* Die Lehen haben eigene Kategorien. Man kann also für eine Grafschaft, Baronie oder sonstiges Lehen eine Übersicht der dortigen Familien erstellen.
 +
* Durch die "ODER"-Option kann ein Briefspieler auf einen Schlag abfragen, welche Familien es in allen Lehen gibt, in denen er Figuren hat.
 +
* Es gibt eine eigene [[:Kategorie:Spielerfamilien]], mit der eine entsprechende Briefspielübersicht schnell gemacht ist.
 +
* Es gibt mehrere Familien-Unterkategorien (Adelshäuser/Bürgerfamilien/Zwergensippen), die man spezifisch abfragen kann. Adel ist noch einmal unterteilt in Hoch- und Niederadel.
 +
* Es gibt eine eigene [[:Kategorie:Untergegangene Familien]], wobei es hier offensichtlich keinen Sinn hätte, den Parameter "Untergegangen" auf "Nein" zu setzen.
  
 
==Wozu eine Vorlage:Phönix?==
 
==Wozu eine Vorlage:Phönix?==

Version vom 6. August 2018, 17:45 Uhr


Was macht diese Vorlage?

Mit dieser Vorlage lassen sich Listen von Familien in Tabellenform generieren.

Die Vorlage

  • durchsucht die Kategorie:Familien
  • filtert dabei auf die Kategorie:AutoCat ( = Hinweis darauf, dass die Vorlage:Familie verwendet wird, was notwendig für die Abfrage ist) sowie eine weitere Kategorie
  • listet in einer Tabelle Name, Kurzbeschreibung, Wappen und Lehen auf, wobei nach dem Kurznamen der Familie sortiert wird.

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:

{{Phönix}}

Ein Beispiel für den umgekehrten Extremfall, dass alle Parameter angegeben werden:

{{Phönix|Kategorie=Handel und Handwerk|Untergegangen=Egal|Maximale Anzahl=10}}

  • 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:

  • Kategorie - Standardwert ist der Name der Seite, auf der die Vorlage eingebunden wird. Muss in jedem Fall der Name einer existierenden Kategorie sein. Ein logisches "ODER" ist möglich, indem man die einzelnen Kategorien durch {{!!}} voneinander trennt. Beispiel: Kategorie=Außerkosch{{!!}}Böse filtert auf alle Familien, die im Außerkosch oder böse sind.
  • Untergegangen Optionen: Nein/Ja/Egal - Standardwert ist "Nein". Damit wird auf existierende / untergegangene Familien gefiltert - oder gar nicht. Die Idee dahinter: Fürs aktuelle Briefspiel sind existierende Häuser relevanter. Falls ein Filter zum Einsatz kommt, wird darauf unterhalb der Tabelle hingewiesen. ( Es werden nur lebende Familien angezeigt. / Hinweis: Es werden nur ausgestorbene Familien angezeigt.)
  • Maximale Anzahl - Standardwert beträgt 12. Gibt es mehr als diese maximale Anzahl von Familien, erscheint in der letzten Zeile der Tabelle unten rechts ein Link auf … weitere Ergebnisse. Die Idee dahinter: In vielen Fällen reicht ein Dutzend Einträge aus. Liegt die Anzahl der gefundenen Familien 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 Familien bestehen könnte, was die Seite sehr lang machen und deren Ladezeit ernorm in die Höhe treiben würde.

Einsatzzweck

Wann immer es darum geht, alle Familien aus einer bestimmten Kategorie zu bekommen! Einige Ideen:

  • Die Lehen haben eigene Kategorien. Man kann also für eine Grafschaft, Baronie oder sonstiges Lehen eine Übersicht der dortigen Familien erstellen.
  • Durch die "ODER"-Option kann ein Briefspieler auf einen Schlag abfragen, welche Familien es in allen Lehen gibt, in denen er Figuren hat.
  • Es gibt eine eigene Kategorie:Spielerfamilien, mit der eine entsprechende Briefspielübersicht schnell gemacht ist.
  • Es gibt mehrere Familien-Unterkategorien (Adelshäuser/Bürgerfamilien/Zwergensippen), die man spezifisch abfragen kann. Adel ist noch einmal unterteilt in Hoch- und Niederadel.
  • Es gibt eine eigene Kategorie:Untergegangene Familien, wobei es hier offensichtlich keinen Sinn hätte, den Parameter "Untergegangen" auf "Nein" zu setzen.

Wozu eine Vorlage:Phönix?

Wir haben bislang keine Arbeitsvorlagen im Kosch-Wiki. Um bei Vorlagen, die verwendet werden, die Versionshistorie nicht mit Tests zuzumüllen, ist es praktisch, Vorlagen speziell zum Ausprobieren zu haben. Diese können, sobald das Ergebnis der Tests in eine Vorlage mit eigenem Namen geflossen ist, geleert und wiederverwendet werden.

Dies ist eine Vorlage, die eine Abfrage beinhaltet, welche auf eine Zeilen-Vorlage zurückgreift.