Vorlage:ISO Kat/Doku: Unterschied zwischen den Versionen
Sonne7 (Diskussion | Beiträge) (→Parameter: (Tabelle) Beim Parameter 'Kat-Schema' die beiden Werte nun als <code> und eingerückt dargestellt (damit sie besser sichtbar sind) + die Beispiele zu den beiden Werten dieses Parameters auf nun für AT passend geändert (konkret dazu 'Tirol' verwendet)) |
Sonne7 (Diskussion | Beiträge) (→Beispiele: (Tabelle) Generelle Überarbeitung vom Inhalt der gesamten Tabelle für nun tatsächlich funktionierende Beispiele passend für das RwAT (dabei auch den Parameter 'Kat-Kontinent' mit Wert 'ja' nun ganz weggelassen, weil er im RwAT nicht wirklich sinnvoll anzuwenden ist, sowie gleichzeitig auch den Bezug zu anderen Kontinenten bzw. anderen Staaten ebenfalls ganz weggelassen, weil diese im RwAT eigentlich ganz unpassend sind)) |
||
| Zeile 12: | Zeile 12: | ||
! Vorlage !! Ist-Ergebnis (Links mehrfach, Kats nur einfach) !! Soll-Ergebnis | ! Vorlage !! Ist-Ergebnis (Links mehrfach, Kats nur einfach) !! Soll-Ergebnis | ||
|- | |- | ||
|<nowiki>{{ISO Kat|Region-ISO=AT- | | <nowiki>{{ISO Kat|Region-ISO=AT-2|Kat-Root=Gewässer|Kat-Schema=in}}</nowiki> | ||
| {{ISO Kat|Region-ISO=AT- | | {{ISO Kat|Region-ISO=AT-2|Kat-Root=Gewässer|Kat-Schema=in|test=ja}} | ||
| Kategorie: | | [[:Kategorie:Gewässer in Kärnten]] | ||
|- | |- | ||
|<nowiki>{{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Berg|Kat-Schema=in}}</nowiki> | | <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}} | | {{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Berg|Kat-Schema=in|test=ja}} | ||
| Kategorie:Berg | | [[:Kategorie:Berg im Land Salzburg]], [[:Kategorie:Berg in Tirol]] | ||
|- | |- | ||
|<nowiki>{{ISO Kat|Region-ISO=AT- | | <nowiki>{{ISO Kat|Region-ISO=AT-4/AT-6|Kat-Root=Geographie|Kat-Schema=()}}</nowiki> | ||
|{{ISO Kat|Region-ISO=AT- | | {{ISO Kat|Region-ISO=AT-4/AT-6|Kat-Root=Geographie|Kat-Schema=()|test=ja}} | ||
| Kategorie: | | [[:Kategorie:Geographie (Oberösterreich)]], [[:Kategorie:Geographie (Steiermark)]] | ||
|- | |- | ||
|<nowiki>{{ISO Kat|Region-ISO=AT- | | <nowiki>{{ISO Kat|Region-ISO=AT-1|Kat-Root=Landeshauptmann|Kat-Schema=()}}</nowiki> | ||
|{{ISO Kat|Region-ISO=AT- | | {{ISO Kat|Region-ISO=AT-1|Kat-Root=Landeshauptmann|Kat-Schema=()|test=ja}} | ||
| | | [[:Kategorie:Landeshauptmann (Burgenland)]] | ||
|} | |} | ||
Aktuelle Version vom 3. September 2023, 15:47 Uhr
|
Diese Seite ist die Dokumentations-Unterseite der Vorlage:ISO Kat. |
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
{{ISO Kat|Region-ISO=|Kat-Root=|Kat-Schema=in|Kat-Kontinent=ja}}
Beispiele
| Vorlage | Ist-Ergebnis (Links mehrfach, Kats nur einfach) | Soll-Ergebnis |
|---|---|---|
| {{ISO Kat|Region-ISO=AT-2|Kat-Root=Gewässer|Kat-Schema=in}} | Kategorie:Gewässer in Kärnten | Kategorie:Gewässer in Kärnten |
| {{ISO Kat|Region-ISO=AT-5/AT-7|Kat-Root=Berg|Kat-Schema=in}} | Kategorie:Berg im Land SalzburgKategorie:Berg in Tirol | Kategorie:Berg im Land Salzburg, Kategorie:Berg in Tirol |
| {{ISO Kat|Region-ISO=AT-4/AT-6|Kat-Root=Geographie|Kat-Schema=()}} | Kategorie:Geographie (Oberösterreich)Kategorie:Geographie (Steiermark) | Kategorie:Geographie (Oberösterreich), Kategorie:Geographie (Steiermark) |
| {{ISO Kat|Region-ISO=AT-1|Kat-Root=Landeshauptmann|Kat-Schema=()}} | Kategorie:Landeshauptmann (Burgenland) | Kategorie:Landeshauptmann (Burgenland) |
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 (Bsp. für die Türkei).
Parameter
| 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: in () |
Berg in Tirol Berg (Tirol) |
| 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: {{Info ISO-3166-2|code=AT-3|name}}=Niederösterreich) 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 {{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 {{ISO Kat~}} hat die gleiche Schnittstelle wie {{ISO Kat}}, erwartet in Region-ISO aber genau einen Wert.
- Die Vorlage {{ISO Kat~/KatName}} baut den Kategorienamen zusammen unter Beachtung des Kat-Schemas. Danach muss noch die Existenzprüfung erfolgen.
- Die Vorlage {{ISO Kat~/KatGen}} erzeugt die Kategorie (unter Berücksichtigung von test)