Extension:CharInsert/de

Die Erweiterung CharInsert ermöglicht es, JavaScript-Links zu erstellen, die beim Anklicken einen vordefinierten Text in das Textfeld einfügen.

Diese Links werden normalerweise in den Systemnachrichten MediaWiki:Edittools (Beispiel in diesem Wiki) verwendet.

Syntax
Nutze -Tags mit einer durch Leerzeichen getrennten Liste von Zeichen oder Markierungen, deren Einfügung du ermöglichen möchtest.

Du kannst innerhalb einer Markierung das Zeichen + verwenden, um eine Stelle zu definieren:


 * an der der ausgewählte Text eingefügt wird oder
 * an der der Mauszeiger platziert wird, wenn kein Text ausgewählt wurde.

Du musst Vorlagen und Leerzeichen in einschließen:



Nutzung und Beispiel-Ausgabe


Einzelne Zeichen
Einzelne Zeichen werden einfach zwischen den "charinsert"-Markierungen aufgelistet.

ergibt



Kombinierte Zeichen
Kombinierte Zeichen werden zwischen den "charinsert"-Markierungen aufgelistet und durch das Zeichen "+" verbunden.

ergibt



Angezeigten Text ändern
Der angezeigte Text kann mit dem -Attribut geändert werden. (In solchen Fällen muss man einzelne -Markierungen pro Zeichen nutzen, um unterschiedliche angezeigte Texte angeben zu können.)

ergibt

Anmerkungen

 * Generierte JavaScript-Links funktionieren auch in anderen Bereichen um das Bearbeitungsfenster herum, z. B. in MediaWiki:Copyrightwarning oder MediaWiki:Newarticletext, auf einer Seite, die mit einer geladen wird, und sogar aus der Textvorschau heraus.
 * Sie können auch in MediaWiki:Uploadtext genutzt werden, um Vorlagen für die Bildbeschreibung einzufügen.
 * Im Gegensatz zu den Schaltflächen der Werkzeugleiste oben bietet diese Erweiterung keine Möglichkeit, um "Beispieltext" einzufügen.
 * Nutze, um neue Zeilen (\n) hinzuzufügen.
 * Fasse Leerzeichen in  ein, sofern dies nötig ist.
 * Füge  in MediaWiki:Edittools ein.

Installation


Erweiterte Installation
Wichtig: Die muss installiert sein, damit dies funktioniert.

Aussehen


Um das Aussehen der Liste mit einfügbaren Zeichen zu ändern, fasse den Inhalt deiner Bearbeitungswerkzeuge mit  und  ein und füge das Aussehen für sie in deine  ein. Diese Seite (www.mediawiki.org) nutzt dies, damit die Links wie Schaltflächen aussehen (wie im Bildschirmfoto an der Seite zu sehen). Das Stylesheet unten wurde dafür genutzt, kopiere es in deine, um das gleiche Aussehen anzuwenden.

Alternativ kannst du ein Aussehen wählen, das sich enger an der Wikimedia-Design-Anleitung und dem WikimediaUI-Thema orientiert:

Skripte
Wenn du viele CharInsert-Links hast, kannst du JavaScript nutzen, um sie in unterschiedliche Gruppen aufzuteilen und einen dynamischen Wechsel mit einem ausklappbaren Menü zu ermöglichen. Zum Beispiel, um diakritische Zeichen von Wiki-Syntax etc. zu trennen. Einige Seiten (wie mediawiki.org, de.wikipedia.org und en.wikipedia.org) haben dies getan. Sie sind jedoch alle auf unterschiedliche Arten implementiert. Die folgende Dokumentation schildert, wie es auf mediawiki.org gemacht wird:

1. Schließe alle CharInsert-Markierungen auf MediaWiki:Edittools in ein und gib dem ganzen eine beschreibende, einzigartige ID (zum Beispiel "mw-edittools-charinsert"):
 * 2. Schließe jeden CharInsert-Block wie folgt in -Markierungen ein:


 * Note:
 * Ändere das Wort 'mw-edittools-section' nicht
 * Der Text hinter "data-section-title=" wird diese Gruppe im Ausklappmenü identifizieren.
 * Stelle sicher, dass es eine Gruppe ohne die Anweisung ' ' gibt: Das ist die Standardauswahl für das Ausklappmenü. Auf dieser Seite heißt es 'Standard', während die anderen Gruppen nach der Sprache benannt sind, für die die Zeichen von Bedeutung sind.
 * 3. Kopiere den Inhalt von MediaWiki:Gadget-Edittools.js auf eine Seite mit dem gleichen Namen in deinem Wiki
 * 4. Füge den folgenden Code in deine ein:


 * Edittools[ResourceLoader|default]|Edittools.js



CharInsert-Menü der englischsprachigen Wikipedia
Um das Menü CharInsert so zu implementieren, wie es in der englischsprachigen Wikipedia genutzt wird, exportiere entweder die Helferlein: Charinsert-core, Charinsert-styles und Charinsert und importiere sie dann über Special:Import in dein eigenes Wiki oder kopiere die folgenden vier Benutzeroberflächenseiten in dein Wiki, wenn du es manuell machen möchtest:


 * MediaWiki:Gadget-charinsert-core.js (Wikipedia) - Haupt-JavaScript-Datei.
 * MediaWiki:Gadget-charinsert-styles.css (Wikipedia) - Erstellt Boxen um die Symbole/Zeichen herum, sodass sie wie Schaltflächen aussehen.
 * MediaWiki:Gadget-charinsert.js (Wikipedia) - Lädt CharInsert.
 * MediaWiki:Gadget-charinsert (Wikipedia) - Für den Text, der im Abschnitt Helferlein in den Benutzereinstellungen angezeigt wird.

Note: Diese Zeichen für die englischsprachige Wikipedia enthalten auch Vorlagen, die separat definiert werden müssen, wenn du sie auch in deinem Wiki nutzen möchtest.
 * Füge die folgenden Definitionen in deine MediaWiki:Gadgets-definition ein:
 * charinsert[ResourceLoader|default|peers=charinsert-styles]|charinsert.js
 * charinsert-core[ResourceLoader|hidden|dependencies=jquery.textSelection,user,mediawiki.storage]|charinsert-core.js
 * charinsert-styles[ResourceLoader|hidden|type=styles]|charinsert-styles.css
 * MediaWiki:Edittools (Wikipedia) - Nur für Benutzer, die JavaScript deaktiviert haben oder es nicht unterstützen (wodurch die Erweiterung WikiEditor ebenfalls deaktiviert wird), weshalb es weder wirklich nötig noch hilfreich ist. Zeigt nur Symbole/Zeichen als einfachen Text unter dem Bearbeitungsfenster an, der dann kopiert und eingefügt werden kann, was für Autoren hilfreich sein kann. Dies wird in der englischsprachigen Wikipedia bei deaktiviertem JavaScript anscheinend nicht aktiviert.

Lösung der englischsprachigen Wikipedia geprüft am: '6. November 2018'