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 {{#if:}}-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

  1. CodeMirror und WikiEditor aktivieren.
  2. TemplateData für wichtige Vorlagen pflegen.
  3. TemplateWizard installieren und aktivieren.
  4. Eigene Toolbar-Buttons in MediaWiki:Common.js anlegen.
  5. (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.