Lehké značkovací jazyky To je důvod, proč byste měli používat AsciiDoc během pravidelného značkování

  • Peter Holmes
  • 0
  • 5320
  • 1419
reklama

Jak jste pravděpodobně viděli z minulých článků, tady na MakeUseOf jsme fanoušky Markdown. Naučíte-li se tento jednoduchý a intuitivní formát, můžete snadno vytvořit pěkně vypadající výstup. Z PDF na webové stránky se váš skromný a prostý textový soubor stane sofistikovaným dokumentem.

Ale Markdown není jediná hra ve městě. Existuje řada dalších tzv. Lehkých značkovacích jazyků podobných Markdown, ale s různými sadami funkcí. Jedním z nich je Asciidoc. Pokud se vám líbí Markdown, ale hledáte trochu více pod kapotou, stojí za zvážení. Zde je několik důvodů.

Co je “Značkovací jazyk” Tak jako tak?

A značkovací jazyk je sada kódů, které, pokud jsou použity na jinak prostý text, vám umožní přidat jednu nebo více z následujících vlastností (mimo jiné):

  • Definujte text
  • Struktura textu
  • Popište rozložení textu
  • Ozdobte text

Jedním značkovacím jazykem, s nímž se denně setkáváte (pokud nejste poustevník), je jazyk značkovacího jazyka nebo HTML. Webové stránky a aplikace, které vám přinášejí zprávy a zobrazují váš e-mail, jsou vytvořeny, alespoň zčásti, se značkami HTML. Naučte se HTML a CSS pomocí těchto výukových programů Krok za krokem Naučte se HTML a CSS pomocí těchto výukových programů Krok za krokem Zajímá vás HTML, CSS a JavaScript? Pokud si myslíte, že máte talent pro učení, jak vytvářet webové stránky od nuly - zde je několik skvělých návodů, které stojí za to vyzkoušet. . HTML využívá značky jako mechanismus značkování nezpracovaného textového obsahu. Zvažte například následující fragment kódu HTML:

 

Představujeme HTML

Tady je odstavec v HTML ... víme, že je to odstavec protože okolní \ tagy jej definují jako jeden.

Tady,

tag určuje, že veškerý text, který má následovat, až do jeho uzavření

tag, je odstavec. V tomto smyslu to definuje text jako odstavec.

Ale všimněte si také značek ... které často slouží k definování rozvržení webové stránky, jako je například to, jak velká je marže ze strany obrazovky.

A značky ozdobí slovo “odstavec” tučným písmem, zatímco

tagy mohou rozložit záhlaví (oddělit jej od okolního textu) a také definovat větší písmo.

Problém s některými značkovacími jazyky (mezi nimi HTML) je, že ruční psaní těchto značek je velmi únavná záležitost. A s dalšími jazyky, jako je XML Co je to soubor XML a jak jej můžete otevřít a používat? Co je soubor XML a jak jej můžete otevřít a používat? Možná jste viděli výraz „XML“. Možná jste dokonce omylem otevřeli soubor XML. Co je XML a jak jej používáte? , značky a jejich atributy tvoří větší část celkového obsahu než samotný text! Podívejte se na následující úryvek DocBook, dialekt XML používaný k vytvoření mnoha technických publikací:

Celý text ve fialové barvě představuje značky, které byste sami potřebovali napsat. První odstavec nezačne až do úplného dna tohoto obrázku. A pokud to nebude provedeno přesně podle standardu DocBook, nebudete jej moci převést na pěkný dokument PDF, který je obvykle konečným cílem.

Zadejte lehký značkovací jazyk

Pokud jste chtěli využít značkovacích jazyků, například publikováním stránky HTML na web nebo převodem souboru DocBook do PDF, aby bylo možné jej vytisknout, musíte udělat jednu ze dvou věcí. Na jedné straně byste mohli investovat čas tím, že se tyto jazyky naučíte dovnitř a ven, zapíšete je ručně a poté trojnásobně zkontrolujete svou práci. Nebo můžete investovat peníze do nástroje, který za vás spravuje jejich složitost.

Naštěstí někteří podnikaví vývojáři přišli s třetí možností. Vytvořili nové značkovací jazyky, které obsahovaly mnoho (v některých případech většinu nebo všechny) rysů těžších protějšků, ale výrazně zjednodušily syntaxi. Tyto “lehká váha” jazyky zahrnují známý Markdown Co je Markdown? 4 důvody, proč byste se měli nyní učit Co je Markdown? 4 důvody, proč byste se měli nyní učit Už vás nebaví editory HTML a WYSIWYG? Pak je Markdown pro vás odpovědí bez ohledu na to, kdo jste. stejně jako Asciidoc, Emacův formát Org-Mode a syntaxi Mediawiki.

Lehké značkovací jazyky mají jednoduchou syntaxi

Jedním z charakteristických znaků těchto jazyků je jejich “značky” (jako jsou) by měla být intuitivní. Pojďme se podívat na předchozí úryvek, tentokrát napsaný v Asciidoc:

Představujeme Asciidoc -------------------- Kde jsou značky * odstavce *? Nepotřebujeme je ... Asciidoc je dost chytrý, aby si uvědomil, že je to odstavec!

Mnohem čitelnější, ne? Počínaje nahoře můžeme identifikovat nadpis tak, jak je “podtrženo” s pomlčkami. Pokud byste to dělali ručně, mohli byste to udělat, jen pod nadpisem stránky v poznámkovém bloku nakreslete podtržení. Neexistují také žádné značky odstavců - Asciidoc považuje za něco mezi dvěma prázdnými řádky, které na něm nemají žádné další značky “prostý” odstavec odstavce. A konečně hvězdičky kolem slova “odstavec” naznačují tučně. Zvedněte ruku, pokud jste to udělali v textové zprávě, aby znamenal totéž.

Každý má jeden nebo více odpovídajících procesorů

“těžká váha” Značkovací jazyky mají obvykle vyhrazenou aplikaci, která je interpretuje za vás. Na webu je to váš prohlížeč a případně i webový server, který změní kód na honosné webové stránky. Vše, co potřebujete vědět o systémech pro správu obsahu Vše, co potřebujete vědět o systémech pro správu obsahu Pro průměrného internetového surfařů, prohlížení obsahu je snadné. Otevřete odkaz a zobrazí se stránka. Co se však děje za scénami? Zde se dozvíte, jak se vaše oblíbené CMS starají o podnikání. . U dokumentů v XML to může být něco jako Microsoft Word, který čte a zapisuje formát DOCX Jak otevírat soubory DOCX aplikace Microsoft Word 2007 Jak otevírat soubory DOCX aplikace Microsoft Word 2007 Už jste někdy dostali jeden z těchto souborů s příponou .docx a přemýšlel, co s tím? Nelze jej zobrazit ve starších verzích aplikace Word, jak tedy můžete otevřít soubor .docx… (což je další dialekt XML). Takže se zdrojem těchto dokumentů nemusíte přímo interagovat, pouze pěkné fasády, které vám aplikace ukazují.

Mezitím jsou dokumenty psané v lehkých jazycích čitelné ve zdrojové podobě (další nájemce), ale pouze skuteční pitomci si mohou myslet, že jsou krásné. Chcete-li získat pěkný výstup, musíte použít procesor. Jedná se o aplikace, které budou procházet váš značkovací řádek po řádku a převést je na něco jiného, ​​co vypadá dobře. Stejné projekty, které vyvíjejí samotný jazyk, obvykle vytvoří nástroj, který s ním půjde. Projekt Markdown nabízí skript Perl se stejným názvem a Asciidocův doprovodný program je psán v Pythonu. Kromě toho budou další konverzní nástroje zahrnovat podporu některých z těchto jazyků. Jedním takovým je vynikající Pandoc Jak snadno převádět mezi formáty dokumentů v Linuxu Jak snadno převádět mezi formáty dokumentů v Linuxu Přechod na Linux může vést k problémům s kompatibilitou souborů. Například dokumenty v LibreOffice nevypadají stejně jako v aplikaci Word. To je jen jeden z důvodů, proč potřebujete pandoc. , které přebírají Markdown a lehké značky reStructured Text, Mediawiki a Org-Mode a převádějí je do PDF, DOCX, ODT a dalších.

Výsledkem je, že lehké značkovací jazyky vám umožňují pracovat v prostém textu, nejpřenosnějším datovém formátu na této planetě, a přesto nakonec produkovat pěkně vypadající výstup. Nyní, když jste přesvědčeni o jeho výhodách, jaký jazyk byste si měli zvolit? Markdown je bezpochyby nejoblíbenější a má své výhody (více o nich později). Zvláště Asciidoc je však hodnou alternativou. V další části prozkoumáme několik důvodů, proč.

Porovnání Markdown a Asciidoc

Formát Asciidoc byl vytvořen s cílem přinést lehkou jednoduchost pro DocBook, jeden z běžnějších formátů v dlouhém (zejména technickém) psaní. Jedním z tvrzení o slávě je to, že se jedná o překlad jeden na jednoho, což znamená, že pro každý prvek v DocBook je v Asciidocu odpovídající zastoupení. Níže se podíváme na některé klady a zápory Asciidoc ve srovnání s Markdown.

Asciidoc pokrývá nadmnožinu prvků psaní

Markdown od začátku měl být jednoduchý formát pro webové spisovatele. Jako takové jsou podporované prvky zápisu (alespoň původní implementace, viz níže) zaměřeny na automatizaci časově náročnějších aspektů psaní HTML (například seznamy, které vyžadují

    nebo
      kromě značek
    • značky pro každou položku).

      Asciidoc je obsahuje také, ale také nabízí pokročilejší prvky DocBook, jako jsou napomenutí (např. “Poznámka:” nebo “Info:” popisné bloky) a složitá rozvržení tabulky. To neznamená, že jste potřeba používat je po celou dobu, ale budou tam a budou k dispozici, pokud je budete někdy potřebovat.

      Asciidoc je jednotný formát

      Když se popularita společnosti Markdown začala rozrůstat, někteří její uživatelé se začali potýkat s některými z výše diskutovaných nedostatků. Tito uživatelé tedy začali vyvíjet svá vlastní rozšíření k řešení těchto problémů, jako je například schopnost přidávat tabulky nebo poznámky pod čarou. Brzy jich bylo mnoho “příchutě” Markdown, včetně (mimo jiné):

      • Chuť používaná Githubem pro “Readme” soubory projektů, které hostil.
      • An “rozšířeno” aroma narozené z portu PHP původního Markdown s extra funkcemi souvisejícími s HTML.
      • Příchuť zvaná “MultiMarkdown” které implementovaly mnoho funkcí psaní delší formy, včetně citací, definic a křížových odkazů.

      Výsledkem je, že váš dokument může vyžadovat prvky, které nejsou všechny pokryty jednou příchutí. Naproti tomu Asciidoc netrpí stejnou fragmentací, jakou Markdown v současnosti dělá.

      Asciidoc zacílí na rozmanitost stylů publikování

      Markdown je skvělý nástroj pro rychlé získání blogového příspěvku z vaší hlavy a na stránku. Ale mimo krabici, není postaven pro strukturování delších děl, jako je kniha. Asciidoc je k tomu určen a jedním příkladem je jeho “zahrnout” funkce. Tyto příkazy umožňují zahrnout veškerý obsah jednoho souboru do jiného:

      include :: somefile.adoc

      To není na rozdíl od toho, jak hlavní dokumenty pracují v textových procesorech. To vám například umožní navrhnout každou kapitolu jako samostatný soubor “zahrnout” všechny do jednoho souboru představujícího knihu. Když to zpracujete “soubor knihy,” výstup bude, jako by všechny kapitoly byly zapsány přímo do tohoto dokumentu.

      Markdown je pro většinu uživatelů dost

      Markdown pokrývá všechny základny pro větší část uživatelů. Pro ty, kteří jednoduše hledají blog nebo psát nějaké poznámky ve formátu prostého textu, Markdown podporuje všechny prvky, které budou potřebovat. Křížové odkazy neznamenají mnoho pro uživatele, který chce pouze vytvořit jednoduchou poznámku nebo webovou stránku. Můžete dokonce použít Markdown pro delší práce s jednoduchými rozvrženími, jako je například román Who Needs Scrivener? 5 nových vývojových aplikací pro Linux, kteří potřebují Scrivener? 5 nových aplikací pro psaní v systému Linux Scrivener není pro systém Linux k dispozici - jak tedy budete sledovat, kam tyto postavy jdou, co udělali a jak dokončují svou cestu? Jeden z těchto nástrojů by měl pomoci. a na konci je zkombinujte.

      Markdown je lépe podporován

      Protože Markdown vyhovuje potřebám většího segmentu uživatelů, skončil lépe podporován, pokud jde o následující:

      • Editoři WYSIWYG (jak jsou definováni ti, kteří přinejmenším poskytují živý náhled) jsou mnohem pravděpodobnější, že podporují Markdown.
      • Online služby, jako je výše uvedený Github, s větší pravděpodobností přijmou Markdown přímo nebo pomocí doplňků. 6 Markdown editory, které hrají pěkně s Google Drive 6 Markdown editory, které hrají pěkně s Google Drive Markdown je formát pro úpravu textu budoucnosti. Je to jednodušší, uhlazenější a snadněji použitelné než HTML, aniž by došlo ke ztrátě síly nebo flexibility. .
      • Přestože publikační systémy, jako jsou generátory statických webů, 7 důvodů, proč zkopírovat svůj CMS a zvážit statický generátor webů 7 důvodů, proč zkopírovat svůj CMS a zvážit statický generátor stránek, bylo mnoho let publikování webových stránek pro mnoho uživatelů obtížné. CMS, jako je WordPress, to změnilo, ale stále mohou být matoucí. Další alternativou je generátor statických stránek. často podporují Asciidoc s pluginy, že podporují Markdown z krabice, je téměř daný.

      Jste ochotni zkusit Asciidoc?

      Zatímco Markdown je de facto volbou mezi lehkými značkovacími jazyky, Asciidoc obsahuje všechny stejné prvky a pak některé. Doplňky Asciidocu vyžadují určitý čas na učení, protože vás mohou lépe připravit na větší a složitější projekty psaní.

      Co myslíš? Jste spokojeni s jednoduchostí Markdown? Nebo si vytvoříte svůj vlastní vícekanálový publikační pracovní postup s lákavou Asciidoc? Možná nenávidíte prostý text a je to Slovo po celou cestu pro vás? Dejte nám vědět v komentářích níže!




Bisher hat noch niemand einen Kommentar zu diesem Artikel abgegeben.

O moderní technologii, jednoduché a cenově dostupné.
Váš průvodce ve světě moderních technologií. Naučte se, jak používat technologie a pomůcky, které nás každý den obklopují, a naučte se, jak objevovat na internetu zajímavé věci.