Lagani jezici za označavanje To je razlog zašto biste trebali koristiti AsciiDoc tijekom redovnog ocjenjivanja

  • Mark Lucas
  • 0
  • 3838
  • 879
Oglas

Kao što ste vjerojatno vidjeli iz prošlih članaka, ovdje u MakeUseOf-u smo obožavatelji Markdown-a. Učenjem ovog jednostavnog i intuitivnog formata, lako možete stvoriti lijep izgled. Od PDF-a do web stranica, vaša skromna i obična tekstualna datoteka postaje sofisticirani dokument.

Ali Markdown nije jedina igra u gradu. Postoji niz drugih takozvanih laganih označnih jezika sličnih Markdownu, ali s različitim setovima značajki. Jedan od takvih je i Asciidoc. Ako vam se sviđa Markdown, ali tražite malo više ispod haube, vrijedi razmisliti. Evo nekoliko razloga zašto.

Što je a “Jezik za označavanje” u svakom slučaju?

označni jezik je skup kodova koji vam se, kada se primjenjuje na inače običan tekst, omogućuje dodavanje jednog ili više sljedećih svojstava (između ostalih):

  • Definirajte tekst
  • Strukturirajte tekst
  • Opišite izgled teksta
  • Ukrasite tekst

Jedan označni jezik s kojim se svakodnevno susrećete (osim ako niste pustinjak) je Hypertext Markup Language ili HTML. Web stranice i aplikacije koje vam donose vijesti i prikazuju vašu e-poštu izgrađene su, barem dijelom, s HTML oznakom. Saznajte HTML i CSS pomoću ovih korak po korak vodiča Saznajte HTML i CSS pomoću ovih korak po korak vodiča znatiželjnih o HTML, CSS , i JavaScript? Ako mislite da imate poteškoće za učenje izrade web stranica ispočetka - evo nekoliko sjajnih tutorijala koje treba isprobati. , HTML koristi oznake kao mehanizam za označavanje neobrađenog tekstualnog sadržaja. Na primjer, razmislite o sljedećem isječku HTML-a:

 

Predstavljamo HTML

Ovdje je odlomak u HTML-u ... znamo da je stav jer ga okolne \ oznake definiraju kao jedno.

Izvoli

oznaka određuje da sav tekst koji slijedi, do njegovog zatvaranja

tag, je odlomak. U tom smislu to definira tekst kao odlomak.

Ali imajte na umu i oznake ... one često služe za definiranje izgleda web stranice, primjerice koliko ima margine sa strane ekrana.

I ono oznake će ukrasiti riječ “stav” podebljanim fontom, a

Oznake mogu postavljati naslov (odmaknuti ga od okolnog teksta), kao i definirati veći font.

Problem s nekim označnim jezicima (HTML među njima) je taj što je ručno unositi ove oznake vrlo mučna stvar. I s drugim jezicima poput XML Što je XML datoteka i kako je možete otvoriti i koristiti? Što je XML datoteka i kako je možete otvoriti i koristiti? Možda ste vidjeli pojam "XML." Možda ste slučajno otvorili XML datoteku. Što je XML i kako ga koristiti? , oznake i njihovi atributi čine veći dio cjelokupnog sadržaja od samog teksta! Pogledajte sljedeći isječak DocBook, XML dijalekt koji se koristi za stvaranje mnogih tehničkih publikacija:

Sav tekst u ljubičastoj boji oznake su koje bi trebalo da unesete sami. Prvi odlomak ne započinje do samog dna slike. A ako se ne izvrši točno kako treba u skladu sa standardom DocBook, nećete ga moći pretvoriti u lijepi PDF dokument koji je obično krajnji cilj.

Unesite lagani jezik za označavanje

Ako želite iskoristiti jezike za označavanje, na primjer, tako da objavite HTML stranicu na webu ili pretvorite DocBook datoteku u PDF kako bi se mogla ispisati, morali biste napraviti jednu od dvije stvari. S jedne strane možete uložiti vrijeme tako što ćete naučiti ove jezike iznutra i izvana, pisati ih ručno, a zatim triput provjeriti svoj rad. Ili biste mogli uložiti novac u alat koji upravlja složenošću ovih za vas.

Srećom, neki poduzetni programeri smislili su treću mogućnost. Stvorili su nove jezike za označavanje koji su sadržavali mnoga (u nekim slučajevima većinu ili čitava) obilježja težih kolega, ali uvelike pojednostavili sintaksu. To “lak” jezici uključuju poznato Markdown Što je Markdown? 4 razloga zašto biste to sada trebali naučiti Što je Markdown? 4 razloga zašto biste ga trebali naučiti sada Umoriti HTML i WYSIWYG urednike? Tada je Markdown odgovor za vas bez obzira tko ste. kao i Asciidoc, Emac-ov Org-Mode format i Mediawiki sintaksa.

Lagani jezici za označavanje imaju jednostavnu sintaksu

Jedna od karakteristika ovih jezika je da su njihovi “oznake” (takvi kakvi jesu) trebali bi biti intuitivni. Pogledajmo prethodni isječak, ovaj put napisan u Asciidocu:

Predstavljamo Asciidoc -------------------- Gdje su oznake * stavka *? Ne trebaju nam ... Asciidoc je dovoljno pametan da shvati ovo je odlomak!

Mnogo čitljiviji, zar ne? Počevši od vrha, možemo prepoznati naslov kakav jest “naglasio” crticama. To možete učiniti ako ste pisali rukopisom, samo podvucite podvlačenje ispod naslova stranice u vašoj bilježnici. Također nema oznaka odlomaka - Asciidoc smatra da je bilo što između dva prazna retka na kojima nema druge oznake “običan” tekst stavka. Na kraju, zvjezdice oko riječi “stav” naznačite podebljanjem. Podignite ruku ako ste to učinili u SMS poruci da znači potpuno istu stvar.

Svaki ima jedan ili više odgovarajućih procesora

“teška kategorija” označni jezici obično imaju namjensku aplikaciju za njihovo tumačenje. Na internetu će vaš preglednik, kao i eventualno web poslužitelj, taj kod pretvoriti u blještave web stranice Sve što trebate znati o sustavima za upravljanje sadržajem Sve što trebate znati o sustavima za upravljanje sadržajem Za prosječnog internetskog surfera, gledanje sadržaja je lako. Otvorite vezu i pojavljuje se stranica. Ali što se događa iza kulisa? Evo kako vaši omiljeni CMS-ovi brinu o poslu. , Za dokumente u XML-u to bi mogao biti nešto poput Microsofta Word, koji čita i piše da je to DOCX format. Kako otvoriti datoteke Microsoft DOCX programa Microsoft Word 2007 Kako otvoriti datoteke DOCX programa Microsoft Word 2007 Jeste li ikada primili jednu od tih datoteka s .docx ekstenzijom i pitao se što učiniti s tim? Ne može se gledati u starijim verzijama Worda, pa kako možete otvoriti .docx datoteku… (što je još jedan XML dijalekt). Tako da nikada ne morate izravno komunicirati s izvorom tih dokumenata, pokazuju vam samo lijepe fasade koje vam aplikacije pokazuju.

U međuvremenu su dokumenti napisani na laganim jezicima u izvornom obliku (još jedan stanar) razumljiv ljudima, ali samo pravi štreberi mogu misliti da su lijepi. Da biste postigli lijep proizvod, trebate koristiti a procesor. To su aplikacije koje će se kretati kroz vašu označnu liniju po liniju i pretvoriti je u nešto drugo što izgleda dobro. Isti projekti koji razvijaju sam jezik obično će proizvesti uslužni program koji ide s njim. Projekt Markdown nudi istoimeni scenarij Perl, a Asciidocov prateći program napisan je na Python-u. Osim toga, drugi alati za pretvorbu uključuju podršku za neki od tih jezika. Jedan od takvih je odličan Pandoc Kako lako pretvoriti između formata dokumenata u Linuxu Kako lako pretvoriti između formata dokumenata u Linuxu Prebacivanje na Linux može rezultirati problemima s kompatibilnošću datoteka. Na primjer, dokumenti ne izgledaju isto u LibreOffice kao u Wordu. Ovo je samo jedan od razloga zašto vam je potreban pandoc. , koji će uzeti Markdown kao i lagane oznake Restrukturirani tekst, Mediawiki i Org način rada i pretvoriti ih u PDF, DOCX, ODT i još mnogo toga.

Rezultat toga je da lagani jezici označavanja omogućavaju rad u običnom tekstu, najprenosivijem formatu podataka na planeti, a na kraju ipak postižu lijep izgled. Sad kad ste uvjereni u njegove prednosti, koji jezik trebate odabrati? Markdown je nesumnjivo najpopularniji, i ima svoje prednosti (više o njima kasnije). Ali Asciidoc je posebno vrijedna alternativa. U sljedećem ćemo odjeljku istražiti nekoliko razloga zašto.

Usporedba Markdown-a i Asciidoca

Asciidoc format je stvoren kako bi donio laganu jednostavnost u DocBook, jedan od najčešćih formata u dugoročnom (posebno tehničkom) pisanju. Jedna od njegovih tvrdnji da je slava je da je to jedan-na-jedan prijevod, što znači za svaki element u DocBook-u, u Asciidocu postoji odgovarajuća reprezentacija. U nastavku ćemo pogledati neke od prednosti i nedostataka Asciidoca u usporedbi s Markdownom.

Asciidoc prekriva niz elemenata pisanja

Markdownov je cilj od početka bio biti jednostavan format za web pisce. Kao takvi, elementi za pisanje koje podržava (barem originalna implementacija, vidi dolje) usredotočeni su na automatizaciju detaljnijih aspekata pisanja HTML-a (na primjer, liste koje zahtijevaju

    ili
      oznake pored
    • oznake za svaku stavku).

      Asciidoc ih također sadrži, ali nudi i naprednije DocBook elemente poput upozorenja (npr. “Bilješka:” ili “Info:” blokovi opisa) i složeni raspored tablica. To ne znači da ste potreba da ih upotrebljavate cijelo vrijeme, ali oni će biti tu i dostupni ako ih ikada zatrebate.

      Asciidoc je jedinstveni format

      Kada je popularnost Markdown-a počela napuštati, neki su se korisnici počeli susresti s nekim gore spomenutim nedostacima. Tako su ti korisnici počeli razvijati vlastita proširenja kako bi riješili ove probleme, poput mogućnosti dodavanja tablica ili noga / završnih bilješki. Ubrzo ih je bilo mnogo “okusa” Markdown-a, uključujući (između ostalog):

      • Okus koji Github koristi za “Pročitaj me” dosjee projekata koje je domaćin.
      • “produžen” okus nastao iz PHP portala originalnog Markdown-a s dodatnim značajkama vezanim uz HTML.
      • Aroma zvana “MultiMarkdown” koji su implementirali mnoge značajke pisanja duljeg oblika, uključujući citate, definicije i unakrsne reference.

      Rezultat toga je da vaš dokument može zahtijevati elemente koji nisu svi obuhvaćeni jednim okusom. Suprotno tome, Asciidoc ne pati od iste fragmentacije koju Markdown trenutno ima.

      Asciidoc cilja na razne stilove objavljivanja

      Markdown je sjajan za brzo izvlačenje bloga iz glave i na stranicu. Ali bez okvira, nije izgrađen za strukturiranje dužih djela, poput knjige. Asciidoc je dizajniran za to, a jedan primjer je njegov “uključiti” funkcije. Ove izjave omogućuju vam da sav sadržaj jedne datoteke uključite u drugu:

      uključuju :: somefile.adoc

      To se ne razlikuje od toga kako glavni dokumenti rade u programima za obradu teksta. To vam omogućuje, primjerice, da onda svako poglavlje nacrtate kao zasebnu datoteku “uključiti” sve u jednu datoteku koja predstavlja knjigu. Kad to obradite “datoteku knjige,” izlaz će biti kao da su sva poglavlja napisana izravno u tom dokumentu.

      Markdown je dovoljan većini korisnika

      Markdown pokriva sve baze za veći dio korisnika. Za one koji jednostavno traže blog ili upisuju neke bilješke u običan tekstualni format, Markdown podržava sve potrebne elemente. Unakrsne reference ne znače puno za korisnika koji samo želi stvoriti jednostavan podsjetnik ili web stranicu. Možete čak koristiti Markdown za dulja djela s jednostavnim izgledima, poput romana Tko treba Scrivenera? 5 romansi za pisanje aplikacija za Linux kome treba pretplatnik? 5 novih knjiga za pisanje aplikacija za Linux Scrivener nisu dostupne za Linux - pa kako ćete pratiti kuda ti likovi idu, što su napravili i kako završavaju svoje putovanje? Pa, jedan od tih alata trebao bi pomoći. , i na kraju ih sami kombinirajte.

      Markdown je bolji

      Budući da Markdown zadovoljava potrebe većeg segmenta korisnika, na kraju je bolje podržan u pogledu sljedećeg:

      • WYSIWYG uređivači (kako ih definiraju oni koji barem omogućuju pregled uživo) vjerojatnije će podržati Markdown.
      • Internetske usluge, poput gore spomenutog Githuba, vjerojatnije će prihvatiti Markdown izravno ili korištenjem dodataka 6 Markdown Editor koji se lijepo slažu s Google diskom 6 Markdown urednici koji se lijepo igraju na Google disku Markdown je format za uređivanje teksta budućnosti. Jednostavniji je, elegantniji i lakši za upotrebu od HTML-a bez žrtvovanja velike snage ili fleksibilnosti. .
      • Iako su izdavački sustavi poput generatora statičkih web stranica 7 razloga za istrebljenje vašeg CMS-a i razmotriti statički generator web stranica 7 razloga za istrebljenje vašeg CMS-a i razmotrivanje statičkog generatora web stranica Mnogo godina je objavljivanje web stranica bilo teško za mnoge korisnike. CMS-ovi poput WordPressa to su promijenili, ali još uvijek mogu biti zbunjujuće. Druga alternativa je statički generator. često podržavaju Asciidoc dodacima, a oni podržavaju Markdown izvan okvira.

      Želite li pokušati Asciidocu?

      Iako je Markdown stvar faktografskog izbora među laganim označnim jezicima, Asciidoc sadrži sve iste elemente, a zatim i neke. Dodaci Asciidocu zahtijevaju malo vremena za učenje, što će vas možda bolje pripremiti za veće i složenije pisanje projekata.

      Što misliš? Jeste li zadovoljni jednostavnošću Markdown-a? Ili stvara svoj vlastiti višekanalni tijek objavljivanja uz Asciidoc mami? Možda mrzite običan tekst i cijela je riječ za vas? Javite nam u komentarima u nastavku!




Još ne komentari

O modernoj tehnologiji, jednostavnoj i pristupačnoj.
Vaš vodič u svijetu moderne tehnologije. Naučite kako koristiti tehnologije i uređaje koji nas okružuju svaki dan i naučite kako otkriti zanimljivosti na Internetu.