Vorlage:Glossarlink/Doku

Diese Seite dokumentiert die Verwendung der Vorlage:Glossarlink.

Beschreibung

Diese Vorlage dient dazu, Begriffe mit einem Link zu einem spezifischen Glossareintrag zu versehen. Der Link wird visuell durch eine gepunktete Unterstreichung hervorgehoben und von einem kleinen Fragezeichen-Icon begleitet. Beim Überfahren des Icons mit der Maus wird der Text "Glossareintrag anzeigen" als Tooltip angezeigt.

Die Vorlage ist ideal, um Fachbegriffe oder spezielle Ausdrücke im Text zu erklären, ohne den Lesefluss zu unterbrechen.

Verwendung

Die Vorlage erwartet zwei Parameter: Zuerst den sichtbaren Text des Links und dann das Ziel des Glossareintrags (Seitenname und optionaler Abschnitt).

Syntax

Die grundlegende Syntax lautet: {{Glossarlink|Sichtbarer Text|Ziel des Glossareintrags}}

• Parameter 1 (Sichtbarer Text): Der Begriff oder die Phrase, die auf der Seite sichtbar ist und als Link fungiert. Dies ist ein Pflichtparameter.
• Parameter 2 (Ziel des Glossareintrags): Der Wikilink zum spezifischen Glossareintrag, z.B. Hilfe:Glossar#HTML oder Hilfe:Spezialbegriffe#PPP. Dies ist ebenfalls ein Pflichtparameter.

Beispiele

Normalfall (beide Parameter vorhanden)

Um auf den Abschnitt "HTML" im "Hilfe:Glossar" zu verlinken: {{Glossarlink|HTML|Hilfe:Glossar#HTML}} Wird zu: {{Glossarlink|HTML|Hilfe:Glossar#HTML}.

Um auf den Abschnitt "LAN" in "Abkürzungen (Liste)" zu verlinken: Weitere Informationen zu {{Glossarlink|LAN|Abkürzungen (Liste)#LAN}} gibt es im Glossar. Wird zu: LAN 

Fehlende Parameter (Fehlermeldungen)

Wenn Parameter fehlen, gibt die Vorlage eine Fehlermeldung aus, um auf das Problem hinzuweisen.

• Fehlender Text für den Link:

   {{Glossarlink||Hilfe:Glossar#HTML}}
   Wird zu: 

• Fehlendes Link-Ziel:

   {{Glossarlink|HTML|}}
   Wird zu: 

• Beide Parameter fehlen:

   {{Glossarlink}}
   Wird zu: 

Technische Details

Die Vorlage generiert einen HTML-<abbr>-ähnlichen Effekt durch Inline-CSS für die gepunktete Unterstreichung (border-bottom: 1px dotted;) und den Mauszeiger (cursor: help;).

Das Fragezeichen-Icon wird durch die Einbindung der Datei realisiert, die auf 12 Pixel Breite skaliert und vertikal ausgerichtet wird (vertical-align: -2px; für eine mittige Darstellung). Das Icon selbst ist nicht anklickbar (link=-Parameter ist leer).

Die Vorlage verwendet Parserfunktionen (#if:), um das Vorhandensein der Parameter zu prüfen und entsprechende Fehlermeldungen auszugeben, falls diese fehlen.