Vorlage:Vorlagendokumentation HDK

Meta-Dokumentation einer FlagIcon-Vorlage, Bereich „HDK“ (Handels-, Dienst- und Kriegsflaggen)

Diese Vorlage ist Teil einer Serie von Vorlagen mit Handels-, Dienst- und Kriegsflaggen vieler Länder. Bevor du sie änderst, sprich das bitte hier ab.
Allgemeine Hinweise zur Erstellung und Benutzung von Vorlagen sind unter Hilfe:Vorlagen erreichbar.

Hinweise

Bevor du diese Vorlage änderst, bitte Folgendes beachten:

Wenn du die Flagge ändern möchtest, benutze bitte vorzugsweise ein Bild von Commons und eher eine SVG-Grafik als ein Rasterbild!
Wenn du die Größe/Breite von 20 px auf einen anderen Wert ändern willst, diskutiere das bitte zuerst und mache es dann in allen Vorlagen oder lasse es bei allen sein!
Wenn du den Namen des Landes ändern willst, beachte bitte Wikipedia:Namenskonventionen/Staaten und das dazugehörige Wikipedia:Meinungsbilder/Einheitliche Ländernamen!
Wenn du die Vorlagenparameter oder den Aufbau der Vorlagen nicht verstehst, mache bitte keine Experimente, sondern frage gerne einfach an! Die Vorlagen sind mittlerweile tausendfach genutzt.
Übersicht Wikipedia:Ländervorlagen Handels-, Dienst- und Kriegsflagge
Flaggen, welche in mehreren, voneinender getrennten Perioden genutzt wurden, haben für jede Periode eine entsprechende Vorlage, weil entweder der Standardtext oder der sogenannte Sortierschlüssel verschieden ist. Bitte die passende Version verwenden.

Systematik

Die Vorlagen bestehen aus einem dreistelligen Länderkürzel, das (soweit vorhanden) der ISO-3166-Kodierung (ISO) entspricht, sowie einem die Bestimmung der Flagge gemäß dem vexillologischen Symbol darstellenden Anhang. So ergibt sich aus dem Aufbau des vexillologischen Symbols:

Führung	Privat	Dienstlich	Militärisch
An Land	Bürgerliche Flagge	Dienstflagge	Kriegsflagge
Zur See	Handelsflagge	Dienstflagge	Kriegsflagge

folgende Systematik für die Anhänge:

Führung	Privat		Dienstlich		Militärisch
An Land	–	–	D	LD	K	LK
Zur See	–	H	D	SD	K	SK

Jahreszahlen stellen einen weiteren möglichen Anhang dar. Eine Vorlage ohne angehängte Jahreszahl gibt stets die aktuelle bzw. zuletzt gültige Ausführung der Flagge wieder, frühere Varianten werden durch die Jahreszahl ihrer Einführung gekennzeichnet.

Vorlagen für spezielle Dienstflaggen (Post, Luftwaffe etc.) weichen von dieser generellen Systematik ab und erhalten separate Anhänge. Die jeweiligen dreistelligen Länderkürzel werden hingegen beibehalten.

Verwendung

Die Vorlagen werden einfach mit {{XYZ-AB}}, gegebenenfalls auch {{XYZ-AB-123}}, eingebunden, wobei XYZ das dreistellige Länderkürzel, AB die möglichen Anhänge sowie 123 das Jahr der Einführung der Flagge darstellt.
Beispiel: {{GBR-SD}} wird zu Vereinigtes Konigreich Vereinigtes Königreich

Beispiel: {{GBR-SD-1707}} wird zu Großbritannien Großbritannien
Die Vorlagen sind um zusätzliche Parameter erweiterbar. Diese müssen jeweils ohne [[…]] angegeben werden:
- Parameter 1: Das Link-Ziel zur Festlegung, ob auf einen anderen als den vorgegebenen Artikel verlinkt werden soll.
  Beispiel: {{GBR-SD|Royal Mail Ship}} wird zu Vereinigtes Konigreich Vereinigtes Königreich.
- Parameter 2: Auch eine Änderung des Link-Textes ist möglich, dies auch unabhängig vom Linkziel.
  Beispiel: {{GBR-SD|2=Royal Mail Ship}} wird zu Vereinigtes Konigreich Royal Mail Ship.
  
  Beispiel: {{GBR-SD|Royal Mail Ship|Königliches Postschiff}} wird zu Vereinigtes Konigreich Königliches Postschiff.
- Parameter Ziel: Sollen sowohl Linktext als auch Linkziel identisch geändert werden, ist dies durch die Angabe des Ziels möglich.
  Beispiel: {{GBR-SD|Ziel=Royal Mail Ship}} wird zu Vereinigtes Konigreich Royal Mail Ship.
- Parameter 3: Mit der alternativen Beschreibung der Flagge ist ein Sortierschlüssel verbunden, der für sortierbare Tabellen genutzt werden kann. Die Voreinstellung des Sortierschlüssels entspricht jeweils dem vorgegebenen Link-Text, jedoch ohne möglicherweise vorhandene Umlaute.
  Beispiel: {{GBR-SD|3=Royal Mail Ship}} wird zu Royal Mail Ship Vereinigtes Königreich.
- Parameter 4: Die Verlinkung der Flagge ist ebenfalls möglich. In diesem Fall entfällt der zusätzliche Link-Text.
  Beispiel: {{GBR-SD|4=Royal Mail Ship}} wird zu Vereinigtes Konigreich.
- Parameter #: Mit Parameter wird nur die Flagge ohne weitere Verlinkung angezeigt.
  Beispiel: {{GBR-SD|#}} wird zu Vereinigtes Konigreich.
- Parameter WIDTH: Hiermit ist eine Änderung der Flaggengröße möglich. Der Parameter wird als Pixelwert (px) interpretiert. Ohne Angabe dieses Parameters wird einheitlich 20px benutzt.
  Beispiel: {{GBR-SD|WIDTH=40}} wird zu Vereinigtes Konigreich Vereinigtes Königreich.