Comment repérer et corriger les liens d’ancrage rompus et les fragments introuvables

Qu’est-ce qu’un lien d’ancrage ou un fragment d’URL ?#

Un lien d’ancrage utilise un identifiant de fragment après # pour désigner un emplacement ou un état dans une ressource. Dans une URL de documentation comme /help/#installation, le chemin identifie le document et le fragment désigne une cible à l’intérieur.

Pour un lien classique vers une section HTML, le fragment correspond généralement à l’identifiant d’un élément. Si le document se charge mais que la cible n’existe plus, le visiteur peut rester en haut ou atteindre un emplacement inattendu. Le code de réponse peut rester un code de réussite, car le document existe.

Pourquoi les liens d’ancrage se rompent après une modification#

De nombreux systèmes de contenu génèrent les identifiants des titres à partir de leur texte. Renommer « Installation » en « Premiers pas » peut modifier le fragment généré même si le sujet reste sur la même page. Réorganiser ou dupliquer les titres peut aussi modifier les identifiants générés automatiquement.

D’autres problèmes proviennent d’une adresse copiée partiellement, d’une modification de ponctuation ou d’une cible placée dans du contenu chargé uniquement après une interaction. Un lien fonctionnant sur votre page ouverte peut échouer lorsque quelqu’un saisit directement l’URL dans un nouvel onglet. Distinguez ces conditions de navigation et testez les deux.

Examiner une ancre introuvable#

Ouvrez l’URL de destination complète, fragment compris. Attendez le chargement du document, puis vérifiez que la section prévue existe et que le navigateur l’atteint. Comparez le fragment à l’identifiant exact utilisé par la page ; ne supposez pas que le texte visible du titre et l’identifiant généré sont identiques.

Utilisez Linky pour repérer les ancres introuvables, puis vérifiez manuellement l’état de la page concernée. L’inspecteur d’URL et de fragments de ce site peut séparer les composants d’une adresse collée, mais il ne charge pas la destination et ne prouve pas qu’un élément y existe.

1. Copiez le lien source complet, fragment compris.
2. Ouvrez-le dans un nouvel onglet et attendez la fin du chargement.
3. Identifiez le titre ou l’élément cible prévu.
4. Comparez son identifiant au fragment.
5. Corrigez la source ou la cible, puis testez de nouveau le parcours publié.

Choisir des identifiants stables pour les contenus référencés#

Pour les documentations souvent référencées, choisissez des identifiants stables qui décrivent le sujet et résistent aux changements de formulation. Un titre visible peut être amélioré sans rompre tous les favoris qui y pointent. Consignez les identifiants importants lors du transfert de contenu entre systèmes.

Si une ancienne ancre est très référencée, envisagez de conserver une cible compatible près de la section de remplacement. Assurez-vous de ne pas créer d’identifiants en double ni de perturber l’accessibilité. Si la compatibilité est impraticable, actualisez les liens que vous contrôlez et communiquez la nouvelle destination si nécessaire.

Fragments, routage et formats de liens particuliers#

Tous les fragments ne sont pas de simples identifiants d’élément. Certaines applications les utilisent pour le routage côté client ou l’état de l’application. Les liens vers des fragments de texte peuvent aussi désigner du texte plutôt qu’un élément cible classique. Identifiez le format avant d’interpréter le résultat du vérificateur.

Si votre application dépend d’un routage particulier par fragments, testez la navigation directe et le rechargement. Pour une référence de contenu ordinaire, préférez une destination stable que les visiteurs peuvent ouvrir et partager sans état préalable de l’application. Documentez les exceptions dans l’audit au lieu d’appliquer une règle unique à toutes les URL.

Vérifier les liens profonds lors des migrations et mises en production#

Ajoutez les fragments importants à la liste de migration, aux côtés des chemins de pages. La navigation de documentation, les sommaires et les notes de version contiennent souvent de nombreux liens de section. Une migration d’URL peut sembler réussie tout en rendant ces références inefficaces.

Avant publication, testez les liens depuis une autre page, pas seulement depuis le sommaire local. Après publication, analysez la page et examinez les liens profonds connus. Conservez ensemble le sujet visé, la page source et la nouvelle cible dans le suivi de correction pour qu’un autre rédacteur puisse comprendre le changement de destination.

• Vérifiez les identifiants de titres générés après les modifications.
• Évitez les identifiants en double dans un même document.
• Conservez des cibles stables pour les sections souvent partagées.
• Testez l’accès direct au contenu chargé dynamiquement.
• Examinez les fragments lors du déplacement ou de la fusion de documentation.

Questions fréquentes#

Mettez cette méthode en pratique

Consultez la documentation Linky associée pour connaître les commandes et limites du produit utilisées dans cet article. Contacter l’assistance si un résultat nécessite des investigations supplémentaires.