Markdown je skvělý pro psaní a umožňuje formátovat dokument v libovolném textovém editoru s využitím bohatých funkcí včetně nadpisů, výňatků z kódu, tučného písma, kurzívy, kontrolních seznamů, odrážek, tabulek a dalších. Ale zatímco se Markdown snadno píše v editoru, jako je nano, není tak snadné jej číst v terminálu.
Glow je nástroj příkazového řádku, který zobrazuje dokumenty Markdown tak, jak se mají číst.
Co je Markdown a proč je těžké zobrazit v terminálu?
Markdown je konvence pro formátování textu, a je to do značné míry opak a Editor typu What You See Is What You Get (WYSIWYG)..
Dokumenty Markdown obsahují různé symboly, které ukazují, jak má být text na stránce formátován. Tyto symboly jsou interpretovány analyzátorem Markdown a buď zobrazeny ve čtečce dokumentů, nebo převedeny do HTML pro zobrazení na webu.
Je to proto, že Markdown spoléhá na to, že symboly jsou interpretovány externí aplikací, takže jej můžete vytvořit i v tom nejjednodušším textovém editoru. K vytvoření dokumentu Markdown nepotřebujete multigigabajtové stahování MS Office; můžete to udělat v nano, vim nebo Emacs.
Zobrazení dokumentů Markdown je jiná věc. Jistě, můžete je znovu otevřít v nano, nebo můžete použít kočka pro zobrazení obsahu souboru, ale neuvidíte Markdown vykreslený tak, jak by pro čtenáře měl být; místo toho uvidíte symboly formátování.
Pro uživatele, kteří tráví hodně času klonování úložišť Git, to se rychle stane fuška. Soubory Git README jsou obvykle dokumenty Markdown a rozdělení vaší pozornosti mezi mentální vykreslování dokumentu Markdown a strávení jeho obsahu znamená, že toho můžete hodně promeškat.
I když byste mohli použít vyhrazený renderer GUI Markdown nebo se podívat na webovou stránku, znamená to, že byste museli rozostřit a opustit svůj terminál. Pokud používáte VPS nebo máte averzi vůči GUI jakéhokoli druhu, budete mít smůlu.
Glow je terminálová čtečka Markdown, která je ideální pro čtení dokumentace Markdown přímo na příkazovém řádku. Můžete jej použít k objevování souborů Markdown a jejich uložení do vaší soukromé sbírky.
Jak nainstalovat Glow na Linux
Přestože Glow není k dispozici ve většině oficiálních repozitářů linuxových distribucí, je stále snadné jej nainstalovat.
O Debianu a jeho derivátech
Chcete-li nainstalovat Glow na distribuce založené na Ubuntu a Debianu, musíte nejprve přidat klíč Glow GPG a poté přidat jeho úložiště do seznamu zdrojů vašeho systému.
Přidejte klíč do svého svazku klíčů a úložiště do zdrojů pomocí:
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 [podepsaný=/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.listAktualizujte seznam balíčků svého systému a poté nainstalujte Glow pomocí:
sudo apt Aktualizace
sudo apt Nainstalujte zářeNainstalujte Glow na Fedoru
Chcete-li stáhnout a nainstalovat Glow na Fedoru, RHEL a další distribuce založené na RPM, nejprve spusťte následující příkaz:
echo '[kouzlo]
jméno=Šarm
baseurl=https://repo.charm.sh/yum/
povoleno=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repoPoté nainstalujte Glow zadáním:
sudo mňam Nainstalujte zářeO Arch Linuxu a jeho derivátech
Glow na distribucích založených na Arch můžete nainstalovat pomocí výchozího správce balíčků Pacman.
sudo pacman -S zářeNainstalujte Glow jako Snap
Pokud máte to štěstí, že máte systém podporovaný proprietárním obchodem Canonical Snap Store, můžete Glow nainstalovat pomocí:
sudo snap Nainstalujte zářePro ty, kteří nemají Snap nainstalovaný nebo nevědí, jak to funguje, se podívejte na našeho podrobného průvodce na instalace a používání Snap Store na Linuxu.
Použití Glow ke čtení dokumentů Markdown ve vašem terminálu
Nejpřímější způsob, jak použít Glow, je předat mu soubor Markdown jako argument:
záře tento-dokument.mdJak můžete vidět, Glow vykreslil jinak obtížný dokument, doplněný tučným písmem a kurzívou, citovaným textem, tabulkami, seznamy a odkazy s kotvícím textem.
To je docela elegantní a Glow také přichází s uživatelským rozhraním terminálu. Můžete jej aktivovat pomocí:
záře...a Glow vám nabídne rekurzivní seznam místních souborů Markdown. V seznamu se můžete pohybovat pomocí šipek na klávesnici a stisknout Vrátit se vybrat jednu. Bít Esc vrátíte se do hlavní nabídky.
Glow můžete spustit v libovolném adresáři přidáním cesty k adresáři jako argumentu:
zářit ~/my/markdown/soubor/výpis/Glow vám usnadní schování souborů Markdown pro pozdější rychlou referenci. Jednoduše otevřete jakýkoli dokument Markdown pomocí Glow TUI a stiskněte S na vaší klávesnici.
Případně, pokud nechcete otevírat celou TUI a schovat dokument Markdown, který máte přímo před sebou, spusťte:
záře skrýš tento-dokument.mdSvé skryté články můžete najít z hlavního TUI pomocí Tab klávesou přejděte na záložku "stash".
Použijte Glow ke čtení dokumentů Markdown online
Glow dokonale funguje se soubory README GitHub, a pokud znáte název požadovaného úložiště, pak:
záře github.com/charmbracelet/glow...bude mít za následek načtení Glow README z GitHubu a vykreslení jako standardní výstup.
Pokud je váš soubor Markdown jinde, můžete použít:
svítit https://host.tld/file.mdPřizpůsobte záři tak, aby se v terminálu zobrazovala markdown
Glow funguje dobře tak, jak je, a pokusí se detekovat barevné schéma vašeho terminálu, než vám nabídne formátovaný Markdown. Pokud chcete, můžete výchozí nastavení změnit a pomocí přepínače stylu si můžete vybrat ze světlého nebo tmavého motivu -s.
záře světlaNebo přepněte do tmavého režimu pomocí:
zářit je temnéPokud máte vlastní šablonu stylů, můžete ji snadno použít také s Glow:
záře-smůj styl.jsonGlow usnadňuje vykreslování dokumentů Markdown
Čtení dokumentů Markdown ve vašem terminálu je obrovským zlepšením kvality života a znamená, že nemusíte utrácet systémové prostředky otevíráním další aplikace nebo prohlížeče řízeného GUI.
Pokud si chcete odpočinout od čtení zdlouhavých dokumentů Markdown, můžete také vyhledávat videa na YouTube ze svého terminálu!