Online konvertor ASCIIDOC do TEXTILE zdarma

Co je formát ASCIIDOC

AsciiDoc je odlehčený značkovací formát uložený jako prostý text, obvykle s příponou .adoc nebo .asciidoc. Podporuje názvy dokumentů, oddíly, upozornění, tabulky, křížové odkazy, atributy, výpisy zdrojového kódu, obrázky a vkládání souborů.

Soubory vytvářejí a zpracovávají Asciidoctor, starší procesor AsciiDoc, AsciidocFX, Antora a textové editory. Běžně se používá v projektech dokumentace, souborech README, příručkách, poznámkách k vydání a zdrojových souborech statických webů. Syntaxe AsciiDoc se mezi implementacemi liší a rozšíření Asciidoctor mohou přidávat funkce, které nejsou součástí základního formátu.

Co je formát TEXTILE

Textile je značkovací jazyk v podobě prostého textu, který používají některé wiki, systémy pro správu obsahu, publikační nástroje a starší webové aplikace. Jeho syntaxe používá krátké značky, například h1. Heading pro nadpisy, *bold* pro tučné písmo, _italic_ pro kurzívu a "link text":https://example.com pro odkazy.

Textile zůstává užitečný, když cílová aplikace obsahuje parser Textile, ale nepodporuje AsciiDoc. Protože jde o prostý text, převedený soubor lze upravovat v libovolném textovém editoru a verzovat bez binárního formátu dokumentu. Jednotlivé implementace Textile se liší podporou tabulek, atributů, poznámek pod čarou a rozšířené syntaxe.

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

Pro rychlý převod bez instalace softwaru použijte převodník na 101convert.com: nahrajte soubor .adoc nebo .asciidoc, jako výstupní formát vyberte TEXTILE, spusťte převod a stáhněte výsledný soubor .textile.

Pro místní a opakovatelný převod použijte Asciidoctor k vytvoření DocBook XML a Pandoc k vytvoření Textile. Pandoc nedokáže spolehlivě přímo analyzovat každý dialekt AsciiDoc, takže tento dvoufázový postup svěřuje interpretaci syntaxe zdrojového souboru nástroji Asciidoctor.

1. Nainstalujte Asciidoctor a Pandoc pomocí způsobu instalace vhodného pro váš operační systém.
2. Otevřete terminál v adresáři obsahujícím zdrojový soubor.
3. Spusťte asciidoctor -b docbook5 -o intermediate.xml input.adoc. Nahraďte input.adoc skutečným názvem souboru. Pokud je příponou zdroje .asciidoc, použijte input.asciidoc.
4. Převeďte mezilehlý dokument pomocí pandoc -f docbook -t textile intermediate.xml -o output.textile.
5. Otevřete output.textile v textovém editoru nebo jej importujte do cílové aplikace Textile a zkontrolujte vykreslený výsledek.

Pokud zdroj používá místní vkládané soubory, spusťte Asciidoctor z adresáře projektu, aby se relativní cesty správně vyřešily. Například asciidoctor -b docbook5 -o intermediate.xml chapters/index.adoc může vyžadovat, aby byly cesty k vkládaným souborům a atributy projektu dostupné z tohoto pracovního adresáře.

Omezení kvality a kompatibility

Mezilehlý krok s DocBook může změnit podrobnosti prezentace. Atributy AsciiDoc, podmíněné bloky, vlastní role, rozšíření, stylování upozornění, nevyřešené křížové odkazy a makra specifická pro procesor mohou být v Textile vynechány nebo zobrazeny odlišně.

Po převodu zkontrolujte tabulky, vnořené seznamy, řádkové formátování, obrázky, poznámky pod čarou, kotvy, bloky zdrojového kódu a odkazy. Obrázky jsou obvykle odkazovány cestou, nikoli vloženy, proto zkopírujte soubory obrázků a zachovejte relativní strukturu adresářů. Vykreslovač Textile nemusí podporovat všechny funkce vytvořené nástrojem Pandoc; nepodporované konstrukce se mohou zobrazit jako escapované značky nebo běžné odstavce.

Ponechte původní soubor AsciiDoc jako autoritativní zdroj. Výstup Textile upravujte pouze v případě, že cílový systém vyžaduje jednorázovou úpravu, protože opakovaný převod tyto změny přepíše.