Dokumentationsseiten verlinken
Erstelle sprachabhängige Content-, Überschriften-, Asset- und externe Links in Markdown.
Verwende eine $docs-Referenz für einen Link auf eine andere Dokumentationsseite. Ginko löst die Referenz zur passenden öffentlichen Route für die Sprache des Lesers auf.
[Configure the sidebar]($docs/authoring/navigation)Die Referenz verwendet die kanonischen englischen Routensegmente und nicht die lokalisierte öffentliche URL. Ginko ordnet diese Segmente der numerischen Dokumentidentität zu. Dieselbe Referenz gehört in die deutsche Übersetzung:
[Navigation gestalten]($docs/authoring/navigation)Auf der englischen Seite ergibt der Link /docs/authoring/navigation, auf der deutschen Seite /de/dokumentation/inhalte/navigation.
Überschrift verlinken
Hänge das in der Zielsprache generierte Fragment der Überschrift an die kanonische englische Routenreferenz an:
[Sidebar-Anzeige festlegen]($docs/authoring/navigation#sidebar-anzeige-festlegen)Verwende ein lokales Fragment, wenn die Überschrift auf derselben Seite steht:
[Zur Installation springen](#installation)Halte Überschriftentexte nach der Veröffentlichung stabil. Wenn du eine Überschrift änderst, ändert sich auch ihr generiertes Fragment.
Anwendungsrouten und Assets verlinken
Verwende eine root-relative URL für eine Nuxt-Route, die nicht aus der Docs-Collection stammt:
[Statusseite öffnen](/status)Referenziere öffentliche Assets vom Website-Stamm aus:
Lege dieses Bild unter public/images/acme-wordmark.svg ab.
Externe Websites verlinken
Verwende eine vollständige HTTPS-URL und benenne das Ziel:
[Nuxt-Dokumentation lesen](https://nuxt.com/docs)Schreibe für Links zwischen Dokumentationsseiten keine lokalisierten öffentlichen Pfade wie /de/dokumentation/.... $docs-Referenzen überstehen Änderungen deutscher Slugs, und der Content-Build schlägt fehl, wenn ein Ziel oder ein #anchor nicht mehr existiert. Benenne ein englisches Routensegment oder eine Überschrift nur um, wenn du die Referenzen darauf gleichzeitig aktualisierst.