Handbuch:Erweiterung/VisualEditor

Der visuelle Editor von BlueSpice basiert auf der MediaWiki-Erweiterung VisualEditor. Er ermöglicht die Formatierung und das Einfügen von Seiteninhalten ohne Wikitext-Kenntnisse.

Was ist der VisualEditor?

Visueller Editor (VisualEditor)

Der visuelle Editor (VisualEditor) ist für die Bearbeitung von Wikiseiten optimiert. Wichtige Merkmale und Funktionen sind:

1. Seitenstrukturierung mit Überschriften
2. einheitliche Textformatierung
3. Verlinkung von Inhalten
4. Einfügen von Spezialinhalten (Dateien/Medien, Tabellen, Vorlagen, Magische Wörter)
5. Seitenoptionen einstellen

Beim Erstellen oder Bearbeiten einer Seite ist man gleich im visuellen Bearbeitungsmodus. Wer mit der Codesprache von MediaWiki ("Wikitext") vertraut ist und entsprechend im Quelltext der Seite arbeiten möchte, kann über die Funktion "Editor wechseln" bequem umschalten:.

Moduswechsel

Textbearbeitung

Typische Textformatierungen wie fett, kursiv, oder Textfarbe sind bereits während der Texteingabe möglich. Wenn Sie mit der Maus Text formatieren, sehen Sie im Anschluß ein Minimenü mit den wichtigsten Formatierungselementen. Mit einem Klick kann die gewünschte Formatierung ausgewählt werden. Dies ist besonders schnell, wenn man zum Beispiel die Textfarbe ändern will:

Changing text colors

Inhalte über die Zwischenablage einfügen

rück-gängig

Wenn Sie Inhalte aus Ihrer Zwischenablage einfügen (z. B. aus MS Word oder MS Excel kopiert), fügen Sie normalerweise auch viele unnötige Formatierungs-Tags aus der ursprünglichen Anwendung ein. Um dies zu vermeiden, sollten Sie den Inhalt als Klartext einfügen.

Wenn Sie bereits Text eingefügt haben, der zu einer unerwünschten Formatierung geführt hat, können Sie die Funktion "rückgängig" in VisualEditor verwenden. Dies entefernt den neuen Inhalt, wenn Sie die Seite noch nicht gespeichert haben oder zwischen visueller Bearbeitung und Quelltextbearbeitung gewechselt haben.

Verwenden Sie in die Tastenkombination Strg + Umschalt + v, um den Inhalt stattdessen als Klartext einzufügen.

Shortcuts

Wenn Sie mehrere Formatierungen gleichzeitig anwenden wollen, geht das über Tastaturkürzel oft am schnellsten. Um Text zum Beispiel fett und kursiv anzuzeigen, markieren Sie den Text und drücken Sie die Tastenkombinationen Strg+b (für das Englische "bold") und Strg+i (für "italics"). Auch ein Link lässt sich schnell über Strg+k einfügen. Ein erneutes Drücken von Strg+b hebt den Fettdruck wieder auf. Mehrere Formatierungen lassen sich nach der Textauswahl über Strg+M kombiniert entfernen.

Alle Editor Funktionen, für die es Tastaturkürzel gibt, sind entsprechend gekennzeichnet.

Menüpunkte mit Tastaturkürzeln

Hinweis:Eine komplette Liste der Tastaturkürzel finden Sie unter "Tastaturkürzel" im Hilfemenü des Visual Editors (dem Fragezeichen-Menüpunkt).

Externe Inhalte einfügen

Viele typische Seitenelemente wie Bilder, Dateien und Tabellen können Sie über das "Einfügen"-Menü in Ihre Seite einbinden.

• Dateiformate mit Vorschau-Option: jpg/jpeg, png, gif, pdf
• Dateien ohne Vorschau-Option werden als Textlink eingebunden (z.B. Office-Formate)
• Dateien können beim Hochladen direkt im Mediendialog mit Namensräumen und Kategorien verknüpft werden

Wenn Sie mehr zum Einfügen dieser Elemente erfahren möchten, öffnen Sie die entsprechende Hilfeseite:

• Bilder
• Dateien (PDF, xls, doc, ...)
• Tabellen
• Vorlagen

Typisch Wiki!

Einige Funktionen im Menü "Einfügen" sind aus der traditionellen Textverarbeitung wenig bekannt, sind aber ganz typisch für die Arbeit mit einem Wiki. Daher werden Sie hier kurz vorgestellt. Tiefer eintauchen können Sie auf den jeweiligen Einzelseiten:

• Kommentar: Fügen Sie Kommentare in die Seite ein. Diese sind nur im Quelltext sichtbar.
• Magisches Wort: Wiki Funktionen wie Unterschrift, Wörterzähler, Kategorienbaum oder sogar Prozessdiagramme mit draw.io lassen sich als "magisches Wort" integrieren.
• Deine Unterschrift: Funktioniert nur auf Seiten, die Unterschriften erlauben. Seiten im Namensraum "Seiten" gehören nicht dazu.
• Galerie: Eine schlichte Bildergalerie kann so manchen Prozessablauf sinnvoll unterstützen.
• Codeblock: Programmiercode wird hier sauber in Codeblocks formatiert dargestellt, optional mit Zeilenangaben.
• Einzelnachweisliste:
• Chemische Formel: Das Rendering von chemischen Formeln verwendet einen externen Dienst über die REST-API von Wikimedia.
• Math Formel: Es öffnet sich ein Editor zum Eingeben einer mathematischen Formel. Mehr Info auf MediaWiki

Bearbeitungsmodus wechseln

Beim Erstellen oder Bearbeiten einer Seite wird die Seite im visuellen Bearbeitungsmodus geladen. Wenn Sie mit der einfachen Codesprache von MediaWiki ("Wikitext") vertraut sind, können Sie mit der Schaltfläche "Editor wechseln" in den Quellbearbeitungsmodus wechseln.

Bearbeitungsmodus wechseln

Hinweis:Ungespeicherte Änderungen können nach dem Wechsel zwischen visueller und Quelltextbearbeitung nicht über die Schaltfläche "rückgängig" wiederhergestellt werden!

MediaWiki Referenz

Da der visuelle Editor eine Standard MediaWiki Erweiterung ist, können Sie auch eine komplette Dokumentation der Funktionalität auf MediaWiki lesen.

Hier im BlueSpice Helpdesk geben wir daher nur kurze Hinweise und Tipps zur Nutzung des Editors.

Funktionen

Im BlueSpice Editor stehen folgende Optionen zur Verfügung:

Textformatierung

Textformatierung
Undo-Funktion	Linker Pfeil: Letzte Aktion rückgängig machen (ausgegraut: es gibt noch keine letzte Aktion) Rechter Pfeil: Letzte Aktion wiederherstellen (ausgegraut: es gibt noch nichts zum Wiederherstellen)
Absatzformatierung	Hier kann Text als Überschrift oder bestimmter Absatztyp definiert werden. Hinweis: Wenn Sie in einer Tabelle arbeiten, ändern sich die Optionen entsprechend (Inhaltszelle und Überschriftszelle): Datei:Handbuch:VisualEditor-absatz2.png
Zeichenformatierung	Falls vor dem Klicken auf das "A" und auf eine Schaltfläche kein Text ausgewählt worden ist, wird der Text ab der aktuellen Position des Cursors entsprechend formatiert. (Mehr Info auf MediaWiki)
Hyperlink einfügen	Wenn kein Text ausgewählt wurde, bevor der Hyperlink Dialog geöffnet wurde, wird der Link mit einer Nummer generiert: [1] Um die Hyperlink-Beschreibung nachträglich zu ändern, klicken Sie einfach auf den Link, um das Bearbeitungsmenü zu öffnen. In einer Tabelle müssen Sie eventuell erst auf die Zelle doppelklicken und dann noch einmal auf den Hyperlink klicken.
Zitat	Das Zitat-Menü dient dazu, Verweise (auch Einzelnachweise oder Fußnoten genannt) innerhalb des Textes einzufügen.
Struktur

Einfügen spezieller Inhalte

Einfügen spezieller Inhalte
Menü Einfügen Datei:Handbuch:VisualEditor-einfügen.png	Über das Menü "Einfügen" können Sie verschiedene Medien (Bilder, Videos) und Textformate einfügen:
Medien Datei:Handbuch:VE Medien.png	Einfügen von Bildern und Videos (Details auf MediaWiki)
Vorlagen	Eine Vorlage in die Seite einbinden.
Tabellen	Tabellen sind ein wichtiges Werkzeug, um Seiten ansprechend zu formatieren. Wir haben viele Tipps zur richtigen Nutzung von Tabellen.
Kommentar	Kommentare sind für Leser nicht sichtbar, sondern nur im Bearbeitungsmodus. Ein Kommentar kann überall auf einer Seite eingefügt werden. Der Kommentar kann durch Anklicken bearbeitet werden. Und so sieht ein Kommentar aus: Datei:Handbuch:VisualEditor-kommentar.png
Galerie	Bilder können mit der Galerie Funktion als Bildersatz kombiniert auf einer Seite dargestellt werden.
Magisches Wort	Mit einem "Magischem Wort" können Sie bestimmte Variablen oder sogenannte Verhaltensschalter in Ihrer Seite einbinden. Zum Beispiel können Sie die Wortzahl anzeigen lassen: Mehr zur Funktion "Magisches Wort". Übersicht aller Magic Words im visuellen Editor.
Deine Unterschrift	Diese Option kann nur in Diskussionen verwendet werden. Hiermit kann an jeder Stelle einer Diskussion die eigene Signatur angefügt werden.
Code-Block	Mit Codeblock können verschiedene Code-Beispiele eingegeben werden, wie z.B. in HTML-Syntax. Der Code wird dann ordentlich formatiert dargestellt:

<span style="color:red">roter Text</span>
Einzelnachweisliste
Chemische Formel
Math-Formel	Es öffnet sich ein Editor zum Eingeben einer mathematischen Formel. Mehr Info auf MediaWiki
Sonderzeichen

Seitenoptionen

Seitenoptionen
Optionsmenü Datei:Handbuch:VisualEditor-optionen.png	Das Optionsmenü erlaubt die Bearbeitung aller Seiteneinstellungen.
Optionen Datei:Handbuch:VE Optionen neu.png	Über diese Schaltfläche können die Seiteneinstellungen und Seiteninformationen innerhalb eines Dialogfensters gleichzeitig aktualisiert werden.
Kategorien Datei:Handbuch:VE Kategorien.png	Hier teilen Sie die Seite den gewünschten Kategorien zu. Die Seite erscheint dann entsprechend auf allen verknüpften Kategorienseiten.
Seiteneinstellungen	Weiterleitung der Seite: Wenn die Seite weitergeleitet wird, wird der Inhalt der Seite nicht mehr angezeigt, sondern es wird direkt die Zielseite geladen. Über diese Einstellung kann auch das Inhaltsverzeichnis am Seitenanfang angezeigt oder entfernt werden. Das Inhaltsverzeichnis wird automatisch durch die Überschriften auf der Seite generiert. Ab drei Überschriften erscheint das Inhaltsverzeichnis standardmäßig automatisch.
Erweiterte Einstellungen	Suchmaschine: Hier kann die Seite von der Indexierung durch die Suchmaschine ausgeschlossen werden. Abschnitt einfügen: Einstellung für die Abschnittsbearbeitung über die Bearbeiten-Schaltfläche in der Kopfleiste. Anzeigetitel: Hier kann ein Anzeigetitel eingegeben werden (Displaytitle), der vom Seitennamen abweicht.
Sprachen
Verwendete Vorlagen	Zeigt die in der Seite aktiv benutzten Vorlagen.
Als rechts-nach-links ansehen	Unterstützung für Sprachen, die von rechts nach links gelesen werden. Das Anklicken dieser Schaltfläche formatiert den Seitentext rechtsbündig. Erneutes Anklicken setzt den Text wieder linksbündig.
Suchen und ersetzen	Wörter oder Zeichen können direkt auf der Seite gesucht und ersetzt werden. Über die Schaltfläche "Rückgängig machen" kann die Änderung aufgehoben werden.

Troubleshooting: Visuelle Bearbeitung ist deaktiviert

Wenn Ihnen nur die Quelltextbearbeitung angezeigt wird, wenden Sie sich bitte an einen Administrator Ihres Wikis. Folgende Einstellungen müssen in diesem Fall überprüft werden:

• Globale Einstellung über den Konfigurationsmanager
• Einstellungen in der Namensraumverwaltung

Weiterführende Links

• Links einfügen

Formatierungssprache für Wikiseiten. Der Wikitext kann im Quelltextmodus angesehen und bearbeitet werden.

Im Wiki abgetrennter Bereich, dessen Inhalte über spezielle Berechtigungen gelesen und bearbeitet werden können. Einen Namensraum erkennt man an einem Präfix vor dem Artikeltitel.

Eine Weiterleitung hilft, Duplikate und inhaltlichen Wildwuchs zu vermeiden. Weiterleitungen werden z.B. für Seiten eingerichtet, deren Inhalte veraltet sind, die nicht mehr gebraucht werden oder mit den Inhalten anderer Seiten übereinstimmen. Sie verweisen in der Regel auf die aktuellste Beschreibung eines Themas und vermeiden unnötige Arbeit im Fall von Ab-kürzungen, Synonymen, Plural/Singular-Duplikaten, Umbenennungen oder Verschiebungen.

Technische Referenz: VisualEditor

---

Feedback zur Dokumentation ist im Community-Forum möglich.