# volution dAsciiDoc en spcification > [! remarque]- > Le contenu de cette page est généré à partir de la transcription audio/vidéo et de la transformation du texte provenant du contenu et des liens de cette source. Source : [https://fosdem.org/2025/schedule/event/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem/](https://fosdem.org/2025/schedule/event/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem/) <video src=« https://video.fosdem.org/2025/k4201/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem.av1.webm » controls></video> ## Résumé et points forts : La session explore l'évolution d'AsciiDoc en une spécification standardisée et son impact sur l'écosystème de la documentation. **Introduction à AsciiDoc** AsciiDoc est un langage de balisage en texte brut populaire pour écrire du contenu technique. Il est apprécié pour ses fonctionnalités riches et sa capacité à modulariser et réutiliser le contenu. Beaucoup de projets open-source l'utilisent pour collaborer sur des sites Web et des documentations. **Défis et solutions** La session aborde les défis liés à l'intégration des différentes parties d'un pipeline de documentation pour offrir une expérience utilisateur et contributeur de qualité. L'accent est mis sur l'importance de la spécification du langage AsciiDoc pour définir des règles de syntaxe standardisées. **Outils et implémentations** Plusieurs outils AsciiDoc sont présentés, démontrant leur utilisation dans des pipelines de documentation de projets réels. La session discute également des extensions qui permettent d'interagir au niveau structurel avec le document. **Conclusion** La normalisation d'AsciiDoc promet d'améliorer l'expérience des utilisateurs et des développeurs, en garantissant une cohérence dans le traitement des documents à travers différents outils et implémentations. ## Importance pour une transformation écosociale L'évolution d'AsciiDoc en une spécification standardisée est cruciale pour une transformation écosociale car elle facilite la création et la diffusion de documentation technique accessible et modulaire. Cela permet d'améliorer l'éducation et l'accès à l'information, des éléments clés pour le développement durable. Les designers écosociaux peuvent utiliser des outils comme Antora pour publier des documentations statiques de manière cohérente. Cependant, des défis subsistent, notamment la nécessité de standardiser les pratiques dans une communauté diversifiée et de surmonter les obstacles d'adoption dans des environnements techniques variés. ## Slides: | | | | --- | --- | | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_001.jpg\|300]] | La première diapositive présente le thème de la session : l'évolution d'AsciiDoc en une spécification et son impact sur l'écosystème. Alexander Schwartz, ingénieur logiciel principal chez Red Hat, est l'orateur de cette session qui se tient à FOSDEM à Bruxelles. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_002.jpg\|300]] | La deuxième diapositive résume la mission de la session : diffuser la documentation aux lecteurs. Elle aborde le flux de travail qui comprend l'écriture, la conversion et la publication, ainsi que la documentation de la marque et du langage AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_003.jpg\|300]] | La troisième diapositive reprend les thèmes de la session, soulignant l'importance de diffuser la documentation aux lecteurs. Elle détaille le flux de travail et mentionne l'importance de la documentation de la marque et du langage AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_004.jpg\|300]] | La quatrième diapositive se concentre sur la mission de diffusion de la documentation. Elle souligne que les auteurs doivent se concentrer sur le contenu et sa structure, que la conversion doit prendre en charge plusieurs cibles à partir d'une source unique, et que la documentation publiée doit éduquer les utilisateurs. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_005.jpg\|300]] | La cinquième diapositive rappelle les objectifs de la session, en mettant l'accent sur le flux de travail d'auteur, de conversion et de publication, ainsi que sur l'importance de la documentation de la marque et du langage AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_006.jpg\|300]] | La sixième diapositive détaille le processus d'écriture, de validation et de révision, en comparant différents environnements d'édition tels que les éditeurs, les IDE, les navigateurs et les interfaces en ligne de commande. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_007.jpg\|300]] | La septième diapositive décrit l'écriture dans un IDE, mettant en avant les avantages tels que l'absence de distraction, la coloration syntaxique, l'autocomplétion, et la vérification de la grammaire et du style. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_008.jpg\|300]] | La huitième diapositive continue sur l'écriture dans un IDE, soulignant la navigation dans le contexte, l'aperçu stylé, et la collaboration via le contrôle de version. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_009.jpg\|300]] | La neuvième diapositive explique comment structurer le texte et les listes en AsciiDoc, avec chaque phrase sur une ligne séparée et des lignes vides pour créer de nouveaux paragraphes. Elle couvre également le formatage du texte et la création de listes numérotées et à puces. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_010.jpg\|300]] | La dixième diapositive traite des paragraphes et des admonitions en AsciiDoc, montrant comment marquer un paragraphe comme important, utiliser des blocs d'exemple, et fournir une coloration syntaxique pour le code. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_011.jpg\|300]] | La onzième diapositive explique comment créer des tableaux en AsciiDoc, en utilisant des délimiteurs pour marquer le début et la fin, et comment formater le texte à l'intérieur des cellules. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_012.jpg\|300]] | La douzième diapositive montre comment intégrer du code source en AsciiDoc, avec des exemples d'inclusion standard et de sélection de blocs avec des commentaires. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_013.jpg\|300]] | La treizième diapositive discute de la validation du contenu en utilisant des outils comme Vale, avec des exemples de configuration pour vérifier le style et les erreurs dans les fichiers AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_014.jpg\|300]] | La quatorzième diapositive compare différents outils et formats de conversion, y compris Maven, npm, CLI, HTML, PDF et DocBook, ainsi que différentes implémentations d'AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_015.jpg\|300]] | La quinzième diapositive présente les convertisseurs en ligne de commande et les outils d'intégration, avec un exemple d'utilisation d'AsciiDoc pour convertir un fichier et générer des avertissements. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_016.jpg\|300]] | La seizième diapositive explique comment écrire des extensions pour interagir au niveau structurel avec AsciiDoc, en ajoutant de nouveaux macros et en générant du contenu qui peut être rendu dans n'importe quel format de sortie pris en charge. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_017.jpg\|300]] | La dix-septième diapositive se concentre sur la publication avec Antora, un outil pour publier des sites statiques à partir de contenu AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_018.jpg\|300]] | La dix-huitième diapositive clarifie que AsciiDoc est le langage, tandis que Asciidoctor est une implémentation, soulignant l'importance de la publication de sites statiques. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_019.jpg\|300]] | La dix-neuvième diapositive détaille les fonctionnalités d'Antora, telles que la génération de sites web simples à héberger, la publication entièrement automatisée, et les thèmes personnalisables. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_020.jpg\|300]] | La vingtième diapositive aborde la navigation personnalisée, le lien entre les pages, et les redirections lorsque les pages ont été renommées. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_021.jpg\|300]] | La vingt-et-unième diapositive décrit les rôles et responsabilités dans l'utilisation d'Antora, avec des auteurs créant du contenu, des opérateurs de documentation préparant les scripts d'automatisation, et des développeurs web personnalisant le thème de l'interface utilisateur. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_022.jpg\|300]] | La vingt-deuxième diapositive récapitule les thèmes de la session, en mettant l'accent sur la diffusion de la documentation, le flux de travail, et l'importance de la documentation de la marque et du langage AsciiDoc. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_023.jpg\|300]] | La vingt-troisième diapositive traite de la marque AsciiDoc, qui est une marque déposée de la Fondation Eclipse, et fournit des liens vers les directives de la marque. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_024.jpg\|300]] | La vingt-quatrième diapositive invite à visiter le site AsciiDoc pour en savoir plus sur le langage et accéder à toutes les ressources. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_025.jpg\|300]] | La vingt-cinquième diapositive encourage à visiter la documentation du langage AsciiDoc pour apprendre à utiliser le langage de manière détaillée. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_026.jpg\|300]] | La vingt-sixième diapositive récapitule les objectifs de la session, en soulignant l'importance de la diffusion de la documentation et du flux de travail. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_027.jpg\|300]] | La vingt-septième diapositive invite à s'impliquer dans la spécification du langage AsciiDoc et à participer aux discussions communautaires. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_028.jpg\|300]] | La vingt-huitième diapositive explique les enregistrements de décisions de spécification, qui aident à standardiser le comportement du langage d'une manière compatible avec les versions antérieures. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_029.jpg\|300]] | La vingt-neuvième diapositive présente le kit de compatibilité technique (TCK) pour vérifier la compatibilité des implémentations, avec un exemple de titre de document et sa structure JSON. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_030.jpg\|300]] | La trentième diapositive fournit des liens vers des ressources AsciiDoc, Asciidoctor, le plugin IntelliJ AsciiDoc, et Antora, ainsi que des vidéos et des exemples. | ![[FOSDEM 2025/assets/Evolving-realworld-AsciiDoc-into-a-specification-a/preview_031.jpg\|300]] | La trente-et-unième diapositive fournit les coordonnées d'Alexander Schwartz, l'orateur principal de la session, y compris son email et ses profils sociaux. ## Liens [Slides](https://fosdem.org/2025/events/attachments/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem/slides/237905/2025-02-0_nWAZ3O6.pdf) [Video recording (MP4)](https://video.fosdem.org/2025/k4201/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem.av1.mp4) [Video recording subtitle file (VTT)](https://video.fosdem.org/2025/k4201/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem.vtt) [Video recording (AV1/WebM)](https://video.fosdem.org/2025/k4201/fosdem-2025-5779-evolving-real-world-asciidoc-into-a-specification-and-how-it-will-help-the-ecosystem.av1.webm) [Chat room(web)](https://fosdem.org/2025/chat/web) [Chat room(app)](https://fosdem.org/2025/chat/app)