Markdown doskonale nadaje się do pisania i umożliwia formatowanie dokumentu w dowolnym edytorze tekstu, przy użyciu bogatych funkcji, takich jak nagłówki, fragmenty kodu, pogrubienie, kursywa, listy kontrolne, wypunktowania, tabele i inne. Ale chociaż Markdown jest łatwy do napisania w edytorze, takim jak nano, nie jest tak łatwy do odczytania w terminalu.
Glow to narzędzie wiersza poleceń, które wyświetla dokumenty Markdown w sposób, w jaki powinny być czytane.
Co to jest Markdown i dlaczego trudno go wyświetlić w terminalu?
Markdown to konwencja formatowania tekstu, i jest prawie przeciwieństwem a Dostajesz to, co widzisz (WYSIWYG)..
Dokumenty Markdown zawierają różne symbole, które pokazują, jak tekst powinien być sformatowany na stronie. Symbole te są interpretowane przez parser Markdown i wyświetlane w czytniku dokumentów lub konwertowane do formatu HTML, który ma być wyświetlany w Internecie.
Ponieważ Markdown opiera się na symbolach interpretowanych przez zewnętrzną aplikację, możesz go utworzyć nawet w najprostszym edytorze tekstu. Nie potrzebujesz wielogigabajtowego pakietu MS Office do pobrania, aby utworzyć dokument Markdown; możesz to zrobić w nano, vimie lub Emacsie.
Wyświetlanie dokumentów Markdown to inna sprawa. Jasne, możesz ponownie otworzyć je w nano lub użyć kot aby wyświetlić zawartość pliku, ale nie zobaczysz kodu Markdown renderowanego tak, jak powinien być dla czytelników; zamiast tego zobaczysz symbole formatowania.
Dla użytkowników, którzy spędzają dużo czasu klonowanie repozytoriów Gitszybko staje się to przykrym obowiązkiem. Pliki README Git to zazwyczaj dokumenty Markdown, a dzielenie uwagi między mentalne renderowanie dokumentu Markdown i trawienie jego treści oznacza, że możesz wiele przegapić.
Chociaż możesz użyć dedykowanego renderera GUI Markdown lub sprawdzić stronę internetową, oznacza to, że będziesz musiał rozogniskować i opuścić terminal. Jeśli używasz VPS lub masz awersję do jakiegokolwiek GUI, nie masz szczęścia.
Glow to terminalowy czytnik Markdown, który idealnie nadaje się do czytania dokumentacji Markdown bezpośrednio w wierszu poleceń. Możesz go użyć do odkrywania plików Markdown i przechowywania ich w swojej prywatnej kolekcji.
Jak zainstalować Glow w systemie Linux
Chociaż Glow nie jest dostępny w większości oficjalnych repozytoriów dystrybucji Linuksa, nadal jest łatwy do zainstalowania.
O Debianie i jego pochodnych
Aby zainstalować Glow w dystrybucjach opartych na Ubuntu i Debianie, najpierw musisz dodać klucz Glow GPG, a następnie dodać jego repozytorium do listy źródeł systemu.
Dodaj klucz do swojego pęku kluczy i repozytorium do swoich źródeł, używając:
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 [podpisany przez =/etc/apt/keyrings/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list
Zaktualizuj listę pakietów swojego systemu, a następnie zainstaluj Glow za pomocą:
sudo apt aktualizacja
sudo apt zainstalować blask
Zainstaluj Glow na Fedorze
Aby pobrać i zainstalować Glow w Fedorze, RHEL i inne dystrybucje oparte na RPM, najpierw uruchom następujące polecenie:
Echo '[czar]
imię=Urok
baseurl=https://repo.charm.sh/yum/
włączone=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
Następnie zainstaluj Glow, wpisując:
sudo mniam zainstalować blask
O Arch Linux i jego pochodnych
Możesz zainstalować Glow w dystrybucjach opartych na Arch, używając domyślnego menedżera pakietów, Pacman.
sudo pacman -S blask
Zainstaluj Glow w mgnieniu oka
Jeśli masz szczęście i masz system obsługiwany przez Snap Store firmy Canonical, możesz zainstalować Glow za pomocą:
sudo snap zainstalować blask
Dla tych, którzy nie mają zainstalowanego Snap lub nie wiedzą, jak to działa, zapoznaj się z naszym szczegółowym przewodnikiem instalowanie i używanie Snap Store w systemie Linux.
Używanie blasku do czytania dokumentów Markdown w twoim terminalu
Najprostszym sposobem użycia Glow jest przekazanie mu pliku Markdown jako argumentu:
blask Ten-dokument.md
Jak widać, Glow wyrenderował trudny dokument, uzupełniony pogrubieniem i kursywą, cytowanym tekstem, tabelami, listami i linkami z tekstem zakotwiczenia.
To całkiem fajne, a Glow jest również wyposażony w terminalowy interfejs użytkownika. Możesz go aktywować za pomocą:
blask
...a Glow przedstawi rekurencyjną listę lokalnych plików Markdown. Możesz poruszać się po liście za pomocą klawiszy strzałek na klawiaturze i naciskać Powrót aby wybrać jeden. Uderzenie wyjście spowoduje powrót do menu głównego.
Możesz uruchomić Glow w dowolnym katalogu, dodając ścieżkę do katalogu jako argument:
blask ~/my/markdown/plik/zrzut/
Glow ułatwia przechowywanie plików Markdown do szybkiego wykorzystania w przyszłości. Po prostu otwórz dowolny dokument Markdown za pomocą Glow TUI i naciśnij S na klawiaturze.
Alternatywnie, jeśli nie masz ochoty otwierać pełnego TUI, aby schować dokument Markdown, który jest tuż przed tobą, uruchom:
zapas blasku Ten-dokument.md
Możesz znaleźć swoje ukryte artykuły z głównego TUI, używając Patka aby przejść do zakładki „schowek”.
Użyj blasku, aby czytać dokumenty Markdown online
Glow doskonale współpracuje z plikami README GitHub, a jeśli znasz nazwę repozytorium, które chcesz, to:
blask https://github.com/charmbracelet/glow
... spowoduje pobranie Glow README z GitHub i wyrenderowanie jako standardowe wyjście.
Jeśli twój plik Markdown znajduje się gdzie indziej, możesz użyć:
blask https://host.tld/file.md
Dostosuj poświatę, aby wyświetlić przecenę w terminalu
Glow działa dobrze i spróbuje wykryć schemat kolorów terminala przed przedstawieniem sformatowanego Markdown. Jeśli chcesz, możesz zmienić ustawienia domyślne i wybrać jasny lub ciemny motyw za pomocą przełącznika stylu -S.
świecące światło
Lub przełącz się na tryb ciemny za pomocą:
poświata -s ciemność
Jeśli masz niestandardowy arkusz stylów, możesz go łatwo używać również z Glow:
blask-Smój styl.json
Blask ułatwia renderowanie dokumentów Markdown
Czytanie dokumentów Markdown w twoim terminalu to ogromna poprawa jakości życia i oznacza, że nie musisz wydawać zasobów systemowych na otwieranie kolejnej aplikacji lub przeglądarki opartej na GUI.
Jeśli masz ochotę zrobić sobie przerwę od czytania długich dokumentów Markdown, możesz też wyszukiwać filmy z YouTube na swoim terminalu!