Markdown je skvelý na písanie a umožňuje formátovať dokument v ľubovoľnom textovom editore pomocou bohatých funkcií vrátane nadpisov, úryvkov kódu, tučného písma, kurzívy, kontrolných zoznamov, odrážok, tabuliek a ďalších. Ale zatiaľ čo sa Markdown ľahko píše v editore, ako je nano, nie je tak ľahké ho čítať v termináli.
Glow je nástroj príkazového riadka, ktorý zobrazuje dokumenty Markdown tak, ako sa majú čítať.
Čo je Markdown a prečo je ťažké zobraziť ho v termináli?
Markdown je konvencia pre formátovanie textu, a je to v podstate opak a Editor typu What You See Is What You Get (WYSIWYG)..
Dokumenty Markdown obsahujú rôzne symboly, ktoré ukazujú, ako má byť text na stránke formátovaný. Tieto symboly sú interpretované analyzátorom Markdown a buď zobrazené v čítačke dokumentov, alebo konvertované do HTML, aby sa zobrazili na webe.
Je to preto, že Markdown sa spolieha na to, že symboly interpretuje externá aplikácia, a preto si ho môžete vytvoriť aj v tom najjednoduchšom textovom editore. Na vytvorenie dokumentu Markdown nepotrebujete multigigabajtové stiahnutie balíka MS Office; môžete to urobiť v nano, vim alebo Emacs.
Zobrazenie dokumentov Markdown je iná vec. Iste, môžete ich znova otvoriť v nano, alebo môžete použiť kat na zobrazenie obsahu súboru, ale neuvidíte Markdown vykreslený tak, ako by mal byť pre čitateľov; namiesto toho uvidíte symboly formátovania.
Pre používateľov, ktorí trávia veľa času klonovanie Git repozitárov, to sa rýchlo stane fuška. Súbory Git README sú zvyčajne dokumenty Markdown a rozdelenie vašej pozornosti medzi mentálne vykreslenie dokumentu Markdown a strávenie jeho obsahu znamená, že vám môže veľa uniknúť.
Aj keď by ste mohli použiť vyhradený vykresľovač GUI Markdown alebo si pozrieť webovú stránku, znamená to, že by ste museli rozostriť a opustiť terminál. Ak používate VPS alebo máte averziu voči GUI akéhokoľvek druhu, budete mať smolu.
Glow je terminálová čítačka Markdown, ktorá je ideálna na čítanie dokumentácie Markdown priamo na príkazovom riadku. Môžete ho použiť na objavovanie súborov Markdown a ich uloženie do vašej súkromnej zbierky.
Ako nainštalovať Glow na Linuxe
Hoci Glow nie je k dispozícii vo väčšine oficiálnych repozitárov Linuxových distribúcií, stále je ľahké ho nainštalovať.
O Debiane a jeho derivátoch
Ak chcete nainštalovať Glow na distribúcie založené na Ubuntu a Debiane, musíte najprv pridať kľúč Glow GPG a potom pridať jeho úložisko do zoznamu zdrojov vášho systému.
Pridajte kľúč do svojho zväzku kľúčov a úložisko do svojich zdrojov pomocou:
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 [podpísaný=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list
Aktualizujte zoznam balíkov vášho systému a potom nainštalujte Glow pomocou:
sudo apt aktualizovať
sudo apt Inštalácia žiara
Nainštalujte Glow na Fedoru
Ak chcete stiahnuť a nainštalovať Glow na Fedoru, RHEL a iné distribúcie založené na RPM, najprv spustite nasledujúci príkaz:
ozvena '[čaro]
meno=Kúzlo
baseurl=https://repo.charm.sh/yum/
povolené=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
Potom nainštalujte Glow zadaním:
sudo mňam Inštalácia žiara
O Arch Linuxe a jeho derivátoch
Glow môžete nainštalovať na distribúcie založené na Arch pomocou predvoleného správcu balíkov, Pacman.
sudo pacman -S žiara
Nainštalujte Glow ako Snap
Ak máte to šťastie, že máte systém podporovaný proprietárnym obchodom Canonical Snap Store, môžete Glow nainštalovať pomocou:
sudo snap Inštalácia žiara
Pre tých, ktorí nemajú nainštalovaný Snap alebo nevedia, ako to funguje, pozrite si nášho podrobného sprievodcu na inštalácia a používanie Snap Store v systéme Linux.
Používanie Glow na čítanie dokumentov Markdown vo vašom termináli
Najpriamejším spôsobom použitia Glow je odovzdať mu súbor Markdown ako argument:
žiara toto-dokument.md
Ako môžete vidieť, Glow vykreslil inak náročný dokument, doplnený tučným písmom a kurzívou, citovaným textom, tabuľkami, zoznamami a odkazmi s kotviacim textom.
To je celkom elegantné a Glow prichádza aj s terminálovým používateľským rozhraním. Môžete ho aktivovať pomocou:
žiara
...a Glow vám predstaví rekurzívny zoznam miestnych súborov Markdown. V zozname sa môžete pohybovať pomocou šípok na klávesnici a stlačiť Návrat vyberte jednu. Udieranie Esc vás vráti do hlavného menu.
Glow môžete spustiť v ľubovoľnom adresári pridaním cesty k adresáru ako argumentu:
žiariť ~/my/markdown/súbor/výpis/
Glow vám uľahčuje ukladanie súborov Markdown pre neskoršie rýchle použitie. Jednoducho otvorte akýkoľvek dokument Markdown pomocou Glow TUI a stlačte S na vašej klávesnici.
Prípadne, ak nechcete otvárať celú TUI na uloženie dokumentu Markdown, ktorý máte priamo pred sebou, spustite:
svietiaca skrýša toto-dokument.md
Svoje skryté články môžete nájsť v hlavnom TUI pomocou Tab prejdite na kartu „skrýša“.
Použite Glow na čítanie dokumentov Markdown online
Glow dokonale funguje so súbormi GitHub README a ak poznáte názov požadovaného úložiska, potom:
žiara github.com/charmbracelet/glow
...povedie k tomu, že súbor Glow README sa načíta z GitHubu a vykreslí sa ako štandardný výstup.
Ak je váš súbor Markdown inde, môžete použiť:
svieti https://host.tld/file.md
Prispôsobte žiaru tak, aby sa v termináli zobrazovala markdown
Glow funguje dobre tak, ako je, a pokúsi sa zistiť farebnú schému vášho terminálu predtým, ako vám ponúkne formátovaný Markdown. Ak chcete, predvolené hodnoty môžete zmeniť a pomocou prepínača štýlu si môžete vybrať zo svetlého alebo tmavého motívu -s.
glow -s svetlo
Alebo prepnite do tmavého režimu pomocou:
žiara je tmavá
Ak máte vlastnú šablónu so štýlmi, môžete ju jednoducho použiť aj s Glow:
žiara-smôj štýl.json
Glow uľahčuje vykresľovanie dokumentov Markdown
Čítanie dokumentov Markdown vo vašom termináli predstavuje obrovské zlepšenie kvality života a znamená, že nemusíte míňať systémové prostriedky na otváranie ďalšej aplikácie alebo prehliadača s grafickým rozhraním.
Ak si chcete oddýchnuť od čítania dlhých dokumentov Markdown, môžete tiež vyhľadávať videá YouTube zo svojho terminálu!