# Erweiterte Links

> Querverweise und LinkEnhancer-Links in GEDCOM-Datensätzen

---

Webtrees ersetzt XREFs wie `@I2@` in Notizen durch einen **Querverweis** und dessen Anzeige-Name — aber das ist nicht sehr flexibel. Man kann den Anzeigenamen nicht festlegen, was bedeutet, dass bei einem Fehler (durch XREF-Umnummerierung oder Tippfehler) die Auflösung des Querverweises nicht leicht oder gar nicht möglich ist.

> **Tipp:** Das Custom-Modul [webtrees-mitalteli-show-xref](https://github.com/elysch/webtrees-mitalteli-show-xref) kann helfen, die XREF- und UID-Referenz von Personendatensätzen zu finden. Einige UIDs (38 Zeichen Länge) werden von webtrees in der Standardansicht automatisch verkürzt — dieses Modul zeigt die unveränderten UIDs.

### Funktionsweise

Die erweiterte Links-Funktion ist per JavaScript implementiert und sucht in der gerenderten webtrees-Ausgabe nach `<a>`-Tags, deren `href`-Attribut mit `#@` beginnt. Dadurch können Links in Markdown und HTML-Markup verarbeitet werden. Da die Verarbeitung im Browser auf Client-Seite erfolgt, wird die Existenz der Querverweis-Datensätze nicht im Voraus geprüft. Fehler treten erst auf, wenn der Link angeklickt wird (z.B. wenn der Zugriff auf die Ressource eingeschränkt ist).

Als Bonus können mit einer Link-Definition verschiedene Ziele adressiert werden, wobei der Querverweis immer der erste Link ist (falls gesetzt) und die anderen nur durch angehängte klickbare Icons dargestellt werden.

### Vordefinierte externe Ziele

Die Parameter-Schlüssel sind in Klammern aufgeführt:

- Wikipedia *(wp)*
- Family Search Family Tree *(fsft)*
- [Einwohnerdatenbank - Familienforschung in Westpreußen](https://westpreussen.de/pages/forschungsergebnisse/einwohnerdatenbank/einwohner.php) *(ewp)*
- OpenStreetMap *(osm)*
- [Wer-wir-waren.at](https://www.wer-wir-waren.at/) *(www)* — ein Dienst des [Vorarlberger Landesmuseumsverein](https://vlmv.at/)
- [WikiTree](https://www.wikitree.com/) *(wit)*
- [CompGen](https://www.compgen.de/) Dienste:
  - [GenWiki](https://wiki.genealogy.net/) *(gw)*
  - [Online Ortsfamilienbücher](https://ofb.genealogy.net/?lang=en) *(ofb)*
  - das [Geschichtliche Orts-Verzeichnis](https://gov.genealogy.net/?lang=de) *(gov)*
  - [GEDBAS - Genealogische Datenbank](https://gedbas.genealogy.net/?lang=en) *(gedbas)*
  - [Datenerfassungssystem (DES) - Gefallenenlisten](https://des.genealogy.net/?lang=en) *(vl)*

Jeder Parameter-Schlüssel kann mehrfach angegeben werden — aber man sollte es der Klarheit halber nicht übertreiben.

**Zusätzliche externe Ziele** können auf der [Admin-Seite](../../setup/settings) konfiguriert werden.

### Syntax

**Markdown:** Ein erweiterter Link sieht so aus: `[Link-Anzeigename](#@param1&paramN)`, sodass ein oder mehrere Ziele auf einmal adressiert werden können. Für Querverweise in webtrees wird eine Datensatz-Referenz erwartet (REF kann die XREF oder eine [UID](../uid-lookup) sein):

- `wt=@REF@` oder `wt=@REF@andererbaum` — Standard-Link, Zugriff auf die Datensatzseite über Redirect-URL
- `wt=n@REF@` — Legacy-Link mit gegebenem Record-Typ (hier: zu einer Notiz mit REF im aktuellen Baum)
  - Verfügbare Record-Typen: `i`=Person, `f`=Familie, `s`=Quelle, `r`=Depot, `n`=Notiz, `l`=geteilter Ort
- `wt=i@REF@andererbaum+dia` — Link zum Personentyp mit REF aus Baum "andererbaum" und zusätzlich Link zum Interaktiven Sanduhrdiagramm dieser Person

**HTML:** Dasselbe gilt für HTML-Links: `<a href="#@wt=i@I1@">Link-Anzeigename</a>`

Dies ist auch in Kombination mit der Namensschild-Funktion des [Vesta Classic Look & Feel Moduls](https://github.com/vesta-webtrees-2-custom-modules/vesta_classic_laf) im HTML-Snippet-Feld verwendbar: `<a href="#@fsft=<ref/>"></a>` zum Verlinken eines Datensatzes im Family Search Family Tree. Es ist auch möglich, solche Links in News-Artikeln von Tyweds [news-menu Modul](https://github.com/Tywed/news-menu) oder in FAQ-Artikeln einzubetten.

Die Syntax der externen Ziele wird von der Markdown-Hilfe-Funktion dieses Moduls aufgelistet. In den meisten Fällen muss nur ein einzelnes Schlüssel-Wert-Parameterpaar angegeben werden, bestehend aus dem Kurznamen des gewünschten Ziels und der ID des dort befindlichen Datensatzes.

### Beispiel

Im oberen Teil des Bildes ist der Bearbeitungsmodus eines Notizdatensatzes zu sehen, unten die Darstellung im Anzeigemodus:

![Notiz mit erweiterten Links - Bearbeiten und Ansicht](img/le/screenshot_note-enh-links-edit-and-view.png)

---

Section pages:

- [Querverweis-Übersicht](/wt-modules/de/docs/linkenhancer/features/enhanced-links/xref-overview/): Querverweis-Übersicht mit Link-Index für große Bäume
- [xref_IDs neu nummerieren (mit Verweisen)](/wt-modules/de/docs/linkenhancer/features/enhanced-links/renumber/): XREFs umnummerieren mit automatischer Link-Reparatur
- [Datenkorrekturen](/wt-modules/de/docs/linkenhancer/features/enhanced-links/data-fixes/): Datenkorrektur-Handler für Link-Integritätsprobleme