Vorlage:Anker/Doku: Unterschied zwischen den Versionen
| (3 dazwischenliegende Versionen desselben Benutzers werden nicht angezeigt) | |||
| Zeile 31: | Zeile 31: | ||
== Verwendung == | == Verwendung == | ||
| − | Es ist öfters sinnvoll, zusätzlich zur momentanen | + | Es ist öfters sinnvoll, zusätzlich zur momentanen Überschrift auf bestimmte Stellen einer längeren Wiki-Seite zu verlinken: |
# Die bisherige Überschrift soll sich ändern; alte Verlinkungen aber weiterhin funktionieren. | # Die bisherige Überschrift soll sich ändern; alte Verlinkungen aber weiterhin funktionieren. | ||
# Gleiche Überschriften kommen mehrfach vor, etwa in einer strukturierten Systematik. | # Gleiche Überschriften kommen mehrfach vor, etwa in einer strukturierten Systematik. | ||
# Größere Elemente haben überhaupt keine Überschrift, die im Inhaltsverzeichnis erscheint. | # Größere Elemente haben überhaupt keine Überschrift, die im Inhaltsverzeichnis erscheint. | ||
| − | Hier kann man einen | + | Hier kann man einen Fragmentbezeichner weitgehend frei wählen. Er kann aber kein Pipe-Symbol »<code>|</code>« oder Anführungszeichen »<code>"</code>« enthalten, sollte nicht mit einer Ziffer beginnen und sollte auch kein <code>#</code> enthalten. Generell wäre alles sinnvoll, was auch als Lemma möglich ist. Der Name darf sich nicht mit einer vorhandenen Überschrift überschneiden. Der Bezeichner sollte „sprechend“, also selbsterklärend sein, sowie kurz und eindeutig. 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“''. | ''Beispiel:'' Der Link <code><nowiki>[[Foo#bar]]</nowiki></code> führt zum Anker <code><nowiki>{{Anker|bar}}</nowiki></code> im Artikel ''„Foo“''. | ||
| Zeile 41: | Zeile 41: | ||
Es können auch mehrere (bis zu 6 insgesamt) Anker mit dieser Vorlage angegeben werden, über <code><nowiki>{{Anker|Name1|Name2|Name3|…}}</nowiki></code>. | Es können auch mehrere (bis zu 6 insgesamt) Anker mit dieser Vorlage angegeben werden, über <code><nowiki>{{Anker|Name1|Name2|Name3|…}}</nowiki></code>. | ||
| − | |||
=== Alternative Namen für Überschriften === | === Alternative Namen für Überschriften === | ||
| Zeile 51: | Zeile 50: | ||
== {{Anker|Name1|Name2}} Überschrift == | == {{Anker|Name1|Name2}} Überschrift == | ||
</pre> | </pre> | ||
| − | |||
=== Einschränkungen === | === Einschränkungen === | ||
| Zeile 59: | Zeile 57: | ||
== {{Anker|Bar}} Bar == | == {{Anker|Bar}} Bar == | ||
</pre> | </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 | + | (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 HTML-ID erzeugen (hier „Bar“) die auf der ganzen Seite ''eindeutig'' (daher einmalig) sein muss.<ref>https://wiki.selfhtml.org/wiki/HTML/Universalattribute#id</ref> |
Da bei Anwendung der Vorlage diese ID doppelt vergeben wird, führt dies zu invalidem HTML und möglichen Inkonsistenzen in der Navigation. | Da bei Anwendung der Vorlage diese ID doppelt vergeben wird, führt dies zu invalidem 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. | 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 Bezeichnung des/der Links (Parameter) die gleichen Einschränkungen wie für HTML-IDs. Also der Name muss mit einem Buchstaben beginnen und darf keine Leerzeichen ( | + | Des Weiteren gelten daher für die Bezeichnung des/der Links (Parameter) die gleichen Einschränkungen wie für HTML-IDs. Also der Name muss mit einem Buchstaben beginnen und darf keine Leerzeichen (Leerraum) enthalten.<ref>https://wiki.selfhtml.org/wiki/Referenz:HTML#ID</ref> |
| − | Eine inoffizielle Liste von (MediaWiki/Wikipedia) bereits vergebenen IDs (daher unzulässigen Namen, ohne Anspruch auf Vollständigkeit/Aktualität) – als Anhaltspunkt – befindet sich in der englischen Wikipedia | + | Eine inoffizielle Liste von (MediaWiki/Wikipedia) bereits vergebenen IDs (daher unzulässigen Namen, ohne Anspruch auf Vollständigkeit/Aktualität) – als Anhaltspunkt – befindet sich in der englischen Wikipedia: Wikipedia:Catalogue of CSS classes#IDs |
=== „Anker 2.0“ === | === „Anker 2.0“ === | ||
| Zeile 74: | Zeile 72: | ||
== Beispiele == | == Beispiele == | ||
| − | In | + | In Alsfeld soll der Abschnitt ''Bauwerke'', in welchem das Rathaus erwähnt wird, verlinkt werden. |
1. In der Überschrift der Bauwerke den Anker-Baustein einfügen: | 1. In der Überschrift der Bauwerke den Anker-Baustein einfügen: | ||
| Zeile 83: | Zeile 81: | ||
2. Jetzt kann man | 2. Jetzt kann man | ||
<pre> | <pre> | ||
| − | + | [Alsfeld#Rathaus|Rathaus Alsfeld] | |
</pre> | </pre> | ||
| − | verlinken; das sieht so aus: | + | verlinken; das sieht so aus: [Alsfeld#Rathaus|Rathaus Alsfeld] |
== Andere Ausgaben == | == Andere Ausgaben == | ||
| − | Für die englische Version, zu der es eine ausführlichere Diskussion gibt | + | Für die englische Version, zu der es eine ausführlichere Diskussion gibt. |
| − | |||
<includeonly> | <includeonly> | ||
</includeonly> | </includeonly> | ||
Aktuelle Version vom 5. Dezember 2016, 19:03 Uhr
|
Diese Seite ist die Dokumentations-Unterseite der Vorlage:Anker. |
}}
{{#invoke:TemplateData|f}}
Inhaltsverzeichnis
Kopiervorlage
{{Anker|}}
Verwendung
Es ist öfters sinnvoll, zusätzlich zur momentanen Überschrift auf bestimmte Stellen einer längeren Wiki-Seite zu verlinken:
- Die bisherige Überschrift soll sich ändern; alte Verlinkungen 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 Pipe-Symbol »|« oder Anführungszeichen »"« enthalten, sollte nicht mit einer Ziffer beginnen und sollte auch kein # enthalten. Generell wäre alles sinnvoll, was auch als Lemma möglich ist. Der Name darf sich nicht mit einer vorhandenen Überschrift überschneiden. Der Bezeichner sollte „sprechend“, also selbsterklärend sein, sowie kurz und eindeutig. 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 [[Foo#bar]] führt zum Anker {{Anker|bar}} im Artikel „Foo“.
Es können auch mehrere (bis zu 6 insgesamt) Anker mit dieser Vorlage angegeben werden, über {{Anker|Name1|Name2|Name3|…}}.
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.
Falls der Anker einen alternativen Namen für eine Überschrift liefern soll, ist der beste Ort, die Vorlage einzubauen, innerhalb der Überschrift selbst:
== {{Anker|Name1|Name2}} Überschrift ==
Einschränkungen
Die Anwendung innerhalb von Überschriften in der Form
== {{Anker|Bar}} Bar ==
(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 HTML-ID erzeugen (hier „Bar“) die auf der ganzen Seite eindeutig (daher einmalig) sein muss.[1] Da bei Anwendung der Vorlage diese ID doppelt vergeben wird, führt dies zu invalidem 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 Bezeichnung des/der Links (Parameter) die gleichen Einschränkungen wie für HTML-IDs. Also der Name muss mit einem Buchstaben beginnen und darf keine Leerzeichen (Leerraum) enthalten.[2]
Eine inoffizielle Liste von (MediaWiki/Wikipedia) bereits vergebenen IDs (daher unzulässigen Namen, ohne Anspruch auf Vollständigkeit/Aktualität) – als Anhaltspunkt – befindet sich in der englischen Wikipedia: Wikipedia:Catalogue of CSS classes#IDs
„Anker 2.0“
In der ersten Version war es noch erforderlich, im Link vor den Ankernamen Anker: zu setzen: [[foo#Anker:bar]]. Dies ist inzwischen nicht mehr erforderlich; die neue Version entspricht auch dem Gebrauch in anderen Wikipedia-Sprachen. Ankernamen können nun in Konflikt mit Überschriften geraten, aber in der Praxis wird dies eher ein Hinweis sein, die Artikelstruktur zu überarbeiten – im Zweifelsfall kann immer noch der Ankername variiert werden.
Weil es schwer sein dürfte, alle bestehenden Verweise zu finden, die das vorgesetzte Anker: verwenden, bleibt diese Möglichkeit erhalten: [[foo#Anker:bar]] funktioniert noch auf längere Zeit.
Beispiele
In Alsfeld soll der Abschnitt Bauwerke, in welchem das Rathaus erwähnt wird, verlinkt werden.
1. In der Überschrift der Bauwerke den Anker-Baustein einfügen:
=== {{Anker|Rathaus}}Bauwerke ===
2. Jetzt kann man
[Alsfeld#Rathaus|Rathaus Alsfeld]
verlinken; das sieht so aus: [Alsfeld#Rathaus|Rathaus Alsfeld]
Andere Ausgaben
Für die englische Version, zu der es eine ausführlichere Diskussion gibt.
