Présentation du contexte

Un générateur de sites web est un programme qui transforme une arborescence de fichiers sources en une arborescence de pages HTML dotée d’un ou plusieurs systèmes de navigation pour parcourir ses pages. Avec un tel générateur, un webmaster crée un site web sans rédiger de pages HTML, et sans gérer les liens de navigation entre les pages. Le site généré est statique, donc pérenne et robuste dans le temps, car insensible aux problèmes de sécurité des CMS motorisés.

Antora est un générateur de sites web qui absorbe nativement des pages sources au format AsciiDoctor pour générer des pages HTML. Il est basé sur node.js.

Asciidoctor est à la fois un format de description de pages et un moteur de conversion de pages rédigées dans ce format en pages HTML (et PDF). Le format AsciiDoctor est une extension du format AsciiDoc, et le moteur AsciiDoctor est une implémentation particulière de la chaîne d’édition d’AsciiDoc. Il existe 2 implémentations équivalentes du moteur AsciiDoctoc, l’une en Ruby et l’autre en Javascript. Antora utilise l’implémentation Javascript.

Asciidoc est un format de description de documents textuels sémantiquement riche, adapté à la rédaction de livres et d’articles. Asciidoc ne s’intéresse pas au rendu des documents, mais à leur composition. C’est une évolution du format DocBook, un dialecte XML des année 1990 possédant une chaine d’édition permettant de générer, à partir d’un même jeu de documents des versions HTML, PDF, postscript, text, epub, manpages, etc.