Online konvertor AD do DOCBOOK zdarma

Co je formát AD

V kategorii textových souborů označuje AD obecně zdrojový soubor AsciiDoc. Soubory AsciiDoc obsahují značky v prostém textu pro nadpisy, seznamy, tabulky, odkazy, obrázky, upozornění, zdrojový kód a metadata dokumentu; stejná syntaxe se běžně ukládá také s příponami .adoc nebo .asciidoc.

Soubory s příponou .ad se vytvářejí nebo upravují pomocí procesorů AsciiDoc, Asciidoctor a běžných textových editorů. Samotná přípona nezaručuje přesný procesor ani verzi syntaxe, proto před převodem zkontrolujte první řádky a vyhledejte atributy, jako jsou :doctype:, :toc: nebo direktivy include.

Co je formát DOCBOOK

DocBook je slovník XML pro strukturovanou technickou dokumentaci. Reprezentuje prvky dokumentu, jako jsou kapitoly, oddíly, odstavce, postupy, tabulky, citace, výpisy programů a křížové odkazy, nezávisle na konečném rozvržení stránky.

DocBook je vhodný v případě, že publikační pipeline používá nástroje, jako jsou xsltproc, Jing, Saxon nebo styly DocBook, k vytváření HTML, PDF, EPUB nebo man pages. Jeho struktura XML také usnadňuje validaci, indexování a pozdější převody do jiných formátů ve srovnání s prezentačně orientovanými značkami.

Jak převést AD na DOCBOOK

Asciidoctor je nejpřímější desktopový nástroj pro převod, protože načítá AsciiDoc a obsahuje DocBook backend.

1. Nainstalujte Asciidoctor pomocí správce balíčků svého operačního systému nebo Ruby gemu a poté instalaci ověřte příkazem asciidoctor --version.
2. Umístěte zdrojový soubor a všechny odkazované obrázky, vkládané soubory nebo soubory atributů do očekávaných relativních cest.
3. Spusťte asciidoctor -b docbook5 -o output.xml input.ad. Volba -b docbook5 vybere XML DocBook 5 a -o nastaví název výstupního souboru.
4. Pro workflow s DocBook 4 použijte asciidoctor -b docbook -o output.xml input.ad, pokud je tento backend v nainstalované verzi k dispozici.
5. Ověřte výsledek pomocí schématu DocBook nebo validačního příkazu požadovaného vaším publikačním systémem. Otevřete output.xml v editoru s podporou XML a zkontrolujte nevyřešené direktivy include, nefunkční cesty k obrázkům a nesprávně zformátované atributy.

Chcete-li provést grafický převod bez instalace softwaru, nahrajte soubor AD na 101convert.com, vyberte DOCBOOK jako cílový formát a stáhněte vygenerované XML. To je vhodné pro jednorázový převod, pokud zdroj používá standardní funkce AsciiDoc a nezávisí na lokálních vkládaných souborech.

Úvahy o kvalitě a kompatibilitě

Značky AsciiDoc se při použití vlastních rozšíření, atributů specifických pro backend, passthrough bloků, maker nebo vložených skriptů nemapují na DocBook dokonale. Po převodu zkontrolujte upozornění, tabulky, callouty, poznámky pod čarou, křížové odkazy a výpisy zdrojového kódu.

Relativní obrázky a direktivy include:: vyžadují přístup k původní struktuře adresářů; převodník, který obdrží pouze hlavní soubor, může tyto zdroje vynechat nebo ponechat nevyřešené odkazy. Výstup DocBook je XML, nikoli hotový PDF soubor nebo webová stránka, proto následně použijte příslušný styl DocBook nebo navazující publikační nástroj.