Wikipedia:Lua/Modul/Text/de

Vorlagenprogrammierung	Diskussionen	Lua			Test	Unterseiten
		Modul	Deutsch	English		Modul:	Dokumentation

Text – Modul mit Funktionen für Textpassagen, Wikitext und ggf. HTML.

Funktionen für Vorlagen

Alle Funktionen haben einen unbenannten Parameter mit dem Text.

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.

concatParams

Beliebig viele Elemente zu einer Liste kombinieren ähnlich table.concat() in Lua.

Vorlagenprogrammierung

1: Erstes Element; fehlende oder leere Elemente werden ignoriert
2 3 4 5 6 …: Zweites usw. Element

Lua

args: table (sequence) mit den Elementen

apply: Trennzeichen bei der internen Verkettung; standardmäßig |
adapt: optionale Formatierung, die auf jedes Element angewendet wird; muss %s enthalten.

containsCJK

Enthält die Zeichenkette ein CJK-Zeichen?

nichts – wenn nicht erkannt

listToText

Formatiere Listenelemente analog zu mw.text.listToText()

Zwischen den Elementen wird ein Komma mit Leerzeichen gesetzt; zwischen dem vorletzten und letzten das Wort „und“.

Als Listenelemente werden die Werte unbenannter Parameter verwendet.

Optionale Parameter von #invoke:

format – Jedes Listenelement soll zunächst mit diesem Pattern formatiert werden, das mindestens ein %s enthalten muss.
template=1 – Die Listenelemente werden der umgebenden Vorlageneinbindung entnommen.

Das Ergebnis ist die Zeichenkette.

sentenceTerminated

Ist die Zeichenkette mit einem Satzendezeichen beendet, auch CJK, auch wenn noch Anführungszeichen oder schließende eckige Klammern folgen?

nichts – wenn nicht erkannt

ucfirstAll: Den ersten Buchstaben jedes erkennbaren Wortes groß schreiben.; Die Parserfunktion {{ucfirst:}} verändert hingegen nur das erste nichtleere Zeichen des Parameters.; Benannte HTML-Entities, deren Notation wegen Unsichtbarkeit oder Syntaxkonflikt üblich ist, werden nicht beeinträchtigt.
uprightNonlatin: Gib eine Zeichenkette zurück, bei der nichtlateinische Zeichen nicht kursiv dargestellt werden, abgesehen von einem einzelnen griechischen Buchstaben.

Beispiele (Testseite)

Eine Testseite illustriert praktische Beispiele.

Funktionen für Lua-Module

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

local lucky, Text = pcall( require, "Module:Text" )
if type( Text ) == "table" then
    Text = Text.Text()
else
    -- Fehlerfall; Text enthält Fehlermeldung
    return "<span class=\"error\">" .. Text .. "</span>"
end

Danach stehen zur Verfügung:

Text.concatParams( s, delimiter )
Text.containsCJK( s )
Text.listToText( table, format )
Text.sentenceTerminated( s )
Text.uprightNonlatin( s )

Verwendung

Allgemeine Bibliothek; nicht eingegrenzt.

Abhängigkeiten

Keine.