Lightweight Markup Languages: Dette er hvorfor du skal bruge AsciiDoc over Regular Markdown

Markdown-sprog kommer i mange smag, hvoraf nogle er bedre end andre. Letvægtssprog som AsciiDoc er nemme at lære og yderst nyttige. Sådan sammenligner du det.

Markdown-sprog kommer i mange smag, hvoraf nogle er bedre end andre.  Letvægtssprog som AsciiDoc er nemme at lære og yderst nyttige.  Sådan sammenligner du det.
Reklame

Som du sandsynligvis har set fra tidligere artikler, her på MakeUseOf er vi fans af Markdown What Is Markdown? 4 grunde til, at du bør lære det nu Hvad er Markdown? 4 grunde til, at du bør lære det nu Træt af HTML og WYSIWYG redaktører? Så Markdown er svaret for dig, uanset hvem du er. Læs mere . Ved at lære dette enkle og intuitive format, kan du nemt skabe flotte udgaver. Fra PDF til websider bliver din ydmyge, almindelige tekstfil et sofistikeret dokument.

Men Markdown er ikke det eneste spil i byen. Der er en række andre såkaldte lette markup-sprog, der ligner Markdown, men med forskellige funktionssæt. En af disse er Asciidoc. Hvis du kan lide Markdown, men søger lidt mere under emhætten, er det værd at overveje. Her er nogle grunde til.

Hvad er et "Markup Language" Anyway?

Et markeringssprog er et sæt koder, der, når de anvendes på ellers almindelig tekst, giver dig mulighed for at tilføje en eller flere af følgende egenskaber (blandt andre):

  • Definer teksten
  • Struktur teksten
  • Beskriv tekstenes layout
  • Dekorer teksten

Et markupsprog, du møder hver dag (medmindre du er en eremit) er Hypertext Markup Language eller HTML. De websteder og applikationer, der bringer dig nyheder og viser dig din e-mail, er bygget, i det mindste delvist med HTML-markup Lær HTML og CSS med disse trin for trin-øvelser Lær HTML og CSS med disse trin for trin-øvelser Nysgerrige om HTML, CSS, og JavaScript? Hvis du tror at du har en evne til at lære at lave hjemmesider lige fra bunden - her er et par gode trinvise vejledninger værd at prøve. Læs mere . HTML gør brug af tags som mekanisme til markering af rå tekstindhold. For eksempel overvej følgende uddrag af HTML:

Introduktion til HTML

Her er et afsnit i HTML ... vi ved, at det er et afsnit, fordi de omgivende \ tags definerer det som en.

Her, den

tag angiver, at al den tekst, der skal følges op til dens lukning

tag, er et afsnit. I den forstand definerer den teksten som et afsnit.

Men bemærk også taggerne ... Disse tjener ofte til at definere layoutet på en webside, f.eks. Hvor meget margen der er fra siden af ​​skærmen.

Og tagsne vil dekorere ordet "afsnit" med en fed skrift, mens

tags kan både lægge overskriften (afstand det fra omgivende tekst) samt definere en større skrifttype.

Problemet med nogle markup-sprog (HTML blandt dem) er, at at skrive disse tags manuelt er en meget kedelig affære. Og med andre sprog som XML Hvad er en XML-fil, og hvad er dens anvendelser? [I tilfælde af at du undrede] Hvad er en XML-fil, og hvad er dens anvendelser? [I tilfælde af at du undrede] Læs mere, tegnerne og deres attributter udgør en større del af det samlede indhold end selve teksten! Se det følgende DocBook-stykke, en XML-dialekt, der bruges til at oprette mange tekniske publikationer:

asciidoc markdown docbook tags

Al teksten i lilla repræsenterer tags, som du selv skal indtaste. Første afsnit starter ikke helt til bunden af ​​billedet. Og hvis det ikke er gjort helt korrekt i henhold til DocBook-standarden, kan du ikke konvertere det til det smukke PDF-dokument, som normalt er slutmålet.

Indtast lette markupsprog

Hvis du vil udnytte markeringssprog, f.eks. Ved at udgive en HTML-side til internettet eller konvertere en DocBook-fil til PDF, så den kan udskrives, skal du gøre en af ​​to ting. På den ene side kan du investere tid ved at lære disse sprog ind og ud, skrive dem manuelt og derefter tredobbelt kontrollere dit arbejde. Eller du kan investere penge i et værktøj, der styrer kompleksiteten af ​​disse til dig.

Heldigvis kom nogle underholdende udviklere op med en tredje mulighed. De har oprettet nye markupsprog, der indeholdt mange (i nogle tilfælde mest eller alle) funktionerne i de tungere modparter, men forenklet syntaxen meget. Disse "lette" sprog omfatter den velkendte Markdown What Is Markdown? 4 grunde til, at du bør lære det nu Hvad er Markdown? 4 grunde til, at du bør lære det nu Træt af HTML og WYSIWYG redaktører? Så Markdown er svaret for dig, uanset hvem du er. Læs mere samt Asciidoc, Emacs Org-Mode-format og Mediawiki-syntaksen.

Letvægtsmærkningssprog har enkel syntaks

Et kendetegn ved disse sprog er, at deres "tags" (som de er) burde være intuitive. Lad os tage et kig på det forrige stykke, denne gang skrevet i Asciidoc:

 Introducing Asciidoc -------------------- Where are the *paragraph* tags? We dont need them... Asciidoc is smart enough to realize this is a paragraph! 

Meget mere læselig, nej? Fra toppen kan vi identificere overskriften, da den er "understreget" med bindestreger. Du kan gøre dette, hvis du var håndskrift, skal du bare tegne en understreget under titlen på siden i din notesbog. Der er heller ingen afsnit tags - Asciidoc betragter alt mellem to tomme linjer, der ikke har nogen anden markering på det for at være "almindelig" afsnit tekst. Endelig indikerer asteriskerne omkring ordet "stykke" bolding. Hæv din hånd, hvis du har gjort det i en tekstbesked for at betyde det nøjagtigt samme.

Hver har en eller flere tilsvarende processorer

De "heavyweight" markup sprog har typisk en dedikeret applikation til at fortolke dem for dig. På internettet er det din browser såvel som muligvis den webserver, der vil vende koden til prangende websider Alt du behøver at vide om Content Management Systems Alt du behøver at vide om Content Management Systems For den gennemsnitlige internet surfer, ser indholdet det er nemt. Du åbner et link, og siden vises. Men hvad foregår bag kulisserne? Her er hvordan dine yndlings CMS'er tager sig af forretninger. Læs mere . For dokumenter i XML kan det være noget som Microsoft Word, som læser og skriver det DOCX-format Sådan åbner du Microsoft Word 2007 DOCX-filer Sådan åbner du Microsoft Word 2007 DOCX-filer Har du nogensinde modtaget en af ​​disse filer med .docx-udvidelsen og undrede sig over hvad man skal gøre med det? Det kan ikke ses i ældre Word-versioner, så hvordan kan du åbne en. Docx-fil ... Læs mere (hvilket er et andet XML-dialekt). Så du behøver aldrig at interagere direkte med kilden til disse dokumenter, kun de smukke facader, dine apps viser dig.

I mellemtiden er dokumenter skrevet på letvægtssprog menneskeligt læsbare i kildeform (en anden lejer), men kun sande nørder tror måske, at de er smukke. For at få ret output, skal du bruge en processor . Disse er applikationer, der løber gennem din markup linje for linje og konvertere det til noget andet, der ser godt ud. De samme projekter, der udvikler sproget i sig selv, vil typisk producere et værktøj til at gå med det. Markdown-projektet tilbyder et Perl-script med samme navn, og Asciidocs ledsagerprogram er skrevet i Python. Derudover vil andre konverteringsværktøjer omfatte støtte til nogle af disse sprog. En sådan er den fremragende Pandoc Sådan konverteres nemt mellem dokumentformater i Linux Sådan kan du nemt konvertere mellem dokumentformater i Linux Skifte til Linux kan resultere i problemer med filkompatibilitet. For eksempel ser dokumenter ikke det samme ud i LibreOffice som de gør i Word. Dette er kun en grund til, at du har brug for pandoc. Læs mere, som vil tage Markdown samt lette markeringer reStructured Text, Mediawiki og Org-Mode og konvertere dem til PDF, DOCX, ODT og meget mere.

asciidoc markdown pandoc formater

Resultatet er, at lette markup-sprog giver dig mulighed for at arbejde i almindelig tekst, det mest bærbare dataformat på planeten, men producerer stadig en flot udgang i slutningen. Nu hvor du er overbevist om sine fordele, hvilket sprog skal du vælge? Markdown er utvivlsomt den mest populære, og har sine fordele (mere på disse senere). Men især Asciidoc er et værdifuldt alternativ. I næste afsnit vil vi undersøge nogle af årsagerne til hvorfor.

Sammenligning af Markdown og Asciidoc

Asciidoc-formatet blev oprettet for at give letvægts enkelhed til DocBook, en af ​​de mere almindelige formater i langformet (specielt teknisk) skrivning. En af sine krav til berømmelse er, at det er en en-til-en oversættelse, hvilket betyder for hvert element i DocBook, der er en tilsvarende repræsentation i Asciidoc. Nedenfor tager vi et kig på nogle af fordele og ulemper ved Asciidoc sammenlignet med Markdown.

Asciidoc dækker et overskud af skriveelementer

Markdowns mål fra starten var at være et simpelt format til webforfattere. Som sådan understøtter de skriveelementer, den understøtter (i det mindste den oprindelige implementering, se nedenfor), at fokusere på automatisering af de mere tidskrevende aspekter ved at skrive HTML (lister for eksempel, som kræver

    eller
      tags i tillæg til
    • tags for hvert element).

      asciidoc markdown komplekse formater

      Asciidoc indeholder også disse, men tilbyder også mere avancerede DocBook elementer som f.eks. Admonitions (f.eks. "Note:" eller "Info:" callout-blokke) og komplekse bordlayouter. Det betyder ikke, at du skal bruge dem hele tiden, men de vil være der og tilgængelige, hvis du nogensinde har brug for dem.

      Asciidoc er et samlet format

      Da populariteten af ​​Markdown begyndte at starte, begyndte nogle af sine brugere at løbe ind i nogle af de mangler, der blev diskuteret ovenfor. Så disse brugere begyndte at udvikle deres egne udvidelser til at løse disse problemer, såsom evnen til at tilføje tabeller eller fod / slutnoter. Snart var der mange "smagsoplevelser" af Markdown, herunder (blandt andre):

      • Den smag, som Github anvendte til "Readme" -filerne af projekter, som den hostede.
      • En "udvidet" smag født ud af en PHP-port i den oprindelige Markdown med ekstra HTML-relaterede funktioner.
      • En smag kaldet "MultiMarkdown", der implementerede mange funktioner i længereformet skrivning, herunder citater, definitioner og krydshenvisninger.

      Resultatet er, at dit dokument muligvis kræver elementer, som ikke alle er dækket af en enkelt smag. I modsætning hertil lider Asciidoc ikke af den samme fragmentering, som Markdown gør i øjeblikket.

      Asciidoc målretter en række udgivelsesstile

      Markdown er fantastisk til hurtigt at få et blogindlæg ud af dit hoved og på siden. Men ud af kassen er den ikke bygget til strukturering af længere arbejde, som en bog. Asciidoc er designet til dette, og et eksempel er dets "inkludere" funktioner. Disse udsagn giver dig mulighed for at inkludere alt indholdet af en fil i en anden:

       include::somefile.adoc 

      Dette er ikke i modsætning til, hvordan Master Dokumenter arbejder i tekstbehandlere. Dette giver dig mulighed for f.eks. At udarbejde hvert kapitel som en separat fil, og derefter "inkludere" dem alle sammen i en fil, der repræsenterer bogen. Når du behandler den "bogfil", vil output blive som om alle kapitlerne blev skrevet direkte ind i det pågældende dokument.

      Markdown er nok for de fleste brugere

      Markdown dækker alle baserne for en større del af brugerne. For dem, der blot søger blog, eller skriver nogle noter i et almindeligt tekstformat, understøtter Markdown alle de elementer, de skal bruge. Krydsreferencer betyder ikke meget for en bruger, der bare ønsker at oprette et simpelt memo eller en webside. Du kan endda bruge Markdown til længere arbejde med enkle layouter, som f.eks. En roman Who needs Scrivener? 5 Novel Skrive Apps til Linux Hvem har brug for Scrivener? 5 Novel Skrive Apps til Linux Scrivener er ikke tilgængelig for Linux - så hvordan vil du holde styr på, hvor disse tegn går, hvad de har gjort, og hvordan de gennemfører deres rejse? Nå, et af disse værktøjer skal hjælpe. Læs mere, og kombiner dem selv i slutningen.

      Markdown er bedre understøttet

      Da Markdown opfylder behovene hos et større segment af brugere, blev det bedre støttet med hensyn til følgende:

      • WYSIWYG redaktører (som defineret af dem, der i det mindste giver et live preview), er meget mere tilbøjelige til at understøtte Markdown.
      • Online-tjenester som den førnævnte Github er mere tilbøjelige til at acceptere Markdown direkte eller ved brug af addons 6 Markdown Editors, der spiller godt med Google Drive 6 Markdown Editors, der spiller godt med Google Drive Markdown er fremtidens tekstredigeringsformat. Det er enklere, slankere og lettere at bruge end HTML uden at ofre meget strøm eller fleksibilitet. Læs mere .
      • Selvom udgivelsessystemer som statiske site generatorer 7 grunde til at ditch dit cms og overveje en statisk site generator 7 grunde til at ditch dit cms og overveje en statisk site generator i mange år var det vanskeligt for mange brugere at offentliggøre et websted. CMS'er som WordPress ændrede det, men de kan stadig være forvirrende. Et andet alternativ er en Static Site Generator. Læs Oftere support Asciidoc med plugins, at de understøtter Markdown ud af boksen er næsten en given.

      Er du villig til at give Asciidoc et forsøg?

      Mens Markdown er noget af et de facto valg blandt lette markup-sprog, indeholder Asciidoc alle de samme elementer og derefter nogle. Ekstraerne af Asciidoc kræver noget tid at lære, måske bedre forberede dig på større og mere komplekse skriveprojekter.

      Hvad synes du? Er du tilfreds med Markdowns enkelhed? Eller skaber du din egen flerkanalspublishing-arbejdsgang med Asciidoc lokkende? Måske hader du almindelig tekst, og det er Word hele vejen for dig? Lad os vide i kommentarerne nedenfor!

In this article