Extension:CharInsert/de

Die Erweiterung CharInsert erlaubt 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 eiber 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:

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

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.

Erweiterte Installation
Wichtig: Die Erweiterung Helferlein 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). The below stylesheet was used for that, copy it to your to apply the same styling.

Alternatively, you can choose a style closer to the Wikimedia Design Style Guide and the WikimediaUI theme:

Skripte
If you have many CharInsert links, one could use JavaScript to put them in separate groups and allow dynamic switching with a dropdown menu. For example to separate diacritical characters from wikisyntax etc. Several sites (such as mediawiki.org, de.wikipedia.org and en.wikipedia.org) have done this. They all implemented it in different ways though. Documented below is the way it is done on mediawiki.org:

1. Wrap all the charinsert tags on MediaWiki:Edittools into a container and give it a descriptive, unique, ID (for example "mw-edittools-charinsert") :
 * 2. Wrap each individual block of charinserts into tags like this:


 * Note:
 * Don't change the word 'mw-edittools-section'
 * The text behind "data-section-title=" will identify this group in the dropdown menu.
 * Make sure there is one group without the ' ' directive: That will be the default choice in the dropdown menu. On this site, it is called 'Standard' while the other groups are named by the language for which the characters are significant.
 * 3. Copy the contents of MediaWiki:Gadget-Edittools.js to an equally named page on your own wiki
 * 4. Add the following code to your :


 * Edittools[ResourceLoader|default]|Edittools.js

CharInsert-Menü der englischsprachigen Wikipedia
For implementing CharInsert menu like the one used on the English Wikipedia, either export gadgets: Charinsert-core, Charinsert-styles, and Charinsert and then import them on your own wiki through Special:Import or if you want to do it manually, copy the following four interface pages to your wiki:


 * MediaWiki:Gadget-charinsert-core.js (Wikipedia) - Main JavaScript file.
 * MediaWiki:Gadget-charinsert-styles.css (Wikipedia) - Creates surrounding boxes around the symbols/characters giving them the look of buttons.
 * MediaWiki:Gadget-charinsert.js (Wikipedia) - CharInsert loader.
 * MediaWiki:Gadget-charinsert (Wikipedia) - For the text shown in user preferences' gadgets section.

Note: This particular English Wikipedia character set also contains templates, which will need to be defined separately, if they are to be used on your Wiki.
 * In your MediaWiki:Gadgets-definition, add the following definitions:
 * 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) - Only for users with JavaScript turned off or unsupported (which disables the WikiEditor extension too), therefore not really necessary or useful either. It only shows symbols/characters as simple text below the editor window, which can then be copy-pasted and thus be of some help to editors. Apparently, it does not get activated in English Wikipedia for disabled JavaScript.

 English Wikipedia Solution checked on: November 6, 2018