Convertitore online gratuito da PNG a ADOC

Formato sorgente: PNG

PNG (Portable Network Graphics) è un formato di immagine raster ampiamente usato per screenshot, loghi, diagrammi, icone e grafica web. Supporta la compressione senza perdita di dati e la trasparenza, il che lo rende una scelta comune quando contano la qualità dell’immagine e i bordi puliti. I file PNG vengono in genere creati da editor grafici, strumenti di acquisizione dello schermo, fotocamere con opzioni di esportazione e software di progettazione.

Formato di destinazione: ADOC

ADOC è un file di documentazione AsciiDoc, un formato di testo semplice usato per scrivere documentazione tecnica, manuali, file README e libri. I suoi principali vantaggi sono leggibilità, controllo versione semplice e pubblicazione flessibile in formati come HTML, PDF ed EPUB. A differenza di PNG, ADOC non è un formato immagine; è un formato di markup basato su testo, quindi convertire PNG in ADOC di solito significa incorporare l’immagine dentro un documento AsciiDoc oppure creare un file AsciiDoc che fa riferimento all’immagine.

Come eseguire la conversione

L’approccio migliore dipende da cosa vuoi che contenga il file ADOC:

1. Se vuoi un file AsciiDoc che visualizzi l’immagine PNG

Crea un nuovo file .adoc e inserisci una macro immagine che punti al file PNG:

image::picture.png[]

Se l’immagine si trova in una sottocartella, usa un percorso relativo come image::images/picture.png[].

Puoi creare o modificare il file in qualsiasi editor di testo, come VS Code, Notepad++ o Vim. Salvalo con l’estensione .adoc.

2. Se vuoi convertire il PNG in contenuto di documentazione

Apri il PNG in un visualizzatore o editor di immagini e descrivilo manualmente in AsciiDoc. Ad esempio, uno screenshot può essere trasformato in documentazione passo-passo con intestazioni, elenchi e l’immagine inclusa come figura.

3. Se vuoi visualizzare in anteprima o pubblicare il risultato

Usa un processore AsciiDoc come Asciidoctor per eseguire il rendering del file:

asciidoctor file.adoc

Questo genera l’output HTML per impostazione predefinita. Se ti servono PDF o altri formati, usa il backend Asciidoctor o la toolchain appropriati.

Usare il convertitore online integrato

Puoi convertire il file su 101convert.com gratuitamente, senza installare alcun software. Carica il PNG, scegli ADOC come formato di destinazione e scarica il risultato generato. È comodo per conversioni rapide, soprattutto quando ti serve solo un file AsciiDoc semplice che fa riferimento o impacchetta l’immagine.

Note su qualità, compatibilità e limitazioni

La conversione da PNG ad ADOC non è una vera conversione da immagine a testo. ADOC non può memorizzare i dati dei pixel come fa PNG, quindi il risultato è di solito o un involucro AsciiDoc attorno all’immagine oppure un documento scritto manualmente che descrive l’immagine. Se ti serve OCR per estrarre testo da uno screenshot, usa prima uno strumento OCR, poi inserisci il testo riconosciuto nel file ADOC.

Per la migliore compatibilità, tieni il file PNG nella stessa cartella del file .adoc oppure usa un percorso relativo corretto. Durante la pubblicazione, assicurati che l’immagine sia accessibile al processore AsciiDoc. I file PNG di grandi dimensioni possono aumentare la dimensione del documento e rallentare il rendering, mentre i PNG trasparenti in genere funzionano bene nell’output di AsciiDoc.

Se il tuo obiettivo è modificare l’immagine stessa, convertitela in un formato per l’editing raster; ADOC è pensato per la documentazione, non per l’editing delle immagini.