Nastavitev predpogojev:
Da bi videli, kako deluje gnezdenje seznama, potrebujemo orodje ali programsko opremo, kjer lahko implementiramo skript za označevanje. Ugotovili smo, da je Visual Studio Code najboljši sestavljalnik za skripte za označevanje. Za implementacijo označevalnega jezika moramo narediti nekaj sprememb v skladu z zahtevami naše naloge. Zagnali smo kodo VS in ustvarili novo projektno datoteko. Privzeto odpre preprosto besedilno datoteko, vendar moramo delati na markdownu, zato bomo spremenili vrsto datoteke. Možnost »Navadno besedilo« je na voljo v desnem kotu vrstice stanja in se uporablja za spreminjanje vrste datoteke. Ko postavite kazalec nanj, vas vpraša za izbiro jezikovnega načina.
Ko ga pritisnete, se prikaže meni. Za izbiro jezika označevanja morate samo napisati »Markdown«.
To bo spremenilo našo vrsto datoteke iz »Plain Text« v »Markdown«.
Na prejšnjem posnetku lahko vidite, da je vrsta datoteke zdaj »Markdown«.
Po tem moramo dodati razširitev za predogled skriptov za označevanje in njihovo pravilno delovanje. Če želite dodati to razširitev iz leve orodne vrstice, vam bo možnost nastavitev ponudila izbirno polje, kjer smo izbrali možnost »Razširitev«.
To bo odprlo okno. Ime razširitve moramo napisati kot »Markdown All in One« in jo namestiti.
Zdaj je razširitev markdown uspešno dodana v našo datoteko.
Zadnja stvar, ki jo moramo storiti, je, da odpremo okno za predogled in si ogledamo rezultate naših ustvarjenih skriptov. Okno za predogled lahko odprete s klikom na tipki »Ctrl+Shift+V« ali pa kliknete ikono s tipko v zgornjem desnem kotu orodja.
S klikom nanj se okno razdeli na dva zaslona. Prvi bo uporabljen za vnos skriptov, medtem ko bo rezultat skripta prikazan v oknu »Predogled«.
Zdaj lahko to orodje uporabimo za začetek dela na skriptih za označevanje. Raziščimo zdaj skripte.
Ubežanje povratnim kljukicam v Markdown:
V Markdown se povratne oznake uporabljajo za ustvarjanje kodnih blokov. Ko vstavimo povratno kljukico, se to nanaša na začetek delčka kode v Markdownu. Na začetku in koncu vsake vrstice kode je dodan en povratni znak, da se ustvarijo vgrajeni bloki kode v dokumentih. Zaradi teh povratnih oznak postane povratne kljukice težko prikazati kot besedilo v dokumentu, ne da bi omogočili ustvarjanje bloka kode. V tej vadnici bomo delali na tem, kako se lahko izognemo povratni kljukici, da jo lahko vključimo kot besedilo, namesto da bi jo obravnavali kot začetek sintakse kode.
Najenostavnejši način preskoka povratne kljukice je, da dodate poševnico nazaj (\), preden vstavite povratno kljukico. Če ne dodate poševnice nazaj, bosta vstavljena povratna kljukica, ki bi jo dodali kot besedilo, in naslednja povratna kljukica v kodi. Ne glede na besedilo, ki bi ga dodali mednje, se bo štelo za blok kode, zato da se temu izognete, vstavite poševnico nazaj. Najprej bomo dodali povratne kljukice, da ustvarimo blok kode, nato pa se bomo v tej predstavitvi naučili ubežati povratni kljukici pri označevanju.
Najprej smo ustvarili glavo za naš dokument. Za generiranje glave prve ravni moramo vstaviti en sam simbol (#), dodati presledek in nato omeniti besedilo za glavo. Besedilo smo zagotovili kot »Markdown Backtick«. Zdaj, da bi ustvarili blok kode, smo najprej dodali povratno kljukico (`) in za njo dali presledek. Nato smo besedilo napisali kot »Vzorčno besedilo«, ki mu je sledil presledek, kjer je uporabljena zaključna kljukica. Zdaj bosta ti dve povratni kljukici obravnavali besedilo med njima kot delček kode in ga tako upodobili kot blok kode.
Tako dobimo glavo »Markdown Backtick« in besedilo, ki smo ga omenili zgoraj, v formatu bloka kode. Pričakovani rezultat si lahko ogledate v posnetku okna predogleda, ki smo ga posredovali spodaj:
Zdaj, da se izognemo tej povratni kljukici in upodabljamo besedilo kot navadno besedilo in ne kot blok kode, moramo uporabiti poševnico nazaj (\) pred začetnim povratnim kljukico in tudi pred končno povratno kljukico. Torej bi naredili ta trik na zgornjem bloku kode, da bi ga upodobili kot običajno besedilo z dodajanjem poševnic nazaj.
Ustvarili smo glavo z besedilom »Markdown Escaping a Backtick«. Po preskoku vrstice smo dodali poševnico nazaj, ki ji je sledila povratna kljukica. Podan je prostor in nato je besedilo določeno kot »Vzorčno besedilo«. Preden smo dodali zaključno kljukico, smo vstavili še eno poševnico nazaj.
Okno za predogled prikazuje pričakovani rezultat, kjer je besedilni niz prikazan kot navadno besedilo s povratnimi oznakami. Tako smo dodali povratno kljukico, ne da bi sprožili njeno funkcionalnost za pretvorbo besedila v blok kode.
V zgornjem primeru je besedilo ovito med dve povratni kljukici. Če želimo v kodni blok dodati eno povratno kljukico, ne da bi to upoštevali kot sintakso za ustvarjanje kodnega bloka. Za to smo dodali dve povratni kljukici, presledek in nato besedilo kot »Dodajamo povratno kljukico: ` «. Vidite lahko, da tukaj želimo prikazati povratno kljukico, ne da bi jo uporabili kot del sintakse. Nato smo dali prostor in dodali dve zaključni kljukici.
Pričakovani rezultat je prikazan na ogled. To ima blok kode, ki ima povratno kljukico kot del.
Zdaj bomo ustvarili še en primer za razumevanje koncepta. Tukaj bomo ustvarili matematični izraz in ga zapisali kot blok kode v markdown v skladu z običajnim besedilom. Zapisali smo ga kot 'Če je `y = 9`, to pomeni, da je `y -3 = 6`'. Tukaj smo uporabili povratne kljukice na 'y = 9' in nato na 'y-3 = 6', da sta oba bloka kode.
Tako nam je prinesel pričakovan rezultat, ki ga lahko vidite na spodnji sliki:
Zdaj, da se izognemo tem povratnim kljukicam in upodabljamo povratne kljukice kot del običajnega besedila, moramo vstaviti poševnice nazaj pred oba para povratnih kljukic.
Matematični izraz, ki smo ga dodali, je prikazan s povratnimi kljukicami kot navadno besedilo in kot blok kode v markdownu.
Zaključek
Povratne kljukice so dodane v oznako navzdol, da se v bloku kode prikaže določeno besedilo ali skript. V tem priročniku smo razpravljali o potrebi po izogibanju povratne kljukice, ko želimo dodati vsebino kot običajno besedilo s povratno kljukico, ne da bi sprožili njihovo delovanje. Razpravljali smo o tem, kako se povratne kljukice uporabljajo za izdelavo blokov kode, nato pa smo vam ponudili rešitev, ki je dodati poševnico nazaj (\) pred povratno kljukico, tako da bo prikazano kot običajno besedilo in ne bo omogočilo bloka kode ustvarjanje.