Benutzer:PerfektesChaos/js/WikiSyntaxTextMod/flow/link

WikiSyntaxTextMod → Syntaxpolitur → Schritt 4

Verlinkungen

In einem vierten Schritt der Syntaxpolitur erfolgt die Handhabung aller Verlinkungen. Mögliche Stellen werden einerseits durch ein [ und anschließend auch über :// aufgefunden.

Zum einen werden Linkziele möglicherweise angepasst, zum anderen erfolgt die Formatierung von Verlinkungen in allgemein üblicher und lesbarer Form. Das erleichtert später anderen Skripten und Bots die Arbeit oder ermöglicht erst das Auffinden.

Wikilink

Syntaxberichtigung

• In zweifelsfreien Fällen werden bei Wikilinks einzelne fehlende öffnende oder schließende Klammern ergänzt; überzählige entfernt.
  • Mehr als zwei öffnende [[ verhindern die Darstellung als Link und werden berichtigt (auf zwei reduziert). Mit [ lässt sich eine beabsichtigte sichtbare öffnende Klammer anzeigen.
• Stehen in einem Wikilink statt des einzelnen senkrechten Strichs mehrere unmittelbar aufeinander folgend, werden sie zu einem einzelnen reduziert.
  • Steht ansonsten im Linktitel ein weiterer senkrechter Strich, dann ist die beabsichtigte Unterteilung zwischen Linkziel und Linktitel nicht zweifelsfrei zuzuordnen und es erfolgt nur eine Fehlermeldung.
• Ein unzulässiger Zeilenumbruch innerhalb eines eingeklammerten Bereichs sinnvoller Ausdehnung wird in ein Leerzeichen umgewandelt.

Wikilink über http

Gelegentlich wird ein externes Link benutzt, wie

[http://de.wikipedia.org/wiki/Wikipedia:Hauptseite

[https://secure.wikimedia.org/wikipedia/de/wiki/Wikipedia:Hauptseite (siehe unten)

Dies wird in ein Wikilink umgesetzt.

Altbestände der Domain wikipedia.de wurden gesucht und kommen in aktuellen Artikeln nicht mehr als Link vor. Während diese ungültigen URL nicht mehr in die Artikel eingetragen werden können, kommt es vor, dass mit der Verlinkung nicht vertraute Autoren ein Wikilink als Weblink einfügen; das kann aber inzwischen nur noch in der TLD .org sein.

Wikilink mit Schreibrichtung (links-rechts)

Wenn unmittelbar vor oder nach einem Wikilink-Ziel ein (meist unsichtbares) Zeichen für die Schreibrichtung steht, wird dieses entfernt. Auf die Zugänglichkeit von Links hat das keinen Einfluss. Bei Interwiki-Verlinkungen beispielsweise in eine arabischsprachige Wikipedia beginnt das Linkziel mit :ar: und ist somit ohnehin nicht betroffen.

• Weitere nullbreite Zeichen werden in den dafür geeigneten Schriften unsichtbar belassen.

Wikipedia in anderen Sprachen und bedeutende Schwesterprojekte

Formal in ein Wikilink berichtigt wird zwar

[http://en.wikipedia.org/wiki/Schur%E2%80%93Zassenhaus_theorem

kann aber nicht als externes Link in den Abschnitt „Weblinks“ oder in <ref> versetzt werden.

Andere große Wikimedia-Schwesterprojekte (mit Kurzcode), die mit http verlinkt wurden, werden ebenfalls gesucht und in ein Wikilink umgesetzt.

Verwirrend ist die Standardzuordnung bei nicht angegebenem Sprachcode:

Aus der deutschsprachigen Wikipedia

Wikitext	Resultierende Sprache
{{Wikisource}}	→de
[[wikisource:Lemma	→en
[[s:Lemma	→de
[[w:Lemma	→en

Dies muss zwangsläufig zu Verwechslungen führen und wird auch öfters falsch verlinkt.

Es wird einheitlich umgestellt auf das Kürzel p (1 Buchstabe oder meta mw wikt):

• p:Lemma – wenn in gleicher Sprache anderes Projekt
• p:lang:Lemma – in anderer Sprache anderes Projekt
• :lang:Lemma – in anderer Sprache, gleiches Projekt

Ein führender Doppelpunkt vor einem Projekt-Bezeichner ist zwar häufig, jedoch funktionslos und wird entfernt.

Sehr selten findet sich die umgekehrte Reihenfolge :lang:p:Lemma – dies wird in die übliche Abfolge gebracht, auch wenn es in beiden Formaten funktionstüchtig ist.

In Artikeln und Hilfeseiten sollte auf den Projekt-Namensraum immer in der Langform (Wikipedia:) verlinkt werden, die dem tatsächlichen Seitentitel entspricht. Kurzformen (Alias) wie WP: gehören auf Diskussionsseiten oder in den Bearbeitungskommentar.

URL als Wikilink

Gemeint ist etwas wie

Gem%C3%A4ldegalerie_%28Berlin%29#Die_Gem.C3.A4ldegalerie_in_Dahlem

Dieses Gebräu in URL-Escape/UTF-8 wird ansprechender gestaltet.

Bekanntlich entsteht es, wenn Bearbeiter die URL des Ziels in das Wikilink kopieren. Die Unterstreichungsstriche werden durch Leerzeichen ersetzt. Die Escape-Sequenzen werden identifiziert und durch ASCII ersetzt, sofern erforderlich wird danach auch nach UTF-8 der Zeichencode in UCS ausgerechnet und durch das resultierende Zeichen ersetzt.

Wikilink auf sich selbst

Gemeint ist ein Wikilink, bei dem die aktuelle Seite (Selbst) Ziel der Verlinkung ist:

[[Selbst]]

lässt die Verlinkung entfallen, ein umgebogener Linktitel

[[Selbst|Alter Ego]]

wird ggf. zu

Alter Ego

Oft auch als

[[Selbst#Abschnitt|

also zu ersetzen durch

[[#Abschnitt|

Innerhalb eines Bereichs von includeonly oder onlyinclude ist das Selbstlink zulässig und erforderlich – dann wird es belassen.

Wikilink vereinfachen

Auch vergleichbare Konstrukte mit Wikilink auf andere Artikel:

[[Obergaden|Obergadenfenster]]

werden vereinfacht zu:

[[Obergaden]]fenster

Dies wird nach den gleichen Regeln zusammengezogen, die auch der Parser anwendet, so dass das Erscheinungsbild des dargestellten Artikels unverändert bleibt.

Insbesondere gilt das für

• [[Linkziel|Linkziel]]
  also schlicht
  [[Linkziel]]

Kleine menschliche Unzulänglichkeiten sind für die Software kein Problem, die hier mehr Phantasie aufweist:

• [[Farbe|Farbeindruck]]
  wird zu
  [[Farbe]]indruck

Weiterhin wird

[[Komponente (Software)|Komponente]]n

in

[[Komponente (Software)|Komponenten]]

transformiert.

Pipe-Trick

Nur wenigen Autoren bekannt ist der „Pipe-Trick“: Hierbei steht am Ende des Linkziels das Pipe-Symbol »|« unmittelbar vor den schließenden Klammern. Der leere Linktitel wird nach bestimmten Regeln aus dem Linkziel ergänzt und in der Seite dargestellt; so wird der Namensraum weggelassen und ein nachgestellter Klammerausdruck oder ein Komma im Linktitel beenden den angezeigten Titel.

Wenn dieses Schreibarbeit sparende Konstrukt vorgefunden wird, wird der sonst angezeigte Linktitel ermittelt und in der üblichen Form eingefügt, damit auch nachfolgende Autoren auf Anhieb die angezeigte Form erkennen können.

Ohnehin ist es ein seit 2005 bekannter Bug, dass dieser Trick innerhalb der „Tag-Extensionen“ wie <ref> oder <gallery> nicht funktioniert; wie auch andere Spezialitäten dort nicht umgesetzt werden. Insofern stellt die Ergänzung den beabsichtigten Zustand erst her.

Anker-Vorlage verlinkt

Selten sieht man noch Restbestände von Verlinkungen auf   #fragment   in der Form

#Anker:fragment

Dies wird entfernt.

Formatierung

Allgemein gilt:

• Es verbleibt kein Leerzeichen zwischen [[ und Linkziel oder um das Pipe-Symbol | oder vor den ]].

Weblink

Als Protokolle für Weblinks werden ausschließlich ausgewertet: http https ftp git mms svn sowie protokoll-relativ. Andere Protokolle sind im Wikitext technisch möglich, aber extrem selten.

Weblink-Korrektur

• Weblink mit \n
  Wenn auf eine URL nach öffnender eckiger Klammer unmittelbar ein Zeilenende \n folgt, wird dieses durch ein Leerzeichen ersetzt, weil das Weblink sonst nicht dargestellt werden kann.
  • Folgt dagegen eine Linkbeschreibung, wird nichts verändert, da das Ende nicht absehbar ist; häufig fehlt die schließende Klammer bis zum Ende des Absatzes.
• Weblink in doppelten eckigen Klammern
  Bei Links auf http:// bzw. https:// werden doppelte eckige Klammern auf einzelne reduziert.
• Können innerhalb einer URL paarweise eckige Klammern identifiziert werden, werden sie in zweifelsfreien Fällen automatisiert escaped:
  • tx_ttnews[tt_news]= usw. stammen mutmaßlich von TYPO3.
  • Es wird […] statt %5B…%5D verwendet. Damit wird die Original-Notation des Weblinks zweifelsfrei gewahrt. Zurzeit wandelt die Wiki-Software dies bei der Seitendarstellung in URL-Encoding mit % um – dies muss aber nicht von jedem Server unterstützt werden.
• Eine Warnung vor verdächtigen Zeichen in der URL wird in folgenden Fällen angezeigt:
  • "'{} bewirkt eine Unterbrechung der URL.
  • Pipe-Symbol | oder '' könnte von anders beabsichtigter Wikisyntax herrühren: Abtrennung des Linktitels und Kursiv- oder Fettschrift bei fehlendem Leerzeichen.
  • Am Ende der URL sind die Satzzeichen (,.;? verdächtig, weil sie durch die Wiki-Software beim ungeklammerten Link nicht als Bestandteil der URL aufgefasst werden; nach Einklammern der URL jedoch hinzugehören.
• Es wird in jedem Fall eine Warnmitteilung ausgegeben; in unsicheren Fällen wird nichts geändert und nur der Fehler angezeigt.

Weblink-Formatierung

Allgemein gilt:

• Es verbleibt kein Leerzeichen zwischen [ und http://
• Zwischen URL und einem Linktitel steht genau ein Leerzeichen.
• In Linktiteln gibt es keine mehrfachen Leerzeichen.

URL-Formatierung

• Es ist üblich, ein Weblink, das mit http/https ausschließlich auf eine Domain zeigt, mit einem Schrägstrich enden zu lassen. Grundsätzlich hat dies für den Zugriff auf die Seite keine Bedeutung (anders, wenn ein Schrägstrich an den Pfad oder das Fragment angehängt wird). Webserver geben ihre eigene URL regelmäßig in dieser Form zurück.
• Der Name der Domain (host) wird in Kleinbuchstaben umgeformt; so auch das Protokoll.

Weblink auf Wiki-Projekte

Bei geklammerten Weblinks mit Bezug zu Wiki-Projekten gilt für die URL:

• Ist eine Darstellung als Wikilink möglich, wird entsprechend konvertiert.
• Andernfalls wird bei dafür bekannten Wiki-Domains eine protokoll-relative Form gebildet. Sofern bestimmte Subdomains standardmäßig über https zu erreichen sind, wird das sichere Protokoll angegeben.
• Die Domain secure.wikimedia.org ist seit Herbst 2011 veraltet; eine gleichwertige aktuelle URL wird gemäß den vorstehenden Regeln gebildet.

Wenn die URL nicht in Klammern steht, aber für die Transformation in ein Wikilink geeignet wäre, wird nichts ersetzt, jedoch eine Warnung angezeigt.

Im Unterschied zu Wikilinks erscheinen Verlinkungen über URL nicht in den Links auf diese Seite und in der globalen Verwendung und können bei Aktualisierungen nicht gefuunden werden.

Änderung des Linkziels oder der Umgebung

Benutzerdefinierte Änderungen von Wikilink, URL, oder auch den angrenzenden Textsegmenten werden sofort an jedem gefundenen Linkziel ausgeführt.

Wenn es eine Notwendigkeit dafür gibt, wird das Linkziel gegen Veränderung geschützt.