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

Soutien
1

Salut la communauté, j’utilise un site discourse pour publier certaines spécifications qui sont principalement écrites en markdown, mais j’ai rencontré le problème que les ancres utilisées pour les en-têtes sont rendues, alors qu’elles devraient être masquées.

Quelqu’un sait-il s’il existe un moyen de les masquer ?

image
image1333×533 27.8 KB

2 « J'aime »
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 »
3

Merci beaucoup @Arkshine !

Le problème vient plutôt du fait que nous publions également les markdowns utilisés pour d’autres raisons sur Discourse, de sorte que les personnes qui maintiennent les documents utilisent ces ancres pour des références croisées lors de la fusion de plusieurs markdowns en un seul document.

Je pense que je vais créer une sorte de script pour nettoyer avant de publier le contenu.

3 « J'aime »
4

Je vois !

La solution consiste également à créer un plugin pour Discourse avec un plugin markdown pour prendre en charge cette syntaxe. Si vous avez un budget, vous pourriez demander sur Marketplace.

5

@Nihokam

Si vous êtes toujours intéressé, j’ai créé un petit plugin Discourse qui permet de spécifier un ID d’ancre à côté de l’en-tête.

Il fonctionne en parallèle des ancres automatiques d’en-tête de Discourse.
Notez qu’il s’agit d’un support basique. Il existe probablement de nombreuses variantes, mais ce plugin ne prend en charge que les suivantes :

## Mon En-tête {#ancre_personnalisee}

générera :

<a name="ancre_personnalisee" href="#ancre_personnalisee" class="custom-anchor-id"></a>

L’image affiche une interface d’éditeur Markdown avec diverses icônes de mise en forme HTML et Markdown, et une liste d’en-têtes développée avec le titre 1, le sous-titre 1.1, un autre titre et des symboles d’entités HTML personnalisées dans la barre d’outils. (Légendé par l’IA)
L’image affiche une interface d’éditeur Markdown avec diverses icônes de mise en forme HTML et Markdown, et une liste d’en-têtes développée avec le titre 1, le sous-titre 1.1, un autre titre et des symboles d’entités HTML personnalisées dans la barre d’outils. (Légendé par l’IA)922×286 7.71 KB

image
image365×223 9.99 KB

L’image montre un extrait HTML avec des balises et imbriquées contenant des références d’ancres personnalisées pour des sections cliquables intitulées « Titre 1 », « Sous-titre 1.1 » et « Autre titre ». (Légendé par l’IA)
L’image montre un extrait HTML avec des balises et imbriquées contenant des références d’ancres personnalisées pour des sections cliquables intitulées « Titre 1 », « Sous-titre 1.1 » et « Autre titre ». (Légendé par l’IA)771×310 10.5 KB

Vous pouvez essayer ! Faites-moi savoir si vous rencontrez des problèmes avec.

2 « J'aime »
6

Merci @Arkshine !

Je vais vérifier avec notre administrateur discourse à ce sujet :grin:

1 « J'aime »
7

@Arkshine Savez-vous comment les ancres sont générées dans Discourse (le site web actuel) ? Je demande car elles ne semblent pas suivre les modèles que vous avez partagés. Par exemple, regardez ceci :

https://meta.discourse.org/t/adding-a-table-to-your-post-using-markdown/66544#creating-a-simple-table-1

Y a-t-il un paramètre pour cela ? Je n’ai pas pu le trouver. Ou utilisent-ils <a> ? Ou votre plugin ?