Online konvertor ASCIIDOC do ODT zdarma

Soubory ASCIIDOC jsou praktické pro dokumentaci spravovanou pomocí systémů pro řízení verzí, ale mnoho kancelářských aplikací vyžaduje k úpravám nebo distribuci formát OpenDocument Text. Převod do ODT zachová dokument jako upravitelný soubor textového procesoru, který mohou otevřít LibreOffice a další programy kompatibilní s OpenDocument.

Co je formát ASCIIDOC

AsciiDoc je odlehčený značkovací formát pro psaní strukturovaných dokumentů v prostém textu. Autoři používají značky, jako jsou nadpisy, seznamy, odkazy, tabulky, upozornění, bloky zdrojového kódu a atributy, namísto přímého ukládání formátování do souboru textového procesoru.

Soubory běžně používají příponu .adoc nebo .asciidoc. Asciidoctor a Asciidoc tyto soubory vytvářejí a zpracovávají a často se objevují v softwarové dokumentaci, souborech README, technických příručkách a úložištích dokumentace spravovaných pomocí Git.

Co je formát ODT

ODT je formát OpenDocument Text, dokumentový formát založený na ZIP, definovaný standardem OpenDocument. Ukládá upravitelný text, styly odstavců a znaků, tabulky, obrázky, metadata a informace o rozvržení stránky.

LibreOffice Writer otevírá a upravuje soubory ODT přímo; Apache OpenOffice a další aplikace kompatibilní s OpenDocument je také dokážou číst. ODT je užitečný, když příjemci potřebují stránkovaný dokument s upravitelným formátováním namísto zdroje ve značkovacím formátu.

Jak skutečně převést ASCIIDOC do ODT

Nejspolehlivější postup na desktopu používá Asciidoctor k vytvoření DocBook XML a následně Pandoc k vytvoření souboru ODT.

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.
3. Převeďte zdroj AsciiDoc do DocBook 5 XML:
   asciidoctor -b docbook5 -o intermediate.xml input.adoc
4. Převeďte prostřední soubor XML do ODT:
   pandoc -f docbook -t odt intermediate.xml -o output.odt
5. Otevřete output.odt v LibreOffice Writer a zkontrolujte nadpisy, tabulky, obrázky, konce stránek, poznámky pod čarou a bloky kódu.

U souboru AsciiDoc obsahujícího obrázky nebo vložené soubory spouštějte příkazy ze zdrojového adresáře, aby se relativní cesty správně vyřešily. Pokud zdroj používá atribut, předejte jej Asciidoctoru pomocí volby, jako je -a toc=, nebo jej definujte v hlavičce dokumentu.

Pokud nechcete instalovat software, můžete soubor zdarma převést na 101convert.com pomocí jeho převaděče ASCIIDOC na ODT.

Omezení kvality a kompatibility

Převod probíhá přes dva modely formátů, takže funkce specifické pro AsciiDoc nemusí být do ODT převedeny přesně. Základní nadpisy, odstavce, zvýraznění, seznamy, odkazy, tabulky, obrázky a bloky kódu se obvykle přenesou, zatímco složité role, vlastní motivy Asciidoctoru, rozšíření, podmíněný obsah, makra a pokročilé styly upozornění mohou vyžadovat ruční úpravy.

Zdroj AsciiDoc popisuje strukturu; ODT vyžaduje také styly stránek, písma, okraje, záhlaví, zápatí a stránkování. Pandoc používá vlastní výchozí nastavení dokumentu, proto výsledek zkontrolujte v LibreOffice a upravujte styly namísto spoléhání se na původní vzhled AsciiDoc. Pokud záleží na konzistentním stránkování, před finálním exportem vložte požadovaná písma nebo je nainstalujte.

Prostřední soubor XML si ponechte, dokud nebude ověření dokončeno. Pomůže určit, zda problém vznikl ve fázi analýzy Asciidoctoru, nebo ve zapisovači ODT v Pandocu.