Online konvertor ADOC do PDF zdarma

Příjemce, tiskárna, archivní systém nebo pracovní postup dokumentu může vyžadovat PDF s pevným rozvržením namísto upravitelného zdroje AsciiDoc. Vykreslení zdroje do PDF zachovává stránkování a umožňuje zobrazit dokument bez nástroje AsciiDoc.

Co je formát ADOC

ADOC je běžná přípona názvu souboru dokumentu AsciiDoc; používají se také .asciidoc a .asc. Jedná se o zdrojový formát prostého textu obsahující značky pro nadpisy, seznamy, odkazy, tabulky, atributy, odkazy na obrázky a direktivy include::.

Vývojáři, techničtí autoři a týmy dokumentace používají soubory ADOC s nástroji, jako jsou Asciidoctor, AsciidoctorJ a Antora. Textový editor zobrazuje zdrojové značky, například = Document title a == Section, nikoli stránkovaný dokument vytvořený vykreslením.

Co je formát PDF

PDF je formát popisu stránek, který zachovává velikost stránky, typografii, mezery, obrázky a stránkování napříč operačními systémy a tiskárnami. Je vhodný pro tisk, sdílení, archivní kopie a dokumenty, které se musí konzistentně zobrazovat na různých zařízeních.

PDF se upravuje méně pohodlně než ADOC. U dokumentace spravované pomocí systému pro správu verzí upravujte soubor ADOC a PDF znovu vygenerujte, místo abyste PDF upravovali přímo.

Jak převést soubor ADOC do PDF

Pomocí Asciidoctor PDF

Asciidoctor PDF je nejpřímější lokální převodník, protože interpretuje syntaxi AsciiDoc a vytváří PDF bez mezilehlého souboru HTML. Vyžaduje Ruby.

1. Nainstalujte Ruby, pokud již není v počítači k dispozici.
2. Nainstalujte Asciidoctor PDF z terminálu pomocí příkazu gem install asciidoctor-pdf.
3. Otevřete terminál v adresáři obsahujícím zdrojový soubor nebo zadejte jeho úplnou cestu.
4. Spusťte příkaz asciidoctor-pdf document.adoc -o document.pdf.
5. Otevřete výsledek a zkontrolujte nadpisy, odkazy, obrázky, tabulky, bloky kódu a zalomení stránek.

Nahraďte názvy souborů skutečnými názvy zdroje a výstupu. Vlastní motiv PDF lze zadat pomocí atributu, jako je -a pdf-theme=my-theme.yml, pokud jsou soubor motivu a všechna odkazovaná písma k dispozici.

Asciidoctor PDF lze také integrovat do skriptů a sestavení dokumentace, což je vhodnější, pokud je třeba PDF konzistentně znovu generovat ze zdroje spravovaného pomocí systému pro správu verzí.

Pomocí 101convert.com

Soubor můžete zdarma převést na webu 101convert.com bez instalace softwaru: nahrajte soubor .adoc, jako výstupní formát zvolte PDF, spusťte převod a stáhněte výsledek. U důvěrných dokumentů nebo souborů závislých na místních obrázcích, direktivách include, vlastních motivech či rozšířeních použijte lokální Asciidoctor PDF.

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

• Přejmenování souboru document.adoc na document.pdf soubor nepřevede; zdroj AsciiDoc musí být vykreslen.
• Relativní cesty k obrázkům a direktivy include:: se musí správně vyhodnotit. Chybějící soubory mohou vytvořit prázdné oblasti obrázků nebo nevyřešený obsah direktiv include.
• Asciidoctor PDF používá vlastní motivy a pravidla rozvržení. CSS použité pro výstup HTML AsciiDoc neurčuje vzhled PDF.
• Písma musí být nainstalována nebo dodána sestavení PDF a musí obsahovat požadované znaky. Jinak mohou být glyfy nahrazeny nebo zobrazeny jako rámečky pro chybějící znaky.
• Diagramy, grafy, zvýrazňování syntaxe a generované ukázky kódu mohou před generováním PDF vyžadovat další rozšíření AsciiDoc, spustitelné soubory nebo kroky sestavení.
• Dlouhé tabulky a bloky kódu se mohou na hranicích stránek zalamovat nevhodně. Upravte šířky, nastavení motivu nebo ovládací prvky zalomení stránek a před distribucí vykreslené PDF zkontrolujte.
• Výstup PDF závisí na verzi převodníku, motivu, písmech a zahrnutých prostředcích, takže různá prostředí mohou vytvářet mírně odlišné stránkování.