Gestion des ancres dans les publications créées avec markdown

Soutien
2

Salut, bienvenue !

Cette syntaxe provient-elle de kramdown ou de PHP Markdown Extra ?

Discourse s’appuie sur MarkdownIt, qui est basé sur la spécification CommonMark. Il ne prend pas en charge la spécification d’un ID d’en-tête.

Il semble qu’ils en aient discuté à un moment donné : Anchors in markdown - Spec - CommonMark Discussion, mais je ne vois pas de conclusion définitive.

Cependant, Discourse génère automatiquement des ancres.
Vous pouvez le voir ici :

Essentiellement, vous pouvez vous attendre à ces ID :

  • h-{headingId} (pas d’ID de publication, pas de slug)
  • h-{slug}-{headingId} (pas d’ID de publication)
  • p-{postId}-h-{headingId} (ID de publication, pas de slug)
  • p-{postId}-h-{slug}-{headingId} (ID de publication, slug)

Par exemple :

L'interface détaillée d'un IDE en ligne, présentant la syntaxe du code HTML avec des éléments mis en surbrillance, y compris une balise d'ancre, les valeurs associées de la balise d'ancre, une propriété CSS flex et des structures de code sémantiquement pertinentes. (Légendé par l'IA)
L'interface détaillée d'un IDE en ligne, présentant la syntaxe du code HTML avec des éléments mis en surbrillance, y compris une balise d'ancre, les valeurs associées de la balise d'ancre, une propriété CSS flex et des structures de code sémantiquement pertinentes. (Légendé par l'IA)865×308 23.1 KB

Si vous préférez, vous pouvez toujours créer une ancre manuellement avec HTML, par exemple, <a name="anchor_name"></a>

L'image montre une fenêtre de navigateur Web avec une zone de texte Header ouverte, contenant du code HTML : << suivi de <a name=test>Header</a>. (Légendé par l'IA)
L'image montre une fenêtre de navigateur Web avec une zone de texte Header ouverte, contenant du code HTML : << suivi de <a name=test>Header</a>. (Légendé par l'IA)708×156 6.87 KB

L'image affiche du code HTML qui crée une balise d'ancre liée à header-1 avec les attributs name et href définis sur p-704-a-nametestestast Header et test respectivement, indiquant une interface de navigation de page Web relative à la surveillance des performances. (Légendé par l'IA)
L'image affiche du code HTML qui crée une balise d'ancre liée à header-1 avec les attributs name et href définis sur p-704-a-nametestestast Header et test respectivement, indiquant une interface de navigation de page Web relative à la surveillance des performances. (Légendé par l'IA)801×190 16.3 KB

Ressources supplémentaires –
Si vous avez besoin de générer une Table des matières, il existe ce composant pour vous :

5 « J'aime »