Convertisseur en ligne gratuit de PNG en ADOC

Format source : PNG

PNG (Portable Network Graphics) est un format d’image matricielle largement utilisé pour les captures d’écran, les logos, les diagrammes, les icônes et les graphismes web. Il prend en charge la compression sans perte et la transparence, ce qui en fait un choix courant lorsque la qualité de l’image et des contours nets sont importants. Les fichiers PNG sont généralement créés par des éditeurs graphiques, des outils de capture d’écran, des appareils photo avec des options d’export, et des logiciels de conception.

Format cible : ADOC

ADOC est un fichier de document AsciiDoc, un format texte brut utilisé pour rédiger de la documentation technique, des manuels, des fichiers README et des livres. Ses principaux avantages sont la lisibilité, un contrôle de version facile et une publication flexible vers des formats tels que HTML, PDF et EPUB. Contrairement à PNG, ADOC n’est pas un format d’image ; c’est un format de balisage basé sur le texte. Ainsi, convertir PNG en ADOC signifie généralement intégrer l’image dans un document AsciiDoc ou créer un fichier AsciiDoc qui référence l’image.

Comment effectuer la conversion

La meilleure approche dépend de ce que vous voulez que le fichier ADOC contienne :

1. Si vous voulez un fichier AsciiDoc qui affiche l’image PNG

Créez un nouveau fichier .adoc et insérez une macro d’image qui pointe vers le fichier PNG :

image::picture.png[]

Si l’image se trouve dans un sous-dossier, utilisez un chemin relatif comme image::images/picture.png[].

Vous pouvez créer ou modifier le fichier dans n’importe quel éditeur de texte, comme VS Code, Notepad++ ou Vim. Enregistrez-le avec l’extension .adoc.

2. Si vous voulez convertir le PNG en contenu de documentation

Ouvrez le PNG dans un visualiseur ou un éditeur d’images, puis décrivez-le manuellement en AsciiDoc. Par exemple, une capture d’écran peut être transformée en documentation pas à pas avec des titres, des listes, et l’image incluse comme figure.

3. Si vous voulez prévisualiser ou publier le résultat

Utilisez un processeur AsciiDoc comme Asciidoctor pour rendre le fichier :

asciidoctor file.adoc

Cela génère une sortie HTML par défaut. Si vous avez besoin de PDF ou d’autres formats, utilisez le backend Asciidoctor ou la chaîne d’outils appropriés.

Utiliser le convertisseur en ligne intégré

Vous pouvez convertir le fichier sur 101convert.com gratuitement, sans installer de logiciel. Téléversez le PNG, choisissez ADOC comme format cible, puis téléchargez le résultat généré. C’est pratique pour les conversions rapides, surtout lorsque vous n’avez besoin que d’un fichier AsciiDoc simple qui référence ou regroupe l’image.

Remarques sur la qualité, la compatibilité et les limites

PNG vers ADOC n’est pas une vraie conversion image-vers-texte. ADOC ne peut pas stocker les données de pixels comme le fait PNG. Le résultat est donc généralement soit un habillage AsciiDoc autour de l’image, soit un document rédigé manuellement qui décrit l’image. Si vous avez besoin d’OCR pour extraire du texte d’une capture d’écran, utilisez d’abord un outil OCR, puis placez le texte reconnu dans le fichier ADOC.

Pour une meilleure compatibilité, conservez le fichier PNG dans le même dossier que le fichier .adoc ou utilisez un chemin relatif correct. Lors de la publication, assurez-vous que l’image est accessible au processeur AsciiDoc. Les fichiers PNG volumineux peuvent augmenter la taille du document et ralentir le rendu, tandis que les PNG transparents fonctionnent généralement bien dans la sortie AsciiDoc.

Si votre objectif est de modifier l’image elle-même, convertissez-la plutôt vers un format destiné à l’édition d’images matricielles ; ADOC est fait pour la documentation, pas pour l’édition d’images.