Convertitore online gratuito da ADOC a PDF

Un destinatario, una stampante, un sistema di archiviazione o un flusso di lavoro documentale può richiedere un PDF con impaginazione fissa invece del sorgente AsciiDoc modificabile. Il rendering del sorgente conserva la paginazione e rende il documento visualizzabile senza uno strumento AsciiDoc.

Che cos'è il formato ADOC

ADOC è l'estensione di file comune per un documento AsciiDoc; vengono utilizzate anche .asciidoc e .asc. È un formato sorgente di testo semplice contenente markup per titoli, elenchi, collegamenti, tabelle, attributi, riferimenti a immagini e direttive include::.

Gli sviluppatori, gli autori tecnici e i team di documentazione utilizzano i file ADOC con strumenti come Asciidoctor, AsciidoctorJ e Antora. Un editor di testo visualizza il markup sorgente, come = Document title e == Section, non il documento impaginato prodotto dal rendering.

Che cos'è il formato PDF

PDF è un formato di descrizione delle pagine che conserva dimensioni della pagina, tipografia, spaziatura, immagini e paginazione tra sistemi operativi e stampanti. È adatto alla stampa, alla condivisione, alle copie d'archivio e ai documenti che devono essere visualizzati in modo uniforme su dispositivi diversi.

Il PDF è meno pratico da modificare rispetto ad ADOC. Per la documentazione sottoposta al controllo versione, modificare il file ADOC e rigenerare il PDF invece di modificare direttamente il PDF.

Come convertire un file ADOC in PDF

Utilizzo di Asciidoctor PDF

Asciidoctor PDF è il convertitore locale più diretto perché interpreta la sintassi AsciiDoc e crea un PDF senza un file HTML intermedio. Richiede Ruby.

1. Installare Ruby se non è già disponibile sul computer.
2. Installare Asciidoctor PDF da un terminale con gem install asciidoctor-pdf.
3. Aprire il terminale nella directory contenente il file sorgente oppure specificarne il percorso completo.
4. Eseguire asciidoctor-pdf document.adoc -o document.pdf.
5. Aprire il risultato e controllare titoli, collegamenti, immagini, tabelle, blocchi di codice e interruzioni di pagina.

Sostituire i nomi dei file con i nomi effettivi del sorgente e dell'output. È possibile fornire un tema PDF personalizzato con un attributo come -a pdf-theme=my-theme.yml, purché il file del tema e tutti i font a cui fa riferimento siano disponibili.

Asciidoctor PDF può anche essere integrato in script e processi di compilazione della documentazione, soluzione preferibile quando i PDF devono essere rigenerati in modo coerente dal sorgente sottoposto al controllo versione.

Utilizzo di 101convert.com

È possibile convertire gratuitamente il file su 101convert.com senza installare software: caricare il file .adoc, scegliere PDF come formato di output, avviare la conversione e scaricare il risultato. Utilizzare Asciidoctor PDF in locale per documenti riservati o file che dipendono da immagini locali, inclusioni, temi personalizzati o estensioni.

Considerazioni sulla qualità e sulla compatibilità

• Rinominare document.adoc in document.pdf non converte il file; il sorgente AsciiDoc deve essere sottoposto a rendering.
• I percorsi relativi delle immagini e le direttive include:: devono essere risolti correttamente. I file mancanti possono creare aree vuote per le immagini o contenuti di inclusione non risolti.
• Asciidoctor PDF utilizza temi e regole di impaginazione propri. I CSS utilizzati per l'output HTML di AsciiDoc non determinano l'aspetto del PDF.
• I font devono essere installati o forniti al processo di compilazione del PDF e devono contenere i caratteri richiesti. In caso contrario, i glifi possono essere sostituiti o visualizzati come riquadri per caratteri mancanti.
• Diagrammi, grafici, evidenziazione della sintassi ed esempi di codice generati possono richiedere ulteriori estensioni AsciiDoc, eseguibili o passaggi di compilazione prima della generazione del PDF.
• Le tabelle lunghe e i blocchi di codice possono interrompersi in modo poco armonioso ai margini delle pagine. Regolare le larghezze, le impostazioni del tema o i controlli delle interruzioni di pagina e controllare il PDF sottoposto a rendering prima della distribuzione.
• L'output PDF dipende dalla versione del convertitore, dal tema, dai font e dalle risorse incluse, quindi ambienti diversi possono produrre una paginazione leggermente diversa.