Wikipedia:Helferlein/Navigation-Popups
aus Wikipedia, der freien Enzyklopädie
Navigation-Popups bieten einfachen Zugriff auf verschiedene Wikipedia-Funktionen in Popups, die erscheinen, wenn man die Maus über Wiki-Links bewegt.
Schnell-Installation: Man geht auf Spezial:Einstellungen in den Karteireiter "Gadgets", setzt im Abschnitt "Lesehilfen" den Haken vor den "Navigations-Popups" und geht auf "Einstellungen speichern". Weiter unten gibt es eine komplette Installationsanleitung für technisch erfahrene Benutzer, die gerne einzelne Konfigurationsoptionen anpassen wollen.
Inhaltsverzeichnis |
[Bearbeiten] Funktionen
- Liefert eine Voransicht (Preview) des Artikel-Textes (Dank an Pilaf für sein Live-Preview-Skript, das dies ermöglicht)
- Zeigt eine Voransicht von Bild-Links
- Zeigt eine Voransicht des ersten Bildes im Artikel - ein Riesenspaß bei Benutzerseiten
- Gibt Hinweise auf Weiterleitungen, Stubs (kurze Artikel) oder Begriffsklärungen
- Zeigt Informationen wie Größe, Anzahl der Links, Anzahl der Bilder, Anzahl der Kategorien und Alter einer Seite an
- Sollte mit allen Wikimedia-Wikis funktionieren
- Modifiziert optional Links, um Weiterleitungen oder Begriffsklärungen zu umgehen
- Unterstützt optional Shortcut-Tastenkombinationen
- Ein-Klick-Zugriff auf
- Bearbeiten
- Benutzerbeiträge
- Kate's tool (Änderungszähler)
- Email an den Benutzer
- Versionen
- Eintragen und Austragen aus der Beobachtungsliste
- die entsprechende Diskussionsseite (Ansicht, Bearbeiten)
- Links auf diese Seite
- Änderungen an verlinkten Seiten
- Für Administratoren: Schützen, freigeben, löschen und Benutzersperre
- Benutzer-Log und Blockierungs-Log
- Zeigt Unterseiten von Benutzerseiten
- Wikipedia-Suche und globale Wikipedia-Suche
[Bearbeiten] Installation
Man muss unter einem Wikipedia-Benutzerkonto angemeldet sein, um Navigation-Popups verwenden zu können. Hier kann man ein solches Konto anlegen und sich anmelden.
Der nächste Schritt ist es auf Spezial:Einstellungen in den Karteireiter "Gadgets" zu gehen, dort im Abschnitt "Lesehilfen" den Haken vor den "Navigations-Popups" zu setzen und anschließend auf "Einstellungen speichern" zu klicken. Davon ausgegangen, dass JavaScript im Browser nicht deaktiviert ist, sollte ab jetzt jedes Mal ein Popup erscheinen, wenn man mit der Maus über einen Wikipedia-Link fährt.
Um das Skript zu deinstallieren, entfernt man einfach den Haken in den Einstellungen und speichert diese ab.
Will man das Script auf Commons, dem Wiktionary oder auch in anderen Sprachversionen der Wikipedia verwenden, muss in diesen Wikis eine etwas andere Installation durchgeführt werden, solange die Gadgets-Erweiterung dort noch nicht von den Serveradministratoren installiert ist. Der folgende Code muss in diesen anderen Wikis (aber nicht in Wikipedia!) zur eigenen monobook.js-Datei, die man als Unterseite seiner Benutzerseite findet, hinzugefügt werden. Im Gegensatz zu verschiedenen anderen Seiten ist bei diesem Link die Kleinschreibung von monobook.js (nicht: Monobook.js) wichtig:
// http://de.wikipedia.org/wiki/Wikipedia:Helferlein/Navigation-Popups document.write('<script type="text/javascript" src="' + 'http://de.wikipedia.org/w/index.php?title=MediaWiki:Gadget-navigation-popups.js' + '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
Wenn man in diesen anderen Wikis einen anderen Skin als MonoBook (den Standard) verwendet, muss man eine entsprechend andere .js-Datei anpassen:
- Classic skin: standard.js
- Cologne Blue: cologneblue.js
- Chick: chick.js
- Simple: simple.js
- Nostalgia: nostalgia.js
- MySkin: myskin.js
[Bearbeiten] Konfiguration (optional)
[Bearbeiten] Ändern der Popup-Darstellung
Man kann das Aussehen des Popups grundlegend ändern, indem man die Benutzer-CSS-Datei anpasst. Die Benutzer-CSS-Datei findet man in Wikipedia auf dem gleichen Weg wie die oben beschriebene .js-Datei für die anderen Wikis, nur dass man die Endung ".js" durch ".css" ersetzt. Für den Standard-Skin ergibt sich also ein URL wie http://de.wikipedia.org/wiki/Benutzer:BENUTZERNAME/monobook.css (oder einfach auf Spezial:Mypage/monobook.css gehen).
Das folgende Beispiel gibt ein Orange-gefärbtes Popup mit einem Rahmen und abgeänderter Schriftart. Alle Zeilen des Beispiels sind optional (Konkret schauen Popups bei Verwendung der letzten Zeile etwas komisch aus, aber sie zeigt die Möglichkeiten der Stylesheet-Anpassung).
table.popupBorderTable { background: #FFBE20 /* orange */ !important } table.popupTable { background: #FFFAEF /* pastel orange */ !important } font.popupFont { font-family: serif !important; color: #440044 !important; font-size: medium !important }
[Bearbeiten] Optionen
Es gibt verschiedene Optionen, die gesetzt werden können. Um eine Option zu verändern, editiert man in Wikipedia die oben schon für andere Wikis genannte .js-Datei (etwa Benutzer:BENUTZERNAME/monobook.js) und fügt eine Zeile in der Form
- Option = Wert;
hinzu, wobei Option und Wert aus unten stehender Tabelle gewählt werden. Um beispielsweise das Herunterladen zu verhindern und Administrator-Links zu aktivieren, benötigt man in etwa folgenden Code in der JavaScript-Datei:
// Konfigurationsvariablen für http://de.wikipedia.org/wiki/Wikipedia:Helferlein/Navigation-Popups simplePopups=true; popupAdminLinks=true;
|
|
||
| Option | Werte* | Beschreibung |
|---|---|---|
| popupDelay | Dezimalzahl, 0.5 | Zeit in Sekunden, bevor ein Popup erscheint. |
| simplePopups | true, false | Wenn man nur die schnellen Links im Popup benötigt oder einen die großen Datenmengen stören, die mit dem Popup automatisch heruntergeladen werden, setzt man diesen Wert auf true. Damit wird nichts heruntergeladen, und die Popups enthalten nur die benötigten Links. |
| popupStructure | 'original', 'fancy', 'fancy2', 'menus' | Wählt die Struktur der Popups aus. Mit dem Wert 'original', der automatisch bei Verwendung von simplePopups=true ausgewählt ist, stehen alle Navigations-Links direkt im Popup; 'fancy' und fancy2 sind Variationen dieses Stils. Die 'menus'-Einstellung, die auch verwendet wird, solange simplePopups nicht true ist, stellt die Links in Menüs innerhalb des Popups dar. Um diese Option richtig zu verwenden, muss der Wert mit einfachen Hochkommata eingeschlossen werden, d.h. popupStructure='fancy';. Bei Verwendung von Opera als Browser ist der Standardwert 'original', da die Menüs mit diesem Browser derzeit nicht funktionieren. |
| popupActionsMenu | true, false | Wenn man Menüs verwendet, hat man entweder den Titel-Link im Popup-Menü (wenn es auf false gesetzt ist) oder in einem separaten "Aktionen"-Menü (wenn es auf true gesetzt ist, was auch der Standardwert ist). |
| popupImages | true, false | Wenn diese Option auf false gesetzt ist, werden Bilder nicht angezeigt. |
| popupAdminLinks | true, false | Wenn diese Option auf true gesetzt ist, erscheinen zusätzliche Links im Popup, die Administratoren dabei helfen, Benutzer zu blockieren, Seiten zu löschen oder den Seitenschutz zu verändern. |
| popupShortcutKeys | true, false | Durch Setzen dieser Option auf true kann man die Links im Popup schnell durch Drücken von Tasten erreichen. Wenn die Maus über einen Artikel-Link mittels Tastenkürzel bewegt wird, erscheint das Tastenkürzel am Ende des Popups. Beispielsweise kann man in Firefox und Opera einen Artikel in einem neuen Tab editieren, indem man 'e Control-Enter' drückt. Internet-Explorer-Benutzer sollten von der Aktivierung dieser Option Abstand nehmen, da Tastenkürzel mit diesem Browser nicht funktionieren und das Aktivieren verschiedene Bugs mit sich bringt. |
| popupDragging | true, false | Wenn diese Option auf true gesetzt ist, kann man das Popup bei gehaltener Shift-Taste im Browserfenster bewegen. |
| popupFixRedirs | true, false | Wenn diese Option auf true gesetzt ist, kann man automatisch Links auf Weiterleitungs-Seiten korrigieren, indem man auf den 'Weiterleitung'-Link im Popup drückt. Hinweis: Üblicher Weise korrigiert man nicht jeden derartige Link, wenn man über ihn stolpert, schon garnicht macht man sich auf die Jagd nach ihnen. Siehe /Über Weiterleitungskorrekturen. |
| popupRedirAutoClick | 'wpSave', 'wpPreview', 'wpDiff' | Was passieren soll, wenn Weiterleitungen korrigiert werden (Speichern, Vorschau, Änderungen). |
| popupFixDabs | true, false | Ähnlich der popupFixRedirs-Option kann man Links auf Begriffserklärungsseiten einfach korrigieren, indem man einen der Links im unteren Popup-Bereich öffnet. |
| popupNavLinks | true, false | Wenn diese Option auf true gesetzt ist, werden Navigations-Links dargestellt, bei false fehlen diese. |
| popupLastEditLink | true, false | Gibt an, ob das Popup einen "letzte Änderung"-Link enthalten soll. |
| popupHistoricalLinks | true, false | Fährt man mit der Maus über einen Link auf eine alte Version oder einen Versionsunterschied, werden bei Angabe von true weitere Links wie "Bearbeite alte Version" angezeigt. Ohne diese Option schauen diese Popups wie normale Popups aus. |
| popupPreviews | true, false | Wenn diese Option auf true gesetzt ist und simplePopups nicht aktiviert ist, wird eine Vorschau des ersten Artikelabschnitts im Popup gezeigt. Die Vorschau fehlt, wenn diese Option auf false gesetzt ist. Berichte von Seiten, wo diese Option schlecht funktioniert, sind von Lupin, dem Hauptentwickler dieses Helferleins, gerne gesehen (bitte auf Englisch). |
| popupSummaryData | true, false | Ist diese Option auf true gesetzt, werden Übersichtsdaten der Zielseite im Popup angezeigt. |
| popupLastModified | true, false | Wenn diese Option auf true gesetzt ist, wird das Seitenalter als Teil der Übersichtsdaten angezeigt. Das Seitenalter ist die Zeit, die seit der letzten Bearbeitung des Artikels vergangen ist. |
| popupOnlyArticleLinks | true, false | Ist diese Option auf true gesetzt, werden Popups nur für Artikel-Links erzeugt, andernfalls bekommen Hilfe- und Bearbeitungs-Links auch solche Popups. |
| imagePopupsForImages | true, false | Standardmäßig werden Bildervorschauen auch dann in das Popup geladen, wenn die Maus über einem bereits sichtbaren Bild steht. Wird diese Option auf false gesetzt, wird diese Bildervorschau unterdrückt. |
| popupMaxWidth | 300, eine Ganzzahl oder false | Die Maximalbreite des Popup-Fensters in Bildschirmpixeln. Wird diese Option auf false gesetzt, passt sich die Popup-Fensterbreite an den Inhalt an. |
| popupInitialWidth | eine Ganzzahl oder false | Gibt die Popup-Fensterbreite zum Zeitpunkt des Öffnens an. Setzt man den Wert auf false, verwendet das Popup anfänglich nur die minimal von seinem Inhalt benötigte Breite. |
| popupEditCounterTool | "kate", "interiot" | Wählt den verwendeten Bearbeitungszähler. Man kann zwischen Kate's tool und Interiot's tool wählen. |
| Bearbeitungskommentare | ||
| popupRevertSummary | Zeichenkette | Gibt den Bearbeitungskommentar beim Zurücksetzen eines Artikels an. Das erste '%s' der angegebenen Zeichenkette wird mit der Revision-ID der zurückgesetzten Seite ersetzt. |
| popupFixRedirsSummary | Zeichenkette | Gibt den Bearbeitungskommentar bei der Weiterleitungskorrektur eines Artikels an. Das erste '%s' der angegebenen Zeichenkette wird mit der Weiterleitungsseite ersetzt, das zweite '%s' wird mit der Zielseite ersetzt. |
| popupFixDabsSummary | Zeichenkette | Gibt den Bearbeitungskommentar bei der Begriffserklärungskorrektur eines Artikels an. Das erste '%s' der angegebenen Zeichenkette wird mit der Begriffserklärungsseite ersetzt, das zweite '%s' wird mit der Zielseite ersetzt. |
| Vorschau-Optionen | ||
| popupPreviewKillTemplates | true, false | Ist es true, werden Vorlagen aus dem Vorschautext gelöscht, andernfalls erscheinen sie als Wikitext. |
| popupPreviewRawTemplates | true, false | Ist es true, werden Vorlagenseiten (also Seiten im Vorlagen:-Namensraum) komplett als Wikitext dargestellt, andernfalls werden sie im Preview dargestellt. |
| popupPreviewFirstParOnly | true, false | Ist diese Option true, wird nur der erste Absatz eines Artikels in der Vorschau dargestellt. |
| popupMaxPreviewSentences | eine Ganzzahl, 4 | Die Artikelgröße in der Vorschau kann auch auf die wiedergegebene Satzanzahl begrenzt werden. |
| popupMaxPreviewCharacters | eine Ganzzahl, 600 | Die Artikelgröße in der Vorschau kann auch auf die dargestellte Zeichenzahl begrenzt werden. |
| Technische Optionen | ||
| popupNavLinkSeparator | Zeichenkette, ' ⋅ ' |
Gibt HTML-Code an, der zwischen den Navigations-Links eingefügt wird. Diese Option ist für Konqueror standardmäßig auf ' • ' und in Microsoft-Browsern auf ' · ' gesetzt, da diese das ⋅-Zeichen nicht unterstützen. |
| popupAppendRedirNavLinks | true, false | Ist diese Option auf true gesetzt, werden separate Links für das Ziel einer Weiterleitung im Popup dargestellt. Ist die Option false, erscheint eine Warnung, um auf die Weiterleitung hinzuweisen, aber es erscheinen dafür keine Links. Die Option ist funktionslos wenn popupNavLinks auf false gesetzt ist. |
| removeTitles | true, false | Mit dieser Option wird der Artikel-Titel als Haupt-Link des Popup-Fensters verwendet. Dies unterbleibt, wenn die Option auf false gesetzt ist. |
| Experimentelle Optionen | ||
| Die folgenden Optionen sind noch nicht gründlich getestet und dokumentiert: popupLiveOptions, popupCookies, popupUnsimplifyLink, popupExtraUserMenu, popupLinksNewWindow. Man kann mit Angabe von popupLiveOptions=true recht einfach erste Tests in diese Richtung unternehmen. | ||
*Standardwerte werden in fetter Schrift angegeben
In Zukunft können weitere Optionen hinzu kommen, Vorschläge für solche Optionen werden gerne angenommen.
[Bearbeiten] Erweiterte Anpassungen
Man kann für Artikel eigene Filter definieren. Diese JavaScript-Funktionen laufen nach Erstellen der Seitenstatistik ab, ihre Ausgabe wird als HTML-Code an diesen Teil des Popups angehängt. (Für simplePopups=true oder popupSummaryData=false unterbleibt diese Darstellung).
Um diese Funktion zu aktivieren, schreibt man eine oder mehrere Filter-Funktionen, die einen String (den Wikitext des Artikels) als Eingabe akzeptieren und den einzufügenden HTML-Code zurückliefern. Sämtliche derartige Funktionen werden in die gewünschte Aufruf-Reihenfolge gebracht und in einem Array mit dem Namen extraPopupFilters aufgelistet.
Will man beispielsweise mitbekommen, wenn der Wikitext eines Artikels Tabellen enthält, die mit HTML-Tags statt mit Wiki-Markup geschrieben ist, kann man beispielsweise den folgenden Code in die eigene .js-Datei hinzufügen:
// initialize the array - only do this once extraPopupFilters=new Array(); // define the function function popupFilterHtmlTable (wikiText) { if (/<table/i.test(wikiText)) return '&lt;table&gt;'; else return ''; }; // add the function to the array (you can repeat this for lots of functions) extraPopupFilters.push(popupFilterHtmlTable);
Wird solcherart ein Popup für eine Seite erzeugt, die eine HTML-Tabelle enthält, sollte man <table> an dieser Stelle im Popup-Fenster sehen. (Das kann allerdings auch auf anderen Seiten wie der gerade dargestellten passieren. Der geneigte Leser betrachte die dafür notwendige Korrektur als Übungsaufgabe).
[Bearbeiten] Browser-Probleme
Wenn jemand diesen Problemen auf den Grund geht, möchte Lupin gerne mehr darüber wissen (Englisch).
Bei Benutzung von IE 7 sollte
window.opera=true;
als erste Zeile in monobook.js (oder entsprechend) gesetzt werden, damit Umlaute in Überschriften funktionieren.
- Angeblich stürzt Safari häufig bei Verwendung dieses Scripts ab.
- Das Verschieben des Popups funktioniert nicht mit dem Internet Explorer.
[Bearbeiten] Feedback
- Probleme und Verbesserungsvorschläge zur deutschen Oberfläche der Navigations-Popups bitte auf MediaWiki Diskussion:Gadget-navigation-popups.js/de schreiben.
- Bugs, Probleme, Vorschläge und Erweiterungen bitte auf Englisch an Lupin.
- Außerdem gibt es eine Seite, auf der man Angaben über Artikel mit falscher Vorschau (Englisch) machen kann.
[Bearbeiten] Autoren
- en:User:Lupin Autor des Scripts
- en:Wikipedia:Tools/Navigation popups Original-Seite (Englisch), enthält weitere Autoren und Danksagungen


