Cowboy am 13. April 2026 um 10:50 Uhr

2026-04-13T10:50:10Z

← Nächstältere Version		Version vom 13. April 2026, 12:50 Uhr
Zeile 1:		Zeile 1:
	{{WP\|JavaScript}}]-[[CowboysWiki:Technik/Skin/Benutzerskripte/Hinweise\|Benutzerskript]] – verschiedene kleine Helferlein für Links im Zusammenhang mit Wiki-Seiten:		{{WP\|JavaScript}}-[[CowboysWiki:Technik/Skin/Benutzerskripte/Hinweise\|Benutzerskript]] – verschiedene kleine Helferlein für Links im Zusammenhang mit Wiki-Seiten:
	* ''[[#diff\|Difflink]]'' – als Wikilink formatierter Quelltext zum {{WP\|Kopieren und Einfügen\|C&P}}.		* ''[[#diff\|Difflink]]'' – als Wikilink formatierter Quelltext zum {{WP\|Kopieren und Einfügen\|C&P}}.
	* ''[[#perma\|Permalink]]'' – als Wikilink formatierter Quelltext zum {{WP\|Kopieren und Einfügen\|C&P}}.		* ''[[#perma\|Permalink]]'' – als Wikilink formatierter Quelltext zum {{WP\|Kopieren und Einfügen\|C&P}}.

Cowboy: Die Seite wurde neu angelegt: „{{WP|JavaScript}}]-Benutzerskript – verschiedene kleine Helferlein für Links im Zusammenhang mit Wiki-Seiten: * ''Difflink'' – als Wikilink formatierter Quelltext zum {{WP|Kopieren und Einfügen|C&P}}. * ''Permalink'' – als Wikilink formatierter Quelltext zum {{WP|Kopieren und Einfügen|C&P}}. * ''Purge'' – Link zum Purgen des Server-Cache in die…“

2026-04-13T10:49:51Z

Die Seite wurde neu angelegt: „{{WP|JavaScript}}]-Benutzerskript – verschiedene kleine Helferlein für Links im Zusammenhang mit Wiki-Seiten: * ''Difflink'' – als Wikilink formatierter Quelltext zum {{WP|Kopieren und Einfügen|C&P}}. * ''Permalink'' – als Wikilink formatierter Quelltext zum {{WP|Kopieren und Einfügen|C&P}}. * ''Purge'' – Link zum Purgen des Server-Cache in die…“

Neue Seite

{{WP|JavaScript}}]-[[CowboysWiki:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] – verschiedene kleine Helferlein für Links im Zusammenhang mit Wiki-Seiten:
* ''[[#diff|Difflink]]'' – als Wikilink formatierter Quelltext zum {{WP|Kopieren und Einfügen|C&P}}.
* ''[[#perma|Permalink]]'' – als Wikilink formatierter Quelltext zum {{WP|Kopieren und Einfügen|C&P}}.
* ''[[#purge|Purge]]'' – Link zum [[Hilfe:Purge|Purgen]] des Server-Cache in die Benutzeroberfläche einfügen.
* ''[[#redirect|Weiterleitung]]'' – Eintrag in die Browser-History einfügen, falls über ein Weiterleitungslink hierher gelangt.

== Einbindung ==
* Wenn das Projekt dieses Gadget bereits registriert haben sollte, genügt ein Häkchen auf der Seite [[Special:Preferences#mw-prefsection-gadgets|Einstellungen]] („Helferlein“).
* Sonst wären die folgenden Zeilen in die persönlichen [[CowboysWiki:Technik/Skin/Einstellungen|JS-Einstellungen]] einzufügen:
<syntaxhighlight lang="javascript" style="margin-left:2em" copy>
mw.loader.load( "https://en.wikipedia.org/w/index.php?title=User:PerfektesChaos/js/pageLinkHelper/r.js&action=raw&bcache=1&maxage=604800&ctype=text/javascript",
"text/javascript" );
</syntaxhighlight>

== Difflink-Quelltext ==
Wenn ein [[Hilfe:Versionsvergleich|Versionsvergleich]] aufgerufen wird, mit dem zwei Versionen derselben Seite gegenübergestellt werden, dann wird in der rechten oberen Ecke der Quelltext für ein Wikilink zum [[Kopieren und Einfügen|C&P]] dargestellt, ungefähr wie folgt.
: {{Hilfe/tt|1=[[Special:Diff/{{REVISIONID}}]]}}
Solch ein [[Special:Diff/{{REVISIONID}}]] ist viel kürzer als eine [[Uniform Resource Locator|URL]] und funktioniert auch im Bearbeitungskommentar oder als Begründung für sonstige Aktionen, wo URL nicht ausgewertet werden.

Die in der Adresszeile des Browsers sichtbare URL wird nach Möglichkeit so umgestaltet, dass sie die Spezialseite zeigt, woraus sich auch im Nachhinein Wikiinks leicht extrahieren lassen.

Das generierte Element hat zwei [[CowboysWiki:Technik/Skin/CSS#CSS-Notation|Selektoren]]:
* <code>.pageLinkHelper</code>
* <code>#pageLinkHelperDifflink</code>

Es wird die URL der aufgerufenen Seite ausgewertet; auf welchem Weg man dorthin gelangte, ist nicht ermittelbar.

Zusätzlich wird auf der Diffpage zu den Metadaten jeder der beiden Versionen ein Permalink-Quelltext dargestellt. Dieses hat zwei [[CowboysWiki:Technik/Skin/CSS#CSS-Notation|Selektoren]]:
* <code>.pageLinkHelper</code>
* <code>.pageLinkHelperDiffRev</code>

== Permalink-Quelltext ==
Wenn eine ältere Version einer Seite aufgerufen wird, dann wird in der rechten oberen Ecke der Quelltext für ein Wikilink zum [[Kopieren und Einfügen|C&P]] dargestellt, ungefähr wie folgt.
: {{Hilfe/tt|1=[[[{{fullurl:Special:PermaLink/{{REVISIONID}}|title={{PAGENAMEE}}}} Special:PermaLink/{{REVISIONID}}]]] [[[{{fullurl:Special:Redirect/page/{{PAGEID}}|title={{PAGENAMEE}}}} Special:Redirect/page/{{PAGEID}}]]]}}
Solche Wikilinks sind viel kürzer als eine [[Uniform Resource Locator|URL]] und funktionieren auch im Bearbeitungskommentar oder als Begründung für sonstige Aktionen, wo URL nicht ausgewertet werden.

Das erste [[Hilfe:Permanentlink|Permalink]] führt zur Seitenversion, das zweite verweist immer auf dieselbe Seite, auch wenn diese zwischenzeitig umbenannt wurde. In dem Kopiermuster ist eine Verlinkung eingebracht, der sich eine URL mitsamt dem rein informativen Parameter <code>title=</code> und dem Seitennamen entnehmen lässt.

Auf manchen Seiten ist (links) in der [[#p-tb|Werkzeugbox]] ein Link auf „{{int:permalink}}“ vorhanden. Die Funktion dieser Verlinkung wird dahingehend umgewandelt, dass auf jeder dieser Seiten die eben genannten Wikilink-Quelltexte eingefügt werden.<ref name="Gadget-PermaPageLink">Das [[MediaWiki:Gadget-PermaPageLink.js]] wird durch ''pageLinkHelper'' obsolet gemacht.</ref>

Das generierte Element hat zwei [[CowboysWiki:Technik/Skin/CSS#CSS-Notation|Selektoren]]:
* <code>.pageLinkHelper</code>
* <code>#pageLinkHelperPermalink</code>

== Purgen des Server Cache ==
Der Benutzeroberfläche wird ein Link hinzugefügt, um die momentane Seite im Server-Cache zu aktualisieren ([[Hilfe:Purge|Purgen]]).

Beim „Vector“-[[Hilfe:Skin|Skin]] wird dies an das Menü angefügt, das sich unter dem ▼ oben auf der Seite ausklappen lässt. Weiter sind keine Maßnahmen erforderlich.

Bei allen anderen Skins – oder wenn ein anderer Ort für den Link gewünscht wird – ist eine Spezifikation notwendig durch eine Zeile etwa wie folgt:
<syntaxhighlight lang="javascript">
mw.libs.pageLinkHelper = { purge: "p-tb" };
</syntaxhighlight>
Dies sollte auf der [[Special:MyPage/common.js|common.js]], [[meta:Special:MyPage/global.js|global.js]] oder Skin-abhängigem JS stehen, und zwar möglichst vor dem Aufruf <code>mw.loader.load()</code> wie im Abschnitt „[[#Einbindung|Einbindung]]“ beschrieben.

Der zugewiesene Code gibt an, wo der Link platziert werden soll:
* <code>"p-cactions"</code> – Ende der ''[[#p-cactions|content actions]]'' (meist horizontales Menü oben auf der Seite) – ''Vorgabe'';
* <code>"p-tb"</code> – Ende der [[#p-tb|Werkzeugbox]] (meist in der linken Spalte des Portals) – ''siehe Beispiel'';
* <code>"p-navigation"</code> – Ende der [[#p-navigation|Navigationsbox]] (meist in der linken Spalte des Portals);
* <code>"ca-history"</code> – jedes ausgewählte [[CowboysWiki:Technik/Skin/GUI#Selektor|Portlet-Element]] dieser Boxen, nach dem der Purge-Link eingefügt werden soll.

Der generierte Link hat je nach Kontext einen [[CowboysWiki:Technik/Skin/CSS#CSS-Notation|Selektor]] wie:
* <code>#ca-purge</code> (Vorgabe)
* <code>#n-purge</code>
* <code>#t-purge</code>

Ausblenden ist auch möglich; etwa weil aus einem anderen Skript bereits entsprechende Möglichkeiten vorhanden sind:
<syntaxhighlight lang="javascript">
mw.libs.pageLinkHelper = false;
</syntaxhighlight>

== Purgen für Experten: forcelinkupdate forcerecursivelinkupdate ==
Weitergehende Aktualisierungen als durch das einfache Purgen einer Seite können mit diesen Features erreicht werden. Das Ergebnis könnte allerdings verwirren. Es ist deshalb standardmäßig nicht aktiv. Experten wissen, wann es anzuwenden wäre und welche Auswirkungen das hätte.

Mit
<syntaxhighlight lang="javascript">
mw.libs.pageLinkHelper = { forcelinkupdate: true,
forcerecursivelinkupdate: true };
</syntaxhighlight>
(Vector) oder aber den gleichen Identifikatoren wie unter [[#purge|Purgen]] dargestellt kann in die ''portlet''-Container ein Link eingefügt werden, das per API auf die gleiche Seite ein ''link update'' startet.

Der generierte Link hat je nach Container einen Selektor wie:
* <code>#ca-purgeLinkUpd #n-purgeLinkUpd #t-purgeLinkUpd</code>
* <code>#ca-purgeLinkUpdRec #n-purgeLinkUpdRec #t-purgeLinkUpdRec</code>

== Weiterleitungen in der Browser-History ==
Wenn man einem Weiterleitungs-Link gefolgt war, erhält man eine kleine Notiz in der linken oberen Ecke der Seite; dazu ein Link auf die Weiterleitungsseite. Arbeitet man nun weiter, insbesondere wenn die Seite bearbeitet wird, dann ist bei der Rückkehr auf die Zielseite die Notiz verschwunden. Sie steht auch nicht in der Browser-History, sodass sie auch nicht über die Zurück-Funktion erreichbar wäre (schließlich war man ja auch nie wirklich auf dieser Weiterleitungsseite gewesen). Es gibt dann keinen einfachen Weg, um die Weiterleitungsseite zu erreichen, falls man dort etwas ändern möchte.

Dieses Gadget fügt in die Browser-History einen Zwischenschritt ein, wenn eine Weiterleitung verarbeitet worden war. Die dargestellte Seite ist immer noch dieselbe Zielseite; aber einen Eintrag zurück erscheint im Adressfeld des Browsers die [[Uniform Resource Locator|URL]], über die man direkt auf die Weiterleitungsseite gelangt. Klickt man nun das Adressfeld an, so wird die Weiterleitungsseite dargestellt und könnte bearbeitet werden.

=== Erforderliche Browser ===
Die Funktionalität ist vom Browser abhängig und bedarf relativ jüngerer Versionen: Chromium 5, Firefox 4, Gecko 2, IE 10, Opera 11.50, Safari 5.0.

=== Adresszeilen bis 2014 ===
Bis Sommer 2014 stand in der Adresszeile die URL der Weiterleitungsseite, wenn man über eine Weiterleitung dorthin gelangt war.<ref name="redirect.summer2014" />

Wenn dieses Verhalten weiterhin simuliert werden soll, kann die nachstehende Option gesetzt werden:
<syntaxhighlight lang="javascript">
mw.libs.pageLinkHelper = { redirect: { legacy: true } };
</syntaxhighlight>
Dies sollte auf der [[Special:MyPage/common.js|common.js]], [[meta:Special:MyPage/global.js|global.js]] oder Skin-abhängigem JS stehen, und zwar möglichst vor dem Aufruf <code>mw.loader.load()</code> wie im Abschnitt „[[#Einbindung|Einbindung]]“ beschrieben.

== Beobachtungsliste, Benutzerbeiträge, Versionsgeschichte, Letzte Änderungen ==
Hier stehen zu Beginn jedes Eintrags Links auf den Versionsunterschied und die Version, die sich schlecht in Wikilinks umformatieren lassen. Das Gadget ersetzt diese URL durch solche auf die entprechenden Spezialseiten, die sich sehr viel einfacher weiterverwenden lassen.

== qqx – Systemnachrichten sichtbar machen ==
Eher von Techies benötigt wird ein zusätzliches Feature, das bei der Wartung der Systemkonfiguration hilft; es macht die Bezeichner der [[CowboysWiki:Technik/Skin/MediaWiki#Systemnachrichten|Systemnachrichten]] in einer Seite sichtbar. Es ist deshalb standardmäßig nicht aktiv.

Mit
<syntaxhighlight lang="javascript">
mw.libs.pageLinkHelper = { slangQQX: true };
</syntaxhighlight>
(Vector) oder aber den gleichen Identifikatoren wie unter [[#purge|Purgen]] dargestellt kann in die ''portlet''-Container ein Link auf die gleiche Seite eingefügt werden, das mit [[Hilfe:URL-Parameter#uselang|uselang]]=[[CowboysWiki:Technik/MediaWiki/Datenformate#lang|qqc]] ausgestattet ist.

Der generierte Link hat je nach Container einen Selektor wie:
* <code>#ca-langQQX #n-langQQX #t-langQQX</code>

== Mehrere Benutzeroptionen ==
Wenn mehrere Optionen angegeben werden sollen, muss ein etwas anderes Format gewählt werden, da man sich sonst gegenseitig überschreibt. Etwas professioneller sieht das wie folgt aus:
<syntaxhighlight lang="javascript">
if ( typeof mw.libs.pageLinkHelper !== "object" ) {
mw.libs.pageLinkHelper = { };
}
mw.libs.pageLinkHelper.purge = "p-tb";
mw.libs.pageLinkHelper.redirect = { legacy: true };
</syntaxhighlight>
Dies sollte auf der [[Special:MyPage/common.js|common.js]], [[meta:Special:MyPage/global.js|global.js]] oder Skin-abhängigem JS stehen, und zwar möglichst vor dem Aufruf <code>mw.loader.load()</code> wie im Abschnitt „[[#Einbindung|Einbindung]]“ beschrieben.

== Sprachkonfiguration ==
Die grundsätzliche Funktionalität ist auf jedem Wiki gegeben.

Die optische Darstellung kann für jede Sprache und ggf. auf jedem einzelnen Wiki individuell angepasst werden. Wenn keine gesonderte Spezifikation bekannt ist, fällt die Umsetzung in die englische Sprache zurück.

Zurzeit sind für „Deutsch“ standardmäßig Anpassungen vorhanden; auch bei der Benutzeroberfläche von mutmaßlich deutsch verstehenden Benutzern.

Weitere Übersetzungen können auf Wunsch zentral eingepflegt werden.

Individuell können Programmierer mittels einer Objektdefinition
<syntaxhighlight lang="javascript">
mw.libs.pageLinkHelper.config = { /* ... */ };
</syntaxhighlight>
jederzeit die Textkomponenten variieren, indem Komponenten analog zur lokalen <code>Config</code> vorgegeben werden.

== Code und Stammseite ==
Die Stammseite ist [[:en:User:PerfektesChaos/js/pageLinkHelper]] mit:
{| class="wikitable"
|-
| Quellcode
|
* [[:en:User:PerfektesChaos/js/pageLinkHelper/r.js|JavaScript]] – Komprimierter Code zum Laden
* [[:en:User:PerfektesChaos/js/pageLinkHelper/d.js|Kommentiertes Skript]] – zum Lesen durch Menschen und Debuggen
|-
| ResourceLoader
|
* <code>ext.gadget.pageLinkHelper</code> ''für [[mw:Extension:Gadgets]]''
* Dependencies: <code>user</code>, <code>mediawiki.util</code>
|-
| Namensraum
|
* <code>-1</code>   *   <code>Contributions Watchlist</code> ''(Gadgets)'' sowie <code>Diff</code> falls das jemals vorkommen sollte
* Jeder inhaltliche Namensraum.
|-
| <code>[[CowboysWiki:Technik/Skin/JS/mw/libs|mw.libs]]</code>
| <code>pageLinkHelper</code>
|}

== Anmerkungen ==
<references>
<ref name="redirect.summer2014">
Dieses Verhalten war nie erwünscht gewesen, sondern bislang unvermeidlich. Mit der bisherigen Browser-Software konnte die Adresszeile nicht wirksam verändert werden und musste die URL der ursprünglich aufgerufenen Seite zeigen. 
Es hatten sich weltweit Leute darüber beklagt, dass es unverständlich und verwirrend sei, wenn in der Adresszeile eine falsche URL steht. Über den kleinen WL-Hinweis links oben auf der Seite sind eigentlich die notwendigen Informationen gegeben. 
Mit {{Phab|Bugzilla=35045}} / {{Phab|Bugzilla=39328}} und dann [[gerrit:143852]] wurde von den inzwischen weitaus überwiegend verfügbaren Möglichkeiten Gebrauch gemacht.
</ref>
</references>

{{#interlanguagelink:en|User:PerfektesChaos/js/pageLinkHelper}}

Benutzer:PerfektesChaos/js/pageLinkHelper - Versionsgeschichte

Cowboy am 13. April 2026 um 10:50 Uhr