Ajout de liens hypertextes

Les hyperliens sont l'un des outils les plus puissants en documentation technique. Bien réalisés, ils réduisent les frictions pour les lecteurs, maintiennent votre contenu interconnecté et améliorent les performances de votre Knowledge base dans la recherche. Mal réalisés, ils créent des impasses, des expériences cassées et des utilisateurs frustrés.

Dans Document360, vous pouvez ajouter des liens hypertextes vers du texte, des images et des fichiers dans vos articles ou pages de catégories, en reliant vers du contenu lié, des ressources externes ou des sections spécifiques au sein d'un même article. Par exemple, si vous écrivez un guide d'installation logicielle, un lien hypertexte vers la page de téléchargement évite à vos lecteurs de devoir le chercher eux-mêmes.

Cet article couvre tout ce que vous devez savoir sur l'ajouter, la gestion et l'optimisation des hyperliens dans Document360, à la fois sur l' Markdown et Advanced WYSIWYG editor.

Pourquoi les hyperliens sont importants dans une base de connaissances

Avant de plonger dans le comment, il vaut la peine de comprendre le pourquoi.

Pour les lecteurs, les hyperliens signifient qu'ils n'ont jamais à partir en plein milieu de la tâche pour partir à la recherche d'informations pertinentes. Si un utilisateur lit votre guide « Débuts » et a besoin de comprendre l'authentification API, un lien hypertexte l'y emmène instantanément, sans recherche, sans changement de contexte.

Pour votre base de connaissances, une structure bien liée indique aux moteurs de recherche (et aux systèmes d'IA) que votre contenu est autoritaire, organisé et complet. Cela impacte directement le SEO (le classement de vos articles sur Google), l'AEO (Answer Engine Optimization, la fréquence à laquelle les assistants IA citent votre contenu) et le GEO (Generative Engine Optimisation, que des outils comme ChatGPT, Perplexity ou Claude utilisent votre contenu comme source).

Pour votre équipe de support, les liens hypertextes entre les articles liés réduisent les questions répétitives. Au lieu de réécrire la même explication sur cinq articles, vous l'écrivez une fois et y mettez un lien partout.

Pour les mainteneurs de contenu, les liens d'ancrage et les identifiants d'en-tête persistants permettent de restructurer les articles sans casser tous les liens qui y mènent.

Types d'hyperliens que vous pouvez créer dans Document360

Document360 prend en charge quatre principaux types d'hyperliens, chacun ayant une fonction différente :

Ajout de liens hypertextes à un article

Lien vers des titres spécifiques

Lorsqu'on traite d'articles longs ou de pages de catégorie, les liens d'ancrage (également appelés bookmark links ou liens fragments) permettent de diriger les lecteurs vers une section spécifique d'un article, pas seulement vers le haut de la page.

Pourquoi cela est important

Les articles longs sont courants dans la documentation technique. Un lecteur qui arrive en haut d'un article de 3 000 mots à la recherche de la section Désinstaller doit faire défiler tout le reste pour le trouver. Un lien d'ancrage les mène directement là-bas.

C'est particulièrement précieux lorsque :

• Liens depuis la FAQ - « Comment réinitialiser mon mot de passe ? » renvoie directement à la section Réinitialiser mot de passe d'un article plus long sur la gestion de compte

• Lien à partir de messages d'erreur - Votre application affiche une erreur avec un lien « En savoir plus » qui mène directement à l'étape de dépannage concernée

• Création d'une table des matières - Un long article s'ouvre sur une liste de sections, chacune renvoyée à son titre ci-dessous

• Partage dans les tickets de support - Les agents de support collent un lien qui mène les clients directement à l'étape concernée, et non au début d'une page

Ajouter un lien de favori

Dans l' éditeur avancé WYSIWYG, suivez ces étapes pour mettre en favori les liens à l'intérieur des articles ou des catégories de pages :

1. Sélectionnez le texte souhaité et appuyez sur Ctrl + K. La fenêtre d'Ajout de lien apparaîtra.

2. Sélectionnez le bouton d 'option Article. Le champ Texte se remplira automatiquement avec le texte sélectionné. Le menu déroulant Espace de travail & Langue affichera votre espace de travail actuel et votre langue. Le champ Recherche d'article sera automatiquement l'article en cours.

3. Sélectionnez un titre dans l'article depuis le lien vers un menu déroulant de l'en-tête. Cela créera un lien direct vers cet en-tête.

4. Sélectionnez la case Open in a new tab si vous souhaitez ouvrir le lien dans un nouvel onglet.

5. Cliquez sur Ajouter.

NOTE

• Les titres H3 et H4 ne seront disponibles dans la liste déroulante que s'ils sont activés dans les paramètres. Pour les activer, naviguez dans () > Knowledge base site > Article settings & SEO Article settings > Article Right et assurez-vous que H3 et H4 sont sélectionnés.

Copie des liens de titres depuis le site de la base de connaissances

Sur le site publié de la base de connaissances, une icône Copier le lien () apparaît à côté de chaque titre H2, H3 et H4 lorsque vous survolez la cible. Cliquer dessus copie l'URL directe de cette section.

Cette fonctionnalité est utile pour :

• Équipes support - Récupérez rapidement et collez un lien direct dans une réponse support

• Documentation interne - Mettez directement en lien votre wiki interne ou vos messages Slack vers une section spécifique

• Relecteurs de contenu - Partagez des retours qui pointent vers la partie exacte de l'article en discussion

Comment Document360 gère les identifiants de tête

Chaque titres (H2 à H6) dans l'éditeur WYSIWYG avancé se voit automatiquement attribuer un ID unique et persistant. L'ID est généré en fonction du contenu linguistique par défaut dès que vous appuyez Enter après avoir tapé un en-tête, et il reste inchangé, même si vous renommez l'en-tête ultérieurement.

• Vous pouvez librement modifier le texte des titres sans interrompre les liens existants, qu'ils pointent vers des titres dans le même article ou dans un autre article.

• Si deux titres ont des titres identiques, Document360 ajoute des suffixes (_1, _2, etc.) pour garder les identifiants uniques.

• Les identifiants sont cohérents entre les traductions. Le même identifiant est conservé dans chaque version linguistique d'un article, de sorte que les liens restent fonctionnels quel que soit le langage consulté.

Ajout d'un lien d'e-mail

Un lien d'e-mail ouvre le client de messagerie par défaut du lecteur avec l'adresse déjà remplie. Cela réduit la friction liée au copier-coller d'une adresse.

Les usages courants dans la documentation incluent :

• « Des questions sur cet article ? Envoyez un e-mail à nos rédacteurs techniques »

• « Pour toute demande de facturation, contactez notre équipe financière »

• « Signalez une inexactitude dans cet article, faites-le nous savoir »

Lien vers des fichiers (PDF, images, documents Word)

Parfois, on veut que les lecteurs cliquent sur un lien et ouvrent directement un fichier, un PDF téléchargeable, une fiche technique, un modèle de configuration.

Document360 rend cela possible via le disque :

1. Téléchargez le fichier sur Document360 Drive.

2. Cliquez sur le fichier téléchargé pour ouvrir la vitrine des détails du fichier .

3. Dans la section Emplacement, cliquez sur l'icône Copier à côté du chemin du fichier. L'URL ressemblera à quelque chose à :https://cdn.document360.io/abc123/filename.pdf

   

4. Allez dans votre article et sélectionnez le texte que vous souhaitez mettre en lien avec un lien hypertexte.

5. Appuyez Ctrl + K pour ouvrir la boîte de dialogue Ajouter un lien .

6. Sélectionnez le bouton Lien externe , collez l'URL copiée, puis cliquez sur Ajouter.

Les lecteurs peuvent désormais cliquer sur le lien pour ouvrir ou télécharger le fichier directement depuis le site de la Knowledge Base.

Modifier ou délier un lien hypertexte

Dans l'éditeur WYSIWYG avancé, cliquer sur un texte hyperlié apparaît une petite barre d'outils avec quatre options ; suivez ces étapes pour gérer un hyperlien :

1. Cliquez sur le texte hyperlié. La boîte de dialogue Link apparaîtra.

2. Pour gérer le lien :

   • Ouvrez le lien : Cliquez sur le lien pour accéder à l'URL.

   • Modifier le lien : Cliquez sur l' Edit () pour modifier l'hyperlien.

   • Délier le texte : Cliquez sur l' icône Dissocier () pour supprimer l'hyperlien.

   • Copiez le lien : Cliquez sur l' Copy () pour copier l'hyperlien.

NOTE

Dans l'éditeur Markdown, les liens sont modifiés manuellement en modifiant directement la syntaxe Markdown.

Comment Document360 gère les URL des liens internes

Lorsque vous créez un lien interne pour un article, l'URL générée peut sembler légèrement différente selon votre configuration. Par exemple :

• https://docs.yourcompany.com/v1/docs/article-name (domaine personnalisé avec version workspace)

• https://yourproject.document360.io/docs/article-name (domaine Document360 par défaut)

Ces variations sont attendues et gérées automatiquement. Le segment /v1/ représente la version de l'espace de travail. Le format du domaine dépend de l'utilisation d'un domaine personnalisé.

Une erreur 404 ne survient que lorsque :

• L'article cible a été supprimé, inédit ou caché

• Le cap cible n'existe plus

• Le lien a été saisi manuellement avec une URL incorrecte

FAQ