Lightweight Markup Languages ​​Dette er hvorfor du bør bruke AsciiDoc over vanlig Markdown

Lightweight Markup Languages ​​Dette er hvorfor du bør bruke AsciiDoc over vanlig Markdown / Teknologi forklart

Som du sikkert har sett fra tidligere artikler, her på MakeUseOf, er vi fans av Markdown. Ved å lære dette enkle og intuitive formatet, kan du enkelt lage flotte utskrifter. Fra PDF-er til nettsider blir din ydmyke, vanlige tekstfil et sofistikert dokument.

Men Markdown er ikke det eneste spillet i byen. Det finnes en rekke andre såkalte lette oppslagsspråk som ligner på Markdown, men med forskjellige funksjonssett. En av disse er Asciidoc. Hvis du liker Markdown, men leter etter litt mer under hetten, er det verdt å vurdere. Her er noen grunner til hvorfor.

Hva er en “Markup Language” Uansett?

EN opptakspråk er et sett med koder som, når de brukes på ellers ren tekst, lar deg legge til en eller flere av følgende egenskaper (blant andre):

  • Definer teksten
  • Struktur teksten
  • Beskriv oppsettet av teksten
  • Dekorer teksten

Et opptakspråk du møter hver dag (med mindre du er en eremitt) er Hypertext Markup Language, eller HTML. Nettstedene og programmene som gir deg nyheter og viser deg din e-post er bygget, i hvert fall delvis, med HTML-markering. Lær HTML og CSS med disse trinnvise opplæringsprogrammene. Lær HTML og CSS med disse trinnvise opplæringsprogrammene. Nysgjerrig om HTML, CSS , og JavaScript? Hvis du tror at du har mulighet til å lære å lage nettsteder fra bunnen av - her er noen gode trinnvise opplæringsprogrammer verdt å prøve. Les mer . HTML benytter seg av tags som mekanisme for å markere rå tekstinnhold. For eksempel, vurder følgende utdrag av HTML:

 

Vi presenterer HTML

Her er et avsnitt i HTML ... vi vet at det er en avsnitt fordi de omkringliggende \ koder definerer den som en.

Her, den

tag spesifiserer at all teksten som skal følges, frem til dens avslutning

tag, er et avsnitt. I denne forstand er det definerer teksten som et avsnitt.

Men vær også oppmerksom på koder ... disse tjener ofte til å definere utformingen av en nettside, for eksempel hvor mye margin det er fra siden av skjermen.

Og Tagger vil dekorere ordet “avsnitt” i fet skrift, mens

Etiketter kan både legge ut overskriften (avstand fra omgivende tekst), samt definere en større skrift.

Problemet med noen oppslagsspråk (HTML blant dem) er at det å skrive disse taggene manuelt er en veldig kjedelig affære. Og med andre språk som XML Hva er en XML-fil og hva er dens bruk? [I tilfelle du lurte på] Hva er en XML-fil og hva er dens bruk? [I tilfelle du lurte på] Les mer, merkene og deres attributter utgjør en større del av innholdet enn selve teksten! Ta en titt på følgende DocBook-utdrag, en XML-dialekt som brukes til å lage mange tekniske publikasjoner:

All teksten i lilla representerer koder som du må skrive inn selv. Første ledd starter ikke helt til bunnen av bildet. Og hvis det ikke er gjort akkurat i henhold til DocBook-standarden, kan du ikke konvertere det til det vakre PDF-dokumentet som vanligvis er sluttmålet.

Skriv inn lette merkingsspråket

Hvis du vil dra nytte av opptakspråk, for eksempel ved å publisere en HTML-side på nettet eller konvertere en DocBook-fil til PDF slik at den kan skrives ut, trengte du å gjøre en av to ting. På den ene siden kan du investere tid ved å lære disse språkene innvendig og utvendig, skrive dem for hånd, og trippel-sjekke arbeidet ditt. Eller du kan investere penger i et verktøy som styrer kompleksiteten til disse for deg.

Heldigvis kom noen initiativrike utviklere opp med et tredje alternativ. De opprettet nye oppslagsspråk som inneholdt mange (i noen tilfeller mest eller alle) funksjonene til de tyngre motsvarene, men forenklet syntaxen sterkt. Disse “lettvekt” språk inkluderer den kjente Markdown Hva er Markdown? 4 grunner til at du bør lære det nå Hva er Markdown? 4 grunner til at du bør lære det nå Lei av HTML og WYSIWYG redaktører? Så Markdown er svaret for deg, uansett hvem du er. Les mer så vel som Asciidoc, Emacs Org-Mode-format og Mediawiki-syntaksen.

Lette markup-språk har enkel syntaks

Et kjennemerke for disse språkene er at deres “tags” (som de er) burde være intuitive. La oss ta en titt på forrige kutt, denne gangen skrevet i Asciidoc:

Introduksjon av Asciidoc -------------------- Hvor er * avsnittet * tagger? Vi trenger dem ikke ... Asciidoc er smart nok til å innse at dette er et avsnitt!

Mye mer lesbar, nei? Fra toppen kan vi identifisere overskriften som det er “understreket” med bindestreker. Du kan gjøre dette hvis du var håndskrift, bare tegne en understreke under tittelen på siden i notisboken. Det finnes også ingen avsnittetiketter - Asciidoc vurderer alt mellom to tomme linjer som ikke har noen annen merking på det “vanlig” avsnitt tekst. Endelig asteriskene rundt ordet “avsnitt” angi fet skrift. Løft hånden din hvis du har gjort dette i en tekstmelding for å bety nøyaktig samme ting.

Hver har en eller flere korresponderende prosessorer

De “tungvekt” markup språk har vanligvis en dedikert applikasjon for å tolke dem for deg. På nettet er det nettleseren din og muligens den webserveren som vil slå koden inn på prangende nettsider Alt du trenger å vite om Content Management Systems Alt du trenger å vite om Content Management Systems For den gjennomsnittlige Internett-surferen, ser du innhold det er lett. Du åpner en kobling, og siden vises. Men hva foregår bak kulissene? Slik ser dine favoritt CMSer seg om virksomheten. Les mer . For dokumenter i XML kan det være noe som Microsoft Word, som leser og skriver det er DOCX-format Slik åpner du Microsoft Word 2007 DOCX-filer Slik åpner du Microsoft Word 2007 DOCX-filer Har du noen gang mottatt en av disse filene med .docx-utvidelsen og lurte på hva jeg skal gjøre med det? Det kan ikke ses i eldre Word-versjoner, så hvordan kan du åpne en. Docx-fil ... Les mer (som er en annen XML-dialekt). Så du trenger aldri å samhandle direkte med kilden til disse dokumentene, bare de vakre fasadene dine viser deg.

I mellomtiden er dokumenter skrevet på lettvektspråk menneskelige lesbare i kildeform (en annen leietaker), men bare sanne nørder tror kanskje de er vakre. For å få fin utgang, må du bruke en prosessor. Dette er applikasjoner som vil løpe gjennom linjelinjen din for linje og konvertere den til noe annet som ser bra ut. De samme prosjektene som utvikler språket i seg selv, vil typisk produsere et verktøy for å gå med det. Markdown-prosjektet tilbyr et Perl-skript med samme navn, og Asciidocs følgesvennprogram er skrevet i Python. I tillegg vil andre konverteringsverktøy inneholde støtte for noen av disse språkene. En slik er den utmerkede Pandoc Slik konverterer du enkelt mellom dokumentformater på Linux Slik kan du enkelt konvertere mellom dokumentformater i Linux Bytte til Linux kan føre til problemer med filkompatibilitet. For eksempel ser dokumentene ikke det samme ut i LibreOffice som de gjør i Word. Dette er bare en grunn til at du trenger pandoc. Les mer, som vil ta Markdown samt lette markeringer reStructured Text, Mediawiki og Org-Mode og konvertere dem til PDF, DOCX, ODT og mer..

Resultatet er at lette oppslagsspråk gir deg mulighet til å jobbe i ren tekst, det mest bærbare dataformatet på planeten, men fremdeles fremdeles gi flotte utganger til slutt. Nå som du er overbevist om sine fordeler, hvilket språk bør du velge? Markdown er utvilsomt den mest populære, og har sine fordeler (mer på disse senere). Men spesielt Asciidoc er et verdig alternativ. I neste avsnitt vil vi utforske et par grunner til hvorfor.

Sammenligning av Markdown og Asciidoc

Asciidoc-formatet ble opprettet for å få lett enkelhet til DocBook, en av de vanligste formatene i langformet (spesielt teknisk) skriving. En av sine krav til berømmelse er at det er en en-til-en-oversettelse, som betyr for hvert element i DocBook, det er en tilsvarende representasjon i Asciidoc. Nedenfor tar vi en titt på noen av fordeler og ulemper ved Asciidoc sammenlignet med Markdown.

Asciidoc dekker et overskudd av skriveelementer

Markdowns mål fra begynnelsen var å være et enkelt format for webforfattere. Som sådan er de skriveelementene som støttes (minst den opprinnelige implementeringen, se nedenfor) fokusert på å automatisere de mer tidskrevende aspektene ved å skrive HTML (for eksempel lister, som krever at

    eller
      merker i tillegg til
    • koder for hvert element).

      Asciidoc inneholder også disse, men tilbyr også mer avanserte DocBook-elementer som admonisjoner (f.eks. “Merk:” eller “info:” callout blokker) og komplekse tabelloppsett. Det betyr ikke deg trenge å bruke dem hele tiden, men de vil være der og tilgjengelig hvis du noen gang trenger dem.

      Asciidoc er et enhetlig format

      Når populariteten til Markdown begynte å ta av, begynte noen av brukerne å løpe inn i noen av de manglene som ble diskutert ovenfor. Så disse brukerne begynte å utvikle sine egne utvidelser for å løse disse problemene, for eksempel muligheten til å legge til tabeller eller fot / slutnoter. Snart var det mange “smaker” av Markdown, inkludert (blant andre):

      • Smaken brukt av Github for “readme” filer av prosjekter det var vertskap for.
      • en “forlenget” smaken født ut av en PHP-port i den opprinnelige Markdown med ekstra HTML-relaterte funksjoner.
      • En smak som heter “MultiMarkdown” som implementerte mange funksjoner ved lengre formskriving, inkludert sitater, definisjoner og kryssreferanser.

      Resultatet er at dokumentet ditt kan kreve elementer som ikke alle dekkes av en enkelt smak. I motsetning henger Asciidoc ikke av den samme fragmenteringen som Markdown gjør for øyeblikket.

      Asciidoc målretter en rekke Publishing Styles

      Markdown er flott for raskt å få et blogginnlegg ut av hodet og på siden. Men ut av esken er det ikke bygget for å strukturere lengre arbeider, som en bok. Asciidoc er designet for dette, og et eksempel er det “inkludere” funksjoner. Disse utsagnene lar deg inkludere alt innholdet i en fil i en annen:

      inkluderer :: somefile.adoc

      Dette er ikke ulikt hvordan hoveddokumenter fungerer i tekstbehandlere. Dette lar deg for eksempel utarbeide hvert kapittel som en egen fil, da “inkludere” dem alle i en fil som representerer boken. Når du behandler det “bokfil,” Utgangen vil være som om alle kapitlene ble skrevet direkte inn i dokumentet.

      Markdown er nok for de fleste brukere

      Markdown dekker alle basene for en større del av brukerne. For de som bare ser på blogger, eller skriver inn noen notater i et vanlig tekstformat, støtter Markdown alle elementene de trenger. Kryssreferanser betyr ikke mye for en bruker som bare ønsker å lage et enkelt notat eller en nettside. Du kan til og med bruke Markdown til lengre arbeid med enkle layouter, for eksempel en roman Who Needs Scrivener? 5 Novel Skriveprogrammer for Linux Hvem trenger Scrivener? 5 Novel Skriveprogrammer for Linux Scrivener er ikke tilgjengelig for Linux - så hvordan vil du holde styr på hvor disse tegnene går, hva de har gjort, og hvordan de fullfører reisen deres? Vel, ett av disse verktøyene bør hjelpe. Les mer, og kombinere dem selv på slutten.

      Markdown er bedre støttet

      Siden Markdown oppfyller behovene til et større segment av brukere, har det endt bedre støttet i forhold til følgende:

      • WYSIWYG redaktører (som definert av de som minst gir et live forhåndsvisning) er mye mer sannsynlig å støtte Markdown.
      • Online-tjenester, som for eksempel nevnte Github, er mer sannsynlig å akseptere Markdown direkte eller ved bruk av addons 6 Markdown Editors som spiller hyggelig med Google Drive 6 Markdown-redaktører som spiller bra med Google Drive Markdown er fremtidens tekstredigeringsformat. Det er enklere, slankere og enklere å bruke enn HTML uten å ofre mye strøm eller fleksibilitet. Les mer .
      • Selv om publiseringssystemer som statiske nettstedgeneratorer 7 grunner til å ditch ditt CMS og vurdere en Static Site Generator 7 grunner til å ditch ditt CMS og vurdere en Static Site Generator I mange år var det vanskelig for mange brukere å publisere et nettsted. CMS som WordPress endret det, men de kan fortsatt være forvirrende. Et annet alternativ er en statisk nettstedgenerator. Les Oftere støtte Asciidoc med plugins, at de støtter Markdown ut av boksen er nesten en gitt.

      Er du villig til å gi Asciidoc et forsøk?

      Mens Markdown er noe av et de facto valg blant lette oppslagsspråk, inneholder Asciidoc alle de samme elementene og deretter noen. Extras av Asciidoc krever litt tid å lære, kanskje bedre forberede deg på større og mer komplekse skriveprosjekter.

      Hva tror du? Er du fornøyd med Markdowns enkelhet? Eller lager du din egen flerkanals publiserings arbeidsflyt med Asciidoc fristende? Kanskje du hater vanlig tekst, og det er Word helt for deg? Gi oss beskjed i kommentarene nedenfor!

      Utforsk mer om: Markdown, skrivetips.