Vorlagenprogrammierung Diskussionen Lua Test Unterseiten
Modul Deutsch English

Modul: Dokumentation

Sort/cellDate – Modul zum Generieren von sortierbaren Datums- und Zeitangaben in Tabellen.

Funktionen für Vorlagen

f
Formatieren.
Parameter einer umgebenden Vorlageneinbindung:
keine
Parameter des #invokealle optional:
d
Datum/Zeit
Format beliebig (deutsch/englisch), sofern eindeutig interpretierbar
Einzelner Tag, auch unspezifischer Monat oder Tag im Monat ohne Jahr usw.
Bekannte Schlüsselwörter dürfen vorangestellt werden.
pattern
Darstellungsformat; bekannte Schablone oder frei programmierbare Formatspezifikation
Der Wert - unterdrückt die optische Darstellung.
lang
Sprachcode der Darstellung
target
Wiki-Seite verlinken
url
Externe Seite verlinken (URL)
pre
Kurzes Präfix
Wird ohne Zeilenumbruch mit dem Datum verbunden; normaler Weißraum.
Kann ein bekanntes Schlüsselwort spezifizieren.
post
Kurzes Postfix
Wird ohne Zeilenumbruch mit dem Datum verbunden; normaler Weißraum.
pad
Versuch einer Ausrichtung von einstelligen Tagesdaten
Wenn 1 dann aktivieren
type
Sortiermodus
Vorgabe: date (projektübliche Alltagsformate)
Zulässige Optionen:
  • date
  • isoDate
  • usLongDate
Anfangsbuchstabe(n) genügen zur zweifelsfreien Identifikation.
Wichtig zur Mischung von Zellen mit und ohne Vorlagennutzung.
rowspan
Tabellen-Attribut: Anzahl der Zeilen
colspan
Tabellen-Attribut: Anzahl der Spalten
class
Universal-Attribut: Leerzeichen-getrennte Liste von Klassenbezeichnern
style
Universal-Attribut: CSS-Deklaration
URL sowie Anführungszeichen " sind unzulässig.
id
Universal-Attribut: Fragmentbezeichner
dir
Universal-Attribut: Schreibrichtung (der gesamten Tabellenzelle)
rtl oder ltr (geerbte Vorgabe)
cat
Titel einer Wartungskategorie im Fehlerfall
Rückgabewert: Wikitext.
  • Bei nicht entschlüsselbarer Eingabe erfolgt eine Fehlermeldung.
furnish
Wikitext mit Auflistung bekannter Schlüsselwörter
failsafe
Versionsbezeichnung

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):

Parameter
Wert Ergebnis aktuell
nichts
false
lokale Version »2024-06-01«
Mindest­version Mindestversionsbezeichnung
Datum im ISO-Format

Es wird verglichen, ob das aktuelle Modul diese Version oder später erfüllt.

  • leer, falls Mindestversion nicht erfüllt
  • 2001-01-01 → »2024-06-01«
  • 2099-01-01 → »«
wikidata Versionsbezeichnung der globalen Mutter (d:Q90149250)
  • Versionsbezeichnung auf Wikidata
  • lokal, falls dort keine gefunden
»2024-06-01«
item ID des Wikidata-Items
  • leer, falls nicht definiert
»Q90149250«
~ Übereinstimmung der lokalen mit der auf Wikidata registrierten Versionsbezeichnung
  • leer, falls aktuell
  • Versionsbezeichnung auf Wikidata, falls ungleich
»«
@ Ist die aktuelle (Modul-)Seite richtig mit Wikidata verknüpft?
  • leer, falls mit dem richtigen Item verknüpft
  • Item-ID, falls nicht
Der Rückgabewert ist in der Vorlagenprogrammierung leer und per Lua false; andernfalls die angegebene Zeichenkette.

Schlüsselwörter (adverbial)

Die nachstehenden Schlüsselwörter werden erkannt und bei ungenauen Angaben ausgewertet:

  • Anfang
  • Ende
  • ab
  • ab dem
  • ab etwa
  • bis
  • bis etwa
  • bis um
  • bis zum
  • ca.
  • etwa
  • frühestens
  • nach
  • nach dem
  • nach etwa
  • seit
  • seit dem
  • seit etwa
  • spätestens
  • um
  • vom
  • von
  • vor
  • vor dem
  • vor etwa
  • zwischen

Verwendung

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

{{#invoke: Sort | 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.