Online konvertor DOCX do ADOC zdarma

Dokumenty Word se převádějí do AsciiDoc, když je nutné dokumentaci uchovávat v Git, kontrolovat jako text nebo vykreslovat pomocí publikačního systému AsciiDoc. Výsledný zdroj .adoc se ve srovnání se souborem Word snadněji porovnává, slučuje a znovu používá při sestavování HTML nebo PDF.

Formát DOCX

.docx je výchozí formát Microsoft Word a součást Office Open XML. Soubor DOCX je balíček ZIP obsahující XML a související soubory pro text, styly, tabulky, obrázky, komentáře, revize, záhlaví, zápatí a vlastnosti dokumentu.

Microsoft Word je jeho primární editor; DOCX mohou také otevřít nebo exportovat LibreOffice Writer, Google Docs, Apple Pages a mnoho systémů pro správu dokumentů. Formát dobře zachovává rozvržení a formátování kancelářských dokumentů, ale jeho zabalená struktura není příliš vhodná pro kontrolu po jednotlivých řádcích v systémech pro správu verzí.

Formát ADOC

.adoc běžně označuje zdrojový soubor AsciiDoc. AsciiDoc je prostý text v UTF-8 se značkami pro nadpisy sekcí, seznamy, tabulky, odkazy, bloky kódu, upozornění, atributy a odkazy na obrázky. Další běžné přípony AsciiDoc jsou .asciidoc a .ad.

Procesory, jako je Asciidoctor, mohou vykreslit AsciiDoc jako HTML, PDF, DocBook, EPUB nebo výstup webu s dokumentací. Obrázky jsou obvykle samostatné soubory odkazované ze zdroje, díky čemuž zůstává text čitelný a obrázkové soubory lze snadno spravovat v Git.

Před převodem ověřte požadovaný formát. Několik produktů používá .adoc pro nesouvisející proprietární soubory; tento převod vytváří text AsciiDoc, nikoli tyto formáty.

Převod souboru

Chcete-li převést soubor bez instalace software, nahrajte soubor DOCX do převodníku na 101convert.com, vyberte ADOC jako výstupní formát, spusťte převod a stáhněte vygenerovaný soubor .adoc. Otevřete jej v textovém editoru a před použitím v publikačním procesu zkontrolujte nadpisy, tabulky, odkazy a odkazy na obrázky.

Pro opakovatelný lokální převod čte Pandoc DOCX a zapisuje AsciiDoc. Po instalaci Pandoc spusťte tento příkaz ze složky obsahující dokument:

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

--extract-media=media zapisuje vložené obrázky do adresáře media a ve výstupu vytváří odkazy na obrázky. Při přesouvání nebo publikování dokumentu ponechte tento adresář spolu se souborem ADOC. --wrap=none zabraňuje libovolnému zalamování řádků, které může vést k přehlednějším rozdílům ve správě zdrojového kódu.

Výsledek vykreslete pomocí Asciidoctor a zkontrolujte vygenerované značky:

asciidoctor output.adoc

Tím se vytvoří output.html, který lze otevřít v prohlížeči a zkontrolovat.

Omezení převodu

Převod závisí spíše na sémantice dokumentu než na jeho vizuálním vzhledu. Před převodem použijte vestavěné styly Heading v aplikaci Word; text, který byl pouze zvětšen nebo zvýrazněn tučně bez použití stylu nadpisu, může zůstat běžným odstavcem.

Obyčejné odstavce, styly nadpisů, seznamy, základní zvýraznění, odkazy a jednoduché tabulky se obvykle převedou přijatelně. Sloučené nebo vnořené tabulky, pevné šířky sloupců, stínování buněk, textová pole, plovoucí objekty, SmartArt, rovnice, složité rozvržení stránky a umístěné obrázky nemají přímý ekvivalent v AsciiDoc a vyžadují ruční přepsání nebo nahrazení obrázky a standardními značkami.

Před převodem vyřešte sledované změny a všechny potřebné komentáře uchovejte samostatně. Záhlaví, zápatí, pole s čísly stránek, makra, ochrana dokumentu a ovládací prvky rozvržení specifické pro Word nejsou spolehlivým obsahem AsciiDoc; důležité informace přesuňte do běžných částí dokumentu.

Externí hypertextové odkazy se obvykle převedou správně, ale záložky Word a křížové odkazy by se měly po vykreslení otestovat. Pro trvalé interní odkazy přiřaďte explicitní kotvy AsciiDoc, například [[installation]], a odkazujte na ně pomocí <<installation,Installation>>.