Wikipedia:Lua/Modul/FileMedia

Vorlagenprogrammierung	Diskussionen	Lua			Test	Unterseiten
		Modul	Deutsch	English		Modul:	Dokumentation

FileMedia – Modul mit Funktionen für Mediendateien (Bilder), Beschreibungsseiten dazu sowie Seiten mit besonders formatierten Inhalten.

Funktionen für Vorlagen

Alle Funktionen haben einen unbenannten Parameter mit dem Seitennamen (sinnvollerweise anzugeben). Dieser ist tolerant gegenüber Leerzeichen vor oder nach dem Inhalt.

Der Rückgabewert ist eine leere Zeichenkette („nichts“), wenn der Parameterwert die Erwartung nicht erfüllt. Wenn ein Ergebnis vorhanden oder die Abfragebedingung wahr ist, resultiert mindestens ein Zeichen. Das Ergebnis beginnt oder endet nicht mit Leerzeichen.

Viele Funktionen sind „teuer“ – das bedeutet, dass maximal 500 Abfragen pro Gesamt-Seite erlaubt sind. Sie können jeweils doppelt teuer werden, wenn die Mediendatei lokal nicht existiert und auch auf Commons nachgefragt werden muss.

getExtension

Extrahiere aus einem Seitentitel die mutmaßliche „Dateiendung“ (Ergebnis kleingeschrieben)

• nichts – wenn nicht erkannt

getHeight

Gewinne aus dem Seitentitel oder Seitennamen einer Datei die Bildhöhe in Pixeln [teuer]

• nichts – wenn nicht erkannt

getHeightWidth

Gewinne aus dem Seitentitel oder Seitennamen einer Datei die Ausdehnung im Format 123x456px wie bei Bildparametern [teuer]

• nichts – wenn nicht erkannt

getMimeType

Gewinne aus dem Seitentitel oder Seitennamen einer Datei den MIME-Typ [teuer]

• nichts – wenn nicht erkannt

getPageCount

Gewinne aus dem Seitentitel oder Seitennamen einer Datei die Seitenanzahl von paged media [teuer]

• 0 – wenn vorhanden, aber nicht potentiell mehrseitig
• nichts – wenn nicht erkannt

getSize

Gewinne aus dem Seitentitel oder Seitennamen einer Datei die Größe in Bytes [teuer]

• nichts – wenn nicht erkannt

getTitle

Gewinne aus dem Seitentitel oder Seitennamen einer Datei den kanonischen Seitentitel (mit Leerzeichen)

• nichts – wenn nicht erkannt

getType

Gewinne aus einem Seitentitel den Datentyp anhand der mutmaßlichen „Dateiendung“

Datentypen sind: audio data paged pixel program style vector video

• nichts – wenn nicht erkannt

getWidth

Gewinne aus dem Seitentitel oder Seitennamen einer Datei die Bildbreite in Pixeln [teuer]

• nichts – wenn nicht erkannt

isFile

Ist es der Bezeichner einer Mediendatei, mit oder ohne Namensraum?

• 1 – ja

isType

Erfüllt der Dateiname die Erwartung 2 an den Dateinamen?

Datentypen 2 sind: audio data paged pixel program style vector video sowie file image – file ist für den Dateinamensraum geeignet und image darüberhinaus als Einzelbild.

• 1 – ja

setParSize

Prüfe oder vervollständige eine Bildgröße in Pixeln als px-Parameter

Ganze positive Zahlen werden um px ergänzt.

Gleichfalls die x-Formate für die Kombination mit der Bildhöhe.

• nichts – wenn nicht erkannt

Optionaler zweiter Parameter: Vorgabe, falls erster Parameter untauglich.

Optionaler Parameter pipe (boolesch): Stelle einem nicht-leeren Ergebnis ein Pipe-Symbol voran.

failsafe

Versionsbezeichnung (lokal): 2023-01-01

Optionaler Zusatzparameter:

• 1 – Mindestversionsbezeichnung oder wikidata

Rückgabewert:

• Leer, falls Mindestversionsbezeichnung nicht erfüllt
• Versionsbezeichnung (auf Wikidata registriert:2023-01-01) bei wikidata, oder lokal falls dort keine gefunden

Beispiele (Testseite)

Eine Testseite illustriert praktische Beispiele.

Allgemeine Hinweise zur Einbindung von Modulen

Eine Einbindung erfolgt jeweils im Format

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