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 fügt {{subst:navpop}} zum Benutzer-JavaScript hinzu. Dieses liegt bei Verwendung des Standard-Skins Monobook hier. Weiter unten gibt es eine komplette Installationsanleitung.
Inhaltsverzeichnis |
[Bearbeiten] Besonderheiten
- Liefert eine Voransicht (Preview) des Artikel-Textes (Kudos an en:User: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 das Hinzufügen von {{subst:navpop}} zur eigenen monobook.js-Datei, die man als Unterseite seiner Benutzerseite hier findet. Im Gegensatz zu verschiedenen Seiten von Wikipedia ist bei diesem Link die Kleinschreibung von monobook.js (nicht: Monobook.js) wichtig! Dadurch wird der folgende Code in die .js-Datei geschrieben:
// [[User:Lupin/popups.js]]
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
Hinweis: Wenn man 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
Nach dem Abspeichern der Seite muss der Browser-Cache gelöscht werden (während des Neuladens der Seite drückt man SHIFT). 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 Script auf Commons, dem Wiktionary oder auch in anderen Sprachversionen der Wikipedia verwenden zu können, muss die angesprochene Installation auch in diesen Wikis durchgeführt werden. Um das Skript zu deinstallieren, löscht man die oben angegebenen Zeilen aus der .js-Datei und löscht auf gleiche Weise den Browser-Cache.
[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 auf dem gleichen Weg wie die oben beschriebene .js-Datei, 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.
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 wieder die oben 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:
// [[:en:User:Lupin/popups.js]] - please include this line
document.write('<script type="text/javascript" src="'
+ 'http://en.wikipedia.org/w/index.php?title=User:Lupin/popups.js'
+ '&action=raw&ctype=text/javascript&dontcountme=s"></script>');
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. (Berichte von Seiten, wo das schlecht funktioniert (englisch), sind gerne gesehen). Die Vorschau fehlt, wenn diese Option auf false gesetzt ist. |
| 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 '<table>';
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 ich 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
Bugs, Probleme, Vorschläge und Erweiterungen: Bitte an Lupin (englisch)
Weiters gibt es eine Seite, auf der man Angaben über Artikel mit falscher Vorschau (englisch) machen kann.
[Bearbeiten] Credits
- en:User:Lupin Autor des Scripts
- en:Wikipedia:Tools/Navigation popups Original-Seite (englisch), enthält weitere Credits
