Convertisseur en ligne gratuit de ASCIIDOC en TEX

Ce qu’est le format ASCIIDOC

AsciiDoc est un format de balisage léger destiné à la documentation structurée. Les fichiers utilisent généralement .adoc ou .asciidoc et contiennent des titres, des listes, des liens, des tableaux, des blocs de code source, des images, des attributs, des inclusions et des avertissements en texte brut lisible.

Asciidoctor et le processeur AsciiDoc d’origine créent et interprètent ces fichiers. Vous pouvez les rencontrer dans des dépôts de documentation logicielle, des fichiers README, des manuels, des livres et des projets de publication sur des sites statiques. AsciiDoc est conçu pour produire des formats tels que HTML, des pages man et DocBook plutôt que du TeX natif.

Ce qu’est le format TEX

TEX est du code source pour le système de composition TeX. Dans le cadre d’une conversion de documents, LaTeX est généralement le format TEX de sortie souhaité, car il fournit des classes de documents, une structuration en sections, des références, des mathématiques, des tableaux, des bibliographies et la prise en charge des packages.

Un fichier .tex est modifié en texte brut et compilé avec un moteur TeX tel que pdflatex, xelatex ou lualatex. TEX est utile lorsque le document final doit respecter un modèle éditorial ou universitaire, produire une pagination cohérente ou préserver un flux de travail d’archivage fondé sur les sources.

Comment convertir réellement ASCIIDOC en TEX

La méthode en ligne de commande la plus fiable utilise Asciidoctor comme générateur DocBook intermédiaire et Pandoc comme convertisseur de DocBook vers LaTeX.

1. Installez Asciidoctor et Pandoc. Vérifiez leur installation avec asciidoctor --version et pandoc --version.
2. Ouvrez un terminal dans le répertoire contenant le fichier source et générez le XML DocBook :
   asciidoctor -b docbook5 -o manual.xml manual.adoc
3. Convertissez le XML en fichier source LaTeX autonome :
   pandoc manual.xml --from=docbook --to=latex --standalone -o manual.tex
4. Compilez le fichier obtenu lorsqu’un PDF est nécessaire :
   pdflatex manual.tex
   Exécutez le compilateur deux fois si le document contient des références croisées ou une table des matières.

Conservez manual.xml jusqu’à la vérification de la sortie ; il fournit une représentation intermédiaire qui facilite le diagnostic des erreurs de conversion. Pour une option accessible depuis un navigateur, 101convert.com propose un convertisseur gratuit ne nécessitant aucune installation logicielle.

Limites de qualité et de compatibilité

Ce processus produit une syntaxe LaTeX dans un fichier .tex, et non nécessairement une syntaxe TeX simple. Les attributs AsciiDoc, les directives conditionnelles, les extensions, les convertisseurs personnalisés, les tableaux complexes, les annotations, les avertissements et les fichiers inclus peuvent nécessiter une correction manuelle ou un prétraitement.

Vérifiez les chemins des images, l’encodage des caractères, les caractères d’échappement, les liens, les citations, la mise en page des tableaux et la structure des titres dans la source générée. Pandoc peut nécessiter des packages LaTeX pour des fonctionnalités telles que les tableaux avancés, la coloration syntaxique ou les diagrammes. Si la source utilise des extensions Asciidoctor ou des thèmes personnalisés, ces règles de présentation ne sont pas automatiquement transférées vers LaTeX et doivent être recréées avec des packages LaTeX ou des modifications du modèle.