Online konvertor ASCIIDOC do EPUB zdarma

Čtečky elektronických knih a publikační systémy běžně vyžadují EPUB namísto zdrojového souboru AsciiDoc. Převod zachová nadpisy, odstavce, seznamy, odkazy, obrázky a další strukturovaný obsah v přeformátovatelném formátu, který lze otevřít v telefonech, tabletech a specializovaných zařízeních pro elektronické knihy.

Co je formát ASCIIDOC

AsciiDoc je značkovací formát v prostém textu pro strukturované dokumenty, jako jsou knihy, příručky, dokumentace k softwaru, články a soubory README. Autoři pomocí čitelné textové syntaxe zapisují nadpisy, seznamy, tabulky, odkazy, bloky kódu, atributy, křížové odkazy a upozornění, místo aby upravovali binární dokument.

Mezi běžné přípony zdrojových souborů patří .adoc, .asciidoc a .asc. Asciidoctor a Asciidoc tyto soubory používají ke generování dokumentů HTML, PDF, man pages a EPUB. Vývojáři se s nimi obvykle setkávají v repozitářích s dokumentací, projektech static-site, projektech založených na Git a v systémech pro sestavování dokumentace.

Co je formát EPUB

EPUB je balíček elektronické knihy založený na formátu ZIP, který obsahuje obsah XHTML, styly CSS, metadata, navigační soubory a volitelné obrázky, fonty a další prostředky. EPUB 3 podporuje sémantické HTML, responzivní rozvržení, navigaci, zvuk nebo video a psaní zprava doleva či vertikální psaní, pokud čtecí systém tyto funkce podporuje.

Na rozdíl od PDF s pevně danými stránkami se obsah EPUB přizpůsobuje velikosti obrazovky, nastavení fontu a orientaci čtecího zařízení. Je vhodný pro distribuci rozsáhlé dokumentace nebo knih prostřednictvím čteček elektronických knih a knihoven i pro kontrolu výsledku pomocí aplikací kompatibilních s EPUB.

Jak převést ASCIIDOC na EPUB

Použití Asciidoctor EPUB3

Asciidoctor EPUB3 je nejpřímější volbou, protože rozumí konstrukcím specifickým pro AsciiDoc, místo aby zdroj považoval za obecný značkovací jazyk. Pokud Ruby ještě není k dispozici, nejprve jej nainstalujte a poté nainstalujte převaděč:

gem install asciidoctor-epub3

V adresáři obsahujícím zdrojový soubor spusťte:

asciidoctor-epub3 book.adoc -o book.epub

Soubor book.adoc nahraďte skutečným názvem souboru. Převaděč načte hlavičku dokumentu, vložené soubory, odkazované obrázky, atributy a strukturální prvky a poté zapíše soubor book.epub.

U projektu s více soubory ponechte vložené zdrojové soubory a adresáře s obrázky na očekávaných relativních umístěních. Typický příkaz s vlastní pracovní složkou vypadá takto:

asciidoctor-epub3 -D output book.adoc

Metadata dokumentu nastavte v hlavičce AsciiDoc před převodem, například:

= Book title
Author Name <author@example.com>
:revnumber: 1.0
:description: A short description
:doctype: book
:toc:
:sectnums:

Pokud jsou cesty k obrázkům relativní vůči společnému adresáři, použijte atribut obrázků, například :imagesdir: images. Zkontrolujte, zda každý odkazovaný obrázek existuje a používá formát podporovaný cílovými čtecími systémy, obvykle JPEG, PNG nebo SVG.

Převod bez instalace softwaru

Pokud není praktické instalovat Ruby nebo Asciidoctor, můžete soubor zdarma převést na webu 101convert.com. Nahrajte soubor AsciiDoc, jako výstupní formát zvolte EPUB, spusťte převod a stáhněte vygenerovanou elektronickou knihu.

Použití Pandoc jako alternativy

Pandoc dokáže některé dokumenty AsciiDoc převést přímo:

pandoc book.adoc -o book.epub

Pandoc použijte u poměrně jednoduchých dokumentů nebo v případě, že je již součástí publikačního pracovního postupu. Asciidoctor EPUB3 obecně spolehlivěji zachovává atributy specifické pro AsciiDoc, upozornění, vložené soubory a křížové odkazy.

Kvalita, kompatibilita a omezení

EPUB je přeformátovatelný, takže pevné konce řádků, přesné pozice stránek a pokyny k rozvržení ve stylu PDF nelze konzistentně zachovat. Čísla stránek, sirotci a vdovy, jejich zpracování a zalamování řádků se liší podle čtecího systému a uživatelského nastavení fontu.

Složitá rozšíření AsciiDoc, vlastní převaděče, vložené diagramy, nepodporovaná makra a formátování určené pouze pro PDF mohou vyžadovat ruční úpravy. Před převodem vygenerujte soubory diagramů a pro všechny lokální prostředky použijte relativní cesty.

Otevřete výsledek alespoň v jedné čtečce EPUB a zkontrolujte obsah, hierarchii nadpisů, odkazy, bloky kódu, tabulky, obrázky a speciální znaky. Pro validaci na úrovni balíčku spusťte EPUBCheck:

epubcheck book.epub

Před distribucí souboru opravte chybějící prostředky, neplatné XHTML, chyby metadat a upozornění týkající se navigace.