Letvægtsmarkeringssprog Det er derfor, du skal bruge AsciiDoc i forhold til regelmæssig markdown

  • Owen Little
  • 0
  • 3392
  • 108
Reklame

Som du sandsynligvis har set fra tidligere artikler, her på MakeUseOf er vi fans af Markdown. Ved at lære dette enkle og intuitive format er du i stand til nemt at skabe et pænt udseende. Fra PDF'er 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 letvægtsmarkeringssprog, der ligner Markdown, men med forskellige funktionssæt. En af disse er Asciidoc. Hvis du kan lide Markdown men leder efter lidt mere under hætten, er det værd at overveje. Her er nogle af grundene.

Hvad er en “Markup Language” Alligevel?

EN markup sprog 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 layout af teksten
  • Dekorer teksten

Et markup-sprog, du støder på hver dag (medmindre du er en eremit), er Hypertext Markup Language eller HTML. Webstederne og applikationerne, der bringer dig nyheder og viser dig din e-mail, er i det mindste delvist bygget med HTML-markering Lær HTML og CSS med disse trinvise tutorials Lær HTML og CSS med disse trin for trin Tutorials nysgerrig efter HTML, CSS , og JavaScript? Hvis du tror, ​​at du har en evne til at lære at oprette websteder fra bunden - her er et par gode trin-for-trin-tutorials værd at prøve. . HTML gør brug af tags som mekanisme til markering af det rå tekstindhold. Overvej for eksempel følgende HTML-uddrag:

 

Introduktion af HTML

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

Her

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

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

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

Og tags vil dekorere ordet “afsnit” med en fed skrift, mens

tags kan både lægge overskriften (mellem den og den omgivende tekst) samt definere en større skrifttype.

Problemet med nogle markup-sprog (HTML blandt dem) er, at det at skrive disse tags manuelt er en meget kedelig affære. Og med andre sprog som XML Hvad er en XML-fil, og hvordan kan du åbne og bruge den? Hvad er en XML-fil, og hvordan kan du åbne og bruge den? Du har muligvis set udtrykket "XML." Du har måske endda ved et uheld åbnet en XML-fil. Hvad er XML, og hvordan bruger du det? , mærkaterne og deres attributter udgør en større del af det samlede indhold end selve teksten! Se på det følgende DocBook-uddrag, en XML-dialekt, der bruges til at oprette mange tekniske publikationer:

Al tekst i lilla repræsenterer tags, som du selv har brug for at indtaste. Det første afsnit starter først i bunden af ​​det billede. Og hvis det ikke gøres nøjagtigt korrekt i henhold til DocBook-standarden, vil du ikke være i stand til at konvertere det til det smukke PDF-dokument, der normalt er slutmålet.

Indtast letvægtsmarkeringssprog

Hvis du ønskede at drage fordel af markeringssprog, f.eks. Ved at offentliggøre en HTML-side på internettet eller konvertere en DocBook-fil til PDF, så den kan udskrives, var du nødt til at gøre en af ​​to ting. På den ene side kunne du investere tid ved at lære disse sprog indvendigt og udvendigt, skrive dem for hånd og derefter tredobbeltkontrol dit arbejde. Eller du kan investere penge i et værktøj, der styrer kompleksiteten af ​​disse for dig.

Heldigvis kom nogle initiativrige udviklere med en tredje mulighed. De skabte nye markup-sprog, der indeholdt mange (i nogle tilfælde de fleste eller alle) af funktionerne i de tyngre kolleger, men forenklet syntaxen i høj grad. Disse “letvægt” sprog inkluderer det velkendte Markdown Hvad er Markdown? 4 grunde til, at du skal lære det nu, hvad er markdown? 4 grunde til, at du skal lære det nu Træt af HTML- og WYSIWYG-redaktører? Så er Markdown svaret for dig, uanset hvem du er. såvel som Asciidoc, Emacs Org-Mode-format og Mediawiki-syntaks.

Letvægtsmarkeringssprog har enkel syntaks

Et kendetegn ved disse sprog er, at deres “tags” (som de er) skal være intuitivt. Lad os se på det forrige uddrag, denne gang skrevet i Asciidoc:

Introduktion af Asciidoc -------------------- Hvor er * afsnit * tags? Vi har ikke brug for dem… Asciidoc er smart nok til at indse, at dette er et afsnit!

Meget mere læselig, nej? Fra toppen kan vi identificere overskriften, som den er “understreget” med bindestreger. Du kan muligvis gøre dette, hvis du skrev, bare tegne en understregning under titlen på siden i din notesbog. Der er heller ingen afsnitskoder - Asciidoc betragter noget mellem to tomme linjer, der ikke har nogen anden markering på “almindeligt” afsnitstekst. Endelig stjerne omkring ordet “afsnit” indikere fed skrift. Ræk din hånd, hvis du har gjort dette i en tekstbesked for at betyde nøjagtigt den samme ting.

Hver har en eller flere tilsvarende processorer

Det “sværvægter” markup-sprog har typisk en dedikeret applikation til at fortolke dem for dig. På nettet er det din browser såvel som muligvis webserveren, der omdanner koden til prangende websider Alt, hvad du behøver at vide om indholdsstyringssystemer Alt, hvad du har brug for at vide om indholdsstyringssystemer. For den gennemsnitlige internet-surfer, der ser indhold det er nemt. Du åbner et link, og siden vises. Men hvad foregår der bag kulisserne? Her er, hvordan dine foretrukne CMS'er tager sig af forretninger. . For dokumenter i XML kan det være noget som Microsoft Word, der læser og skriver det er DOCX-format Sådan åbnes Microsoft Word 2007 DOCX-filer Sådan åbnes Microsoft Word 2007 DOCX-filer Har du nogensinde modtaget en af ​​disse filer med .docx-udvidelsen og spekulerede på, hvad man skal gøre med det? Det kan ikke ses i ældre Word-versioner, så hvordan kan du åbne en .docx-fil… (som er en anden XML-dialekt). Så du behøver aldrig at interagere direkte med kilden til disse dokumenter, kun de smukke facader, som dine apps viser dig.

I mellemtiden er dokumenter skrevet på letvægtssprog menneskelige at læse i kildeform (en anden lejer), men kun ægte nerder synes måske, at de er smukke. For at få en smule output skal du bruge en processor. Dette er applikationer, der kører gennem din markering linje for linje og konverterer den til noget andet, der ser godt ud. De samme projekter, der udvikler selve sproget, vil typisk producere et værktøj, der følger med det. Markdown-projektet tilbyder et Perl-script med samme navn, og Asciidocs ledsagerprogram er skrevet i Python. Derudover inkluderer andre konverteringsværktøjer support til nogle af disse sprog. En sådan er den fremragende Pandoc Hvordan man nemt konverterer mellem dokumentformater i Linux Sådan nemt konverteres mellem dokumentformater i Linux Skift til Linux kan resultere i problemer med filkompatibilitet. For eksempel ser dokumenter ikke det samme ud i LibreOffice som i Word. Dette er kun en grund til, at du har brug for pandoc. , der vil tage Markdown samt letvægtsmarkeringer omstruktureret Text, Mediawiki og Org-Mode og konvertere dem til PDF, DOCX, ODT og mere.

Resultatet er, at letvægtsmarkeringssprog giver dig mulighed for at arbejde i almindelig tekst, det mest bærbare dataformat på planeten, men alligevel producere pænt udseende til sidst. Nu hvor du er overbevist om dens fordele, hvilket sprog skal du vælge? Markdown er uden tvivl den mest populære og har sine fordele (mere om disse senere). Men især Asciidoc er et værdigt alternativ. I det næste afsnit undersøger vi et par grunde til det.

Sammenligning af Markdown og Asciidoc

Asciidoc-formatet blev oprettet for at bringe DocBook, som er en af ​​de mere almindelige formater i langformet (især teknisk) skrivning, let. Et af det, der hævder at være berømt, er, at det er en en-til-en-oversættelse, hvilket betyder for hvert element i DocBook, at der er en tilsvarende repræsentation i Asciidoc. Nedenfor vil vi se på nogle af fordele og ulemper ved Asciidoc sammenlignet med Markdown.

Asciidoc dækker et Superset af skriveelementer

Markdowns mål fra starten var at være et simpelt format for webforfattere. Som sådan er de skriveelementer, den understøtter (i det mindste den oprindelige implemenation, se nedenfor) fokuseret på at automatisere de mere tidskrævende aspekter ved at skrive HTML (lister for eksempel, der kræver

    eller
      tags ud over
    • tags for hver vare).

      Asciidoc indeholder disse også, men tilbyder også mere avancerede DocBook-elementer såsom formaninger (f.eks. “Bemærk:” eller “Info:” callout-blokke) og komplekse tabellayouts. Det betyder ikke dig brug for at bruge dem hele tiden, men de vil være der og være tilgængelige, hvis du nogensinde har brug for dem.

      Asciidoc er et samlet format

      Da populariteten af ​​Markdown begyndte at begynde, begyndte nogle af dens brugere at løbe ind i nogle af de mangler, der blev omtalt ovenfor. Så disse brugere begyndte at udvikle deres egne udvidelser til at løse disse problemer, såsom muligheden for at tilføje tabeller eller fod / slutnoter. Snart var der mange “varianter” af Markdown, inklusive (blandt andre):

      • Den smag, som Github har brugt til “Vigtigt” filer med projekter, det var vært for.
      • en “udvidet” smag født ud af en PHP-port i det originale Markdown med ekstra HTML-relaterede funktioner.
      • En smag kaldet “MultiMarkdown” der implementerede mange funktioner i længerevarende skrivning, herunder citater, definitioner og krydshenvisninger.

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

      Asciidoc målretter mod en række udgivelsesformater

      Markdown er fantastisk til hurtigt at få et blogindlæg ud af dit hoved og ind på siden. Men ud af kassen er det ikke bygget til strukturering af længere værker som en bog. Asciidoc er designet til dette, og et eksempel er det “omfatte” funktioner. Disse udsagn giver dig mulighed for at medtage alt indholdet af en fil i en anden:

      inkluderer :: somefile.adoc

      Dette er ikke i modsætning til, hvordan Master Documents fungerer i tekstbehandlere. Dette giver dig f.eks. Mulighed for at udarbejde hvert kapitel som en separat fil “omfatte” dem alle i en fil, der repræsenterer bogen. Når du behandler det “bogfil,” output vil være som om alle kapitler blev skrevet direkte i det dokument.

      Markdown er nok for de fleste brugere

      Markdown dækker alle baser for en større del af brugerne. For dem, der bare ønsker at blogge eller indtaste nogle noter i et almindeligt tekstformat, understøtter Markdown alle de elementer, de har brug for. Krydshenvisninger betyder ikke meget for en bruger, der bare vil oprette en enkel memo eller webside. Du kan endda bruge Markdown til længere værker med enkle layouts, såsom en roman Who Needs Scrivener? 5 Novelle Writing-apps til Linux Hvem har brug for Scrivener? 5 Novelle Writing-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 afslutter deres rejse? Nå, et af disse værktøjer skal hjælpe. , og kombiner dem selv i slutningen.

      Markdown understøttes bedre

      Da Markdown imødekommer et større segment af brugere, understøttes det bedre med hensyn til følgende:

      • WYSIWYG-redaktører (som defineret af dem, der i det mindste giver en live preview) er meget mere tilbøjelige til at understøtte Markdown.
      • Onlinetjenester, såsom ovennævnte Github, accepterer mere sandsynligt direkte eller ved hjælp af addons 6 Markdown-redaktører, der spiller pænt med Google Drive 6 Markdown-redaktører, der spiller pænt med Google Drev Markdown er fremtidens tekstredigeringsformat. Det er enklere, slankere og lettere at bruge end HTML uden at ofre megen kraft eller fleksibilitet. .
      • Selvom publiceringssystemer som statiske stedgeneratorer 7 grunde til at grøfte din CMS og overveje en statisk stedgenerator 7 grunde til at grøfte din CMS og overveje en statisk stedgenerator I mange år var det svært 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 statisk stedgenerator. understøtter ofte Asciidoc med plugins, at de understøtter Markdown ud af boksen er næsten en given.

      Vil du prøve Asciidoc??

      Mens Markdown er noget af et de facto valg blandt letvægtsmarkeringssprog, indeholder Asciidoc alle de samme elementer og derefter nogle. Ekstraudstyret fra Asciidoc kræver lidt tid at lære, ved måske bedre forberede dig til større og mere komplekse skriveprojekter.

      Hvad synes du? Er du tilfreds med enkeltheden af ​​Markdown? Eller opretter du din egen multikanals publiceringsarbejdsgang med Asciidoc lokkende? Måske hader du almindelig tekst, og det er Word hele vejen for dig? Fortæl os det i kommentarerne herunder!




Endnu ingen kommentarer

Om moderne teknologi, enkel og overkommelig.
Din guide i en verden af moderne teknologi. Lær hvordan du bruger de teknologier og gadgets, der omgiver os hver dag, og lær, hvordan du finder interessante ting på Internettet.