Limbajul de marcare ușoară Acesta este motivul pentru care ar trebui să utilizați AsciiDoc peste marcajul regulat

Limbajul de marcare ușoară Acesta este motivul pentru care ar trebui să utilizați AsciiDoc peste marcajul regulat / Tehnologie explicată

După cum probabil ați văzut din articolele anterioare, aici la MakeUseOf suntem fani ai lui Markdown. Prin învățarea acestui format simplu și intuitiv, puteți crea cu ușurință rezultate excelente. De la pagini PDF la pagini web, fișierul dvs. de text simplu și prost devine un document sofisticat.

Dar Markdown nu este singurul joc din oraș. Există o serie de alte așa-numite limbi de marcare ușoare, similare Markdown, dar cu seturi de caracteristici diferite. Unul dintre acestea este Asciidoc. Dacă vă place Markdown, dar căutați un pic mai mult sub capota, merită luată în considerare. Iată câteva motive de ce.

Ce este “Limbajul de marcare” Oricum?

A limba de marcare este un set de coduri care, atunci când este aplicat textului altfel simplu, vă permite să adăugați una sau mai multe din următoarele proprietăți (printre altele):

  • Definiți textul
  • Structurați textul
  • Descrieți aspectul textului
  • Decorează textul

Un limbaj de markup pe care îl întâlniți în fiecare zi (cu excepția cazului în care sunteți un pustnic) este Hypertext Markup Language sau HTML. Site-urile web și aplicațiile care vă aduc știri și vă arată e-mailul dvs. sunt construite, cel puțin parțial, cu marcaj HTML Aflați HTML și CSS cu aceste Tutoriale Pas cu pas Aflați HTML și CSS cu aceste Tutoriale pas cu pas Curios despre HTML, CSS și JavaScript? Dacă credeți că aveți un talent pentru a învăța cum să creați site-uri web de la zero - aici sunt câteva tutoriale pas cu pas care merită încercate. Citeste mai mult . HTML utilizează Etichete ca mecanism de marcare a conținutului textului brut. De exemplu, luați în considerare următorul fragment HTML:

 

Introducerea HTML

Iată un paragraf în HTML ... știm că este a paragraf pentru că înconjurător \ etichetele îl definesc ca pe unul.

Aici

tag-ul specifică faptul că tot textul de urmat, până la închiderea sa

tag, este un paragraf. În acest sens definește textul ca paragraf.

Dar notați de asemenea tag-uri ... acestea servesc adesea pentru a defini aspectul unei pagini web, cum ar fi câtă marjă există de pe partea laterală a ecranului.

Si etichetele vor decora cuvântul “paragraf” cu un font aldine, în timp ce

etichetele pot să stabilească atât poziția (distanțându-l de textul din jur), cât și să definească un font mai mare.

Problema cu unele limbi de marcare (HTML printre ei) este că tastarea acestor etichete manual este o aventură foarte obositoare. Și cu alte limbi cum ar fi XML Ce este un fișier XML și care sunt utilizările lui? [În cazul în care v-ați întrebat] Ce este un fișier XML și care sunt utilizările acestuia? [În cazul în care ați întrebat] Citiți mai mult, etichetele și atributele acestora reprezintă o porțiune mai mare a conținutului global decât textul însuși! Uitați-vă la următorul fragment DocBook, un dialect XML folosit pentru a crea numeroase publicații tehnice:

Tot textul purpuriu reprezintă etichete pe care trebuie să le introduceți singuri. Primul paragraf nu pornește decât în ​​partea inferioară a imaginii respective. Și dacă nu se face exact după standardul DocBook, nu veți putea să-l convertiți în documentul PDF destul, care este, de obicei, obiectivul final.

Introduceți limbajul de marcare ușoară

Dacă doriți să profitați de limbile de marcare, de exemplu prin publicarea unei pagini HTML pe web sau prin conversia unui fișier DocBook în format PDF, astfel încât să poată fi tipărit, trebuie să faceți una din cele două lucruri. Pe de o parte, puteți inventa timp învățând aceste limbi în interiorul și în afară, scriându-le manual, apoi triple-verificați-vă munca. Sau puteți investi bani într-un instrument care gestionează complexitatea acestora pentru dvs..

Din fericire, unii dezvoltatori întreprinzători au venit cu oa treia opțiune. Ei au creat noi limbi de marcare care conțineau multe (în unele cazuri cele mai multe sau toate) caracteristicile celor mai grele omologi, dar simplificau foarte mult sintaxa. Aceste “categorie ușoară” limbile includ Markdown familiare Ce este Markdown? 4 motive pentru care ar trebui să o înveți acum Ce este Markdown? 4 motive pentru care ar trebui să-l învățați acum Obosit de editori HTML și WYSIWYG? Apoi, Markdown este răspunsul pentru dvs. indiferent cine sunteți. Citiți mai multe, precum formatul Asciidoc, modul Org-Mode al lui Emac și sintaxa Mediawiki.

Limbile de marcare ușoară au o sintaxă simplă

Un semn distinctiv al acestor limbi este acela al lor “Etichete” (cum ar fi acestea) ar trebui să fie intuitivă. Să aruncăm o privire la fragmentul anterior, de data aceasta scris în Asciidoc:

Introducerea Asciidoc -------------------- Unde sunt tagurile * paragraf *? Nu avem nevoie de ei ... Asciidoc este suficient de inteligent pentru a realiza că acesta este un paragraf!

Mai mult de citit, nu? Începând din partea de sus, putem identifica poziția așa cum este “accentuat” cu liniuțe. S-ar putea să faceți acest lucru dacă ați fost scris de mână, doar trageți o subliniere sub titlul paginii din notebook. Nu există, de asemenea, etichete paragraf - Asciidoc consideră orice dintre două linii goale care nu au nici un alt marcaj pe el să fie “simplu” textul paragrafului. În cele din urmă, asteriscurile din jurul cuvântului “paragraf” indicați bolding. Ridicați mâna dacă ați făcut acest lucru într-un mesaj text pentru a însemna exact același lucru.

Fiecare are unul sau mai mulți procesori corespondenți

“grea” limbile de marcare au, de obicei, o aplicație dedicată pentru a le interpreta pentru dvs. Pe web, este browser-ul dvs. și, eventual, serverul web care va transforma codul în pagini web strălucitoare Tot ce trebuie să știți despre sistemele de management al conținutului Tot ce trebuie să știți despre sistemele de gestionare a conținutului Pentru surferul de internet mediu, vizualizarea conținutului este usor. Deschideți un link și apare pagina. Dar ce are loc în spatele scenei? Iată cum gestionează CMS-urile dvs. preferate de afaceri. Citeste mai mult . Pentru documentele XML, ar putea fi ceva asemănător cu Microsoft Word, care citește și scrie formatul DOCX Cum se deschide fișierele DOCX Microsoft Word 2007 Cum se deschide fișierele DOCX ale Microsoft Word 2007 Ați primit vreodată unul dintre acele fișiere cu extensia .docx și se întreba ce să facă cu ea? Nu se poate vedea în versiuni mai vechi, așa cum puteți deschide un fișier .docx ... Read More (care este un alt dialect XML). Deci, nu trebuie niciodată să interacționați direct cu sursa acestor documente, doar pe cele frumoase ale fațadelor pe care le vă arată aplicațiile.

Între timp, documentele scrise în limbi ușoare pot fi citite de om în formă sursă (un alt chiriaș), dar numai tovarășii adevărați ar putea crede că sunt frumoși. Pentru a obține destul de ieșire, trebuie să utilizați a procesor. Acestea sunt aplicații care se vor executa prin linia de marcare prin linie și vor fi convertite în altceva care arată bine. Aceleași proiecte care dezvoltă limba în sine vor produce de obicei un utilitar pentru a merge cu el. Proiectul Markdown oferă un script Perl cu același nume, iar programul asociat lui Asciidoc este scris în Python. În plus, alte utilitare de conversie vor include suport pentru unele dintre aceste limbi. Un astfel de lucru este excelent Pandoc Cum de a converti cu ușurință între formate de documente în Linux Cum de a converti cu ușurință între formate de documente în Linux Trecerea la Linux poate duce la probleme cu compatibilitatea fișierelor. De exemplu, documentele nu arată la fel în LibreOffice ca și în Word. Acesta este doar un motiv pentru care aveți nevoie de pandoc. Citiți mai mult, ceea ce va face Markdown, precum și marcarea ușoară a textelor restructurate, Mediawiki și Org-Mode și le vom converti în PDF, DOCX, ODT și multe altele.

Rezultatul este că limbile de marcare ușoare vă permit să lucrați în text simplu, cel mai portabil format de date de pe planetă, dar totuși să producă în cele din urmă o producție frumoasă. Acum, că sunteți convins de meritele sale, ce limbă ar trebui să alegeți? Markdown este, fără îndoială, cel mai popular și are avantajele sale (mai multe despre acestea mai târziu). Dar, în special, Asciido este o alternativă demnă. În secțiunea următoare vom explora câteva motive.

Comparând Markdown și Asciidoc

Formatul Asciidoc a fost creat pentru a aduce o ușoară ușurință DocBook, unul dintre cele mai comune formate de scriere pe termen lung (în special tehnic). Unul dintre pretențiile sale este că este o traducere individuală, adică pentru fiecare element din DocBook, există o reprezentare corespunzătoare în Asciidoc. Mai jos vom arunca o privire asupra unora dintre avantajele și dezavantajele lui Asciidoc în comparație cu Markdown.

Asciidoc acoperă un Superset de elemente de scriere

Scopul lui Markdown de la început a fost să fie un format simplu pentru scriitorii web. Ca atare, elementele de scriere pe care le susține (cel puțin implementarea originală, vezi mai jos) se concentrează în jurul automatizării aspectelor de scriere a codului HTML (de exemplu liste care necesită

    sau
      în plus față de
    • etichete pentru fiecare articol).

      Asciidoc conține și ele, dar oferă și elemente DocBook mai avansate, cum ar fi admonițiile (de ex. “Notă:” sau “Info:” blocuri de descriere) și machete complexe. Nu înseamnă că tu nevoie să le folosești tot timpul, dar ei vor fi acolo și vor fi disponibili dacă le vei avea vreodată nevoie.

      Asciidoc este un format unificat

      Când popularitatea lui Markdown a început să decoleze, unii dintre utilizatorii săi au început să se confrunte cu unele dintre neajunsurile discutate mai sus. Astfel, acești utilizatori au început să își dezvolte propriile extensii pentru a rezolva aceste probleme, cum ar fi abilitatea de a adăuga mese sau picior / note de subsol. În curând au existat multe “arome” din Markdown, inclusiv (printre altele):

      • Aroma utilizată de Github pentru “Citește-mă” dosare de proiecte pe care le-a găzduit.
      • Un “extins” aromă născut dintr-un port PHP al originalului Markdown cu caracteristici suplimentare legate de HTML.
      • O aromă numită “MultiMarkdown” care a implementat multe caracteristici ale scrisului în formă mai lungă, inclusiv citări, definiții și referințe încrucișate.

      Rezultatul este că documentul dvs. poate necesita elemente care nu sunt toate acoperite de un singur gust. În schimb, Asciidoc nu suferă de aceeași fragmentare pe care Markdown o are în prezent.

      Asciidoc vizează o varietate de stiluri de publicare

      Markdown este excelent pentru obținerea rapidă a unui post blog din cap și pe pagină. Dar din cutie, nu este construit pentru a structura opere mai lungi, cum ar fi o carte. Asciidoc este conceput pentru acest lucru, și un exemplu este acesta “include” funcții. Aceste instrucțiuni vă permit să includeți tot conținutul unui fișier în altul:

      includ :: somefile.adoc

      Acest lucru nu este diferit de modul în care Master Documents lucrează în procesoare de text. Aceasta vă permite să proiectați fiecare capitol ca fișier separat, atunci “include” toate într-un fișier reprezentând cartea. Când procesați asta “carte de fișiere,” rezultatul va fi ca și cum toate capitolele vor fi scrise direct în acel document.

      Marcarea este suficientă pentru majoritatea utilizatorilor

      Markdown acoperă toate bazele unei porțiuni mai mari de utilizatori. Pentru cei care caută pur și simplu un blog sau introduc câteva note într-un format de text simplu, Markdown acceptă toate elementele de care vor avea nevoie. Referințele transversale nu înseamnă prea mult pentru un utilizator care dorește doar să creeze o notă simplă sau o pagină web. Puteti chiar folosi Markdown pentru lucrari mai lungi cu layout-uri simple, cum ar fi un roman care are nevoie de scriitor? 5 Novel Writing Apps pentru Linux Cine are nevoie de Scrivener? 5 Aplicații pentru scrierea de noi versiuni pentru Linux Scrivener nu este disponibil pentru Linux - așa cum veți ține evidența locului în care se duc aceste personaje, ce au făcut și cum își încheie călătoria? Unul dintre aceste instrumente ar trebui să ajute. Citiți mai multe și combinați-le la sfârșit.

      Marcarea este mai bine susținută

      Deoarece Markdown răspunde nevoilor unui segment mai mare de utilizatori, acesta a ajuns mai bine susținut în ceea ce privește următoarele:

      • Editorii WYSIWYG (așa cum sunt definiți de cei care oferă cel puțin o previzualizare live) sunt mult mai susceptibili să sprijine Markdown.
      • Serviciile online, cum ar fi Github mai sus mentionate, au mai multe sanse de a accepta Markdown direct sau prin utilizarea de addons 6 Editori Markdown care joaca frumos cu Google Drive 6 Editori Markdown care joaca frumos cu Google Drive Markdown este formatul de editare a textului viitorului. Este mai simplu, mai ușor și mai ușor de folosit decât HTML, fără a sacrifica multă putere sau flexibilitate. Citeste mai mult .
      • Deși sistemele de publicare cum ar fi generatoare de site-uri statice 7 motive pentru a vă scufunda CMS și să ia în considerare un generator de site-ul static 7 motive pentru a vă scufunda CMS și să ia în considerare un generator de site-ul static De mulți ani, publicarea unui site web a fost dificil pentru mulți utilizatori. CMS, cum ar fi WordPress, au schimbat acest lucru, dar pot fi în continuare confuze. O altă alternativă este un generator de site-uri statice. Citește mai des suport Asciidoc cu plugin-uri, pe care le susțin Markdown din cutie este aproape dat.

      Sunteți dispus să încercați Asciidoc?

      În timp ce Markdown este o alegere de facto printre limbile de marcare ușoară, Asciidoc conține toate aceleași elemente și apoi unele. Extrasul de Asciidoc necesită ceva timp pentru a învăța, mai bine vă poate pregăti pentru proiecte mai mari și mai complexe de scriere.

      Tu ce crezi? Sunteți mulțumit de simplitatea lui Markdown? Sau vă creați propriul flux de lucru cu publicații multi-canale cu Asciidoc enticing? Poate că vă urăști un text simplu și este Cuvântul tot drumul pentru tine? Spuneți-ne în comentariile de mai jos!

      Explorați mai multe despre: Markdown, Sfaturi pentru scriere.