Modul:Citation/utilities/Doku
Dies ist eine nachgeordnete Seite der Dokumentation von Modul:Citation/utilities. Sie enthält Informationen zur Verwendung, Kategorisierung und zu anderem Inhalt, der nicht Bestandteil der originalen Modul-Seite ist. |
Dieses Modul wird auf vielen Seiten benutzt, und Änderungen werden projektweit sofort wahrgenommen. Bitte teste Änderungen vorher im /Sandkasten oder in deinem Benutzernamensraum. Die getestete Änderung sollte dann in einem einzigen Edit auf dieser Seite eingefügt werden. Bitte diskutiere Änderungen zuerst auf der Diskussionsseite bevor du sie implementierst. |
Dieses Modul ist getestet und für den projektweiten Gebrauch geeignet. Es kann in Vorlagen benutzt und auf Hilfeseiten erläutert werden. Entwicklungen an dem Modul sollten auf Citation/Test und die Anwendung auf der Spielwiese getestet werden, da wiederholte Trial-and-Error-Edits die Resourcen stark belasten können. |
Verwendung
[Bearbeiten]Das Modul stellt gemeinsame Funktionen für das Modul:Citation zur Verfügung.
Funktionen
[Bearbeiten]function cu.isSet( param )
liefert true
, wenn die Zeichenkette param
einen nicht-leeren Wert enthält.
function cu.round( num, decimalPlaces )
liefert die auf decimalPlaces
Stellen gerundete Zahl num
zurück.
function cu.getNumber( s )
konvertiert eine Zeichenkette in eine Zahl unter Berücksichtigung des in Modul:Citation/i18n spezifizierten Dezimalzeichens ci.texts.decimalPoint
. Wenn in der Zeichenkette [sic!]
enthalten ist, wird 0 zurückgegeben. Damit wird verhindert, dass eine Zahlenangabe als zu groß und fehlerhaft gekennzeichnet wird.
function cu.addErrorMsg( msg )
fügt eine Fehlermeldung in die intern vorgehaltene Fehlertabelle errorMsgs
ein.
function cu.getErrorMsgs()
liefert eine Zeichenkette mit allen in der Fehlertabelle errorMsgs
enthaltenen Fehlermeldungen – jede aber nur einmal – zurück.
function cu.getFirst( s, delimiter )
liefert das erste Element einer mit dem Trenner delimiter
unterteilten Zeichenkette zurück.
function cu.inArray( tab, val )
liefert true
zurück, wenn das Element val
in der Tabelle tab
enthalten ist.
function cu.getKey( t, list )
liefert das key
-Element aus der Tabelle list
, die Parameternamen in Übersetzung enthält.
function cu.getArgValue( list, param, args )
liefert einen einzelne Wert aus der Parametertabelle args
für den Parameter param
zurück. Die Tabelle list
wir für die Übersetzung der Parameternamen benötigt.
function cu.parameterCleanup( s )
liefert eine bereinigte Zeichenkette zurück, aus der Steuerzeichen, verschiedene Block-Tags (div, p, br) entfernt und XML- bzw. SGML-Zeichenreferenzen ausgetauscht wurden.
function cu.cleanupPageNumbers( pages )
liefert eine Zeichenkette zurück, in der verschiedene Striche durch den Bindestrich ersetzt wurden.
function cu.coinsCleanup( s )
liefert eine Zeichenkette, in der verschiedene Steuerzeichen, span-Tags, Wiki-Syntax (hauptsächlich Links) entfernt wurden.
function cu.finalCleanup( s )
liefert eine Zeichenkette, in der aufeinander folgende Interpunktionszeichen entfernt wurden.
function cu.makeLink( url, text )
liefert einen Link in Wiki-Syntax.
function cu.encodeHandle( handle )
liefert den URI-encodeten Wert des Parameters handle
.
function cu.getDate( aDate, aFormat, errorMsg )
liefert eine formatierte Datumsangabe aus aDate
mit dem Format aFormat
. Bei fehlerhafter Wandlung wird die Fehlermeldung errorMsg
in die interne Fehlertabelle geschrieben.
function cu.hasExtension( url, ext )
liefert true
, wenn die Internetadresse url
die Dateierweiterung ext
besitzt.
function cu.insertItem( tab, s, formatStr )
fügt die formatierte Zeichenkette s
in die Tabelle tab
ein, wenn sie nicht leer ist.
function cu.insertItem2( tab, s1, s2, formatStr )
fügt eine formatierte Zeichenkette aus den Teilzeichenketten s1
und s2
in die Tabelle tab
ein, wenn sie beide nicht leer sind.
function cu.formatItem( s, formatStr )
liefert die formatierte Zeichenkette s
, wenn sie nicht leer ist.
function cu.formatItem2( s1, s2, formatStr )
liefert eine formatierte Zeichenkette aus den Teilzeichenketten s1
und s2
, wenn sie beide nicht leer sind.
function cu.templateStyles( frame )
stellt die templatestyles
für die Vorlagen bereit, die das Modul Modul:Citation
benutzen.
function cu.getNbnCheckDigit( urn )
liefert die Prüfziffer für urn:nbn
-Identifikatoren der Länder at
, ch
, de
und fi
.
function cu.check_UrnNbn( urn )
prüft, ob die urn
über die korrekte Prüfziffer verfügt.
Verwendung in anderen Modulen
[Bearbeiten]Dieses Modul ist notwendig für die Ausführung folgender Module. Bei Anpassungen sollte die Funktionstüchtigkeit der folgenden Module geprüft werden. Benutze dazu auch diese Tracking-Kategorie um Fehler zu finden, die sich dann auf Artikel auswirken:
- Citation
- Modul benötigt das Modul Citation/utilities – Wartungskategorie, in der nochmals alle Module gelistet sind, die von diesem Modul abhängig sind.