Ce guide explique comment créer un lien direct vers un titre dans une publication ou un sujet Discourse, permettant aux utilisateurs de naviguer efficacement dans les longues publications.
Niveau d’utilisateur requis : Tous les utilisateurs
L’ajout de titres dans les longues publications peut rendre le contenu plus lisible et permettre aux utilisateurs de créer des liens directs vers des sections spécifiques. Ceci peut être particulièrement utile pour naviguer dans des discussions et de la documentation étendues.
Résumé
Ce guide couvre :
- La création de titres en utilisant Markdown
- La création de liens directs vers des titres spécifiques dans une publication
Créer des titres en utilisant Markdown
Pour créer un titre en Markdown, préfixez une ligne de texte avec un ou plusieurs caractères #. Le nombre de caractères # correspond au niveau du titre. Voici quelques exemples :
## Ceci est un titre de niveau 2
Voici un court paragraphe ensuite.
### Ceci est un titre de niveau 3
Voici un autre court paragraphe.
Lors du rendu, cela ressemble à ceci :
Ceci est un titre de niveau 2
Voici un court paragraphe ensuite.
Ceci est un titre de niveau 3
Voici un autre court paragraphe.
Créer un lien direct vers un titre
Pour partager un lien direct vers un titre dans une publication :
- Survolez le titre pour révéler une icône de lien à côté de celui-ci :
. - Cliquez sur l’icône de lien pour mettre à jour l’URL dans la barre d’adresse de votre navigateur avec le lien direct vers ce titre.
- Copiez l’URL mise à jour à partir de la barre d’adresse pour la partager avec d’autres.
L’icône de lien n’apparaît que sur les appareils de bureau (non tactiles) lorsque vous survolez un titre. Sur les appareils tactiles et mobiles, les ancres de lien existent sur la page mais ne sont pas visibles.
Comprendre les URL d’ancre de titre
Lorsque vous cliquez sur l’icône de lien d’un titre, l’URL dans votre barre d’adresse se met à jour avec un fragment dans le format :
#p-{postId}-{slugified-heading}-{number}
Par exemple, un titre « Getting Started » dans la publication 12345 produirait un fragment d’URL comme #p-12345-getting-started-1. Le nombre à la fin est un compteur séquentiel basé sur la position du titre dans la publication.
Bonnes pratiques
- Utilisez des titres descriptifs pour résumer clairement le contenu.
- Structurez votre publication en utilisant des titres hiérarchiques si nécessaire.
- Assurez-vous que les titres sont cohérents et logiques pour une meilleure lisibilité.
- Soyez conscient que la modification du texte des titres ou la réorganisation des titres modifiera leurs URL d’ancre, ce qui pourrait casser les liens existants.
FAQ
Puis-je créer un lien vers n’importe quelle partie d’une publication ?
Vous pouvez créer un lien vers n’importe quel titre correctement formaté en Markdown, tant qu’il ne se trouve pas à l’intérieur d’un bloc de citation ou d’un bloc de devis. Les titres à l’intérieur de ces blocs ne génèrent pas de liens d’ancre.
Les liens vers les titres fonctionnent-ils entre différentes publications ?
Oui ! Ces liens dirigeront vers le titre dans la publication lorsqu’ils sont utilisés dans d’autres sujets ou partagés ailleurs.
