Online konvertor ASCIIDOC do HTML zdarma

Soubory AsciiDoc je třeba převést, pokud má být dokumentace otevřena ve webovém prohlížeči, publikována na webu nebo dodána systému, který přijímá HTML místo zdrojového kódu značek. HTML zachovává nadpisy, seznamy, odkazy, tabulky, bloky kódu a další strukturu ve formátu, který lze přímo zobrazit.

Co je formát ASCIIDOC

AsciiDoc je textový formát značek pro strukturované dokumenty, jako je softwarová dokumentace, příručky, soubory README, články a technické specifikace. Autoři označují strukturu pomocí čitelné syntaxe pro nadpisy, seznamy, odkazy, upozornění, tabulky, zdrojový kód, obrázky a křížové odkazy.

Běžné přípony souborů jsou .adoc, .asciidoc a někdy .asc. Soubory se vytvářejí nebo upravují v běžných textových editorech a nástrojích pro dokumentaci, včetně Asciidoctor, Asciidoctor.js a Antora. Soubor AsciiDoc obsahuje zdrojové značky, takže prohlížeč zobrazí jeho formátovací znaky namísto vykreslení zamýšlené struktury dokumentu.

Co je formát HTML

HTML je formát značek interpretovaný webovými prohlížeči a používaný webovými stránkami, portály s dokumentací, systémy pro správu obsahu a pracovními postupy souvisejícími s e-mailem. Převod do HTML převede strukturu AsciiDoc na prvky, jako jsou <h1>, <p>, <ul>, <table> a <pre>.

HTML je vhodné, když příjemci potřebují zobrazení v prohlížeči, dokumentaci s možností vyhledávání, obsah, který lze kopírovat, nebo soubor, který lze vložit na webovou stránku. Výsledek může obsahovat styly CSS, odkazy na obrázky, prostředky pro zvýraznění syntaxe a odkazy na další vygenerované stránky.

Jak skutečně převést ASCIIDOC do HTML

Pomocí Asciidoctor

1. Nainstalujte Ruby a procesor Asciidoctor a poté spusťte gem install asciidoctor.
2. Otevřete terminál v adresáři obsahujícím zdrojový soubor.
3. Převeďte jej pomocí asciidoctor input.adoc -o output.html. Nahraďte názvy souborů skutečnými názvy zdrojového a cílového souboru.
4. Otevřete output.html v prohlížeči a zkontrolujte nadpisy, odkazy, tabulky, bloky kódu a obrázky.

Chcete-li vytvořit vložené HTML vhodné pro vložení na jinou stránku, použijte asciidoctor -e input.adoc -o fragment.html. Chcete-li použít stylopis, zadejte jeho umístění pomocí atributu Asciidoctor, například asciidoctor -a stylesheet=site.css input.adoc -o output.html.

Pomocí online převodníku

Soubor můžete zdarma převést na webu 101convert.com bez instalace softwaru. Nahrajte soubor AsciiDoc, v případě potřeby zvolte HTML jako výstupní formát, spusťte převod a stáhněte vygenerovaný soubor. Po stažení zkontrolujte obrázky a zahrnuté soubory, protože převod prováděný v prohlížeči nemusí mít přístup k místním cestám odkazovaným ve zdroji.

Otázky kvality a kompatibility

Dokumenty AsciiDoc mohou odkazovat na obrázky, zahrnovat další zdrojové soubory, načítat atributy a používat vlastní rozšíření. Místní převod pomocí Asciidoctor je obvykle vhodnější, pokud na těchto závislostech záleží, protože převodník může být spuštěn ze správného adresáře projektu a používat zamýšlené atributy.

Uchovávejte odkazované obrázky a soubory CSS na očekávaných relativních místech nebo před publikováním aktualizujte vygenerované cesty. Soubor HTML může obsahovat odkazy na samostatné prostředky namísto jejich vložení, takže přesunutí pouze souboru HTML může způsobit chybějící obrázky nebo výstup bez stylů.

Vlastní makra, nepodporovaná rozšíření, chybějící vložené soubory a nesprávné atributy dokumentu mohou vést k neúplnému výstupu. Otestujte vygenerované HTML v cílovém prohlížeči nebo publikačním systému, zejména pokud zdroj používá zvýraznění syntaxe, odkazy mezi dokumenty nebo znaky mimo ASCII.