Aller au contenu principal
Page non répertoriée
Cette page n'est pas répertoriée. Les moteurs de recherche ne l'indexeront pas, et seuls les utilisateurs ayant un lien direct peuvent y accéder.

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.
Le texte du lien n'est pas traduit automatiquement

Contrairement à la prose ordinaire, le texte de lien d’une balise <Url> n’est jamais soumis à une traduction automatique : l’élément est conservé tel quel lors de la traduction du document, quelle que soit la langue. Si vous ajoutez un texte de lien, renseignez-le simultanément dans toutes les langues prises en charge, dans le document où vous insérez le lien pour la première fois. Une langue omise à ce stade restera manquante jusqu’à ce que quelqu’un modifie la source et l’ajoute manuellement.

Si vous n’avez pas besoin d’une formulation personnalisée pour une utilisation particulière, laissez le texte de lien vide et le texte de lien par défaut de la clé sera utilisé à la place — ce texte est traduit de manière normale, une seule fois, dans la collection d’URL.

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.