Wikipedia:Lua/Modul/CoordParse
| Vorlagenprogrammierung | Diskussionen | Lua | Unterseiten | |||
| Modul | Deutsch | English | Modul: | Dokumentation | ||
CoordParse – Modul mit Funktionen zur Interpretation und Analyse von Geokoordinaten.
Funktionen für Vorlagen
- feed
- Einzelne Zeichenkette verarbeiten; ergibt Dezimalzahl
- 1 – Koordinatenwert
- latitude –
1= Breitenkoordinate, sonst Länge - Parameter zur Konfiguration von Himmelsrichtungen
- Parameter zur Handhabung von Fehlern
- focus
- Position aus einer oder zwei Koordinaten verarbeiten; ergibt eine Dezimalzahl
- 1 – Position
- latitude –
1= Breitenkoordinate, sonst Länge - Parameter zur Konfiguration von Himmelsrichtungen
- Parameter zur Handhabung von Fehlern
- Beispielsammlung
- fragments
- Vier Komponenten verarbeiten; ergibt Dezimalzahl
- 1 – Gradzahl
- 2 – (optional) Minutenzahl
- 3 – (optional) Sekundenzahl
- 4 – (optional) Himmelsrichtung (
N,E,S,Wusw.) - latitude –
1= Breitenkoordinate, sonst Länge - Parameter zur Konfiguration von Himmelsrichtungen
- Parameter zur Handhabung von Fehlern
- failsafe
- Versionsmanagement
Die Failsafe-Schnittstelle erlaubt den damit ausgerüsteten Modulen in globaler Verteilung
- sicherzustellen, dass eine von einer Vorlage oder einem Modul benötigte Funktion in der lokalen Kopie eines Bibliotheksmoduls vorhanden ist, und ggf. auch in einer erforderlichen Mindestversion;
- die globale Aktualisierung und Verknüpfung von Modulen über Wikidata zu verwalten.
Die Failsafe-Schnittstelle liegt sowohl auf Ebene der Vorlagen wie auch in direktem Lua-Zugriff vor.
Die Funktionen sind im Einzelnen (nicht alle werden bereits überall in vollem Umfang unterstützt):
| Wert | Ergebnis | aktuell |
|---|---|---|
nichtsfalse | lokale Version | »2022-09-15« |
| Mindestversion | Mindestversionsbezeichnung Datum im ISO-Format Es wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt.
|
|
wikidata | Versionsbezeichnung der globalen Mutter (d:Q113956219)
| »2022-09-15« |
item | ID des Wikidata-Items
| »Q113956219« |
~ | Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung
| »« |
@ | Ist die aktuelle (Modul-)Seite richtig mit Wikidata verknüpft?
| »Q113956219« |
Der Rückgabewert ist in der Vorlagenprogrammierung leer und per Lua false; andernfalls die angegebene Zeichenkette. | ||
Himmelsrichtungen
Standardmäßig werden als Kennbuchstaben für Himmelsrichtungen erwartet: N, E, S, W
Mit einem Parameter gleichen Namens, dem ein Lua-Pattern für Großbuchstaben zugewiesen wird, kann dies lokalisiert werden.
- deutsch
E=[EO]- französisch
W=[WO]
Fehlermanagement
Jede Fehlermeldung trägt class="error".
Die Texte können lokal über nachstehende Parameter konfiguriert werden, andernfalls erfolgt eine Behelfsmarkierung. Als Vorlagenparametername ist jeweils err voranzustellen, um lokal und gemäß Kontext zu konfigurieren.
| ID | Gegenstand |
|---|---|
Bad | Ungültig |
Empty | Leer |
GT4 | Mehr als 4 Komponenten |
DegGT | Gradzahl zu groß |
DegLT | Gradzahl zu klein |
DegX | Gradzahl fehlt |
Mgt60 | Minutenzahl ≥ 60 |
Mlt0 | Minutenzahl < 0 |
MinX | Minutenzahl fehlt |
Sgt60 | Sekundenzahl ≥ 60 |
Slt0 | Sekundenzahl < 0 |
Num | Zahl nicht erkannt |
SepEl | Dezimalbruch nicht an letzter Stelle |
Minus | Minuszeichen unzulässig |
Word | Unbekannte Himmelsrichtung |
Multi | Zu viele Komponenten in Position |
Class | Leerzeichen-getrennte Liste zusätzlicher Klassennamen zu class="error". |
Style | Zusätzliches CSS für Fehlermeldungen. |
Eine Wartungskategorie kann definiert werden, beispielsweise Kategorie:Wikipedia:Vorlagenfehler/Parameter:Koordinate.
- Parametername:
Cat - Anzugeben ist der Titel der Kategorie.
- Es kann ein Pipesymbol , ein Sortierschlüssel und
]]nachgestellt werden, wie an dieser Stelle der Wikisyntax üblich.
Allgemeine Hinweise zur Einbindung von Modulen
Eine Einbindung erfolgt jeweils im Format
{{#invoke: CoordParse | 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.
- Das gibt einem Programmierer Aufschluss, dass ein Lua-Modul benutzt wird, welche/s und ggf. welche Einzelfunktion daraus, und verlinkt auf die Dokumentation.
- Die Modul-Dokumentationen bekommen ein Link, in welchen Vorlagen sie eingesetzt werden, und wo bei eventuellen Funktionsänderungen Anpassungen erforderlich werden.
- 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.
