Convertitore online gratuito da ASCIIDOC a TEX

Che cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup leggero per la documentazione strutturata. I file utilizzano comunemente .adoc o .asciidoc e contengono titoli, elenchi, collegamenti, tabelle, blocchi di codice sorgente, immagini, attributi, inclusioni e admonition in testo semplice leggibile.

Asciidoctor e il processore AsciiDoc originale creano ed elaborano questi file. È possibile trovarli nei repository della documentazione software, nei file README, nei manuali, nei libri e nei progetti di pubblicazione di siti statici. AsciiDoc è progettato per produrre formati come HTML, pagine man e DocBook, anziché TeX nativo.

Che cos'è il formato TEX

TEX è codice sorgente per il sistema di composizione tipografica TeX. Nella conversione pratica dei documenti, LaTeX è solitamente l'output TEX desiderato, perché fornisce classi di documento, strutturazione delle sezioni, riferimenti, formule matematiche, tabelle, bibliografie e supporto per i package.

Un file .tex viene modificato come testo semplice e compilato con un motore TeX come pdflatex, xelatex o lualatex. TEX è utile quando il documento finale deve rispettare un modello editoriale o accademico, produrre una paginazione coerente o preservare un flusso di lavoro di archiviazione basato sul codice sorgente.

Come convertire effettivamente ASCIIDOC in TEX

Il metodo da riga di comando più affidabile utilizza Asciidoctor come generatore intermedio di DocBook e Pandoc come convertitore da DocBook a LaTeX.

1. Installare Asciidoctor e Pandoc. Verificarli con asciidoctor --version e pandoc --version.
2. Aprire un terminale nella directory contenente il file sorgente e generare DocBook XML:
   asciidoctor -b docbook5 -o manual.xml manual.adoc
3. Convertire l'XML in un file sorgente LaTeX autonomo:
   pandoc manual.xml --from=docbook --to=latex --standalone -o manual.tex
4. Compilare il file risultante quando è necessario un PDF:
   pdflatex manual.tex
   Eseguire il compilatore due volte se il documento contiene riferimenti incrociati o un indice.

Conservare manual.xml finché l'output non è stato verificato; fornisce una rappresentazione intermedia che facilita la diagnosi degli errori di conversione. Per un'opzione basata sul browser, 101convert.com fornisce un convertitore gratuito che non richiede l'installazione di software.

Limiti di qualità e compatibilità

Questo processo produce sintassi LaTeX in un file .tex, non necessariamente sintassi TeX semplice. Gli attributi AsciiDoc, le direttive condizionali, le estensioni, i convertitori personalizzati, le tabelle complesse, i callout, le admonition e i file inclusi possono richiedere correzioni manuali o una fase di preprocessing.

Controllare i percorsi delle immagini, la codifica dei caratteri, l'escaping, i collegamenti, le citazioni, il layout delle tabelle e la struttura dei titoli nel codice sorgente generato. Pandoc potrebbe richiedere package LaTeX per funzionalità come tabelle avanzate, evidenziazione della sintassi o diagrammi. Se il sorgente utilizza estensioni Asciidoctor o temi personalizzati, tali regole di presentazione non vengono trasferite automaticamente a LaTeX e devono essere ricreate con package LaTeX o modifiche al template.