Convertisseur en ligne gratuit de ADOC en PDF

Un destinataire, une imprimante, un système d’archivage ou un workflow documentaire peut nécessiter un PDF à mise en page fixe plutôt que le fichier source AsciiDoc modifiable. Le rendu de la source au format PDF préserve la pagination et permet de consulter le document sans outil AsciiDoc.

Qu’est-ce que le format ADOC ?

ADOC est l’extension de nom de fichier courante pour un document AsciiDoc ; .asciidoc et .asc sont également utilisées. Il s’agit d’un format source en texte brut contenant du balisage pour les titres, les listes, les liens, les tableaux, les attributs, les références d’image et les directives include::.

Les développeurs, les rédacteurs techniques et les équipes de documentation utilisent les fichiers ADOC avec des outils tels que Asciidoctor, AsciidoctorJ et Antora. Un éditeur de texte affiche le balisage source tel que = Document title et == Section, et non le document paginé produit par le rendu.

Qu’est-ce que le format PDF ?

PDF est un format de description de page qui conserve le format des pages, la typographie, l’espacement, les images et la pagination sur différents systèmes d’exploitation et différentes imprimantes. Il convient à l’impression, au partage, aux copies d’archivage et aux documents qui doivent être consultés de manière uniforme sur différents appareils.

Le PDF est moins pratique à modifier que l’ADOC. Pour la documentation gérée dans un système de contrôle de version, modifiez le fichier ADOC et régénérez le PDF plutôt que de modifier directement le PDF.

Comment convertir un fichier ADOC en PDF

Utiliser Asciidoctor PDF

Asciidoctor PDF est le convertisseur local le plus direct, car il interprète la syntaxe AsciiDoc et crée un PDF sans fichier HTML intermédiaire. Ruby est requis.

1. Installez Ruby s’il n’est pas déjà disponible sur l’ordinateur.
2. Installez Asciidoctor PDF depuis un terminal avec gem install asciidoctor-pdf.
3. Ouvrez le terminal dans le répertoire contenant le fichier source ou indiquez son chemin complet.
4. Exécutez asciidoctor-pdf document.adoc -o document.pdf.
5. Ouvrez le résultat et vérifiez les titres, les liens, les images, les tableaux, les blocs de code et les sauts de page.

Remplacez les noms de fichiers par les noms réels de la source et du fichier de sortie. Un thème PDF personnalisé peut être fourni avec un attribut tel que -a pdf-theme=my-theme.yml, à condition que le fichier de thème et les polices référencées soient disponibles.

Asciidoctor PDF peut également être intégré à des scripts et à des processus de build de documentation, ce qui est préférable lorsque les PDF doivent être régénérés de manière cohérente à partir d’une source gérée dans un système de contrôle de version.

Utiliser 101convert.com

Vous pouvez convertir gratuitement le fichier sur 101convert.com sans installer de logiciel : téléversez le fichier .adoc, choisissez PDF comme format de sortie, lancez la conversion, puis téléchargez le résultat. Utilisez Asciidoctor PDF en local pour les documents confidentiels ou les fichiers qui dépendent d’images locales, de directives include, de thèmes personnalisés ou d’extensions.

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

• Renommer document.adoc en document.pdf ne convertit pas le fichier ; la source AsciiDoc doit être rendue.
• Les chemins d’image relatifs et les directives include:: doivent être résolus correctement. Les fichiers manquants peuvent créer des zones d’image vides ou du contenu include non résolu.
• Asciidoctor PDF utilise ses propres thèmes et règles de mise en page. Le CSS utilisé pour la sortie HTML AsciiDoc ne détermine pas l’apparence du PDF.
• Les polices doivent être installées ou fournies au processus de build PDF et contenir les caractères requis. Dans le cas contraire, les glyphes peuvent être remplacés ou affichés sous forme de carrés indiquant des caractères manquants.
• Les diagrammes, les graphiques, la coloration syntaxique et les exemples de code générés peuvent nécessiter des extensions AsciiDoc, des exécutables ou des étapes de build supplémentaires avant la génération du PDF.
• Les tableaux longs et les blocs de code peuvent être coupés de manière inappropriée aux limites des pages. Ajustez les largeurs, les paramètres du thème ou les contrôles de saut de page, puis inspectez le PDF rendu avant sa distribution.
• La sortie PDF dépend de la version du convertisseur, du thème, des polices et des ressources incluses ; différents environnements peuvent donc produire une pagination légèrement différente.