Erweiterung: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. |
MediaWiki | >= 1.43 |
Lizenz | GNU General Public License 2.0 oder neuer |
Herunterladen | |
<charinsert> |
|
Quarterly downloads | 87 (Ranked 67th) |
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
Á á Ć ć É é Í í Ĺ ĺ Ń ń Ó ó Ŕ ŕ Ś ś Ú ú Ý ý Ź ź
Kombinierte Zeichen
Kombinierte Zeichen werden zwischen den "charinsert"-Markierungen aufgelistet und durch das Zeichen "+" verbunden.
<charinsert>“+” ‘+’ «+» ‹+› „+“ ‚+‘ [[+]] {{+}}</charinsert>
ergibt
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
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 Ordnerextensions/
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
Diese Erweiterung wird in einem oder mehreren Wikis von Wikimedia verwendet. Das bedeutet mit hoher Wahrscheinlichkeit, dass die Erweiterung stabil ist und gut genug funktioniert, um auf solch häufig besuchten Webseiten benutzt zu werden. Suche nach dem Erweiterungs-Namen in den Wikimedia CommonSettings.php und den InitialiseSettings.php-Konfigurations-Dateien, um nachzusehen, wo es installiert ist. Eine vollständige Liste der installierten Erweiterungen in einem bestimmten Wiki wird auf Special:Version im Wiki generiert und angezeigt. |
Diese Erweiterung ist in den folgenden Softwarepaketen enthalten und/oder wird von den folgenden Wiki-Farmen, bzw. Wiki-Hostern verwendet: Dies ist keine maßgebliche Liste. Softwarepakete und/oder Wiki-Farmen, bzw. Wiki-Hoster nutzen diese Erweiterung ggf., obwohl sie nicht in dieser Liste enthalten sind. Prüfe daher stets die Nutzung im verwendeten Softwarepaket und/oder bei der Wiki-Farm, bzw. dem Wiki-Hoster. |