Convertisseur en ligne gratuit de AD en DOCBOOK

Qu’est-ce que le format AD ?

Dans la catégorie des fichiers texte, AD désigne généralement un fichier source AsciiDoc. Les fichiers AsciiDoc contiennent un balisage en texte brut pour les titres, listes, tableaux, liens, images, avertissements, code source et métadonnées du document ; la même syntaxe est également couramment enregistrée avec les extensions .adoc ou .asciidoc.

Les fichiers portant l’extension .ad sont créés ou modifiés avec des processeurs AsciiDoc, Asciidoctor et des éditeurs de texte ordinaires. L’extension seule ne garantit pas le processeur exact ni la version de la syntaxe ; inspectez donc les premières lignes à la recherche d’attributs tels que :doctype:, :toc: ou de directives d’inclusion avant la conversion.

Qu’est-ce que le format DOCBOOK ?

DocBook est un vocabulaire XML destiné à la documentation technique structurée. Il représente les éléments du document tels que les chapitres, sections, paragraphes, procédures, tableaux, citations, listes de programmes et références croisées indépendamment de la mise en page finale.

DocBook convient lorsqu’un pipeline de publication utilise des outils tels que xsltproc, Jing, Saxon ou des feuilles de style DocBook pour produire du HTML, du PDF, de l’EPUB ou des pages de manuel. Sa structure XML facilite également la validation, l’indexation et les transformations ultérieures vers d’autres formats par rapport à un balisage orienté présentation.

Comment convertir AD en DOCBOOK

Asciidoctor est l’outil de conversion de bureau le plus direct, car il lit AsciiDoc et inclut un backend DocBook.

1. Installez Asciidoctor à l’aide du gestionnaire de paquets de votre système d’exploitation ou du gem Ruby, puis vérifiez l’installation avec asciidoctor --version.
2. Placez le fichier source ainsi que les images référencées, les fichiers inclus ou les fichiers d’attributs dans les chemins relatifs prévus.
3. Exécutez asciidoctor -b docbook5 -o output.xml input.ad. L’option -b docbook5 sélectionne le XML DocBook 5 et -o définit le nom du fichier de sortie.
4. Pour un workflow DocBook 4, utilisez asciidoctor -b docbook -o output.xml input.ad si ce backend est disponible dans la version installée.
5. Validez le résultat avec le schéma DocBook ou la commande de validation requise par votre système de publication. Ouvrez output.xml dans un éditeur compatible XML afin de vérifier les inclusions non résolues, les chemins d’image incorrects et les attributs mal formés.

Pour effectuer une conversion graphique sans installer de logiciel, téléversez le fichier AD sur 101convert.com, sélectionnez DOCBOOK comme format cible, puis téléchargez le XML généré. Cette méthode convient à un fichier ponctuel lorsque la source utilise les fonctionnalités standard d’AsciiDoc et ne dépend pas de fichiers d’inclusion locaux.

Considérations relatives à la qualité et à la compatibilité

Le balisage AsciiDoc ne correspond pas parfaitement à DocBook lorsque la source utilise des extensions personnalisées, des attributs spécifiques au backend, des blocs de transmission, des macros ou des scripts intégrés. Vérifiez les avertissements, tableaux, annotations, notes de bas de page, références croisées et listes de code source après la conversion.

Les images relatives et les directives include:: nécessitent l’accès à la structure de répertoires d’origine ; un convertisseur qui ne reçoit que le fichier principal peut omettre ces ressources ou laisser des références non résolues. La sortie DocBook est du XML, et non un PDF ou une page web finalisé(e) ; appliquez donc ensuite la feuille de style DocBook appropriée ou l’outil de publication en aval.