Quelltext der Seite Vorlage:ISO Kat/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
Diese Vorlage dient der automatischen Kategorisierung in einem definierten und strukturell einheitlichem Kategoriebaum in Abhängigkeit von einer ISO Regionsangabe. Die Vorlage ist für die automatische Vergabe von Kategorien nach einem Schema aus Infoboxen heraus gedacht.

== Kopiervorlage ==
<pre style="white-space:pre-wrap;">
{{ISO Kat|Region-ISO=|Kat-Root=|Kat-Schema=in|Kat-Kontinent=ja}}
</pre>

== Beispiele == 
{| class="wikitable"
|-
! Vorlage !! Ist-Ergebnis (Links mehrfach, Kats nur einfach) !! Soll-Ergebnis
|-
|<nowiki>{{ISO Kat|Region-ISO=AT-5|Kat-Root=Berg|Kat-Schema=in}}</nowiki>
| {{ISO Kat|Region-ISO=AT-5|Kat-Root=Berg|Kat-Schema=in|test=ja}}
| Kategorie:Berg in Salzburg
|-
|<nowiki>{{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Berg|Kat-Schema=in}}</nowiki>
|{{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Berg|Kat-Schema=in|test=ja}}
| Kategorie:Berg in Salzburg, Kategorie:Berg in Tirol
|-
|<nowiki>{{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Insel|Kat-Schema=()}}</nowiki>
|{{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Insel|Kat-Schema=()|test=ja}}
| Kategorie:Insel (Österreich)
|-
|<nowiki>{{ISO Kat|Region-ISO=AT-3|Kat-Root=Insel|Kat-Schema=()|Kat-Kontinent=ja}}</nowiki>
|{{ISO Kat|Region-ISO=AT-3|Kat-Root=Insel|Kat-Schema=()|Kat-Kontinent=ja|test=ja}}
| Kategorie:Insel (Österreich)
|-
|<nowiki>{{ISO Kat|Region-ISO=RU|Kat-Root=Insel|Kat-Schema=()|Kat-Kontinent=ja}}</nowiki>
|{{ISO Kat|Region-ISO=RU|Kat-Root=Insel|Kat-Schema=()|Kat-Kontinent=ja|test=ja}}
| Kategorie:Insel (Russland), Kontinent nicht eindeutig
|}

== Schnittstellen ==
Für das Schema ''in'' ist es notwendig, sprachlich korrekt die Ortsangabe zu einer ISO Region zu definieren. Standardmäßig wird ''in region'' erzeugt, also etwa ''Pass in Österreich'', ''Berg in Südtirol''. Das passt für die meisten Regionen. Abweichungen etwa für die Türkei ''Pass in der Türkei'' können nur erzeugt werden, wenn in den entsprechenden Info ISO-3166-2 Vorlagen der neue Parameter ''in'' entsprechend versorgt wird ([http://de.wikipedia.org/w/index.php?title=Vorlage%3AInfo_ISO-3166-2%3ATR&diff=101530311&oldid=93865439 Bsp. für die Türkei]).

== Parameter ==
{| class="wikitable sortable"
|-
! Parameter !! Beschreibung !! Beispiele 
|-
| Region-ISO || ISO Region in der üblichen Schrägstrichnotation, bis zu vier Regionen || AT-5, AT, AT-7/DE-BY, AT-7/DE, AT-4/AT-5/AT-6
|-
| Kat-Root || Name der Root-Kategorie, diese dient als Präfix für die Erzeugung der ISO gemäßen Kategorien || Berg, See, …
|-
| Kat-Schema || Schema der Kategorienamensgenerierung, Aufzähltyp. Mögliche Werte sind <br />in<br />() || <br />Berg in Bayern<br />Berg (Bayern)
|-
| Kat-Kontinent || Falls ja, wird auch die Kategorie für den Kontinent erzeugt. Doppelkategorisierung ist bei vielen geographischen Objekten üblich. || Berg in Europa
|-
| test || Testparameter, falls gesetzt, unterdrückt er die Generierung der Kategorien und erzeugt nur den Text für die Kategorien. ||
|}

== Requirements ==
*Es werden nur existierende Kategorien erzeugt. Falls eine fehlende Kategorie später angelegt wird, dann wird sie automatisch gefüllt.
*Existiert eine Kategorie auf unterster ISO 2 Ebene nicht, dann wird die passende Kategorie auf ISO 1 Ebene erzeugt, existiert sie auf Ebene 1 nicht, dann wird sie auf Ebene 0 erzeugt.
*Die Generierung der Kategorienamen erfolgt mit der grammatikalisch richtigen Flexion. Also ''Berg in Tirol'', aber ''Berg in der Steiermark'', ''Berg auf den Philippinen'', ''Berg in den Vereinigten Staaten''

== Design ==
Das Schema ''()'' ist einfach zu realisieren, es wird einfach der in den Info Vorlagen enthaltene ''name'' eingesetzt. (Bsp. für Niederösterreich: <nowiki>{{Info ISO-3166-2|code=AT-3|name}}</nowiki>={{Info ISO-3166-2|code=AT-3|name}}) Für das Schema ''in'' muss eine korrekte Namensumsetzung irgendwo definiert werden, da dies grammatikalisch richtig nicht zu generieren ist. 
Die [[Vorlage:Info ISO-3166-2]] erhält einen neuen Schnittstellenparameter ''in'', mit dem diese Flexion abgefragt werden kann. Diese liefert entweder den abgespeicherten Wert oder den Defaultwert zurück. Der Defaultwert ergibt sich als ''in name''.

Der erzeugte Kategoriename wird einem Existenztest unterzogen. Wenn die Kategorie existiert, dann wird sie erzeugt, existiert sie nicht, dann erfolgt eine Wiederholung derselben Prozedur auf der nächsten ISO Ebene, maximal aber auf country/state-Ebene (level 0).

=== Untervorlagen ===
* Die Vorlage {{Vorlage|ISO Kat}} ist die öffentliche Schnittstelle, sie macht die Parameterprüfung und die Aufspaltung der Region-ISO, falls mehrere Regionen durch / getrennt angeführt werden.
* Die Vorlage {{Vorlage|ISO Kat~}} hat die gleiche Schnittstelle wie {{Vorlage|ISO Kat}}, erwartet in Region-ISO aber genau einen Wert.
* Die Vorlage {{Vorlage|ISO Kat~/KatName}} baut den Kategorienamen zusammen unter Beachtung des Kat-Schemas. Danach muss noch die Existenzprüfung erfolgen.
* Die Vorlage {{Vorlage|ISO Kat~/KatGen}} erzeugt die Kategorie (unter Berücksichtigung von test)