Quelltext der Seite Wikiup:Lua/Modul/Multilingual/de

{{LuaModuleDoc}}
<onlyinclude>'''<code>Multilingual</code>''' – Modul mit Funktionen im Zusammenhang mit Sprachen, Sprachcodes, Sprachnamen.

== {{Anker|Vorlage}} Funktionen für Vorlagen ==

Alle Funktionen haben zumindest einen unbenannten Parameter (sinnvollerweise anzugeben), und gelegentlich optional weitere. Dies ist tolerant gegenüber Leerzeichen vor oder nach dem Inhalt. Groß- und Kleinschreibung von Code-Segmenten wie <code>de-AT</code> hat keine Bedeutung; Codes werden nur in Kleinschreibung zurückgegeben.

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.
; fair   {{Anker|fair}}
: Formatierung des Codes gemäß RFC 5646 sowie Syntaxprüfung.
: Rückgabewert: Leer, falls ungültig.
; fallback   {{Anker|fallback}}
: Ist eine andere Sprache als Ersatz sinnvoll?
:* <code>1</code> – Sprachcode, der eigentlich unterstützt werden soll
:* <code>2</code> – Alternativer Sprachcode als möglicher Ersatz
:* Ergebnis: ''nichts'' – wenn kein Ersatz bekannt; dann Englisch?
; findCode   {{Anker|findCode}}
: Ermittlung des Codes zu einem Sprachnamen (in aktueller Projektsprache).
: Ein Code selbst würde ebenfalls identifiziert werden.
; fix   {{Anker|fix}}
: Reparaturversuch für ungültige Sprachcodes
:* <code>1</code> – Sprachcode, der geprüft werden soll
:* Ergebnis: ''nichts'' – wenn unbeanstandet; sonst Vorschlag
; format   {{Anker|format}}
: Formatiere einen oder mehrere Sprachnamen.
:* <code>1</code> – Sprachenliste oder Einzelsprache
:* <code>slang</code> – Sprache des Ergebnisses, wenn nicht in der jeweiligen Sprache selbst
:** <code>*</code> – eigene Sprache ''(Vorgabe)''
:** <code>!</code> – aktuelle Projektsprache
:** Jeder gültige Code
:* <code>shift</code> – Groß- und Kleinschreibung
:** <code>c</code> – Das erste Wort jeder Bezeichnung in Großschreibung
:** <code>d</code> – Alles in Kleinschreibung
:** <code>f</code> – Das erste Wort der Liste in Großschreibung, Rest Kleinschreibung
:** <code>m</code> – Das erste Wort jedes Listenelements in Kleinschreibung
:* <code>link=1</code> – Sprachnamen verlinken, falls ermittelbar
:* <code>scream</code> – Titel einer Wartungskategorie im Fehlerfall
:* <code>split</code> – ''pattern'' zur Aufgliederung einer Liste; etwa <code>split=,</code> – andernfalls wird <code>1</code> als Einzelsprache aufgefasst
:* <code>separator</code> – Listentrennung bei der Ausgabe, sonst <code>split</code>
:* <code>start</code> – Einem ersten Listenelement voranzustellende Zeichenkette (wirkungslos, wenn leere Liste resultiert)
; getBase   {{Anker|getBase}}
: Basissprache aus einem mutmaßlichen ISO-Code extrahieren.
; getName   {{Anker|getName}}
: Welcher Name ist diesem Code zugeordnet?
:* <code>2</code> – Sprache der Antwort
:** <code>*</code> – in der Sprache selbst ''(Vorgabe)''
:** <code>!</code> – in der Projektsprache
:** Jeder ISO-Code.
: Der Rückgabewert entspricht dem der Parserfunktion <code><nowiki>{{#language:welche|Darstellungssprache}}</nowiki></code>.
:* Der momentane Wert dieser weltweiten Systemprogrammierung kann aber ggf. korrigiert sein durch [[Modul:Multilingual/names]].
; int   {{Anker|int}}
: Systemnachricht in beliebige Sprache übersetzen
:* <code>1</code> – Bezeichner der Systemnachricht 
:* <code>2</code> – Sprachcode für die Übersetzung
:* <code>$1</code>, <code>$2</code>, … – Parameter
:* Ergebnis: analog <code><nowiki>{{int:}}</nowiki></code>
; isLang   {{Anker|isLang}}
: Kann das ein ISO-Code sein?
:* Ergebnis: ''nichts'' – wenn nicht
; isLangWiki   {{Anker|isLangWiki}}
: Kann das eine Wiki-Sprachversion sein?
:* Ergebnis: ''nichts'' – wenn nicht
; isRTL   {{Anker|isRTL}}
: Gehört dieser Code zu einer von rechts nach links geschriebenen Schrift?
:* <code>1</code> – Sprachcode gemäß [[ISO 639]] oder Schriftsystem-Code gemäß [[ISO 15924]]
: Ergebnis: nicht leer wenn rechts nach links
; message   {{Anker|message}}
: Versuche, einen mehrsprachigen Text bestmöglich in der Benutzersprache (momentan <code>{{int:lang}}</code>) darzustellen
:* <code>en</code> – englischsprachige Textversion
:* <code>de</code> – deutschsprachige Textversion
:* <code>…</code> – beliebige weitere Textversionen
:* <code>$1</code> – Parameterwert zur Ersetzung
:* <code>$2</code> – Parameterwert zur Ersetzung
:* <code>…</code> – …
:* <code>$9</code> – Parameterwert zur Ersetzung
: Ergebnis: bestmögliche Textversion mit Ersetzung von $-Platzhaltern, oder leer
; sitelink   {{Anker|sitelink}}
: Verlinke lokale oder nächstmögliche fremde Seite zu einem Wikidata-Item
:* <code>1</code> – Nummer des Items oder ID beginnend mit „Q“
: Ergebnis: Gemäß Benutzersprache bestmögliche Sprachversion, oder leer
; tabData   {{Anker|tabData}}
: Versuche, ein mehrsprachiges Textfragment aus den ''commons:Data:''-Tabellen bestmöglich in der Benutzersprache (momentan <code>{{int:lang}}</code>) darzustellen
:* <code>1</code> – Seiten-Bezeichner auf ''commons:'', vorangestelltes <code>Data:</code> und nachgestelltes <code>.tab</code> sind nicht erforderlich.
:* <code>2</code> – Bezeichner des Textfragments innerhalb der Tabelle.
:* <code>alt</code> – ''(optional)'' Ersatztext, falls nichts gefunden.
: Von den Internationalisierungstabellen wird erwartet, dass sie folgende Bedingung erfüllen:
:# Spalte: ''string'', mit Bezeichner des Textfragments
:# Spalte: ''localized'', mit mehrsprachigen Textfragmenten
; userLang   {{Anker|userLang}}
: Versuche, die Benutzersprache (momentan <code>{{int:lang}}</code>) durch eine Anwendung zu unterstützen.
:* <code>1</code> – Leerzeichen-getrennte Liste der verfügbaren Codes gemäß ISO 639
:* ''Ergebnis:''
:** Wenn die aktuelle Benutzersprache nicht Element der Liste ist, wird auf das erste Element zurückgefallen.
:** Wenn die aktuelle Benutzersprache eine Variante ist wie <code>de-AT</code> oder <code>de-CH</code> und diese nicht explizit in der Liste genannt wird, wird ersatzweise die Basissprache (hier&nbsp;<code>de</code>) versucht.
:** Wenn alles nicht passt und keine Liste vorgegeben wurde, ist die Ausgabe die Projektsprache (hier&nbsp;<code>{{CONTENTLANGUAGE}}</code>) und notfalls <code>en</code> für Englisch.
; wikibase   {{Anker|wikibase}}
: Zeige den Text zu einem Wikidata-Entity bestmöglich in der Benutzersprache (momentan <code>{{int:lang}}</code>)
:* <code>1</code> – Item-ID, beginnend mit <code>Q</code> oder <code>P</code> oder <code>L</code>
:* <code>2</code> – ''(optional)'' <code>1</code> oder <code>descriptions</code>; ''(Vorgabe)'' <code>0</code> oder <code>labels</code>
:* ''Ergebnis:'' Hinterlegter Text, oder leer
; failsafe   {{Anker|failsafe}}
: Versionsmanagement
{{Wikipedia:Lua/Modul-Failsafe|Modul=Multilingual}}

===  Beispiele (Testseite) ===
Eine [[Wikipedia:Lua/Modul/Multilingual/Test|Testseite]] illustriert praktische Beispiele.</onlyinclude>

== {{Anker|Lua}} Funktionen für Lua-Module ==

Alle oben dokumentierten Funktionen können auch über <code>require()</code> in andere Module eingebunden werden:
<syntaxhighlight lang="lua">
local lucky, Multilingual = pcall( require, "Module:Multilingual" )
if type( Multilingual ) == "table" then
    Multilingual = Multilingual.Multilingual()
else
    -- Fehlerfall; Multilingual enthält Fehlermeldung
    return "<span class=\"error\">" .. Multilingual .. "</span>"
end
</syntaxhighlight>
Danach stehen zur Verfügung:
; Multilingual.[[#fair|fair]]( ask )   {{Anker|fair()}}
:* ''ask'' – Zeichenkette oder aber ''table'' gemäß [[#getLang()|getLang()]]
; Multilingual.[[#fallback|fallback]]( able, another )   {{Anker|fallback()}}
; Multilingual.[[#findCode|findCode]]( ask )   {{Anker|findCode()}}
; Multilingual.[[#fix|fix]]( attempt )   {{Anker|fix()}}
; Multilingual.[[#format|format]]( apply, alien, alter, active, alert, frame, assembly, adjacent, ahead )   {{Anker|format()}}
:* ''apply'' – Sprachenliste oder Einzelsprache
:* ''alien'' – Sprache des Ergebnisses
:** <code>nil false "*"</code> – eigene Sprache ''(Vorgabe)''
:** <code>"!"</code> – aktuelle Projektsprache
:** Jeder gültige Code
:* ''alter'' – optionale Korrektur der Groß- und Kleinschreibung
:** <code>"c"</code> – Das erste Wort jeder Bezeichnung in Großschreibung
:** <code>"d"</code> – Alles in Kleinschreibung
:** <code>"f"</code> – Das erste Wort der Liste in Großschreibung, Rest Kleinschreibung
:** <code>"m"</code> – Das erste Wort jedes Listenelements in Kleinschreibung
:* ''active'' – Sprachnamen verlinken, wenn <code>true</code>
:* ''alert'' – optionaler string, Titel einer Wartungskategorie im Fehlerfall
:* ''frame'' – wenn verfügbar
:* ''assembly'' – optionaler string mit ''pattern'', wenn Liste erwartet
:* ''adjacent'' – Listentrennung bei der Ausgabe, sonst ''assembly''
:* ''ahead'' – Einem ersten Listenelement voranzustellende Zeichenkette
; Multilingual.[[#getBase|getBase]]( ask )   {{Anker|getBase()}}
; Multilingual.getLang( ask )   {{Anker|getLang()}}
: Zerlegung eines Sprachcodes in Komponenten
: Rückgabewert: ''table''
:: <code>.base</code> – Basissprache (2–3 Kleinbuchstaben)
:: <code>.region</code> – Staat (2 Großbuchstaben)
:: <code>.script</code> – Schrift (4 Buchstaben, erster groß)
:: <code>.year</code> – Jahr (4 Ziffern)
:: <code>.extension</code> – Erweiterung (1 Kleinbuchstabe)
:: <code>.other</code> – Sonstiges
:: <code>.legal</code> – ''true'' wenn gültig
:: <code>.n</code> – Anzahl der Komponenten
; Multilingual.[[#getName|getName]]( ask, alien )   {{Anker|getName()}}
:* ''alien'' – optionaler string, Sprache des Ergebnisses
:** <code>nil false "*"</code> – eigene Sprache
:** <code>"!"</code> – aktuelle Projektsprache
:** Jeder gültige Code
; Multilingual.i18n( available, alt, frame )   {{Anker|i18n()}}
: Internationalisierter Text ([[I18N]]) in bestmöglicher Sprache.
:* ''available'' – Mapping; Sprachcode → Meldungstext als ''table''
:* ''alt'' – optionaler string, mit Meldungstext falls ''table'' versagt
:* ''frame'' – wenn verfügbar
; Multilingual.[[#int|int]]( access, alien, apply )   {{Anker|int()}}
; Multilingual.[[#isLang|isLang]]( ask )   {{Anker|isLang()}}
; Multilingual.[[#isLangWiki|isLangWiki]]( ask )   {{Anker|isLangWiki()}}
; Multilingual.[[#isMinusculable|isMinusculable]]( ask, assign, about )   {{Anker|isMinusculable()}}
; Multilingual.[[#isRTL|isRTL]]( ask )   {{Anker|isRTL()}}
; Multilingual.[[#message|message]]( arglist, frame )   {{Anker|message()}}
: Wähle ein Textfragment aus.
:* ''arglist'' – Parameter wie bei der Vorlage als ''table'', Sprachcodes als ''key''
:* ''frame'' – wenn verfügbar
; Multilingual.[[#sitelink|sitelink]]( all, frame )   {{Anker|sitelink()}}
: Verlinke lokale oder nächstmögliche fremde Seite zu einem Wikidata-Item.
:* ''arglist'' – Item-Bezeichner; ''string'' oder ''table'' (entity) oder ''number''
:* ''frame'' – wenn verfügbar
: Rückgabewert: ''string'', mit irgendeinem internen Link, oder leere Zeichenkette
; Multilingual.[[#tabData|tabData]]( access, at, alt, frame )   {{Anker|tabData()}}
: Wähle ein Textfragment aus einer ''commons:Data:''-Tabelle aus.
:* ''access'' – Seiten-Bezeichner auf Commons; ''string''
:* ''at'' – Schlüsselwort für das Textfragment ; ''string''
:* ''alt'' – Ersatztext; ''optional string''
:* ''frame'' – wenn verfügbar
: Rückgabewerte: 
:# Textfragment als ''string'', sonst ''nil'' oder ''false''
:# ''string'' mit Sprachcode des Textfragments, notfalls <code>error</code>
; Multilingual.[[#userLang|userLang]]( accept, frame )   {{Anker|userLang()}}
:* ''accept'' – Leerzeichen-getrennte Liste der verfügbaren Codes
:* ''frame'' – wenn verfügbar
; Multilingual.userLangCode()   {{Anker|userLangCode()}}
: Errate die momentane Sprache der Benutzeroberfläche.
: Rückgabewert: ''string'', notfalls <code>"en"</code>
; Multilingual.[[#failsafe|failsafe]]( atleast )   {{Anker|failsafe()}}
: Versionsbezeichnung
:* atleast<br /> ''optional''<br /> ''nil'' oder Mindestversion oder&nbsp;<code>~</code>
: Rückgabewert: ''string'' oder <code>false</code>
Im Erfolgsfall geben die ''Multilingual.get*()'' eine Zeichenkette zurück, die ''Multilingual.is*()'' usw. den Wert <code>true</code>; bei Misserfolg jeweils <code>false</code>.

== Installation auf anderen Projekten ==
Siehe [[../en|englischsprachige Dokumentation]].

== Verwendung ==
Allgemeine Bibliothek; nicht eingegrenzt.

== Abhängigkeiten ==
* [[../../WLink|WLink]]
* [[../../ISO15924|ISO15924]]<!--
* [[../config|/config]] – optionale projektspezifische Anpassung -->

[[Kategorie:Wikipedia:Lua/Modul/Dokumentation|Multilingual]]