Convertitore online gratuito da ASCIIDOC a ODT

I file ASCIIDOC sono pratici per la documentazione gestita con il controllo del codice sorgente, ma molte applicazioni per l'ufficio richiedono il formato OpenDocument Text per la modifica o la distribuzione. La conversione in ODT conserva il documento come file di elaborazione testi modificabile, che LibreOffice e altri programmi compatibili con OpenDocument possono aprire.

Che cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup leggero per la scrittura di documenti strutturati in testo semplice. Gli autori utilizzano markup come titoli, elenchi, link, tabelle, admonition, blocchi di codice sorgente e attributi invece di memorizzare la formattazione direttamente in un file di elaborazione testi.

I file utilizzano comunemente l'estensione .adoc o .asciidoc. Asciidoctor e Asciidoc creano ed elaborano questi file, che vengono spesso utilizzati nella documentazione software, nei file README, nei manuali tecnici e nei repository di documentazione gestiti con Git.

Che cos'è il formato ODT

ODT è il formato OpenDocument Text, un formato di documento basato su ZIP definito dallo standard OpenDocument. Memorizza testo modificabile, stili di paragrafo e di carattere, tabelle, immagini, metadati e informazioni sul layout della pagina.

LibreOffice Writer apre e modifica direttamente i file ODT; anche Apache OpenOffice e altre applicazioni compatibili con OpenDocument possono leggerli. ODT è utile quando i destinatari hanno bisogno di un documento impaginato con formattazione modificabile anziché del codice sorgente di markup.

Come convertire effettivamente ASCIIDOC in ODT

Il flusso di lavoro desktop più affidabile utilizza Asciidoctor per produrre DocBook XML, quindi Pandoc per creare il file ODT.

1. Installa Asciidoctor e Pandoc. Con Ruby installato, Asciidoctor può essere installato utilizzando gem install asciidoctor; installa Pandoc dal relativo pacchetto desktop ufficiale per il tuo sistema operativo.
2. Apri un terminale nella directory contenente il file sorgente.
3. Converti il sorgente AsciiDoc in DocBook 5 XML:
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Converti il file XML intermedio in ODT:
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Apri output.odt in LibreOffice Writer e controlla titoli, tabelle, immagini, interruzioni di pagina, note a piè di pagina e blocchi di codice.

Per un file AsciiDoc con immagini o file inclusi, esegui i comandi dalla directory del sorgente affinché i percorsi relativi vengano risolti correttamente. Se il sorgente utilizza un attributo, passalo ad Asciidoctor con un'opzione come -a toc= oppure definiscilo nell'intestazione del documento.

Se non vuoi installare software, puoi convertire gratuitamente il file su 101convert.com utilizzando il relativo convertitore da ASCIIDOC a ODT.

Limitazioni di qualità e compatibilità

La conversione passa attraverso due modelli di formato, quindi le funzionalità specifiche di AsciiDoc potrebbero non essere mappate esattamente in ODT. Titoli, paragrafi, enfasi, elenchi, link, tabelle, immagini e blocchi di codice di base vengono generalmente trasferiti, mentre ruoli complessi, temi personalizzati di Asciidoctor, estensioni, contenuti condizionali, macro e stili avanzati delle admonition potrebbero richiedere modifiche manuali.

Il sorgente AsciiDoc descrive la struttura; ODT richiede anche stili di pagina, font, margini, intestazioni, piè di pagina e impaginazione. Pandoc applica le proprie impostazioni predefinite del documento, quindi controlla il risultato in LibreOffice e modifica gli stili invece di fare affidamento sull'aspetto originale di AsciiDoc. Incorpora o installa i font richiesti prima dell'esportazione finale se è importante mantenere un'impaginazione coerente.

Conserva l'XML intermedio fino al completamento della convalida. Questo aiuta a identificare se un problema è originato nella fase di analisi di Asciidoctor o nel writer ODT di Pandoc.