Online konvertor ASCIIDOC do PDF zdarma

Co je formát ASCIIDOC

AsciiDoc je značkovací formát v prostém textu pro strukturované dokumenty, jako jsou softwarové příručky, soubory README, knihy, články a technické specifikace. Autoři zapisují čitelné zdrojové soubory s nadpisy, seznamy, oddělenými bloky kódu, tabulkami, atributy, křížovými odkazy a volitelnými rozšířeními; běžné přípony souborů jsou .adoc a .asciidoc.

Soubory AsciiDoc se běžně vytvářejí v textových editorech, integrovaných vývojových prostředích, repozitářích dokumentace a systémech používajících Asciidoctor nebo původní procesor AsciiDoc. Zdroj zůstává upravitelný a vhodný pro správu verzí, ale jeho výsledný vzhled závisí na převodníku, motivu, písmech, obrazových souborech a atributech dokumentu.

Co je formát PDF

PDF ukládá stránky včetně jejich rozvržení, písem, grafiky a rozměrů pro tisk, které zůstávají zachovány napříč operačními systémy. Hodí se pro formální dokumentaci, e-mailové přílohy, tisk, záznamy a kontrolu, protože příjemci obvykle nepotřebují zdrojový editor ani nástrojový řetězec AsciiDoc.

PDF je pro úpravy a automatické porovnávání verzí méně praktické než AsciiDoc. Může být také větší než zdrojový soubor, zejména pokud obsahuje vložená písma nebo obrázky ve vysokém rozlišení.

Jak převést ASCIIDOC do PDF

Nejpřímější metoda z příkazového řádku používá Asciidoctor PDF, převodník do PDF pro nástrojový řetězec Asciidoctor založený na Ruby.

1. Nainstalujte Ruby, pokud ještě není k dispozici.
2. Nainstalujte převodník pomocí příkazu gem install asciidoctor-pdf --pre. Volba --pre může být vyžadována pro aktuální předběžnou verzi balíčku; při instalaci nejnovější stabilní verze ji vynechte.
3. Otevřete terminál v adresáři obsahujícím zdrojový soubor a spusťte příkaz asciidoctor-pdf manual.adoc -o manual.pdf.
4. Otevřete soubor manual.pdf v prohlížeči PDF a zkontrolujte zalomení stránek, tabulky, bloky kódu, odkazy a obrázky.

U zdrojového souboru, který odkazuje na obrázky nebo zahrnuje jiné soubory AsciiDoc, spusťte příkaz z projektového adresáře dokumentu a zachovejte jeho relativní strukturu složek. Pomocí -a toc=left nebo -a toc=macro přidáte obsah a pomocí -a pdf-theme=custom-theme.yml použijete vlastní motiv PDF. Název, autora a revizi lze nastavit v záhlaví dokumentu pomocí atributů, jako jsou = Installation manual, Author Name <author@example.com> a :revnumber: 1.2.

Soubor můžete také zdarma převést na webu 101convert.com bez instalace softwaru. Nahrajte soubor AsciiDoc, jako výstupní formát zvolte PDF, spusťte převod a stáhněte vygenerovaný dokument.

Úvahy týkající se kvality a kompatibility

Syntaxe AsciiDoc je zpracovávána převodníkem, nikoli přímo kopírována do PDF, takže nepodporovaná rozšíření, vlastní makra, cesty k zahrnovaným souborům a podmíněný obsah mohou změnit výsledek. Asciidoctor PDF používá aktuální pracovní adresář a atributy dokumentu k vyhledání zahrnovaných souborů a prostředků; chybějící cesty vedou k neúplnému výstupu nebo varováním.

Pro předvídatelné stránkování vložte písma nebo je explicitně nakonfigurujte, nastavte velikost stránky a okraje v motivu PDF a použijte rozměry obrázků určené pro tisk. Po převodu zkontrolujte diagramy, soubory SVG, externí odkazy, poznámky pod čarou, přetečení tabulek a znaky psané zprava doleva nebo nelatinkové znaky. Zdrojový soubor se může úspěšně převést, přesto mohou vzniknout oříznuté tabulky nebo chybějící glyfy, pokud vybrané písmo neobsahuje požadované znaky.