Comic Book Guy: Die Seite wurde neu angelegt: „{{Dokumentation/Dokuseite}} {{TemplateData|JSON= { "description": { "de": "'''Linkziel'''(e) zu einem Abschnitt oder einem Element '''innerhalb''' der aktuellen Wiki-Seite vereinbaren {{#switch: {{lc:{{int:lang}}}} |de|de-at|de-ch|de-formal|als|bar|dsb|frr|gsw|hsb|ksh|lb|nds|pdc|pdt|pfl|sli|stq|vmf|en|en-gb|en-uk|en-us=|#default=[{{canonicalurl:Template:Anchor|uselang=en}} ''(English version)'']}}", "e…“

2024-08-26T13:22:06Z

Die Seite wurde neu angelegt: „<noinclude>{{Dokumentation/Dokuseite}}</noinclude> {{TemplateData|JSON= { "description": { "de": "'''Linkziel'''(e) zu einem Abschnitt oder einem Element '''innerhalb''' der aktuellen Wiki-Seite vereinbaren<noexport> {{#switch: {{lc:{{int:lang}}}} |de|de-at|de-ch|de-formal|als|bar|dsb|frr|gsw|hsb|ksh|lb|nds|pdc|pdt|pfl|sli|stq|vmf|en|en-gb|en-uk|en-us=|#default=[{{canonicalurl:Template:Anchor|uselang=en}} ''(English version)'']}}</noexport>", "e…“

Neue Seite

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
{{TemplateData|JSON=
{ "description":
{ "de": "'''Linkziel'''(e) zu einem Abschnitt oder einem Element '''innerhalb''' der aktuellen Wiki-Seite vereinbaren<noexport> {{#switch: {{lc:{{int:lang}}}} |de|de-at|de-ch|de-formal|als|bar|dsb|frr|gsw|hsb|ksh|lb|nds|pdc|pdt|pfl|sli|stq|vmf|en|en-gb|en-uk|en-us=|#default=[{{canonicalurl:Template:Anchor|uselang=en}} ''(English version)'']}}</noexport>",
"en": "Define link target to a section or element within current wiki page"
},
"params": { "1": { "label": { "de": "Anker-1",
"en": "anchor #1" },
"description": { "de": "[[Fragmentbezeichner]] mit [[#Syntaxprüfung|Syntaxtest]]",
"en": "Fragment ID, with syntax check" },
"type": "line",
"suggested": true
},
"2": { "label": { "de": "Anker-2",
"en": "anchor #2" },
"description": { "de": "Weiterer Fragmentbezeichner (mit Syntaxtest)",
"en": "Another fragment ID, with syntax check" },
"suggested": false,
"inherits": "1"
},
"3": { "label": { "de": "Anker-3",
"en": "anchor #3" },
"inherits": "2" },
"-1": { "label": { "de": "ungeprüfter Anker 1",
"en": "unchecked anchor 1" },
"description": { "de": "Fragmentbezeichner ohne Syntaxtest",
"en": "Fragment ID, skipping syntax check" },
"type": "line"
},
"-2": { "label": { "de": "ungeprüfter Anker 2",
"en": "unchecked anchor 2" },
"description": { "de": "Weiterer Fragmentbezeichner ohne Syntaxtest",
"en": "Another fragment ID, skipping syntax check" },
"inherits": "-1" },
"-3": { "label": { "de": "ungeprüfter Anker 3",
"en": "unchecked anchor 3" },
"inherits": "-2" },
"4": { "label": { "de": "Anker-4",
"en": "anchor #4" },
"inherits": "2" },
"5": { "label": { "de": "Anker-5",
"en": "anchor #5" },
"inherits": "2" },
"6": { "label": { "de": "Anker-6",
"en": "anchor #6" },
"inherits": "2" },
"x1": { "label": { "de": "ungeprüfter Anker x1",
"en": "unchecked anchor x1" },
"description": { "de": "Weiterer Fragmentbezeichner ohne Syntaxtest (nicht mehr erwünschtes Namensschema, gelegentlich durch <code>[[#templatedata:-1|-1]]</code> usw. ersetzen)",
"en": "Another fragment ID, skipping syntax check (outdated naming scheme, use <code>-1</code>)" },
"inherits": "-2" }
},
"format": "inline"
}
|TOC=1}}

== Kopiervorlage ==
<pre>
{{Anker|}}
</pre>

== Verwendung ==
Es ist öfters sinnvoll, zusätzlich zur momentanen [[Hilfe:Überschrift|Überschrift]] auf bestimmte Stellen einer längeren Wiki-Seite zu verlinken:
# Die bisherige Überschrift soll sich ändern, alte Verlinkungen sollen aber weiterhin funktionieren.
# Gleiche Überschriften kommen mehrfach vor, etwa in einer strukturierten Systematik.
# Größere Elemente haben überhaupt keine Überschrift, die im Inhaltsverzeichnis erscheint.
Hier kann man einen [[Fragmentbezeichner]] weitgehend frei wählen. Er kann aber kein [[Senkrechter Strich|Pipe-Symbol]] »<code>|</code>« oder [[Anführungszeichen]] »<code>"</code>« enthalten, sollte nicht mit einer [[Ziffer]], sondern mit einem [[Buchstabe]]n beginnen und sollte auch kein [[Doppelkreuz (Schriftzeichen)|Doppelkreuz]] »<code>#</code>« enthalten. Generell ist alles sinnvoll, was auch [[Hilfe:Seitenname#invalid|als Lemma möglich]] ist. Der Name darf sich nicht mit einer vorhandenen Überschrift überschneiden, mit einem anderen Anker oder den MediaWiki-seitigen Bezeichnern natürlich auch nicht. Der Bezeichner sollte „sprechend“, also selbsterklärend, sowie kurz und eindeutig sein. Es ist pfiffig, als Bezeichner Wörter oder Konstrukte zu wählen, die sprachlich als zukünftige Überschriften nicht in Frage kommen. Groß- und Kleinschreibung sind signifikant.

''Beispiel:'' Der Link <code><nowiki>[[Foo#bar]]</nowiki></code> führt zum Anker <code><nowiki>{{Anker|bar}}</nowiki></code> im Artikel „Foo“.

Es können auch mehrere (beliebig viele) Anker mit dieser Vorlage angegeben werden, und zwar über <code><nowiki>{{Anker|</nowiki>''Name1''<nowiki>|</nowiki>''Name2''<nowiki>|</nowiki>''Name3''<nowiki>|…}}</nowiki></code>.

Der Bezeichner ist für die Leser der Seite kaum sichtbar, könnte von aufmerksamen Betrachtern allerdings in der [[Uniform Resource Locator|URL]] gesehen werden.

Die Browser sollen bei Unterschieden in Groß- und Kleinschreibung von unterschiedlichen Sprungzielen ausgehen; mehrere Fragmentbezeichner in der Seite sollten sich jedoch nicht ausschließlich durch Groß- und Kleinschreibung unterscheiden, auch nicht durch unsichtbare Nuancen in typografischen Details. Wie in jedem Wikilink sind Leerzeichen, mehrfache Leerzeichen und Unterstreichungsstrich <code>_</code> gleichwertig.

=== Alternative Namen für Überschriften ===
Mit Hilfe von Ankern kann vermieden werden, dass – wenn sich die Überschrift des Abschnitts ändert – alle Links auf diesen Abschnitt angepasst werden müssen. Diese Vorlage ist aber nicht dazu gedacht, Tipparbeit beim Verlinken zu sparen. Deshalb sollte bei neu gesetzten Links immer gleich auf die richtige Abschnittsüberschrift verlinkt werden, wenn diese einfach und voraussichtlich beständig formuliert ist.

Falls der Anker einen alternativen Namen für eine Überschrift liefern soll, ist der beste Ort, die Vorlage einzubauen, innerhalb der Überschrift selbst:
<pre>
== {{Anker|Name1|Name2}} Überschrift ==
</pre>
Zu den Gründen siehe [[Hilfe:Überschrift#anchor|Hilfe:Überschrift]].

=== Einschränkungen ===
Die Anwendung innerhalb von Überschriften in der Form
<pre>
== {{Anker|Bar}} Bar ==
</pre>
(d. h. gleicher Text sowohl in Vorlage wie Überschrift selbst) ist nicht nur überflüssig, sondern ist unzulässig und zu vermeiden: Technischer Hintergrund ist, dass Überschriften automatisch einen Anker mit einer [[Hypertext Markup Language|HTML]]-ID erzeugen (hier „Bar“), die auf der ganzen Seite ''eindeutig'' (daher einmalig) sein muss.<ref>[https://wiki.selfhtml.org/wiki/HTML/Attribute/id selfhtml.org]</ref>
Da bei Anwendung der Vorlage diese ID doppelt vergeben wird, führt dies zu ungültigem HTML und möglichen Inkonsistenzen in der Navigation.

Aus dem gleichen Grund sind Vorlageneinbindungen mit einem Wert identisch zu einer schon vorhandenen Überschrift unzulässig; es wird in der Regel die erste Fundstelle angesprungen.

Des Weiteren gelten daher für die hier erzeugten Bezeichner die gleichen Einschränkungen wie für [[Hypertext Markup Language|HTML]]-IDs.<ref>[https://wiki.selfhtml.org/wiki/CSS/Tutorials/Selektoren/einfacher_Selektor#Umgang_mit_IDs.2C_die_spezielle_Zeichen_enthalten selfhtml.org]</ref>

Eine inoffizielle Liste von ([[MediaWiki]]) bereits vergebenen IDs (daher unzulässigen Namen, ohne Anspruch auf Vollständigkeit/Aktualität) – als Anhaltspunkt – befindet sich in der englischsprachigen Wikipedia: [[:en:Wikipedia:Catalogue of CSS classes #IDs]]

=== Tabellen ===
Innerhalb von Tabellen sollten keine Anker mittels dieser Vorlage gesetzt werden.
* Je nach Tabellenlayout kann das dazu führen, dass genau auf die fragliche Textzeile positioniert wird. Ist diese jedoch nicht oben bündig ausgerichtet, kann es leicht sein, dass von ihren Nachbarzellen die oberen Zeilen nicht im Sichtbereich erscheinen, weil dieser am tiefer liegenden Anker ausgerichtet wurde.
Besser ist hier folgende Syntax:
<pre>
|- id="MeinSprungZiel"
| Text der ersten Zelle
| Text der zweiten Zelle
</pre>
Bei <code>[[Hilfe:Tags#id|id="…"]]</code> wird der Name des Sprungziels angegeben; das bezieht sich dann auf die gesamte Tabellenzeile, und der Browser „weiß“ dann, dass er diese auch komplett anzeigen soll, also etwa auch mit den Rahmenlinien.

Generell ist die Vorlage dafür vorgesehen, um im normalen Text zunächst ein Dummy-Element zu generieren und dieses dann mit dem Fragmentbezeichner auszustatten. Wo hingegen bereits ein HTML-Element oder Tabellensyntax vorhanden ist, wäre es pfiffiger, dieses direkt über <code>id="…"</code> mit dem Bezeichner zu versehen.

''Zwei Dinge sind jedoch zu beachten:''
* Innerhalb einer ID darf kein Leerzeichen vorkommen, stattdessen ist der Unterstrich zu benutzen. Die Vorlage führt die Ersetzung automatisch durch, bei direkter Eintragung muss man selbst darauf achten. In Wikisyntax kann das Sprungziel trotzdem mit Leerzeichen angegeben werden. Es ist keine robuste oder stabile Lösung, sich darauf zu verlassen, dass das zufällig momentan beobachtete Verhalten der MediaWiki-Software dauerhaft alle Probleme lösen würde und in jeder Konstellation zum beabsichtigten Resultat führen würde.
* Je Tabellenelement darf nur eine ID vorkommen. Wenn in seltenen Fällen mehr IDs benötigt werden, kann man unter Umständen eine ID der Tabellenzeile und eine direkt einer Zelle zuordnen, sonst bleibt nur die Nutzung der Vorlage übrig.
Syntax:
<pre>
|- id="ein_Sprungziel_mit_Unterstrich"
| id="anderes_Sprungziel" | Text der ersten Zelle
| Text der zweiten Zelle
</pre>
Wenn dieser Tabellencode im Artikel ''Beispiel'' zu finden wäre, könnte man mit diesen Wikilinks direkt auf die Sprungziele verweisen: <code><nowiki>[[Beispiel#ein Sprungziel mit Unterstrich]]</nowiki></code> und <code><nowiki>[[Beispiel#anderes Sprungziel]]</nowiki></code>.

== Syntaxprüfung ==
Seit Ende 2019 werden die Fragmentbezeichner auf Robustheit und möglicherweise überflüssige Wikisyntax überprüft.
* Mit <code>-1=</code> oder <code>-2=</code> usw. (zuvor auch: <code>x1=</code> oder <code>x2=</code>) lässt sich für alle konfliktträchtigen Bezeichner die Syntaxprüfung vorläufig zurückzustellen.

; Nicht gern gesehen
: Ziffer am Anfang; könnte in mancher externen Nutzung zu Problemen führen.
: Wird jedoch geduldet, wo es nun mal so ist; lieber vermeiden.
: Löst trotzdem Fehlermeldung aus.
: Besser umgehen, indem zur Gliederung innerhalb der Seite ggf. <code>§</code>, <code>Nr</code> oder <code>Band</code> vorangestellt wird: <code>§1</code> <code>Nr1</code> <code>Art1</code> (bei Jahreszahlen schwieriger)
; Mutmaßliche Fehler
: Wikisyntax im Bezeichner, also Wikilinks und auch [[Hypertext Markup Language|HTML]]-Codes oder Entities, machen die erforderliche URL unlesbar und würden nicht sinnvoll angesprochen werden können.
: Wenn die MediaWiki-Software aus einer Abschnittsüberschrift einen Bezeichner bildet, wird diese auch auf den reinen Text reduziert und alles Markup entfällt.
: Ein Wikilink auf einen Fragmentbezeichner, der seinerseits mit eckigen Klammern oder Pipes gebildet wird, ist kaum noch sinnvoll zu notieren.
; Ungeeignete Bezeichner
: Syntaktische Schwierigkeiten entstehen, wenn eines der folgenden Zeichen enthalten ist: <code>#</code> <code>%</code> <code><</code> <code>></code> und die Begrenzer <code>'</code> <code>"</code>
; Absolut verbotene Bezeichner
: Das sind alle, zu denen es in der Wiki-Seite bereits ein gleichnamiges Sprungziel gibt (oder damit zu rechnen wäre). Der Browser springt immer nur zum allerersten gefundenen, und das HTML-Dokument wird fehlerhaft.
: Das wären alle gleichnamigen Überschriften und anderen Anker in unserem Text.
: Außerdem alle Bezeichner in der Wiki-Software<span class="nomobile"> – etwa [[#top]]</span>. Das sind:
:* Alles mit <code>mw-</code> und <code>wp</code> beginnend gehört der globalen Software.
:* {{#invoke:Vorlage:Anker|forbidden}}
:* Alle Elemente des Desktop-Portalrahmens, wie beim [[Wikipedia:Technik/Skin/GUI|GUI]] beschrieben, bzw. das dafür verwendete Namensformat.

== Wartung ==
{{Vorlagenfehler-Wartungskat}}

== Anzahl der Parameter ==
Seit Ende 2019 gibt es keine Begrenzung der Anzahl der Sprungziele mehr.

== {{Anker|Bsp|examples}} {{int:apisandbox-examples}} ==
In [[Alsfeld]] soll der Abschnitt ''Gebäude'', in welchem das Rathaus erwähnt wird, verlinkt werden.

1. In der Überschrift „Gebäude“ den Anker-Baustein einfügen:
<pre>
=== {{Anker|Rathaus}} Gebäude ===
</pre>

2. Jetzt kann man
<pre>
[[Alsfeld#Rathaus|Rathaus Alsfeld]]
</pre>
verlinken; das sieht so aus: [[Alsfeld#Rathaus|Rathaus Alsfeld]]

== „Anker 2.0“ ==
In der ersten Version (2006–2009) war es noch erforderlich gewesen, im Link vor den Ankernamen <code>Anker:</code> zu setzen: <code><nowiki>[[foo#Anker:bar]]</nowiki></code>. Das erwies sich jedoch bald als unpraktisch; sowohl bei der Verlinkung, aber vor allem auch, weil man für eine anders formulierte Abschnittsüberschrift keine Anker mit ihrem bisherigen Text setzen konnte, sondern sämtliche Verlinkungen aktualisieren musste.

Die ursprünglichen Verweise, die das vorgesetzte <code>Anker:</code> verwendeten, wurden zunächst zusätzlich unterstützt: <code><nowiki>[[foo#Anker:bar]]</nowiki></code> funktionierte noch in einer Übergangsphase.

Bis Sommer 2017 waren alle Bestandsverlinkungen im ANR und auf aktiven Projektseiten auf die einfachere Praxis umgestellt worden; Ende 2017 wurde die mittlerweile unnötige Duplizierung von Elementen im HTML-Dokument aufgegeben.

Eine weitere Umstellung ist mittlerweile einbezogen: Historisch waren früher Umlaute und Sonderzeichen durch die MediaWiki-Software nach einem anderen Verfahren kodiert worden, als das heutzutage (seit [[HTML5]]) möglich und üblich ist. Die Vorlage generiert zur Kompatibilität mit alten externen Lesezeichen und Dokumenten zusätzlich zur heutigen vereinfachten Form auch die frühere Notation („Punkt-Encoding“), falls dies zu Unterschieden führt, bis nicht mehr mit nennenswertem Aufkommen alter Sprungziele zu rechnen ist.

== Hilfsmittel ==
Das [[Wikipedia:Technik/Skin/Benutzerskripte/Hinweise|Benutzerskript]] [[Benutzer:PerfektesChaos/js/fragmentAnchors|fragmentAnchors@PerfektesChaos]] analysiert eine Wiki-Seite. Ungeeignete Sprungziele, doppelt vergebene und fehlende innere Verlinkungen werden aufgelistet. Bei den normalerweise versteckten Sprungmarkierungen wird eine Möglichkeit angeboten, sie sichtbar zu machen und sie einfach zu kopieren.

== {{Anker|Andere Sprachversionen}} Andere Sprachversionen – Template:Anchor ==
In der englischsprachigen Wikipedia gibt es eine Vorlage [[:en:Template:Anchor]].
* Zur Kompatibilität unterstützen wir insbesondere zur anschließenden Migration eine [[Vorlage:Anchor]] als Weiterleitung, bis die Einbindung ggf. durch deutschsprachigen Namen ersetzt oder in einem anderssprachigen Wiki einkopiert wurde.

== Anmerkungen ==
<references />
<includeonly>
{{Dokumentation/Lua|Vorlage:Anker}}

[[Kategorie:Vorlage:Formatierungshilfe]]
[[Kategorie:Vorlage:Linkhilfe]]
[[Kategorie:Vorlage:mehrsprachig dokumentierte Vorlage]]
</includeonly>

Vorlage:Anker/Doku - Versionsgeschichte