Benutzer:FNDE/Script/WikiBar

aus Wikipedia, der freien Enzyklopädie

Die optionale Erweiterung WikiBar erlaubt die komfortable Navigation durch verschiedene Funktionen und Seiten auf Wikipedia. Mit einem einzigen Tastendruck kann sich der Anwender eine personalisierte Leiste einblenden und mit einer weiteren Taste entsprechende Befehle aufrufen. Somit ist es möglich, häufig besuchte Seiten (wie z.B. die eigene Diskussionsseite oder Beobachtungsliste) sowie integrierte Befehle innerhalb einer Sekunde aufzurufen. Für routinierte Nutzer besteht die Möglichkeit, vordefinierte Befehle direkt auszuführen um noch mehr Zeit zu sparen. Die native MediaWiki-Plattform arbeitet normalerweise mit Tastenkombinationen, welche i.d.R. mit SHIFT und ALT aufgerufen werden – für die Bedienung von WikiBar ist grundsätzlich nur eine Taste notwendig, um die entsprechende Funktion auszulösen. In der Übersicht werden ausschließlich Funktionen gelistet, welche für die jeweilige Seite bereitgestellt sind. Sollte für einen Artikel z.B. keine Version in der englischen Wikipedia vorliegen, so wird die Option Artikel auf Englisch nicht angezeigt. Aufgrund der haptischen und visuellen Vorteile des Ziffernblocks, wurden die vordefinierten Befehle den nachfolgenden Nummern zugewiesen. Alle Funktionen sind frei belegbar und können mit jeder beliebigen Taste verknüpft werden.

Num 0 Dialog öffnen / schließen
Num 1 Artikel anzeigen
Num 2 Artikel bearbeiten
Num 3 Versionen anzeigen
Num 4 Artikel in der englischen Wikipedia aufrufen
Num 5 Version als gesichtet markieren (→ sichten)
Num 5 Ungesichtete Version des Artikels anzeigen
Num 6 Seiten mit ungesichteten Versionen anzeigen
Num 7 Benutzerseite aufrufen
Num 8 Diskussion aufrufen
Num 9 Beobachtungsliste öffnen
ESC Dialog schließen
Dialog schließen

Für die einfache Integration als Benutzerscript, besteht die Möglichkeit das bereitgestellte Setup ohne Programmierkenntnisse zu übernehmen. Alle Befehle sind in der Übersicht (siehe oben) abgebildet. Sofern gewünscht, können in der erweiterten Variante sowohl die Bezeichnung, als auch die Belegung der Tasten den persönlichen Präferenzen angepasst werden. Die Zuordnung der Funktionen erfolgt anhand der DOM-Elemente im Quelltext, welche sowohl mit CSS als auch mit jQuery selektiert werden können. Das Script erlaubt es einzelne Links, Schaltflächen oder Aktionen aufzurufen. Während der Texteingabe sind alle Funktionen standardmäßig deaktiviert.

Einfache Einbindung

mw.loader.load('//de.wikipedia.org/w/index.php?title=Benutzer:FNDE/Script/WikiBar/setup.js&action=raw&ctype=text/javascript');

Du benötigst Hilfe bei der Einbindung? Gerne beantworte ich deine Fragen auf der Diskussionsseite.
Möglicherweise hilft dir auch das Tutorial zur Einbindung von Benutzerskripten auf Wikipedia.

Benutzerdefinierte Einbindung

Zugelassene Parameter können mit der Funktion bar_set_option([Parameter],[Wert]); personalisiert werden. Das Setup steuert die Belegung der globalen und lokalen Shortcuts. Grundsätzlich können sämtliche F-Tasten (z.B. F1), der Nummernblock (z.B. 7) und einige Arbeitstasten (z.B. ENTER) mit den verfügbaren Funktionen (z.B. Sichten, Entsichten, Revertieren) belegt werden. Eine vollständige Zuordnung der Tasten ist direkt im Script (core.js) einsehbar. Der letzte Abschnitt erlaubt die Gestaltung der verwendeten Farben mittels Hexadezimal, RGB oder ausgeschriebenen HTML-Codes. Die Funktion bar_add_delimiter(true) erlaubt das einfügen von Trennlinien im Dialog. Die Anordnung erfolgt fortlaufend anhand Position im Quelltext. Externe http(s)-Links werden automatisch erkannt. Es ist nicht möglich, interne Links wie WP:QS oder /wiki/Apple zu setzen. Bitte beachten: Funktionen mit identischer Tastenbelegung können nur ausgeführt werden, wenn die jeweilige Seite nur einen Selektor bereitstellt.
function bar_setup() {

    // Globale Tastenbelegung: bar_set_option([Action], [Key]);

    bar_set_option('toggle', '0'); // Dialog öffnen / schließen (Num. 0)
    bar_set_option('close', 'ESC'); // Dialog schließen (ESC)
    bar_set_option('immediately', false); // Benutzerdefinierte Tasten sofort (ohne Dialog) auslösen
	
    // Benuzerdefinierte Tasten: bar_add_bar_item([Key], [Description],[DOM-Element] or [http-Adress]);

    bar_add_bar_item('1', 'Artikel', '#ca-view a'); // Artikel aufrufen (Num. 1)
    bar_add_bar_item('2', 'Bearbeiten', '#ca-edit a'); // Artikel bearbeiten (Num. 2)
    bar_add_bar_item('3', 'Versionen', '#ca-history a'); // Versionen anzeigen (Num. 3)

    bar_add_delimiter(true); // Trennlinie einfügen

    bar_add_bar_item('4', 'Artikel auf Englisch', '.interwiki-en a'); // Artikel in der engl. Wikipedia anzeigen (Num. 4)
    bar_add_bar_item('5', 'Gesichtet markieren', '#mw-fr-submit-accept'); // Version als gesichtet markieren (Num. 5)
    bar_add_bar_item('5', 'Ungesichtete Änderungen', '.flaggedrevs_notice a[href$="&diff=cur"]:first'); // Ungesichtete Änd. anzeigen (Num. 5)
    bar_add_bar_item('6', 'Ungesichtete Artikel', 'https://de.wikipedia.org/wiki/Spezial:Seiten_mit_ungesichteten_Versionen'); // ungesichtete Art. (Num. 6)

    bar_add_delimiter(true); // Trennlinie einfügen

    bar_add_bar_item('7', 'Benutzer', '#pt-userpage a'); // Eigene Benutzerseite aufrufen (Num. 7)
    bar_add_bar_item('8', 'Diskussion', '#pt-mytalk a'); // Benutzerdiskussion aufrufen (Num. 8)
    bar_add_bar_item('9', 'Beobachtet', '#pt-watchlist a'); // Beobachtungsliste aufrufen (Num. 9)
	
    bar_add_delimiter(true); // Trennlinie einfügen
	
    bar_add_bar_item('✖', 'Fenster schließen', '[close_window]'); // Dialog Schließen (Num. Multipl.)
	
    // Design-Parameter: bar_set_option([Prefix],[Color]);
	
    bar_set_option('bg_color', 'rgba(17,17,17,0.95)'); // Hintergrundfarbe (Overlay)
    bar_set_option('box_border_color', '#d12727'); // Farbe der Umrandung (Dialog)
    bar_set_option('box_bg_color', '#291111'); // Hintergrundfarbe (Dialog)
    bar_set_option('line_color', '#d12727'); // Farbe der Umrandung (Trennlinie)
    bar_set_option('text_color', '#ffffff'); // Textfarbe (Bezeichnung)
    bar_set_option('key_color', '#ffffcc'); // Textfarbe (Taste)

}

mw.loader.load('//de.wikipedia.org/w/index.php?title=Benutzer:FNDE/Script/WikiBar/core.js&action=raw&ctype=text/javascript');

Weitere Beispiele

bar_add_bar_item('1', 'WikiLint', 'http://tools.wmflabs.org/wikilint/cgi-bin/wikilint'); // WikiLint aufrufen (Num. 41
bar_add_bar_item('2', 'Qualitätssicherung', 'https://de.wikipedia.org/wiki/Wikipedia:Qualitätssicherung'); // WP:QS aufrufen (Num. 2)
bar_add_bar_item('3', 'Vergleichen', '.mw-history-compareselectedversions-button'); // gewählte Versionen vergleichen (Num. 3)
bar_add_bar_item('4', 'Abschnitt hinzufügen', '#ca-addsection a'); // neuen Abschnitt hinzufügen (Num. 4)
bar_add_bar_item('5', 'Beiträge', '#pt-mycontris a'); // Benutzerbeiträge aufrufen (Num. 5)
bar_add_bar_item('6', 'Beobachten', '#ca-watch a'); // Diesen Artikel beobachten (Num. 6)
bar_add_bar_item('7', 'Verschieben', '#ca-move a'); // Artikel verschieben (Num. 7)
bar_add_bar_item('8', 'Zufall', '#n-randompage a'); // Zufälliger Artikel (Num. 8)

Dateistruktur

Fertig konfiguriertes Benutzerskript: Benutzer:FNDE/Script/WikiBar/setup.js
Benutzerscript ohne Einstellungen: Benutzer:FNDE/Script/WikiBar/core.js

Changelog

27.01.2016 v0.0.2-beta self.close() fixed
26.07.2015 v0.0.1-beta Release