Erweiterung:CharInsert

From mediawiki.org
This page is a translated version of the page Extension:CharInsert and the translation is 100% complete.
MediaWiki-Erweiterungen
OOjs UI icon advanced-invert.svg
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 (Brion VIBBERDiskussion)
Letzte Version continuous updates
Kompatibilitätspolitik Snapshots werden zusammen mit MediaWiki veröffentlicht. Der Master ist nicht abwärtskompatibel.
MediaWiki 1.25+
PHP 5.4+
Lizenz GNU General Public License 2.0 oder neuer
Herunterladen
‎<charinsert>
Ü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 &#10;, 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

Aufgrund von Fehler T88922 funktioniert die Werkzeugleiste von CharInsert nicht auf der Spezialseite "Hochladen", wenn MediaWiki 1.27.x genutzt wird. Nutze die Versionen von MediaWiki 1.28+, beachte jedoch, dass manche Helferlein ohne weitere Aktualisierung möglicherweise nicht wie erwartet funktionieren.
  • Die Erweiterung herunterladen und die Datei(en) in ein Verzeichnis namens CharInsert im Ordner extensions/ ablegen.
  • Folgenden Code am Ende der LocalSettings.php einfügen:
    wfLoadExtension( 'CharInsert' );
    
  • Wenn du das Helferlein Edittools nutzt, aktualisiere den Code auf die aktuellste Version (≥ 27. Mai 2016)
  • Yes Erledigt – Zu Special:Version in dem Wiki (bei Einstellung auf deutsch nach Spezial:Version) navigieren, um die erfolgreiche Installierung der Erweiterung zu überprüfen.

Für Benutzer, die MediaWiki in der Version 1.24 und früher betreiben:

Die oben stehenden Anweisungen beschreiben die neue Installationsanweisung für diese Erweiterung unter der Verwendung von wfLoadExtension(). Wird diese Erweiterung in einer dieser früheren Versionen (MediaWiki 1.24 und früher)  – an Stelle von wfLoadExtension( 'CharInsert' ); – installiert, benutze:

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

Erweiterte Installation

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

Aussehen

Charinsert-sample-edittools-box.png

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>
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 '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:

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

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.

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