Convertisseur en ligne gratuit de JPG en ADOC

Format source

JPG (ou JPEG) est un format d’image matricielle largement utilisé, conçu pour les photographies et autres images à tonalités continues. Il est pris en charge par presque tous les appareils, appareils photo, navigateurs et éditeurs d’images. JPG utilise une compression avec perte, qui permet de garder des tailles de fichiers réduites, mais peut dégrader la qualité de l’image après des enregistrements répétés. Il est couramment utilisé pour les photos, les captures d’écran, les graphiques web et le partage d’images.

Format cible

ADOC est un format de document texte AsciiDoc utilisé pour rédiger de la documentation technique, des manuels, des livres et des docs de logiciels. Il est populaire auprès des développeurs et des rédacteurs techniques car il est facile à modifier dans n’importe quel éditeur de texte, fonctionne bien avec la gestion de versions et peut être converti en HTML, PDF, EPUB et d’autres formats de publication. Par rapport aux fichiers d’images binaires, ADOC est lisible par l’humain et structuré avec des balises.

Comment effectuer la conversion

Convertir le JPG en ADOC n’est pas une transformation directe de format au sens habituel, car une image JPG ne contient pas de texte modifiable. En pratique, la conversion consiste à créer un fichier AsciiDoc qui référence ou intègre l’image. La meilleure approche consiste à rédiger un petit document ADOC et à placer le JPG à côté.

1. Placez le fichier JPG dans le même dossier que votre document, ou notez son chemin.
2. Créez un nouveau fichier texte nommé document.adoc dans un éditeur de texte.
3. Ajoutez une référence d’image telle que image::photo.jpg[] pour intégrer la photo dans AsciiDoc.
4. Si vous voulez une légende, utilisez .Caption text sur la ligne au-dessus de la macro d’image.
5. Enregistrez le fichier avec l’extension .adoc.

Exemple de contenu pour document.adoc :

= My document .Caption text image::photo.jpg[]

Si vous voulez créer le fichier avec un éditeur de bureau, ouvrez un éditeur de texte tel que VS Code, Notepad++, ou n’importe quel éditeur de code, puis enregistrez le fichier avec l’extension .adoc. Si vous devez générer un document à partir de l’image automatiquement, vous pouvez aussi utiliser d’abord un logiciel OCR pour extraire le texte du JPG, puis placer ce texte dans le balisage AsciiDoc.

Vous pouvez convertir le fichier sur 101convert.com gratuitement, sans installer de logiciel.

Remarques sur la qualité et les limites

La principale limite est que JPG est un format d’image, pas un document texte, donc il n’existe pas de conversion vraie en un clic vers un contenu AsciiDoc significatif. Si le JPG contient du texte, vous devrez utiliser OCR pour transformer l’image en texte modifiable avant de l’enregistrer en ADOC. La précision de l’OCR dépend de la qualité de l’image, de la netteté de la police, du contraste et de la résolution.

Si votre objectif est uniquement d’afficher l’image dans AsciiDoc, la conversion est simple : le fichier ADOC stocke une référence au JPG plutôt que de convertir les pixels eux-mêmes. Conservez le JPG dans un emplacement stable par rapport au fichier ADOC afin que les liens ne se cassent pas. Pour la publication, les processeurs AsciiDoc tels que Asciidoctor rendront correctement le JPG référencé dans la sortie HTML ou PDF, à condition que le chemin de l’image soit valide.