Prise en charge du format AsciiDoc pour écrire des articles

Existe-t-il un moyen de permettre la publication de messages au format AsciiDoc ?

AsciiDoc est un langage de balisage léger similaire à Markdown. Nous utilisons AsciiDoc pour l’écriture et Antora pour le rendu du site de documentation. En attendant, nous utilisons Discourse comme notre communauté.

La communauté et le site de documentation peuvent partager des informations/connaissances communes. Il est nécessaire de migrer certains contenus de documentation vers la communauté.

4 « J'aime »

Bienvenue, Stephen :slight_smile:

Il n’existe actuellement aucun moyen d’écrire des publications au format AsciiDoc.
Je pense que cela nécessiterait un plugin, et je soupçonne qu’il serait difficile à implémenter s’il entrait en conflit avec l’utilisation régulière de Markdown-it que Discourse utilise. Je ne suis cependant pas développeur.

Pouvez-vous préciser ce que vous entendez par là ? Je ne suis pas sûr de comprendre.

1 « J'aime »

Tant qu’il était implémenté dans des îles, la création d’un plugin pour le faire ne serait pas trop difficile. J’estime sa création à une semaine de travail plus ou moins, par exemple :

```asciidoc
VOTRE ASCIIDOC ICI
```

L’intégration et la publication d’Antora ajouteraient une bonne dose de complexité et pourraient faire passer cela à plusieurs semaines de travail.

2 « J'aime »

Ooh. Nous utilisons également Antora. Ce serait génial !

Oui. Un plugin serait bien. Étant donné que nos publications peuvent nécessiter beaucoup de tableaux, ce que Markdown ne gère pas bien. De plus, certaines publications peuvent devoir être traduites dans d’autres langues, après traduction, le format est un désordre.

Je suis heureux d’apprendre qu’il n’est pas difficile de développer un tel plugin. Pourriez-vous partager des instructions ou un tutoriel pour le développer ? Je pourrai alors demander à nos ingénieurs de le développer.

Avez-vous vu le composant svgbob ?