Convertitore online gratuito da DOCX a ADOC

I documenti Word vengono convertiti in AsciiDoc quando la documentazione deve essere mantenuta in Git, revisionata come testo o sottoposta al rendering da un sistema di pubblicazione AsciiDoc. Il file sorgente .adoc risultante è più facile da confrontare, unire e riutilizzare nelle build HTML o PDF rispetto a un file Word.

Formato DOCX

.docx è il formato predefinito di Microsoft Word e fa parte di Office Open XML. Un file DOCX è un pacchetto ZIP contenente XML e file correlati per testo, stili, tabelle, immagini, commenti, revisioni, intestazioni, piè di pagina e proprietà del documento.

Microsoft Word è il suo editor principale; anche LibreOffice Writer, Google Docs, Apple Pages e molti sistemi di gestione dei documenti possono aprire o esportare file DOCX. Il formato conserva bene la struttura e la formattazione dei documenti d’ufficio, ma la sua struttura confezionata è poco adatta alla revisione riga per riga nel controllo versione.

Formato ADOC

.adoc identifica comunemente un file sorgente AsciiDoc. AsciiDoc è testo semplice UTF-8 con markup per titoli di sezione, elenchi, tabelle, collegamenti, blocchi di codice, admonition, attributi e riferimenti a immagini. Altre estensioni comuni di AsciiDoc sono .asciidoc e .ad.

Processori come Asciidoctor possono eseguire il rendering di AsciiDoc come HTML, PDF, DocBook, EPUB o output per siti di documentazione. Le immagini sono normalmente file separati a cui fa riferimento il sorgente; questo mantiene il testo leggibile e facilita la gestione delle risorse grafiche in Git.

Confermare il formato richiesto prima della conversione. Alcuni prodotti usano .adoc per file proprietari non correlati; questa conversione produce testo AsciiDoc, non tali formati.

Convertire il file

Per eseguire la conversione senza installare software, caricare il file DOCX nel convertitore di 101convert.com, selezionare ADOC come formato di output, avviare la conversione e scaricare il file .adoc generato. Aprirlo in un editor di testo e controllare titoli, tabelle, collegamenti e riferimenti alle immagini prima di utilizzarlo in un flusso di pubblicazione.

Per una conversione locale ripetibile, Pandoc legge DOCX e scrive AsciiDoc. Dopo aver installato Pandoc, eseguire questo comando dalla cartella contenente il documento:

pandoc input.docx --from=docx --to=asciidoc --extract-media=media --wrap=none --output=output.adoc

--extract-media=media scrive le immagini incorporate in una directory media e genera riferimenti alle immagini nell’output. Conservare questa directory insieme al file ADOC quando si sposta o si pubblica il documento. --wrap=none evita l’interruzione arbitraria delle righe, che può produrre differenze più pulite nel controllo del codice sorgente.

Eseguire il rendering del risultato con Asciidoctor per controllare il markup generato:

asciidoctor output.adoc

Viene creato output.html, che può essere aperto in un browser per la revisione.

Limiti della conversione

La conversione dipende dalla semantica del documento, non dall’aspetto visivo. Applicare gli stili Heading integrati di Word prima della conversione; il testo reso grande o in grassetto senza uno stile di titolo potrebbe rimanere un paragrafo normale.

I paragrafi semplici, gli stili dei titoli, gli elenchi, l’enfasi di base, i collegamenti e le tabelle semplici vengono generalmente trasferiti in modo accettabile. Le tabelle unite o annidate, le larghezze fisse delle colonne, il riempimento delle celle, le caselle di testo, gli oggetti mobili, SmartArt, le equazioni, i layout di pagina complessi e le immagini posizionate non hanno un equivalente diretto in AsciiDoc e richiedono una riscrittura manuale oppure la sostituzione con immagini e markup standard.

Risolvere le modifiche rilevate prima della conversione e conservare separatamente gli eventuali commenti necessari. Intestazioni, piè di pagina, campi dei numeri di pagina, macro, protezione del documento e controlli del layout specifici di Word non costituiscono contenuti AsciiDoc affidabili; spostare le informazioni essenziali in normali sezioni del documento.

I collegamenti ipertestuali esterni vengono generalmente convertiti correttamente, ma i segnalibri e i riferimenti incrociati di Word devono essere verificati dopo il rendering. Per collegamenti interni duraturi, assegnare ancore AsciiDoc esplicite come [[installation]] e farvi riferimento con <<installation,Installation>>.