Wikipedia:Lua/Modul/ISO3166

aus Wikipedia, der freien Enzyklopädie
Zur Navigation springen Zur Suche springen
Vorlagenprogrammierung Diskussionen Lua Test Unterseiten
Modul Deutsch English

Modul: Dokumentation

ISO3166 – Modul mit Funktionen zur Konvertierung von Codes gemäß ISO 3166 für Territorien.

Historische Staaten können nur selten erfasst werden, da es die Codes erst seit den 1970er Jahren gibt und diese teilweise später erneut vergeben wurden. Aufteilungen von Staaten verweisen nicht auf aktuelle Teilstaaten, jedoch Vereinigungen. Es sind nur ISO-bekannte oder reservierte Codes erfasst, nicht aber fremder Organisationen wie IOC, da diese oft kollidieren.

Funktionen für Vorlagen

f
Standardfunktion: Abfrage des konvertierten Codes
  • 1 – zu konvertierender Code (Pflichtparameter)
  • 2 – gewünschtes Format für Ergebnis
    • A2 oder A3 oder NUM oder A4
    • Vorgabe: A3
  • 3 – nicht in aktuelles Territorium weiterleiten
    • 1 – historisches Gebiet
    • Vorgabe: 0 – aktueller Staat
failsafe
Versionsbezeichnung (lokal): 2019-10-14
Optionaler Zusatzparameter:
  • 1 – Mindestversionsbezeichnung oder wikidata oder ~
{{#invoke:ISO3166|failsafe}} ergibt 2019-10-14
Mit Angabe eines Parameters als Datum im ISO-Format wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt.
  • {{#invoke:ISO3166|failsafe|2001-01-01}} ergibt: »2019-10-14«
  • {{#invoke:ISO3166|failsafe|2099-01-01}} ergibt: »« – leer, falls Mindestversionsbezeichnung nicht erfüllt
Ist dieser Zusatzparameter das Schlüsselwort wikidata, so ist der Wert die auf Wikidata registrierte Versionsbezeichnung (2019-10-14) oder lokal, falls dort keine gefunden.
  • Ist der Zusatzparameter das Zeichen ~, so ist das Ergebnis leer, falls Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung besteht ().
Rückgabewert:
  • Leer, falls Mindestversionsbezeichnung nicht erfüllt, oder Übereinstimmung mit Wikidata
  • Versionsbezeichnung (auf Wikidata registriert:2019-10-14) bei wikidata, oder lokal falls dort keine gefunden, bzw. leer wenn synchronisiert

Beispiele (Testseite)

Eine Testseite illustriert praktische Beispiele.

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

{{#invoke: ISO3166 | Funktionsname | Wert1 | Wert2 | NameX=Wert … }}

Die Parameter können wie bei Vorlagen benannt oder unbenannt sein; deren Regeln gelten analog.

Wenn unbekannte Zeichenketten von außen kommen (als Vorlagenparameter), sollte immer mit der Form 1=Wert gearbeitet werden.

Zu allgemeinen Problemen beachte die Abhilfen wie bei Vorlagen.

Wenn in einer Vorlage ein Modul verwendet wird, sollte auch immer die Vorlage:Dokumentation/Lua in der Dokumentationsseite eingebunden werden.

  1. Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
  2. Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.
  3. Die Vorlage wird zur Übersicht kategorisiert in Kategorie:Vorlage:mit Lua-Programmierung.

Zu weiteren Informationen siehe Hilfe:Lua.

Bei Problemen wende dich bitte an die Vorlagen-Werkstatt, in schweren Fällen hilft auch die Lua-Werkstatt.