Extension:CharInsert/de

MediaWiki-Erweiterungen – Liste

CharInsert Erscheinungsstatus: stable
Einbindung	Tag, Page action
Beschreibung	Erzeugen von JavaSkript-basierten Eingabefeldern.
Author(s)	Brion Vibber
Lizenz	GPL
Download	Download snapshot Subversion [Help] Browse source code
Hooks verwendet ParserFirstCallInit

CharInsert ist eine Erweiterung, welche JavaScript-Links erzeugt. Diese Links dienen dazu einen vordefinierten Text beim Anklicken in ein Textfeld einzufügen.

Üblicherweise werden diese Links für die Systemmeldungen bei MediaWiki:Edittools genutzt. Ein Beispiel findet sich hier: Wikipedia:MediaWiki:Edittools).

Syntax

Geben Sie innerhalb von <charinsert>-Tags eine durch Leerzeichen getrennte Auflistung von Zeichen oder anderen Tags an, die beim Editieren in das Textfeld eingefügt werden sollen.

Zusätzlich können sie das + -Symbol innerhalb des einzufügenden Textes nutzen um:

• den im Textfeld markierten Text an der entsprechenden Stelle einzufügen oder
• den Cursor nach dem Einfügen an dieser Stelle zu platzieren.

Sie müssen Leerzeichen bzw. Templates mit dem <nowiki>-Tag umschließen:

<charinsert><nowiki>== + ==</nowiki></charinsert>
bzw.
<charinsert><nowiki>{{template}}</nowiki></charinsert>

Beispiel

Bitte beachten Sie, dass das anklicken der nachfolgenden Link eine Auswirkungen haben wird, da es kein dazugehöriges Textfeld gibt.

<charinsert>Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź</charinsert>
[<charinsert>== + ==</charinsert>]
[<charinsert>{{template}}</charinsert>]

ergibt:
Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź [== ==] [{{template}}]

Hinweise

• Die erzeugten JavaSkript-Links funktionieren auch in anderen Bereichen ausser dem Bearbeitungsfenster. So zum Beispiel bei MediaWiki:Copyrightwarning oder MediaWiki:Newarticletext, aber auch auf Seiten mit vorgefüllten Eingabefeldern und sogar bei der Vorschau.
• Sie können beispielsweise auch genutzt werden um bei MediaWiki:Uploadtext Bildbeschreibungsvorlagen einzufügen.
• Die erzeugten JavaSkript-Links nutzen die Funktion insertTags() aus wikibits.js.
• Im Gegensatz zu den Werkzeugschaltflächen im oberen Bereich verfügt diese Erweiterung nicht über die Möglichkeit einzufügenden "Beispieltext" zu definieren.

Installation

• Laden Sie die letzte Version herunter und entpacken Sie diese in das Extension-Verzeichnis.
• Fügen Sie die folgende Zeile am Ende der LocalSettings.php-Datei ein:

  require_once("$IP/extensions/CharInsert/CharInsert.php");
  

• Ergänzen Sie <charinsert></charinsert> Tags in Mediawiki:Edittools oder einer anderen passenden Systemnachrichtenseite, die auf Edit/Create-Seiten angezeigt wird, etwa die Copyright-Warnungen. Damit kann man bestimmen, wo auf der Bearbeiten-Seite die "CharInsert"-Listen erscheinen.

Fortgeschrittene Installation

• Schließen Sie die Charinsert-Listen in <div class="my-buttons"></div> Tags ein. Fügen Sie dann Stylesheets in Mediawiki:Common.css ein, um das Aussehen der von CharInsert erzeugten Links anzupassen. Diese Site (www.mediawiki.org) lässt die Links wie Buttons aussehen. Ein anderes Beispiel ist hier wiedergegeben, es erzeugt eine Box wie im nebenstehenden Screenshot gezeigt.

 
/******* Extra buttons for 'edittools' (modified from www.mediawiki.org/MediaWiki:Common.css) ********/
.my-buttons {
        /* padding: 1em; */
        /* margin:5px; */
}
.my-buttons a {
        color: black;
        background-color: #c0d0e0 ;
        font-family:monospace;
        font-size: 115%;
        text-decoration: none;
        border: thin #069 outset;
        line-spacing:5pt;
}
.my-buttons a:hover {
        background-color: #d0e0f0;
        border-style:outset;
}
.my-buttons a:active {
        background-color: #e0f0e0;
        border-style: inset;
}

• Mit Javascript kann man außerdem eine Dropdownbox erzeugen, mit der man verschiedene Gruppen von CharInsert-Links auswählbar macht, z.B. wenn nicht genug Platz auf dem Bildschirm ist oder wenn man Sonderzeichen von Wiki-Syntax-Hilfen trennen möchte usw. Diese Site, die englische und die deutsche Wikipedia implementieren das jeweils verschieden. Hier wird die Methode auf mediawiki.org ohne Modifikation beschrieben (Stand Januar 2011, MW 1.16):

1. Umschließen Sie die gesamte Liste von Charinsert-Tags mit diesem div (die Angabe bei "id=" ist die wichtigste):

<div id="specialchars" class="my-buttons" style="margin-top:10px; border:1px solid #aaaaaa; padding:1px; text-align:center; font-size:110%;" title="Click on the wanted special character.">
...
</div>

2. Schließen Sie jeden einzelnen Block von Charinsert-Tags in ein p-Tag ein:

<p class="specialbasic" id="Wiki-Syntax" style="display:none">
...
</p>

Hinweis:

• Das Wort 'specialbasic' sollte nicht geändert werden.
• Der Text hinter "id=" ist der Name des Blocks, der im Dropdown-Menü angezeigt wird.
• Genau eine Gruppe muss ohne 'display:none' spezifiziert sein. Das ist dann die Defaultauswahl im Dropdown-Menu. Hier auf www.mediawiki.org ist das 'Standard' während die anderen Sonderzeichen nach Sprachen sortiert und benannt sind.

3. Kopieren Sie die beiden Seiten Mediawiki:Edittools.js und Mediawiki:Editpage.js in Ihr Wiki. Vermutlich müssen Sie die beiden Seiten neu anlegen.

4. Schreiben Sie den folgenden Code nach Mediawiki:Common.js:

var load_edittools = true;
// extra drop down menu on editing for adding special characters
importScript( 'MediaWiki:Edittools.js' );
// Editpage scripts
if( wgAction == 'edit' || wgAction == 'submit' ) {
        importScript( 'MediaWiki:Editpage.js' );
}

Hinweis:

• Die JS Programme beinhalten eigene Definitionen für "my-buttons". Die obige eigene Definition wird dadurch wirkungslos.
• Die JS Programme sind wahrscheinlich MW-versionsabhängig. In einem Wiki mit MW 1.15.3, kopiert von hier unter 1.16, haben sie funktioniert.