Quelltext der Seite Wikiup:Technik/Skin/Gadgets/editMenus

{{../../../!header
|Text=Quelltext-Einfügungen
|Shortcut=WP:HW/editMenus}}

Mit '''editMenus''' wird für alle Benutzer bei der Quelltextbearbeitung eine „Sonderzeichenleiste“ unterhalb des Bearbeitungsfeldes angeboten. Sie ermöglicht das Einfügen von Textsequenzen in Eingabefelder. Neben einzelnen Schriftzeichen werden auch komplexere Syntax-Elemente wie etwa [[Hilfe:Vorlagen|Vorlagen]]-Einbindungen angeboten.

Benutzer können das Verhalten individuell konfigurieren.

== Position in der Seite und Grundfunktion ==
Direkt unterhalb jedes mehrzeiligen Text-Eingabefeldes wird eine Auswahl angeboten. Es besteht aus:
* Einem Auswahl-Angebot für Einzel-Menüs, beispielsweise für unterschiedliche <!-- menschliche --> Sprachen.
* Rechts daneben das ausgewählte Einzel-Menü mit Verlinkungen.
Ein Klick auf ein Element des Einzel-Menü fügt im momentan aktiven Textbereich das zugeordnete Element ein. Im einfachsten Fall ist das ein einzelnes Sonderzeichen oder ein Buchstabe aus einer fremden Sprache oder Schrift.
* Wenn an der betreffenden Stelle bereits ein Textbereich ausgewählt (markiert) gewesen war, dann wird bei manchen Syntax-Elementen dieser Textinhalt mit einer Anfangs- und End-Syntax direkt umschlossen, andernfalls werden diese unmittelbar aufeinander folgend eingefügt.
* Die Einfügung soll auf jedes Textfeld in der Seite wirken (also etwa auch auf einen [[Hilfe:Zusammenfassung und Quellen|Bearbeitungskommentar]]), in dem zuletzt der Mauszeiger aktiv wurde. Es ist dabei bedeutungslos, an welcher Stelle der Seite die Auswahl angeboten wird. Es kann jedoch nicht ausgeschlossen werden, dass dieser Vorgang durch andere Skripte beeinflusst wird, wenn diese virtuell Textfelder aktivieren und zum zuletzt benutzten machen.
* Wird gleichzeitig die Taste {{Taste|Einfg}} gedrückt, dann wird eine ggf. vorhandene Textauswahl überschrieben.
* Während der Bearbeitung derselben Seitenversion bleibt auch nach erneutem Seitenaufbau (etwa zur Vorschau) die Sprachauswahl erhalten.
<div style="border: 1px solid #808080; clear: both; overflow: auto; padding-left: 0.5em; padding-top: 0.2em;">
Standardaussehen der editMenus-Sonderzeichenleiste:
[[Datei:EditMenus.png|center]]
</div>

== Minimierung und Einblenden ==
Rechts außen befindet sich eine kleine rote Schaltfläche mit einem&nbsp;„X“.
* Darüber lässt sich das angebotene Einzel-Menü ausblenden.
* Ein Klick in das Gesamt-Auswahlmenü, insbesondere die Auswahl einer anderen Sprache, macht es wieder sichtbar.
* Beim Neuaufbau der Seite wird es jedoch zurzeit sicherheitshalber wieder eingeblendet.
* Nach einer gewissen Gewöhnungsphase soll eine Ausblendung jedoch für diese Bearbeitung einer Seitenversion erhalten bleiben. Bei Bearbeitung einer anderen Seite erfolgt standardmäßig immer eine Einblendung.

== Ausgestattete Seiten ==
Zurzeit sind das:
* Jede Seite während der Quelltext-Bearbeitung (unabhängig davon, ob Textfelder ggf. für die Veränderung gesperrt sind)
* [[Hilfe:Hochladen|Hochlade-Formular]]
Perspektivisch ist geplant, genau gleiche und dafür geeignete Zusammenstellungen auch für die Nutzung im [[Hilfe:VisualEditor|VisualEditor]] anzubieten.

Die genannten Seiten werden zwar immer ausgestattet; zurzeit werden jedoch projektweit nur Definitionen vom Typ <code>wikitext</code> angeboten. Auf Seiten anderer Inhaltsmodelle (Programmiersprachen) haben diese keine Wirkung; es könnten jedoch projektweite oder benutzerdefinierte Angebote speziell für bestimmte Programmiersprachen entstehen.

== Konfiguration ==

{{../!Aktivierung|script=1|style=0|h3=1|group=B|leave=1|global=0}}

=== {{Anker|PREGO}} Interaktive Optionen ===
Alle angemeldeten und nicht angemeldeten Benutzer („IP“) können einige grundlegende Anpassungen ohne Programmieraufwand vornehmen:
* Sprachenliste in der Reihenfolge verändern – persönlich benötigte Sprachen zuerst
** Eine Liste individuell wichtiger Einzel-Menüs kann benannt werden.
** Beliebig viele Bezeichner von Einzel-Menüs, etwa die Namen einer Fremdsprache, können eingetragen werden.
** Durch Leerzeichen voneinander getrennt; wichtigste zuerst.
** Nicht existierende Bezeichner, die vorsorglich einsortiert wären oder nur manchmal vorhanden sind, wären unschädlich und würden ignoriert.
* Verhalten der Ein- und Ausblendung beeinflussen
* Hilfe-Link <span style="background: #008000; color: #FFFFFF; padding-left: 2px; padding-right: 2px;">?</span> auf diese Seite hier nicht mehr einfügen
* Generierung der HTML-Elemente unterdrücken – einzige Möglichkeit für nicht angemeldete Benutzer, die Bereitstellung frühzeitig wieder abzubrechen. Bei angemeldeten Benutzern bietet sich die [[#Deaktivierung|Deaktivierung]] an, wodurch das Gadget gar nicht erst gestartet wird.
Dazu ist (bei aktiviertem Gadget) [[Special:Blankpage/preferencesGadgetOptions#editMenus|diese Spezialseite]] aufzurufen und etwas abzuwarten, bis sie dynamisch aufgebaut worden ist.
* Entsprechende Wünsche können konfiguriert werden.
* Abschließend ist die Schaltfläche <span style="background: #D0D0D0; border: 2px solid; border-color: #E0E0E0 #E0E0E0 #707070 #707070; color: #00A000; font-size: 120%; padding-left: 2px; padding-right: 2px;">'''+'''</span> anzuklicken.
* Im Erfolgsfall müsste ein grünes Häkchen [[Datei:Symbol OK.png|12px]] erscheinen.
* Das Zahnradsymbol <span style="background: #80FFFF; border: 2px solid; border-color: #E0E0E0 #E0E0E0 #707070 #707070; color: #00A000; font-size: 120%; padding-left: 2px; padding-right: 2px; ">[[Datei:Nuvola apps kcmsystem.svg|14px]]</span> öffnet die Optionen für ein bestimmtes Gadget.

Bei nicht angemeldeten Benutzern wird versucht, die Optionen dauerhaft im Browserprofil zu hinterlegen. Bei angemeldeten Benutzern erfolgt eine zentrale Verwaltung auf dem Wiki-Server. 

=== CSS ===
Die wesentlichen Elemente haben folgende Selektoren:
; .menuSwitcher
: Gesamte Werkzeugleiste
; .menuSwitcher-panel
: Jedes Einzel-Auswahlmenü
; .menuSwitcher-panel-''n''
: Einzel-Auswahlmenü; ''n'' ist eine bei der ersten Konfiguration vergebene fortlaufende Nummer ab&nbsp;1
; .editMenus-button
: Als Button dekorierte Schaltflächen
; .menuSwitcher a[data-id="''i''"]
: Einfüge-Link; ''i'' ist eine bei der ersten Konfiguration vergebene fortlaufende Nummer ab&nbsp;0 über alle Einzel-Menüs gezählt.
; .menuSwitcher option[data-item="''n''"]
: Element der Liste der Einzel-Menüs; ''n'' ist eine bei der ersten Konfiguration vergebene fortlaufende Nummer ab&nbsp;1 für das Einzel-Auswahlmenü
Damit können [[../../CSS|eigene Dekorationen]] vereinbart werden.

Nachstehend einige Beispiele. Für unangemeldete Benutzer müssen die Menüs vollständig angeboten werden, weil diese kaum Möglichkeiten zur Konfiguration haben. Angemeldete Benutzer können in erster Linie von ihnen nicht benötigte Elemente ausblenden.

''Alle Schaltflächen im Button-Stil ausblenden''
<syntaxhighlight lang="css" style="margin-left:2em">
.editMenus-button {
   display: none;
}
</syntaxhighlight>

''Umlaute ÄÖÜäöü und ß ausblenden;'' {{Taste|ß}} ist Nr. <code>11</code> und <code>span</code> sind die umgebenden Trennzeichen
<syntaxhighlight lang="css" style="margin-left:2em">
.menuSwitcher-panel-1 span,
.menuSwitcher a[data-id="7"],
.menuSwitcher a[data-id="8"],
.menuSwitcher a[data-id="9"],
.menuSwitcher a[data-id="10"],
.menuSwitcher a[data-id="11"],
.menuSwitcher a[data-id="12"],
.menuSwitcher a[data-id="13"] {
   display: none;
}
</syntaxhighlight>

''Alle Schaltflächen im Button-Stil ausgenommen Signatur ausblenden''
<syntaxhighlight lang="css" style="margin-left:2em">
.editMenus-button {
   display: none;
}
.menuSwitcher a[data-id="6"] {
   display: inline;
}
</syntaxhighlight>

Die Nummerierungen können sich durch projektweite Konfigurationsanpassungen verändern.

=== {{Anker|JS}} Konfiguration mittels JavaScript ===
[[/JS|Fortgeschrittene Konfigurationsmöglichkeiten]] werden angemeldeten und nicht angemeldeten Benutzern mittels JavaScript ermöglicht.

Es können eigene Menüs programmiert werden und weitgehend in die projektweit angebotene Gestaltung eingegriffen werden.
<!--
=== Deaktivierung durch nicht angemeldete Benutzer ===
Sie können die Seiten-Ausstattung vermutlich nicht restlos verhindern, jedoch durch folgende Greasemonkey-Abfolge die Ausführung weitgehend blockieren; je nach zeitlichem Ablauf:
mw.loader.state( { "ext.gadget.editMenus": "ready" } );
mw.loader.state( { "ext.gadget.editMenusDef": "ready" } );
mw.loader.state( { "ext.gadget.menuSwitcher": "ready" } );
mw.hook( "menuSwitcher.config" ).fire( false );
-->

== Cookies ==
Im [[Web Storage|Speicher]] des Browsers wird bis zum Ende der Sitzung, ggf. bereits zum Schließen des Tabs ein Element <code>menuSwitcher.dewiki</code> hinterlegt. Darin wird der Status in der letzten Seitenaktion vermerkt.

Für nicht angemeldete Benutzer können [[#PREGO|Konfigurationseinstellungen]] dauerhaft im Browserprofil hinterlegt werden.

== Syntaxhervorhebungs-Werkzeuge ==
Die Werkzeuge wie [[../../../Text/Edit/CodeMirror|CodeMirror]] verstecken das Bearbeitungsfeld. Es gibt deshalb zurzeit keine Möglichkeit, die hier angebotene Einfügungstechnik mit einem solchen Modus zu kombinieren.
* Es wird keine Benachrichtigung versandt, wenn durch Bearbeiter ein solcher Modus ein- oder ausgeschaltet wird. Damit ist keine Berücksichtigung möglich.
* Selbst wenn eine Programmierschnittstelle angeboten wird, sind für die Einfügungen zusätzliche Kenntnisse erforderlich: Welcher Bereich ist zurzeit selektiert (markiert)? Es sollen davor und dahinter öffnende und schließende Elemente eingefügt werden; das ist jedoch nicht bekannt.
* ''editMenus'' verwendet eine Programmierschnittstelle von MediaWiki für das Analysieren der Cursor-Position, die momentane Textauswahl und die Einfügung selbst. Diese MediaWiki-Funktion müsste für alle Hilfsmittel die überlagerten Syntaxhervorhebungs-Modi transparent verarbeiten, so dass eine Anwendung auch nichts davon wissen muss, was für ein sonstiger Modus eingeschaltet sein könnte.

== Vorgeschichte ==
Bis 5. November 2018 war seit 2006/2009 eine unter der internen Bezeichnung ''Onlyifediting'' programmierte Hilfestellung verwendet worden.
* Diese basierte auf einer Technologie der Wiki-Software von 2006, von der die WMF im Frühjahr 2017 angekündigt hatte, sie würde die Wartung und Pflege dieser uralten und nicht mehr mit den modernen Anwendungen kompatiblen Programmbibliothek einstellen, zumal weltweit nur noch 0,03 % der aktiven Benutzer die darauf beruhende Werkzeugleiste nutzen.<ref>[[Wikipedia:Technik/Text/Edit/VisualEditor/Rückmeldungen/Archiv/1 #Editing News &#35;1—2017|Editing News &#35;1/2017]] (deutsch; Archivseite 450 kB)</ref>
Das hier dargestellte Gadget entspricht genau der Funktionalität wie sie sich seit 2009 entwickelt hatte, mit folgenden Abweichungen:
* Vorangestellt werden ein halbes Dutzend Buttons, die den wichtigsten Funktionen der gleichzeitig weggefallenen „Toolbar 2006“ entsprechen.
* Das Gadget wird unmittelbar unterhalb des Bearbeitungsfeldes dargestellt, und nicht mehr jenseits von Urheberrechtshinweisen und den Schaltflächen für Vorschau und Publizieren (Speichern).
Zeitgemäße Möglichkeiten und Maßnahmen kamen hinzu.

== Weitere Informationen ==
* [[Hilfe:Symbolleisten]]
* [[../editMenusDef/]] – Programmierung und Administration

== Anmerkungen ==
<references />

[[Kategorie:Wikipedia:Technik/Skin/Gadgets|editMenus]]