Quelltext der Seite Vorlage:Anker/Doku

<noinclude>{{Dokumentation/Dokuseite}}</noinclude>
== 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 <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.

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:

<pre>
== {{Anker|Name1|Name2|Name3}}Überschrift ==
</pre>

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
<pre>
== {{Anker|Bar}} Bar ==
</pre>
(d.&nbsp;h. Gleicher Text sowohl in Vorlage wie in der Überschrift selbst) ist überflüssig und zu vermeiden: Die Überschrift
<pre>
== Bar ==
</pre>
generiert automatisch einen Anker mit der id 'Bar'. Bei Anwendung der Vorlage wird diese id doppelt vergeben, was zu invalidem {{WikipediaLink|HTML}} führt und Inkonsistenzen in der Navigation und der {{WikipediaLink|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.

===„Anker 2.0“===
In der ersten Version war es noch erforderlich, im Link vor den Ankernamen ''Anker:'' zu setzen: <code><nowiki>[[foo#Anker:bar]]</nowiki></code>. 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: <code><nowiki>[[foo#Anker:bar]]</nowiki></code> funktioniert noch.

== Beispiele ==
In {{WikipediaLink|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:
<pre>=== Bauwerke {{Anker|Rathaus}} ===</pre>

2. Jetzt kann man <pre>{{WikipediaLink|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 [http://en.wikipedia.org/wiki/Template:Anchor en:Template:Anchor].