Zum Hauptinhalt springen
Unlisted page
This page is unlisted. Search engines will not index it, and only users having a direct link can access it.

URLs

The URL component lets you reference an external link by key instead of hardcoding it. Each key maps to a URL per language, so a visitor always lands on the language-appropriate version of the destination, and a link that moves or breaks only needs fixing in one place, no matter how many docs reference it.

Managing URLs​

You can edit the URLs collection in the CMS.

  1. Click the Add icon ( + ) to add a new Key.
  2. Under URL (per language), click the Add icon to add a Translation for each language the link should support. Give it a Language Code and the destination URL.
  3. Under Default Link Text (per language), add a Translation for each language, giving the text a <Url> usage should show when it doesn't supply its own.

Using URLs​

  1. Select URL Link from the Embed list.
  2. Enter the URL Key matching an entry in the URLs collection.
  3. Optionally, add Link Text translations to override the key's default text for this specific usage — the same key can be used in different places with different wording.
Der Linktext wurde nicht maschinell übersetzt

Im Gegensatz zu gewöhnlicher Prosa wird der Linktext einer <Url>-Verwendung niemals einer automatischen Übersetzung unterzogen – die gesamte Komponente bleibt bei der Übersetzung eines Dokuments in jeder Sprache genau so erhalten, wie sie geschrieben wurde. Wenn Sie Linktext hinzufügen, geben Sie diesen gleichzeitig in allen unterstützten Sprachen in dem Dokument ein, in dem Sie den Link zum ersten Mal einfügen. Eine Sprache, die an dieser Stelle ausgelassen wird, bleibt so lange unberücksichtigt, bis jemand die Quelle bearbeitet und sie manuell hinzufügt.

Wenn Sie für eine bestimmte Verwendung keinen benutzerdefinierten Wortlaut benötigen, lassen Sie den Linktext leer; stattdessen wird der Standard-Linktext des Schlüssels verwendet – dieser Text wird auf die übliche Weise einmalig in der URLs-Sammlung übersetzt.

Example​

URL NOT FOUND

The URLs collection also hosts the Link Health dashboard, which reports on both the URLs stored here and any external links still hardcoded directly in your docs — including which of those aren't in the URLs collection yet, so you can find and centralize them. See Dashboards for details.