Convertitore online gratuito da ASCIIDOC a DOCX

Cos'è il formato ASCIIDOC

AsciiDoc è un formato di markup in testo normale per documenti strutturati come manuali software, note di rilascio, libri, specifiche e file README. I file utilizzano comunemente le estensioni .adoc o .asciidoc e possono essere creati con qualsiasi editor di testo, un IDE o sistemi di documentazione basati su Asciidoctor.

AsciiDoc memorizza titoli, elenchi, tabelle, collegamenti, blocchi di codice sorgente, immagini, admonition, attributi e riferimenti incrociati come testo leggibile. Asciidoctor è il convertitore più utilizzato e può generare HTML, DocBook, PDF tramite strumenti aggiuntivi e altri formati di output.

Cos'è il formato DOCX

DOCX è il formato di documento basato su XML utilizzato da Microsoft Word e supportato da LibreOffice Writer, OnlyOffice e altre applicazioni per l'ufficio. È adatto ai flussi di lavoro di videoscrittura che richiedono paragrafi modificabili, stili, tabelle, commenti, revisioni, intestazioni, piè di pagina e stampa orientata alle pagine.

DOCX è preferibile quando i destinatari devono modificare visivamente il documento, applicare modelli Word, aggiungere commenti di revisione o inviare un file a un sistema che non accetta il markup in testo normale. A differenza di AsciiDoc, DOCX non conserva il markup sorgente come interfaccia principale per la modifica.

Come convertire effettivamente ASCIIDOC in DOCX

Utilizzo di Asciidoctor e Pandoc

Il metodo desktop più controllabile consiste nel generare il rendering di AsciiDoc come DocBook con Asciidoctor, quindi convertire il file DocBook in DOCX con Pandoc.

1. Installare Asciidoctor e Pandoc. Con Ruby installato, Asciidoctor può essere installato utilizzando gem install asciidoctor. Installare Pandoc dal relativo pacchetto desktop ufficiale per il proprio sistema operativo.
2. Aprire un terminale nella directory contenente il file sorgente e generare DocBook 5:

asciidoctor -b docbook5 -o manual.xml manual.adoc

3. Convertire il file intermedio in DOCX:

pandoc manual.xml -o manual.docx

4. Aprire manual.docx in Word o LibreOffice Writer e controllare titoli, tabelle, immagini, blocchi di codice, interruzioni di pagina e collegamenti prima di distribuirlo.

Per utilizzare un modello Word, fornire un DOCX di riferimento contenente gli stili desiderati:

pandoc manual.xml --reference-doc=company-template.docx -o manual.docx

Mantenere disponibili le immagini nei percorsi relativi utilizzati dal sorgente AsciiDoc. Se il sorgente utilizza attributi o inclusioni, eseguire Asciidoctor dalla directory del progetto affinché tali file possano essere risolti. Un documento con più file sorgente può prima essere assemblato con una direttiva include::, quindi elaborato utilizzando gli stessi comandi.

Utilizzo del convertitore online

È possibile convertire gratuitamente il file su 101convert.com senza installare software: caricare il file ASCIIDOC, scegliere DOCX come formato di output, avviare la conversione e scaricare il documento generato. Controllare il risultato dopo il download, soprattutto se il sorgente contiene immagini locali, inclusioni, estensioni personalizzate di Asciidoctor o diagrammi.

Limitazioni di qualità e compatibilità

Il passaggio intermedio attraverso DocBook preserva la struttura standard del documento meglio della copia dell'HTML sottoposto a rendering in Word, ma non può riprodurre ogni funzionalità di Asciidoctor. Le estensioni personalizzate, i blocchi passthrough, i contenuti condizionali, la logica complessa degli attributi, i processori per diagrammi, gli stili specializzati delle admonition e alcune macro potrebbero essere omessi o convertiti in testo normale.

DOCX utilizza il layout di pagina e gli stili di Word, mentre AsciiDoc descrive principalmente la struttura semantica. È necessario prevedere di regolare margini, caratteri, larghezze delle tabelle, evidenziazione della sintassi, dimensioni delle immagini, didascalie, intestazioni, piè di pagina e interruzioni di pagina nel DOCX risultante. I blocchi di codice sorgente e le tabelle meritano particolare attenzione, poiché le righe lunghe e le colonne larghe possono fuoriuscire dalla pagina.

I collegamenti e i titoli di base vengono generalmente convertiti correttamente. I riferimenti incrociati, le note a piè di pagina, i contenuti multimediali incorporati e i percorsi relativi delle immagini dipendono dalle versioni di Asciidoctor e Pandoc e dal modo in cui è organizzato il sorgente. Conservare il file .adoc originale come sorgente autorevole se il documento continuerà a essere mantenuto.