Convertisseur en ligne gratuit de ASCIIDOC en TEXTILE

Qu’est-ce que le format ASCIIDOC ?

AsciiDoc est un format de balisage léger enregistré sous forme de texte brut, généralement avec les extensions .adoc ou .asciidoc. Il prend en charge les titres de documents, les sections, les admonitions, les tableaux, les références croisées, les attributs, les listes de code source, les images et les inclusions.

Les fichiers sont créés et traités par Asciidoctor, l’ancien processeur AsciiDoc, AsciidocFX, Antora et les éditeurs de texte. Les projets de documentation, les fichiers README, les manuels, les notes de version et les fichiers source de sites statiques l’utilisent couramment. La syntaxe AsciiDoc varie selon les implémentations, et les extensions d’Asciidoctor peuvent ajouter des fonctionnalités qui ne font pas partie du format de base.

Qu’est-ce que le format TEXTILE ?

Textile est un langage de balisage en texte brut utilisé par certains wikis, systèmes de gestion de contenu, outils de publication et anciennes applications web. Sa syntaxe utilise de courts marqueurs tels que h1. Heading pour les titres, *bold* pour le texte en gras, _italic_ pour l’italique et "link text":https://example.com pour les liens.

Textile reste utile lorsque l’application de destination dispose d’un analyseur Textile, mais ne prend pas en charge AsciiDoc. Comme il s’agit de texte brut, le fichier converti peut être modifié avec n’importe quel éditeur de texte et versionné sans format de document binaire. Les implémentations de Textile diffèrent quant à la prise en charge des tableaux, des attributs, des notes de bas de page et de la syntaxe étendue.

Comment convertir réellement ASCIIDOC en TEXTILE

Pour effectuer rapidement une conversion sans installer de logiciel, utilisez le convertisseur de 101convert.com : téléversez le fichier .adoc ou .asciidoc, sélectionnez TEXTILE comme format de sortie, lancez la conversion, puis téléchargez le fichier .textile obtenu.

Pour une conversion locale et reproductible, utilisez Asciidoctor pour créer du DocBook XML, puis Pandoc pour créer du Textile. Pandoc n’analyse pas de manière fiable tous les dialectes AsciiDoc directement. Cette procédure en deux étapes permet donc à Asciidoctor d’interpréter la syntaxe source.

1. Installez Asciidoctor et Pandoc à l’aide de la méthode d’installation adaptée à votre système d’exploitation.
2. Ouvrez un terminal dans le répertoire contenant le fichier source.
3. Exécutez asciidoctor -b docbook5 -o intermediate.xml input.adoc. Remplacez input.adoc par le nom de fichier réel. Utilisez input.asciidoc lorsque cette extension correspond à la source.
4. Convertissez le document intermédiaire avec pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Ouvrez output.textile dans un éditeur de texte ou importez-le dans l’application Textile cible, puis vérifiez le résultat affiché.

Si la source utilise des inclusions locales, exécutez Asciidoctor depuis le répertoire du projet afin que les chemins relatifs soient correctement résolus. Par exemple, asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc peut nécessiter que les chemins d’inclusion et les attributs du projet soient disponibles depuis ce répertoire de travail.

Limites de qualité et de compatibilité

L’étape intermédiaire DocBook peut modifier certains détails de présentation. Les attributs AsciiDoc, les blocs conditionnels, les rôles personnalisés, les extensions, le style des admonitions, les références croisées non résolues et les macros propres au processeur peuvent être omis ou représentés différemment dans Textile.

Vérifiez les tableaux, les listes imbriquées, la mise en forme inline, les images, les notes de bas de page, les ancres, les blocs de code source et les liens après la conversion. Les images sont normalement référencées par leur chemin plutôt qu’intégrées. Copiez donc les fichiers image et préservez la structure relative des répertoires. Un moteur de rendu Textile peut ne pas prendre en charge toutes les fonctionnalités produites par Pandoc ; les constructions non prises en charge peuvent apparaître sous forme de balisage échappé ou de paragraphes ordinaires.

Conservez le fichier AsciiDoc original comme source de référence. Ne modifiez la sortie Textile que lorsque le système de destination exige un ajustement ponctuel, car une nouvelle conversion écrasera ces modifications.