Convertisseur en ligne gratuit de ASCIIDOC en PDF

Qu’est-ce que le format ASCIIDOC ?

AsciiDoc est un format de balisage en texte brut destiné aux documents structurés tels que les manuels de logiciels, les fichiers README, les livres, les articles et les spécifications techniques. Les auteurs écrivent des fichiers source lisibles contenant des titres, des listes, des blocs de code délimités, des tableaux, des attributs, des références croisées et des extensions facultatives ; les extensions de nom de fichier courantes sont .adoc et .asciidoc.

Les fichiers AsciiDoc sont généralement créés dans des éditeurs de texte, des environnements de développement intégrés, des référentiels de documentation et des systèmes qui utilisent Asciidoctor ou le processeur AsciiDoc d’origine. Le source reste modifiable et compatible avec le contrôle de version, mais son apparence finale dépend du convertisseur, du thème, des polices, des ressources image et des attributs du document.

Qu’est-ce que le format PDF ?

PDF stocke les pages avec leur mise en page, leurs polices, leurs graphiques et leurs dimensions d’impression préservés sur différents systèmes d’exploitation. Il convient à la documentation officielle, aux pièces jointes d’e-mails, à l’impression, à l’archivage et à la relecture, car les destinataires n’ont généralement pas besoin de l’éditeur source ni de la chaîne d’outils AsciiDoc.

PDF est moins pratique qu’AsciiDoc pour la modification et la comparaison automatique des versions. Il peut également être plus volumineux que le fichier source, notamment lorsqu’il intègre des polices ou des images haute résolution.

Comment convertir ASCIIDOC en PDF

La méthode en ligne de commande la plus directe est Asciidoctor PDF, le convertisseur PDF de la chaîne d’outils Asciidoctor basée sur Ruby.

1. Installez Ruby s’il n’est pas déjà disponible.
2. Installez le convertisseur avec gem install asciidoctor-pdf --pre. L’option --pre peut être nécessaire pour le package de préversion actuel ; omettez-la lors de l’installation de la dernière version stable.
3. Ouvrez un terminal dans le répertoire contenant le fichier source et exécutez asciidoctor-pdf manual.adoc -o manual.pdf.
4. Ouvrez manual.pdf dans un lecteur PDF et vérifiez les sauts de page, les tableaux, les blocs de code, les liens et les images.

Pour un fichier source qui fait référence à des images ou inclut d’autres fichiers AsciiDoc, exécutez la commande depuis le répertoire du projet du document et préservez sa structure de dossiers relative. Utilisez -a toc=left ou -a toc=macro pour ajouter une table des matières, et -a pdf-theme=custom-theme.yml pour appliquer un thème PDF personnalisé. Un titre, un auteur et une révision peuvent être définis dans l’en-tête du document avec des attributs tels que = Installation manual, Author Name <author@example.com> et :revnumber: 1.2.

Vous pouvez également convertir gratuitement le fichier sur le site web 101convert.com sans installer de logiciel. Importez le fichier AsciiDoc, choisissez PDF comme format de sortie, démarrez la conversion, puis téléchargez le document généré.

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

La syntaxe AsciiDoc est traitée par un convertisseur plutôt que copiée directement dans PDF ; les extensions non prises en charge, les macros personnalisées, les chemins d’inclusion et le contenu conditionnel peuvent donc modifier le résultat. Asciidoctor PDF utilise le répertoire de travail actuel et les attributs du document pour résoudre les inclusions et les ressources ; les chemins manquants génèrent une sortie incomplète ou des avertissements.

Pour obtenir une pagination prévisible, intégrez ou configurez explicitement les polices, définissez le format de page et les marges dans un thème PDF, et utilisez des dimensions d’image adaptées à l’impression. Après la conversion, vérifiez les diagrammes, les fichiers SVG, les liens externes, les notes de bas de page, les débordements de tableaux ainsi que les caractères de droite à gauche ou non latins. Un fichier source peut être converti avec succès tout en produisant des tableaux tronqués ou des glyphes manquants si la police sélectionnée ne contient pas les caractères requis.