Convertisseur en ligne gratuit de ASCIIDOC en ODT

Les fichiers ASCIIDOC sont pratiques pour la documentation gérée avec un contrôle de version, mais de nombreuses applications bureautiques exigent le format OpenDocument Text pour l’édition ou la diffusion. La conversion en ODT conserve le document sous la forme d’un fichier de traitement de texte modifiable que LibreOffice et d’autres programmes compatibles avec OpenDocument peuvent ouvrir.

Qu’est-ce que le format ASCIIDOC ?

AsciiDoc est un format de balisage léger permettant de rédiger des documents structurés en texte brut. Les auteurs utilisent des éléments de balisage tels que des titres, des listes, des liens, des tableaux, des admonitions, des blocs de code source et des attributs, au lieu d’enregistrer directement la mise en forme dans un fichier de traitement de texte.

Les fichiers utilisent généralement l’extension .adoc ou .asciidoc. Asciidoctor et Asciidoc créent et traitent ces fichiers, qui apparaissent souvent dans la documentation logicielle, les fichiers README, les manuels techniques et les référentiels de documentation gérés avec Git.

Qu’est-ce que le format ODT ?

ODT est le format OpenDocument Text, un format de document basé sur ZIP défini par la norme OpenDocument. Il stocke du texte modifiable, des styles de paragraphe et de caractère, des tableaux, des images, des métadonnées et des informations de mise en page.

LibreOffice Writer ouvre et modifie directement les fichiers ODT ; Apache OpenOffice et d’autres applications compatibles avec OpenDocument peuvent également les lire. ODT est utile lorsque les destinataires ont besoin d’un document paginé avec une mise en forme modifiable plutôt que du code source de balisage.

Comment convertir concrètement ASCIIDOC en ODT

Le workflow de bureau le plus fiable utilise Asciidoctor pour produire du DocBook XML, puis Pandoc pour créer le fichier ODT.

1. Installez Asciidoctor et Pandoc. Si Ruby est installé, Asciidoctor peut être installé à l’aide de gem install asciidoctor ; installez Pandoc à partir de son package de bureau officiel adapté à votre système d’exploitation.
2. Ouvrez un terminal dans le répertoire contenant le fichier source.
3. Convertissez la source AsciiDoc en DocBook 5 XML :
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Convertissez le fichier XML intermédiaire en ODT :
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Ouvrez output.odt dans LibreOffice Writer et vérifiez les titres, les tableaux, les images, les sauts de page, les notes de bas de page et les blocs de code.

Pour un fichier AsciiDoc contenant des images ou des fichiers inclus, exécutez les commandes depuis le répertoire source afin que les chemins relatifs soient résolus correctement. Si la source utilise un attribut, transmettez-le à Asciidoctor avec une option telle que -a toc= ou définissez-le dans l’en-tête du document.

Si vous ne souhaitez pas installer de logiciel, vous pouvez convertir gratuitement le fichier sur 101convert.com à l’aide de son convertisseur ASCIIDOC-to-ODT.

Limitations en matière de qualité et de compatibilité

La conversion passe par deux modèles de format, de sorte que les fonctionnalités spécifiques à AsciiDoc peuvent ne pas être reproduites exactement dans ODT. Les titres, paragraphes, mises en évidence, listes, liens, tableaux, images et blocs de code simples sont généralement transférés, tandis que les rôles complexes, les thèmes Asciidoctor personnalisés, les extensions, le contenu conditionnel, les macros et la mise en forme avancée des admonitions peuvent nécessiter des ajustements manuels.

La source AsciiDoc décrit la structure ; ODT nécessite également des styles de page, des polices, des marges, des en-têtes, des pieds de page et une pagination. Pandoc applique ses propres paramètres par défaut au document : inspectez donc le résultat dans LibreOffice et modifiez les styles plutôt que de vous fier à l’apparence d’origine d’AsciiDoc. Intégrez ou installez les polices requises avant l’exportation finale si une pagination cohérente est importante.

Conservez le XML intermédiaire jusqu’à la fin de la validation. Il permet de déterminer si un problème provient de l’étape d’analyse d’Asciidoctor ou de l’écriture ODT de Pandoc.