Markdown este excelent pentru scriere și vă permite să formatați un document în orice editor de text, folosind funcții bogate, inclusiv titluri, extrase de cod, aldine, cursive, liste de verificare, marcatori, tabele și multe altele. Dar, deși Markdown este ușor de scris într-un editor precum nano, nu este atât de ușor de citit în terminal.
Glow este un utilitar de linie de comandă care afișează documentele Markdown așa cum sunt menite să fie citite.
Ce este Markdown și de ce este greu de afișat într-un terminal?
Markdown este o convenție pentru formatarea textului, și este aproape opusul a Editor de tip What You See Is What You Get (WYSIWYG)..
Documentele Markdown conțin o varietate de simboluri care arată modul în care textul ar trebui să fie formatat pe o pagină. Aceste simboluri sunt interpretate de un parser Markdown și fie afișate într-un cititor de documente, fie convertite în HTML pentru a fi afișate pe web.
Pentru că Markdown se bazează pe interpretarea simbolurilor de către o aplicație externă, o puteți crea chiar și în cel mai simplu editor de text. Nu aveți nevoie de o descărcare MS Office de mai mulți gigabyte pentru a crea un document Markdown; o poți face în nano, vim sau Emacs.
Afișarea documentelor Markdown este o problemă diferită. Sigur, le puteți deschide din nou în nano sau le puteți utiliza pisică pentru a vizualiza conținutul fișierului, dar nu veți vedea Markdown redat așa cum ar trebui să fie pentru cititori; veți vedea în schimb simbolurile de formatare.
Pentru utilizatorii care petrec mult timp clonarea depozitelor Git, aceasta devine rapid o corvoadă. Fișierele Git README sunt de obicei documente Markdown și împărțirea atenției între redarea mentală a unui document Markdown și digerarea conținutului acestuia înseamnă că puteți rata multe.
Deși ați putea folosi un renderer dedicat GUI Markdown sau puteți consulta site-ul web, aceasta înseamnă că va trebui să vă defocalizați și să părăsiți terminalul. Dacă utilizați un VPS sau aveți o aversiune față de GUI-uri de orice fel, ați avea ghinion.
Glow este un cititor Markdown bazat pe terminal, care este perfect pentru citirea documentației Markdown direct pe linia de comandă. Îl poți folosi pentru a descoperi fișiere Markdown și a le păstra în colecția ta privată.
Cum se instalează Glow pe Linux
Deși Glow nu este disponibil în majoritatea depozitelor oficiale ale distribuțiilor Linux, este totuși ușor de instalat.
Pe Debian și derivatele sale
Pentru a instala Glow pe distribuțiile bazate pe Ubuntu și Debian, mai întâi, va trebui să adăugați cheia Glow Glow și apoi să adăugați depozitul acesteia la lista de surse a sistemului dumneavoastră.
Adăugați cheia la breloul dvs. de chei și depozitul la sursele dvs. folosind:
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [semnat de=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list
Actualizați lista de pachete a sistemului, apoi instalați Glow cu:
sudo apt Actualizați
sudo apt instalare strălucire
Instalați Glow pe Fedora
Pentru a descărca și instala Glow pe Fedora, RHEL și alte distribuții bazate pe RPM, executați mai întâi următoarea comandă:
ecou '[farmec]
nume=farmec
baseurl=https://repo.charm.sh/yum/
activat=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
Apoi, instalați Glow tastând:
sudo yum instalare strălucire
Pe Arch Linux și derivatele sale
Puteți instala Glow pe distribuțiile bazate pe Arch folosind managerul de pachete implicit, Pacman.
sudo pacman -S glow
Instalați Glow as a Snap
Dacă aveți norocul să aveți un sistem suportat de magazinul proprietar Snap de la Canonical, puteți instala Glow cu:
sudo snap instalare strălucire
Pentru cei care nu au Snap instalat sau nu știu cum funcționează, consultați ghidul nostru detaliat instalarea și utilizarea Snap Store pe Linux.
Folosind Glow pentru a citi documentele Markdown în terminalul dvs
Cel mai simplu mod de a folosi Glow este să îi transmiteți un fișier Markdown ca argument:
strălucire acest-document.md
După cum puteți vedea, Glow a redat un document altfel dificil, complet cu aldine și cursive, text citat, tabele, liste și link-uri cu text ancora.
Este destul de frumos, iar Glow vine și cu o interfață de utilizator terminal. Îl poți activa cu:
strălucire
... și Glow vă va prezenta o listă recursivă de fișiere Markdown locale. Puteți naviga prin listă cu tastele săgeți de la tastatură și puteți apăsa Întoarcere pentru a selecta unul. Lovind Esc vă va întoarce la meniul principal.
Puteți lansa Glow în orice director adăugând calea directorului ca argument:
strălucire ~/my/markdown/file/dump/
Glow vă ajută să păstrați fișierele Markdown pentru o referință rapidă mai târziu. Pur și simplu deschideți orice document Markdown cu Glow TUI și apăsați S pe tastatura ta.
Alternativ, dacă nu vă place să deschideți întregul TUI pentru a ascunde un document Markdown care este chiar în fața dvs., rulați:
ascunziș strălucitor acest-document.md
Puteți găsi articolele ascunse din TUI principal, folosind Tab tasta pentru a naviga la fila „Stash”.
Utilizați Glow pentru a citi documentele Markdown online
Glow funcționează perfect cu fișierele GitHub README și, dacă știți numele depozitului pe care îl doriți, atunci:
strălucire github.com/charmbracelet/glow
... va avea ca rezultat preluarea Glow README din GitHub și redată ca ieșire standard.
Dacă fișierul Markdown este în altă parte, puteți utiliza:
strălucire https://host.tld/file.md
Personalizați strălucirea pentru a afișa Markdown în terminal
Glow funcționează bine așa cum este și va încerca să detecteze schema de culori a terminalului înainte de a vă prezenta Markdown formatat. Puteți modifica setările implicite dacă doriți și puteți alege dintre o temă deschisă sau întunecată cu comutatorul de stil -s.
strălucire -s lumină
Sau comutați la modul întunecat cu:
strălucire - e întuneric
Dacă aveți o foaie de stil personalizată, o puteți utiliza cu ușurință și cu Glow:
strălucire-sstilul meu.json
Glow facilitează redarea documentelor Markdown
Citirea documentelor Markdown în terminalul dvs. reprezintă o îmbunătățire uriașă a calității vieții și înseamnă că nu trebuie să cheltuiți resursele sistemului pentru a deschide încă o altă aplicație sau browser bazat pe GUI.
Dacă doriți să luați o pauză de la citirea documentelor Markdown lungi, puteți căuta videoclipuri YouTube și de pe terminalul dvs.!