Vorlagenprogrammierung Diskussionen Lua Unterseiten
Modul Deutsch English

Modul: Dokumentation

Vorlage:Runeberg – Modul zum Generieren korrekter Verlinkungen über runeberg.org zugänglicher Digitalisierungsprojekte.

Funktionen für Vorlagen

Bearbeiten
range
Band-Titel
Parameter:
suite
Kennung für Digitalisierungsprojekt
DBL oder NF oder Salmonsen
ed
Auflage (1 oder 2 wo erforderlich)
optional
vol
Bandnummer (1–…)
suppl
Supplement
optional boolean
1 oder 0 oder leer
wwwLink
Link auf Digitalisat
Parameter:
suite
Kennung für Digitalisierungsprojekt
DBL oder NF oder Salmonsen
ed
Auflage (1 oder 2 wo erforderlich)
optional
vol
Bandnummer (1–…)
optional, wenn erforderliche Auflage gegeben
sub
Spaltennummer oder Seitenzahl
optional, wenn Bandnummer gegeben
page
Blattnummer
optional, wenn Bandnummer gegeben
Darf nicht zusammen mit sub angegeben werden.
suppl
Supplement
optional boolean
1 oder 0 oder leer
runeberg
optional, Pfad zu verbesserter Reproduktion innerhalb des Bandes
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):

Parameter
Wert Ergebnis aktuell
nichts
false
lokale Version »2023-12-18«
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 → »2023-12-18«
  • 2099-01-01 → »«
wikidata Versionsbezeichnung der globalen Mutter (d:Q123906537)
  • Versionsbezeichnung auf Wikidata
  • lokal, falls dort keine gefunden
»2023-12-18«
item ID des Wikidata-Items
  • leer, falls nicht definiert
»Q123906537«
~ Ü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.

Digitalisierungsprojekte

Bearbeiten

Die folgenden Digitalisierungsprojekte sollen unterstützt werden:

  • DBL – Dansk biografisk Lexikon (1887…1905)
  • NF – Nordisk familjebok (1876…1926)
  • Salmonsen – Salmonsen, 2. Auflage

Fehlermanagement

Bearbeiten

Bei Parameterfehlern einer der beiden produktiven Funktionen werden die nachstehenden Parameter berücksichtigt:

errCat
Kategorie-Titel für Fehlerfall
optional
errClass
Klasse (zusätzlich zu error) für Fehlermeldung
optional
errStyle
CSS-Stildefinition für Fehlermeldung
optional
errText
Text der Fehlermeldung
optional

Verwendung

Bearbeiten

Abhängigkeiten

Bearbeiten

Keine.

Funktionen für Lua-Module

Bearbeiten

Einige Funktionen können auch über require() in andere Module eingebunden werden:

local lucky, Runeberg = pcall( require, "Module:Vorlage:Runeberg" )
if type( Runeberg ) == "table" then
    Runeberg = Runeberg()
else
    -- Fehlerfall; Runeberg enthält Fehlermeldung
    return "<span class='error'>" .. Runeberg .. "</span>"
end
Runeberg.failsafe(atleast)
  1. atleast
    optional
    nil oder Mindestversion oder "wikidata"
Rückgabewert: string oder false