Erweiterung:CharInsert

MediaWiki-Erweiterungen

CharInsert Freigabestatus: stabil
Einbindung	Tag , Seitenaktivität , MeinWiki
Beschreibung	Ermöglicht es, JavaScript-Felder zum Einfügen von Zeichen zu erstellen.
Autor(en)	Brion Vibber (Brooke VibberDiskussion)
Letzte Version	continuous updates
Kompatibilitätspolitik	Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
Lizenz	GNU General Public License 2.0 oder neuer
Herunterladen	Erweiterung herunterladen Git [?]: Git master herunterladen Repository durchsuchen (Phabricator · GitHub) Ergänzungen und Änderungen Repository-Mitwirkende (GitHub) Code-Review
Tags ‎<charinsert>
Verwendete Hooks BeforePageDisplay ParserFirstCallInit
Quarterly downloads	70 (Ranked 71st)
Public wikis using	9,224 (Ranked 15th)
Übersetze die CharInsert-Erweiterung, wenn sie auf translatewiki.net verfügbar ist
Probleme	Offene Aufgaben · Einen Fehler melden

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 ‎<charinsert>-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 ‎<nowiki> einschließen:

<charinsert><nowiki>== + ==</nowiki> <nowiki>{{stub}}</nowiki></charinsert>

Nutzung und Beispiel-Ausgabe

Einzelne Zeichen

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

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

ergibt

Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź

Das Anklicken der Links wird keinen Effekt haben, da es keine Eingabe und kein Bearbeitungsfeld gibt.

Kombinierte Zeichen

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

<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>

ergibt

“” ‘’ «» ‹› „“ ‚‘ [[]] {{}}

Das Anklicken der Links wird keinen Effekt haben, da es keine Eingabe und kein Bearbeitungsfeld gibt.

Angezeigten Text ändern

MediaWiki Version:

≥ 1.38 Gerrit change 748823

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

<charinsert label="Lateinisches A">A</charinsert> <charinsert label="Kyrillisches А">А</charinsert> <charinsert label="Griechisches Alpha">Α</charinsert>

ergibt

Lateinisches A Kyrillisches А Griechisches Alpha

Das Anklicken der Links wird keinen Effekt haben, da es keine Eingabe und kein Bearbeitungsfeld gibt.

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 Inputbox 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 ‎<nowiki>...‎</nowiki> ein, sofern dies nötig ist.
• Füge ‎<charinsert>...‎</charinsert> in MediaWiki:Edittools ein.

Installation

• Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens CharInsert im Ordner extensions/ ablegen.
  Entwickler und Code-Beitragende sollten stattdessen die Erweiterung von Git installieren, mit:cd extensions/
git clone https://gerrit.wikimedia.org/r/mediawiki/extensions/CharInsert
• Folgenden Code am Ende deiner LocalSettings.php -Datei einfügen:

  wfLoadExtension( 'CharInsert' );
  

• Wenn du das Helferlein Edittools nutzt, aktualisiere den Code auf die aktuellste Version (≥ 3. April 2020)
•  Erledigt – Navigiere zu Special:Version in deinem Wiki, um zu überprüfen, ob die Erweiterung erfolgreich installiert wurde.

Erweiterte Installation

Wichtig: Die Extension:Gadgets muss installiert sein, damit dies funktioniert.

Aussehen

Um das Aussehen der Liste mit einfügbaren Zeichen zu ändern, fasse den Inhalt deiner Bearbeitungswerkzeuge mit <div class="mw-charinsert-buttons"> und ‎</div> ein und füge das Aussehen für sie in deine MediaWiki:Common.css 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 MediaWiki:Common.css, um das gleiche Aussehen anzuwenden.

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]]
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	border: 1px solid #aaa;
	margin-top: 10px;
	padding: 1px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #cde !important;
	color: #000;
	border: thin #069 outset;
	padding: 0 1px 1px;
	font-weight: bold;
	font-size: 0.9em;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover,
.mw-charinsert-buttons a:active {
	background-color: #bcd;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	font-size: 0.9em;
	margin-left: 1px;
	padding-left: 1px;
	padding-right: 1px;
}

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

 
/**
 * Styling for links generated by [[MediaWiki:Edittools]] in WikimediaUI inspired theme.
 * @source https://www.mediawiki.org/wiki/Extension:CharInsert#Styling
 * @updated 2020-03-17
 */
.mw-charinsert-buttons {
	margin-top: 8px;
	border: 1px solid #c8ccd1;
	padding: 2px 4px 4px;
	font-size: 1.1em;
	text-align: center;
}

.mw-charinsert-buttons a {
	background-color: #f8f9fa !important;
	color: #202122;
	border: thin #36c outset;
	padding: 0 1px 2px;
	font-size: 0.9em;
	font-weight: bold;
	text-decoration: none;
}

.mw-charinsert-buttons a:hover {
	background-color: #fff;
    color: #404244;
}

.mw-charinsert-buttons a:active {
	background-color: #c8ccd1;
	border-style: inset;
}

.client-js .mw-edittools-section {
	display: inline;
}

.client-js .mw-edittools-section input[type="button"] {
	background-color: #f8f9fa;
	color: #202122;
	margin-left: 1px;
    border-radius: 2px;
	padding: 1px 6px;
	font-size: 0.9em;
    /* Apply pointer cursor to all interactive elements. */
    cursor: pointer;
}

.client-js .mw-edittools-section input[type="button"]:hover {
	background-color: #fff;
    color: #404244;
}

.client-js .mw-edittools-section input[type="button"]:active {
	background-color: #c8ccd1;
    color: #000;
}

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 ‎<div> ein und gib dem ganzen eine beschreibende, einzigartige ID (zum Beispiel "mw-edittools-charinsert"):

<div id="mw-edittools-charinsert" class="mw-charinsert-buttons" title="Click on the wanted special character.">
...
</div>

2. Schließe jeden CharInsert-Block wie folgt in ‎<p>-Markierungen ein:

<p class="mw-edittools-section" data-section-title="Wiki-Syntax" style="display: none;">
...
</p>

 Hinweis:

• Ä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 'style="display: none;"' 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 MediaWiki:Gadgets-definition 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.

• 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.

 Hinweis: 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.

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