Hilfe:Editor-Anpassung in MediaWiki – Parser-Erweiterungen per Klick
Aus CMO
Ziel
Der Editor in MediaWiki soll um Buttons erweitert werden, mit denen häufige Parserfunktionen (z. B. ) eingefügt werden können.
Zusätzlich können Vorlagen und Syntax-Hilfen über Erweiterungen komfortabel bedient werden.
Nützliche Erweiterungen
- WikiEditor
- Grundlegende Toolbar. Lässt sich um eigene Buttons erweitern.
- CodeMirror
- Syntax-Highlighting im Wikitext-Editor.
- TemplateData
- Beschreibt die Parameter von Vorlagen.
- TemplateWizard
- Klick-Dialog zum Einfügen und Ausfüllen von Vorlagen.
- VisualEditor (optional)
- WYSIWYG-Editor. Mit TemplateData/TemplateWizard besonders stark.
Parserfunktionen als Buttons hinzufügen
1. WikiEditor aktivieren
In LocalSettings.php:
wfLoadExtension( 'WikiEditor' );
$wgDefaultUserOptions['usebetatoolbar'] = 1;
$wgDefaultUserOptions['usebetatoolbar-cgd'] = 1;
2. Toolbar-Buttons anlegen
In MediaWiki:Common.js oder als Gadget:
mw.loader.using('ext.wikiEditor', function () {
if (mw.config.get('wgAction') !== 'edit' && mw.config.get('wgAction') !== 'submit') return;
$(function () {
$('#wpTextbox1').wikiEditor('addToToolbar', {
section: 'advanced',
group: 'format',
tools: {
parser_if: {
label: 'Parser: #if',
type: 'button',
icon: 'https://upload.wikimedia.org/wikipedia/commons/3/38/OOjs_UI_icon_function-ltr.svg',
action: {
type: 'encapsulate',
options: {
pre: '{{#if: ',
peri: 'Bedingung',
post: ' | dann | sonst }}'
}
}
}
}
});
});
});
Nach dem Speichern und Neuladen erscheint im Editor ein Button, der automatisch den -Block einfügt.
Weitere Buttons (z. B. für #switch, #time, #expr) können nach demselben Muster hinzugefügt werden.
Komfort-Funktionen für Vorlagen
- TemplateData
- Erstellt maschinenlesbare Beschreibungen der Parameter einer Vorlage.
- TemplateWizard
- Zeigt beim Einfügen von Vorlagen einen Dialog zum komfortablen Ausfüllen der Parameter an.
Beispiel-Vorgehen
- CodeMirror und WikiEditor aktivieren.
- TemplateData für wichtige Vorlagen pflegen.
- TemplateWizard installieren und aktivieren.
- Eigene Toolbar-Buttons in
MediaWiki:Common.jsanlegen. - (Optional) VisualEditor installieren, wenn WYSIWYG bevorzugt wird.
Fazit
Mit diesen Erweiterungen und ein paar Zeilen JavaScript lässt sich der Standard-Editor zu einer leistungsfähigen Arbeitsumgebung für komplexe Parser- und Vorlagenstrukturen ausbauen.