Online konvertor ASCIIDOC do TYP zdarma

Typst vyžaduje zdrojové dokumenty ve svém značkovacím formátu .typ, zatímco mnoho dokumentačních projektů je vytvářeno jako soubory .adoc nebo .asciidoc. Převod mezi nimi umožňuje znovu použít strukturovanou dokumentaci v publikačním workflow Typst, aniž byste museli ručně vytvářet každý nadpis, seznam a odkaz.

Co je formát ASCIIDOC

AsciiDoc je textový značkovací formát pro technickou dokumentaci, příručky, soubory README, knihy a webové stránky. Soubory běžně používají příponu .adoc nebo .asciidoc; vytvářejí a zpracovávají je Asciidoctor a Asciidoctor.js. Formát podporuje nadpisy, seznamy, tabulky, bloky zdrojového kódu, křížové odkazy, atributy, vkládání souborů, upozornění, obrázky a metadata dokumentu.

Co je formát TYP

V kategorii textových souborů označuje .typ zdrojový značkovací formát Typst. Typst je systém pro sazbu, jehož kompilátor převádí zdrojové soubory do PDF a dalších vykreslených výstupů. Soubory TYP kombinují čitelnou syntaxi zdrojového kódu s instrukcemi pro rozvržení nadpisů, obrázků, tabulek, citací, nastavení stránek a znovu použitelných funkcí. Jsou užitečné, pokud cílové workflow používá kompilátor Typst namísto vykreslovače AsciiDoc nebo toolchainu LaTeX.

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

Nejspolehlivější automatizovaný postup vede z Asciidoctor do DocBook XML a následně z Pandoc do Typst. Nainstalujte Asciidoctor a aktuální vydání Pandoc a spusťte:

asciidoctor -b docbook5 -o document.xml document.adoc
pandoc -f docbook -t typst -o document.typ document.xml

Soubor document.adoc nahraďte názvem zdrojového souboru. První příkaz rozbalí strukturu AsciiDoc do DocBooku; druhý mapuje prvky DocBooku na značkovací formát Typst. Výsledek zkompilujte pomocí:

typst compile document.typ

U souboru AsciiDoc, který závisí na atributech, je během převodu nastavte například takto:

asciidoctor -a revnumber=2.0 -a showtitle -b docbook5 -o document.xml document.adoc

Bez instalace software můžete také použít bezplatný převodník na webu 101convert.com: vyberte zdrojový formát ASCIIDOC, nahrajte soubor, zvolte TYP a uložte převedený výsledek.

Omezení kvality a kompatibility

Jde o překlad značek, nikoli o změnu formátu na úrovni bajtů. Základní nadpisy, odstavce, zvýraznění, seznamy, tabulky, bloky kódu a mnoho odkazů se obvykle převede dobře, ale atributy AsciiDoc, podmíněný obsah, vlastní role, makra, rozšíření, vkládání souborů a bloky diagramů mohou vyžadovat ruční přepsání v Typst.

Před převodem, pokud je to možné, vyřešte vkládané soubory a vygenerujte externí prostředky. Ve vygenerovaném souboru .typ zkontrolujte cesty k obrázkům, šířky tabulek, citace, nastavení stránek a křížové odkazy. Pandoc může zachovat obsah, ale změnit sémantiku rozvržení, proto soubor zkompilujte pomocí Typst a zkontrolujte vykreslené PDF, místo abyste se spoléhali pouze na převedený zdrojový kód.