Convertisseur en ligne gratuit de ASCIIDOC en HTML

Les fichiers AsciiDoc doivent être convertis lorsque la documentation doit être ouverte dans un navigateur web, publiée sur un site web ou fournie à un système qui accepte le HTML plutôt que le balisage source. Le HTML conserve les titres, les listes, les liens, les tableaux, les blocs de code et les autres structures dans un format directement consultable.

Qu’est-ce que le format ASCIIDOC ?

AsciiDoc est un format de balisage en texte brut pour les documents structurés tels que la documentation logicielle, les manuels, les fichiers README, les articles et les spécifications techniques. Les auteurs indiquent la structure à l’aide d’une syntaxe lisible pour les titres, les listes, les liens, les avertissements, les tableaux, le code source, les images et les références croisées.

Les extensions de fichier courantes sont .adoc, .asciidoc et parfois .asc. Les fichiers sont créés ou modifiés avec des éditeurs de texte ordinaires et des outils de documentation, notamment Asciidoctor, Asciidoctor.js et Antora. Un fichier AsciiDoc est un balisage source : un navigateur affichera donc ses caractères de formatage au lieu de restituer la structure prévue du document.

Qu’est-ce que le format HTML ?

HTML est le format de balisage interprété par les navigateurs web et utilisé par les sites web, les portails de documentation, les systèmes de gestion de contenu et les workflows liés aux e-mails. Une conversion HTML transforme la structure AsciiDoc en éléments tels que <h1>, <p>, <ul>, <table> et <pre>.

HTML convient lorsque les destinataires ont besoin d’une consultation dans un navigateur, d’une documentation interrogeable, d’un contenu copiable ou d’un fichier pouvant être intégré à une page web. Le résultat peut inclure une mise en forme CSS, des références d’images, des ressources de coloration syntaxique et des liens vers d’autres pages générées.

Comment convertir réellement ASCIIDOC en HTML

Utilisation d’Asciidoctor

1. Installez Ruby et le processeur Asciidoctor, puis exécutez gem install asciidoctor.
2. Ouvrez un terminal dans le répertoire contenant le fichier source.
3. Convertissez-le avec asciidoctor input.adoc -o output.html. Remplacez les noms de fichiers par les noms réels de la source et de la destination.
4. Ouvrez output.html dans un navigateur et vérifiez les titres, les liens, les tableaux, les blocs de code et les images.

Pour produire du HTML intégré pouvant être inséré dans une autre page, utilisez asciidoctor -e input.adoc -o fragment.html. Pour appliquer une feuille de style, indiquez son emplacement avec un attribut Asciidoctor tel que asciidoctor -a stylesheet=site.css input.adoc -o output.html.

Utilisation d’un convertisseur en ligne

Vous pouvez convertir gratuitement le fichier sur le site web 101convert.com sans installer de logiciel. Importez le fichier AsciiDoc, sélectionnez HTML comme format de sortie si nécessaire, lancez la conversion, puis téléchargez le fichier généré. Vérifiez les images liées et les fichiers inclus après le téléchargement, car la conversion dans un navigateur peut ne pas avoir accès aux chemins locaux référencés par la source.

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

Les documents AsciiDoc peuvent référencer des images, inclure d’autres fichiers source, charger des attributs et utiliser des extensions personnalisées. Une conversion locale avec Asciidoctor est généralement préférable lorsque ces dépendances sont importantes, car le convertisseur peut s’exécuter depuis le répertoire de projet approprié et utiliser les attributs prévus.

Conservez les images référencées et les fichiers CSS aux emplacements relatifs attendus, ou mettez à jour les chemins générés avant la publication. Un fichier HTML peut contenir des liens vers des ressources séparées plutôt que de les intégrer : déplacer uniquement le fichier HTML peut donc entraîner l’absence d’images ou produire un résultat sans style.

Les macros personnalisées, les extensions non prises en charge, les inclusions manquantes et les attributs de document incorrects peuvent produire un résultat incomplet. Testez le HTML généré dans le navigateur ou le système de publication cible, en particulier lorsque la source utilise la coloration syntaxique, des liens entre documents ou des caractères non ASCII.