Online konvertor ASCIIDOC do ORG zdarma

Co je formát ASCIIDOC

AsciiDoc je formát značek v prostém textu určený pro technickou dokumentaci, příručky, soubory README, knihy a webové stránky. Soubory běžně používají přípony .adoc nebo .asciidoc a vytvářejí se pomocí Asciidoctoru, původního procesoru AsciiDoc, dokumentačních systémů, jako je Antora, nebo libovolného textového editoru.

AsciiDoc podporuje hierarchické nadpisy, atributy, křížové odkazy, tabulky, upozornění, výpisy zdrojového kódu, obrázky, vkládání souborů, podmínky a rozšíření bloků. Jeho syntaxe je výraznější než základní jednoduché značky, ale několik těchto funkcí nemá v Org přímý ekvivalent.

Co je formát ORG

Org je formát značek v prostém textu spojený s režimem Org v Emacsu. Soubory Org používají příponu .org a kombinují strukturované nadpisy se stavy TODO, značkami, vlastnostmi, tabulkami, bloky zdrojového kódu, odkazy, citacemi, plánováním a údaji agendy.

Org je užitečný, když bude převedený dokument upravován v Emacsu, prohledáván pomocí agendy Org nebo vyhledávacích nástrojů, exportován do HTML či PDF nebo udržován jako součást projektu literárního programování. Jeho syntaxe nadpisů používá hvězdičky, bloky zdrojového kódu používají #+BEGIN_SRC a #+END_SRC a odkazy používají závorkovou notaci ve stylu Org.

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

Nejspolehlivějším pracovním postupem na desktopu je použití Asciidoctoru následované nástrojem Pandoc. Asciidoctor zpracuje syntaxi a vkládání souborů AsciiDoc, zatímco Pandoc převede výslednou strukturu DocBook na Org.

1. Nainstalujte Asciidoctor a Pandoc pomocí balíčků vhodných pro váš operační systém.
2. Z adresáře obsahujícího zdrojový soubor vygenerujte DocBook a předejte ho do Pandocu:

asciidoctor -b docbook5 -o - input.adoc | pandoc -f docbook -t org -o output.org

Příkaz načte input.adoc, zapíše výstup Asciidoctoru ve formátu DocBook na standardní výstup a uloží výsledek Org jako output.org. Názvy souborů podle potřeby nahraďte; pokud dokument obsahuje relativní cesty k obrázkům nebo vkládaným souborům, použijte stejný pracovní adresář.

U vícestupňového pracovního postupu uložte mezilehlý soubor, abyste jej mohli zkontrolovat:

asciidoctor -b docbook5 -o intermediate.xml input.adoc
pandoc -f docbook -t org intermediate.xml -o output.org

Otevřete output.org v Emacsu a zkontrolujte úrovně nadpisů, odkazy, názvy jazyků zdrojového kódu, tabulky, cesty k obrázkům a veškerá metadata Org, která je třeba doplnit ručně. Pokud nechcete nic instalovat, použijte bezplatný převodník na webu 101convert.com a stáhněte výsledný soubor .org.

Omezení kvality a kompatibility

Strukturální obsah se obvykle převede dobře, ale atributy AsciiDoc, podmíněné části, vlastní role, passthrough bloky, rozšíření diagramů a makra specifická pro procesor mohou být vynechána nebo převedena na běžný text. Asciidoctor při prvním příkazu rozbalí standardní vkládané soubory, ty však musí být dostupné a odkazované pomocí použitelných relativních cest.

Upozornění AsciiDoc a stylované bloky nemusí mít odpovídající nativní konstrukce v Org; po konverzi je zkontrolujte. Tabulky mohou vyžadovat ruční zarovnání nebo přepracování a odkazy na obrázky zůstávají závislé na původních souborech prostředků. DocBook je mezilehlá reprezentace, takže stylování AsciiDoc a chování specifické pro backend nejsou zachovány přesně.

Pokud zdroj používá vlastní rozšíření Asciidoctoru, nejprve převeďte reprezentativní ukázku a před zpracováním větší sady dokumentů porovnejte vygenerovaný soubor Org s originálem.