Benutzer:PerfektesChaos/js/WikiSyntaxTextMod/usage/replace

In der js-Datei des Benutzers sind die gewünschten Ersetzungsausdrücke vor dem mw.loader.load zu definieren in den Komponenten des Anwendungsobjekts

1. mw.libs.WikiSyntaxTextMod.config.mod.comment = Kommentar-Ersetzungsliste;
2. mw.libs.WikiSyntaxTextMod.config.mod.template = Vorlagen-Ersetzungsliste;
3. Link-Ersetzungslisten
   • mw.libs.WikiSyntaxTextMod.config.mod.url
   • mw.libs.WikiSyntaxTextMod.config.mod.wikilink
4. mw.libs.WikiSyntaxTextMod.config.mod.plain = Text-Ersetzungsliste;

Die Reihenfolge der Listen-Definitionen ist unwesentlich. Die Ersetzungen werden in der vorstehend nummerierten Reihenfolge ausgeführt; vorangegangene Ersetzungen werden dabei berücksichtigt.

Ausgangslage ist die vollständige Syntaxpolitur mit allen Normalisierungen der Zeichenkodierung und Formatierungen.

Formal gesprochen sind alle Ersetzungslisten Arrays. Die einzelnen Ersetzungen geschehen in Reihenfolge der Elemente; vorangegangene Ersetzungen wirken auf nachfolgende Aktivitäten. Jedes Element ist eine Transformation, bestehend aus einem Suchkriterium, einem Ersetzungsausdruck und möglichen Flags.

Bevor eine der genannten Komponenten zugewiesen kann, muss das Anwendungsobjekt definiert worden sein. Ein leeres Gerüst dafür wird einmalig wie folgt aufgebaut:

mw.libs.WikiSyntaxTextMod  =  { config:  { lang: { },
                                           load: { },
                                           mod:  { },
                                           page: { }
                                         }
                              };

Jede Ersetzungsregel ist ein Array mit zwei oder drei Elementen:

1. Reguläre Ausdrücke (RegExp) sind notwendig, um die gesuchten Zeichenketten vorzugeben.
   • Reguläre Ausdrücke sind ausschließlich als Zeichenketten, nicht aber als sogenannte „Literale“ möglich.
2. Ein Ersetzungsausdruck ist der zum gefundenen RegExp passende neue Text.
   Möglich ist die Ersetzung von Klammerausdrücken mit $1, $2, usw. für die erste, zweite Klammer.
   • Ein Sonderfall ist die Verwendung einer Funktion an Stelle eines statischen Ersetzungstextes.
3. flag (optional)
   Steuerung der Suche
   • Mögliche Werte:
     "" – Einmaliges Auffinden, Groß-/Kleinschreibung beachten
     "g" – Globale Suche, Groß- und Kleinschreibung beachten
     "i" – Einmaliges Auffinden, Groß-/Kleinschreibung ignorieren (i = ignore case)
     "gi" – Globale Suche, Groß-/Kleinschreibung ignorieren
   • Der Standardwert ist dem Anwendungsfall zu entnehmen.
     • "g" bei Operationen im gesamten Wikitext
     • "" bei Aktivitäten auf einem Bezeichner, wie Vorlagen-Name oder Vorlagen-Parameter-Name

Ein Beispiel für die kontextsensitive dynamische Verkettung wird bei Ligaturen gegeben.

Standardmäßig werden die Definitionen sowie deren Elemente auf formale Zulässigkeit geprüft. Dies empfiehlt sich in einer ersten Testphase. Funktioniert dann alles wunschgemäß, kann die Überprüfung abgeschaltet werden (true), um die Prozedur nicht unnötig zu beschäftigen.

mw.libs.WikiSyntaxTextMod.config.mod.tested  =  true;

Mittels der folgenden Benutzerkonfiguration wird ein Bearbeitungskommentar eingefügt, falls einer der Modifizierungs-Ausdrücke zu einer Ersetzung geführt hat:

mw.libs.WikiSyntaxTextMod.config.mod.summary  =  "linkfix/BKL";

Diese Funktion ermöglicht statt eines statischen Ersetzungs-Ausdrucks die dynamische Generierung einer Zeichenkette, die in ihrem Format dem statischen Ersetzungsausdruck entsprechen muss.

Der besondere Vorteil ist, dass auch von außen nicht bekannte Informationen über Kategorien und anderes einfließen können. So kann in der deutschsprachigen Wikipedia geprüft werden auf die beiden Komponenten

• .l10n.proj.dewiki.got.at – österreichbezogen
• .l10n.proj.dewiki.got.ch – schweizbezogen

Die Joker-Funktion ist eine benutzerdefinierte Funktion, mit der nach Abschluss aller kontrollierten, behüteten Ersetzungen auf den resultierenden Wikitext eine globale Zeichenketten-Ersetzung vorgenommen werden kann.

Wie beim Namensgeber reicht die Palette vom albernen Spaßvogel, der mit infantilen Streichen piesackt, bis zum gewalttätigen Psychopathen.