Online konvertor ASCIIDOC do DOCX zdarma

Co je formát ASCIIDOC

AsciiDoc je značkovací formát v podobě prostého textu pro strukturované dokumenty, jako jsou softwarové příručky, poznámky k vydání, knihy, specifikace a soubory README. Soubory běžně používají přípony .adoc nebo .asciidoc a lze je vytvářet v libovolném textovém editoru, IDE nebo dokumentačních systémech založených na Asciidoctoru.

AsciiDoc ukládá nadpisy, seznamy, tabulky, odkazy, bloky zdrojového kódu, obrázky, upozornění, atributy a křížové odkazy jako čitelný text. Asciidoctor je nejčastěji používaný převodník a dokáže generovat HTML, DocBook, PDF prostřednictvím dalších nástrojů a další výstupní formáty.

Co je formát DOCX

DOCX je dokumentový formát založený na XML, který používá Microsoft Word a podporují jej LibreOffice Writer, OnlyOffice a další kancelářské aplikace. Je vhodný pro textové pracovní postupy, které vyžadují upravitelné odstavce, styly, tabulky, komentáře, sledované změny, záhlaví, zápatí a tisk orientovaný na stránky.

DOCX je vhodnější, když příjemci potřebují dokument vizuálně upravovat, používat šablony Wordu, přidávat komentáře k revizi nebo odevzdat soubor do systému, který nepřijímá značkování v podobě prostého textu. Na rozdíl od AsciiDoc nezachovává DOCX zdrojové značky jako primární rozhraní pro úpravy.

Jak skutečně převést ASCIIDOC na DOCX

Pomocí Asciidoctoru a Pandocu

Nejlépe kontrolovatelnou desktopovou metodou je vykreslit AsciiDoc jako DocBook pomocí Asciidoctoru a poté převést soubor DocBook na DOCX pomocí Pandocu.

1. Nainstalujte Asciidoctor a Pandoc. Pokud máte nainstalovaný Ruby, lze Asciidoctor nainstalovat pomocí gem install asciidoctor. Pandoc nainstalujte z oficiálního desktopového balíčku pro svůj operační systém.
2. Otevřete terminál v adresáři obsahujícím zdrojový soubor a vygenerujte DocBook 5:

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

3. Převeďte mezilehlý soubor na DOCX:

pandoc manual.xml -o manual.docx

4. Otevřete manual.docx ve Wordu nebo LibreOffice Writeru a před distribucí zkontrolujte nadpisy, tabulky, obrázky, bloky kódu, konce stránek a odkazy.

Chcete-li použít šablonu Wordu, zadejte referenční soubor DOCX obsahující požadované styly:

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

Uchovávejte obrázky v relativních cestách používaných zdrojovým souborem AsciiDoc. Pokud zdroj používá atributy nebo includes, spusťte Asciidoctor z adresáře projektu, aby bylo možné tyto soubory najít. Dokument s více zdrojovými soubory lze nejprve sestavit pomocí direktivy include:: a poté zpracovat stejnými příkazy.

Pomocí online převodníku

Soubor můžete zdarma převést na 101convert.com bez instalace softwaru: nahrajte soubor ASCIIDOC, jako výstupní formát zvolte DOCX, spusťte převod a stáhněte vygenerovaný dokument. Po stažení výsledek zkontrolujte, zejména pokud zdroj obsahuje místní obrázky, includes, vlastní rozšíření Asciidoctoru nebo diagramy.

Omezení kvality a kompatibility

Mezilehlý krok s DocBookem zachovává standardní strukturu dokumentu lépe než kopírování vykresleného HTML do Wordu, ale nedokáže reprodukovat všechny funkce Asciidoctoru. Vlastní rozšíření, passthrough bloky, podmíněný obsah, složitá logika atributů, procesory diagramů, specializované styly upozornění a některá makra mohou být vynechány nebo převedeny na běžný text.

DOCX používá rozvržení stránek a styly Wordu, zatímco AsciiDoc primárně popisuje sémantickou strukturu. Počítejte s tím, že ve výsledném DOCX bude nutné upravit okraje, písma, šířky tabulek, zvýrazňování syntaxe, velikosti obrázků, titulky, záhlaví, zápatí a konce stránek. Bloky zdrojového kódu a tabulky je vhodné zkontrolovat obzvlášť pečlivě, protože dlouhé řádky a široké sloupce mohou přesahovat stránku.

Odkazy a základní nadpisy se obvykle převedou dobře. Křížové odkazy, poznámky pod čarou, vložená média a relativní cesty k obrázkům závisí na verzích Asciidoctoru a Pandocu a na způsobu uspořádání zdroje. Pokud bude dokument nadále udržován, ponechte původní soubor .adoc jako autoritativní zdroj.