Vorlage:Anker/Doku
Aus Kitakien
(→Dokumentation: +Hinweise wg. doppelten IDs) |
K (8 Versionen: Vorlagenmix) |
||
| (Der Versionsvergleich bezieht 6 dazwischenliegende Versionen mit ein.) | |||
| Zeile 1: | Zeile 1: | ||
<noinclude>{{Dokumentation/Dokuseite}}</noinclude> | <noinclude>{{Dokumentation/Dokuseite}}</noinclude> | ||
== Beschreibung == | == Beschreibung == | ||
| - | |||
Gebraucht wird ein spezifischer Link zu einem Abschnitt eines Artikels in der Wikipedia. | Gebraucht wird ein spezifischer Link zu einem Abschnitt eines Artikels in der Wikipedia. | ||
Die '''Vorlage Anker''' bietet diese Möglichkeit an, ohne dass man auf eine Überschrift verlinken muss. So können „sprechende“ Abschnittsnamen erzeugt werden, wo eine Überschrift nicht angebracht ist oder nicht so prägnant formuliert werden kann, wie es für den Link wünschenswert wäre. | Die '''Vorlage Anker''' bietet diese Möglichkeit an, ohne dass man auf eine Überschrift verlinken muss. So können „sprechende“ Abschnittsnamen erzeugt werden, wo eine Überschrift nicht angebracht ist oder nicht so prägnant formuliert werden kann, wie es für den Link wünschenswert wäre. | ||
| - | ==Dokumentation== | + | == Dokumentation == |
Die Vorlage <nowiki>{{Anker}}</nowiki> erwartet einen Parameter hinter dem |, dessen Namen man frei wählen kann: | Die Vorlage <nowiki>{{Anker}}</nowiki> erwartet einen Parameter hinter dem |, dessen Namen man frei wählen kann: | ||
<pre>{{Anker|bar}}</pre> erzeugt im Artikel ''foo'' einen Anker. Diesen kann man anschließend mit <pre>[[foo#bar]]</pre> verlinken. | <pre>{{Anker|bar}}</pre> erzeugt im Artikel ''foo'' einen Anker. Diesen kann man anschließend mit <pre>[[foo#bar]]</pre> verlinken. | ||
| - | ===Alternative Namen für Überschriften=== | + | Es können auch mehrere Anker mit dieser Vorlage angegeben werden (bis zu 6 Anker insgesamt), über <code><nowiki>{{Anker|Name1|Name2|Name3|...}}</nowiki></code>. |
| + | |||
| + | === Alternative Namen für Überschriften === | ||
| + | |||
Falls der Anker einen alternativen Namen für eine bestehende Überschrift liefern soll, ist der beste Ort, die Vorlage einzubauen, nicht vor der Überschrift, sondern in der gleichen Zeile: | Falls der Anker einen alternativen Namen für eine bestehende Überschrift liefern soll, ist der beste Ort, die Vorlage einzubauen, nicht vor der Überschrift, sondern in der gleichen Zeile: | ||
<pre> | <pre> | ||
| - | =={{Anker|Name1 | + | == {{Anker|Name1|Name2|Name3}}Überschrift == |
</pre> | </pre> | ||
| Zeile 24: | Zeile 26: | ||
== {{Anker|Bar}} Bar == | == {{Anker|Bar}} Bar == | ||
</pre> | </pre> | ||
| - | (d.h. Gleicher Text sowohl in Vorlage wie in der Überschrift selbst) ist überflüssig und zu vermeiden: Die Überschrift | + | (d. h. Gleicher Text sowohl in Vorlage wie in der Überschrift selbst) ist überflüssig und zu vermeiden: Die Überschrift |
<pre> | <pre> | ||
== Bar == | == Bar == | ||
| - | <pre> | + | </pre> |
| - | generiert automatisch einen Anker mit der id 'Bar'. Bei Anwendung der Vorlage wird diese id doppelt vergeben, was zu invalidem | + | generiert automatisch einen Anker mit der id 'Bar'. Bei Anwendung der Vorlage wird diese id doppelt vergeben, was zu invalidem [[HTML]] führt und Inkonsistenzen in der Navigation und der [[Cascading Style Sheets|CSS]]-Formatierung führen kann. |
Aus dem gleichen Grund sind Vorlageneinbindungen mit einem Wert identisch zu einer schon vorhandenen Überschrift unzulässig. | Aus dem gleichen Grund sind Vorlageneinbindungen mit einem Wert identisch zu einer schon vorhandenen Überschrift unzulässig. | ||
| Zeile 37: | Zeile 39: | ||
Weil es schwer sein dürfte, alle bestehenden Verweise zu finden, die das vorgesetzte ''Anker:'' verwenden, bleibt diese Möglichkeit erhalten: <code><nowiki>[[foo#Anker:bar]]</nowiki></code> funktioniert noch. | Weil es schwer sein dürfte, alle bestehenden Verweise zu finden, die das vorgesetzte ''Anker:'' verwenden, bleibt diese Möglichkeit erhalten: <code><nowiki>[[foo#Anker:bar]]</nowiki></code> funktioniert noch. | ||
| - | ==Beispiele== | + | == Beispiele == |
In [[Alsfeld]] soll das Kapitel ''Bauwerke'', in welchem das Rathaus erwähnt wird, verlinkt werden. | In [[Alsfeld]] soll das Kapitel ''Bauwerke'', in welchem das Rathaus erwähnt wird, verlinkt werden. | ||
| Zeile 45: | Zeile 47: | ||
2. Jetzt kann man <pre>[[Alsfeld#Rathaus|Rathaus Alsfeld]]</pre> verlinken, das sieht so aus: [[Alsfeld#Rathaus|Rathaus Alsfeld]] | 2. Jetzt kann man <pre>[[Alsfeld#Rathaus|Rathaus Alsfeld]]</pre> verlinken, das sieht so aus: [[Alsfeld#Rathaus|Rathaus Alsfeld]] | ||
| - | + | == Andere Ausgaben == | |
| - | + | Für die englische Version, zu der es eine ausführlichere Diskussion gibt, siehe [[:en:Template:Anchor]]. | |
| - | + | ||
| - | + | ||
| - | ==Andere Ausgaben== | + | |
| - | + | ||
Aktuelle Version vom 14:54, 9. Dez. 2009
| Datei:Information icon.svg | Diese Seite ist die Dokumentations-Unterseite der Vorlage:Anker. |
Inhaltsverzeichnis |
Beschreibung
Gebraucht wird ein spezifischer Link zu einem Abschnitt eines Artikels in der Wikipedia. Die Vorlage Anker bietet diese Möglichkeit an, ohne dass man auf eine Überschrift verlinken muss. So können „sprechende“ Abschnittsnamen erzeugt werden, wo eine Überschrift nicht angebracht ist oder nicht so prägnant formuliert werden kann, wie es für den Link wünschenswert wäre.
Dokumentation
Die Vorlage {{Anker}} erwartet einen Parameter hinter dem |, dessen Namen man frei wählen kann:
{{Anker|bar}}
erzeugt im Artikel foo einen Anker. Diesen kann man anschließend mit
[[foo#bar]]
verlinken.
Es können auch mehrere Anker mit dieser Vorlage angegeben werden (bis zu 6 Anker insgesamt), über {{Anker|Name1|Name2|Name3|...}}.
Alternative Namen für Überschriften
Falls der Anker einen alternativen Namen für eine bestehende Überschrift liefern soll, ist der beste Ort, die Vorlage einzubauen, nicht vor der Überschrift, sondern in der gleichen Zeile:
== {{Anker|Name1|Name2|Name3}}Überschrift ==
So werden die Anker bei einer Bearbeitung auch dann sichtbar, wenn nur der Abschnitt bearbeitet wird.
Falsche Anwendung
Die Anwendung innerhalb von Überschriften in der Form
== {{Anker|Bar}} Bar ==
(d. h. Gleicher Text sowohl in Vorlage wie in der Überschrift selbst) ist überflüssig und zu vermeiden: Die Überschrift
== Bar ==
generiert automatisch einen Anker mit der id 'Bar'. Bei Anwendung der Vorlage wird diese id doppelt vergeben, was zu invalidem HTML führt und Inkonsistenzen in der Navigation und der CSS-Formatierung führen kann.
Aus dem gleichen Grund sind Vorlageneinbindungen mit einem Wert identisch zu einer schon vorhandenen Überschrift unzulässig.
„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 Überschriftnamen 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.
Beispiele
In Alsfeld soll das Kapitel Bauwerke, in welchem das Rathaus erwähnt wird, verlinkt werden.
1. In der Überschrift der Bauwerke den Anker-Baustein einfügen:
=== Bauwerke {{Anker|Rathaus}} ===
2. Jetzt kann man
[[Alsfeld#Rathaus|Rathaus Alsfeld]]
verlinken, das sieht so aus: Rathaus Alsfeld
Andere Ausgaben
Für die englische Version, zu der es eine ausführlichere Diskussion gibt, siehe en:Template:Anchor.
