Convertitore online gratuito da ASCIIDOC a PDF

Cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup in testo semplice per documenti strutturati come manuali software, file README, libri, articoli e specifiche tecniche. Gli autori scrivono file sorgente leggibili con titoli, elenchi, blocchi di codice delimitati, tabelle, attributi, riferimenti incrociati ed estensioni opzionali; le estensioni di file comuni sono .adoc e .asciidoc.

I file AsciiDoc vengono comunemente creati negli editor di testo, negli ambienti di sviluppo integrati, nei repository di documentazione e nei sistemi che utilizzano Asciidoctor o il processore AsciiDoc originale. Il sorgente rimane modificabile e compatibile con i sistemi di controllo versione, ma il suo aspetto finale dipende dal convertitore, dal tema, dai font, dalle risorse grafiche e dagli attributi del documento.

Cos'è il formato PDF

PDF memorizza le pagine mantenendone invariati il layout, i font, gli elementi grafici e le dimensioni di stampa tra diversi sistemi operativi. È adatto alla documentazione formale, agli allegati email, alla stampa, all'archiviazione e alla revisione, perché in genere i destinatari non hanno bisogno dell'editor sorgente o della toolchain AsciiDoc.

PDF è meno comodo di AsciiDoc per la modifica e il confronto automatico delle versioni. Può inoltre essere più grande del file sorgente, in particolare quando incorpora font o immagini ad alta risoluzione.

Come convertire ASCIIDOC in PDF

Il metodo da riga di comando più diretto è Asciidoctor PDF, il convertitore PDF della toolchain Asciidoctor basata su Ruby.

1. Installa Ruby se non è già disponibile.
2. Installa il convertitore con gem install asciidoctor-pdf --pre. L'opzione --pre può essere necessaria per il pacchetto prerelease corrente; omettila quando installi l'ultima versione stabile.
3. Apri un terminale nella directory contenente il file sorgente ed esegui asciidoctor-pdf manual.adoc -o manual.pdf.
4. Apri manual.pdf in un visualizzatore PDF e controlla interruzioni di pagina, tabelle, blocchi di codice, link e immagini.

Per un file sorgente che fa riferimento a immagini o include altri file AsciiDoc, esegui il comando dalla directory del progetto del documento e mantieni la relativa struttura delle cartelle. Usa -a toc=left o -a toc=macro per aggiungere un indice, e -a pdf-theme=custom-theme.yml per applicare un tema PDF personalizzato. Titolo, autore e revisione possono essere impostati nell'intestazione del documento con attributi come = Installation manual, Author Name <author@example.com> e :revnumber: 1.2.

Puoi anche convertire gratuitamente il file sul sito web 101convert.com senza installare software. Carica il file AsciiDoc, scegli PDF come formato di output, avvia la conversione e scarica il documento generato.

Considerazioni sulla qualità e sulla compatibilità

La sintassi AsciiDoc viene elaborata da un convertitore anziché essere copiata direttamente nel PDF, quindi estensioni non supportate, macro personalizzate, percorsi degli include e contenuti condizionali possono modificare il risultato. Asciidoctor PDF utilizza la directory di lavoro corrente e gli attributi del documento per risolvere include e risorse; i percorsi mancanti producono un output incompleto o avvisi.

Per ottenere un'impaginazione prevedibile, incorpora o configura esplicitamente i font, imposta il formato della pagina e i margini in un tema PDF e usa dimensioni delle immagini orientate alla stampa. Dopo la conversione, controlla diagrammi, file SVG, link esterni, note a piè di pagina, overflow delle tabelle e caratteri da destra a sinistra o non latini. Un file sorgente può essere convertito correttamente continuando tuttavia a produrre tabelle tagliate o glifi mancanti se il font selezionato non contiene i caratteri richiesti.