Markdown è ottimo per la scrittura e ti consente di formattare un documento in qualsiasi editor di testo, utilizzando funzionalità avanzate tra cui intestazione, estratti di codice, grassetto, corsivo, elenchi di controllo, elenchi puntati, tabelle e altro. Ma mentre Markdown è facile da scrivere in un editor come nano, non è così facile da leggere nel terminale.
Glow è un'utilità della riga di comando che visualizza i documenti Markdown nel modo in cui devono essere letti.
Che cos'è Markdown e perché è difficile da visualizzare in un terminale?
Markdown è una convenzione per la formattazione del testo, ed è praticamente l'opposto di a Editor di tipo What You See Is What You Get (WYSIWYG)..
I documenti Markdown contengono una varietà di simboli che mostrano come il testo dovrebbe essere formattato su una pagina. Questi simboli vengono interpretati da un parser Markdown e visualizzati in un lettore di documenti o convertiti in HTML per essere visualizzati sul Web.
È perché Markdown si basa sui simboli interpretati da un'app esterna che puoi crearlo anche nell'editor di testo più semplice. Non è necessario un download di MS Office multi-gigabyte per creare un documento Markdown; puoi farlo in nano, vim o Emacs.
La visualizzazione di documenti Markdown è una questione diversa. Certo, puoi aprirli di nuovo in nano o puoi usarli gatto per visualizzare il contenuto del file, ma non vedrai il Markdown reso come dovrebbe essere per i lettori; vedrai invece i simboli di formattazione.
Per gli utenti che trascorrono molto tempo clonare i repository Git, questo diventa rapidamente un lavoro ingrato. I file Git README sono in genere documenti Markdown e dividere la tua attenzione tra il rendering mentale di un documento Markdown e la digestione del suo contenuto significa che puoi perdere molto.
Sebbene tu possa utilizzare un renderer Markdown della GUI dedicato o controllare il sito Web, ciò significa che dovresti sfocare e lasciare il tuo terminale. Se stai usando un VPS o hai un'avversione per le GUI di qualsiasi tipo, saresti sfortunato.
Glow è un lettore Markdown basato su terminale, perfetto per leggere la documentazione Markdown direttamente sulla riga di comando. Puoi usarlo per scoprire i file Markdown e nasconderli nella tua raccolta privata.
Come installare Glow su Linux
Sebbene Glow non sia disponibile nei repository ufficiali della maggior parte delle distribuzioni Linux, è comunque facile installarlo.
Su Debian e le sue derivate
Per installare Glow su distribuzioni basate su Ubuntu e Debian, per prima cosa devi aggiungere la chiave Glow GPG e quindi aggiungere il suo repository all'elenco delle fonti del tuo sistema.
Aggiungi la chiave al tuo portachiavi e il repository alle tue fonti usando:
sudo mkdir -p /etc/apt/keyrings
ricciolo -fsSL https://repo.charm.sh/apt/gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/charm.gpg
echo "deb [firmato da=/etc/apt/portachiavi/charm.gpg] https://repo.charm.sh/apt/" | sudo tee /etc/apt/sources.list.d/charm.list
Aggiorna l'elenco dei pacchetti del tuo sistema, quindi installa Glow con:
sudo apt aggiornamento
sudo apt installare incandescenza
Installa Glow su Fedora
Per scaricare e installare Glow su Fedora, RHEL e altre distribuzioni basate su RPM, esegui prima il seguente comando:
eco '[fascino]
nome=Fascino
baseurl=https://repo.charm.sh/yum/
abilitato=1
gpgcheck=1
gpgkey=https://repo.charm.sh/yum/gpg.key' | sudo tee /etc/yum.repos.d/charm.repo
Quindi, installa Glow digitando:
sudo gnam installare incandescenza
Su Arch Linux e i suoi derivati
Puoi installare Glow su distribuzioni basate su Arch utilizzando il gestore di pacchetti predefinito, Pacman.
sudo pacman -S bagliore
Installa Glow in un batter d'occhio
Se sei abbastanza fortunato da avere un sistema supportato dallo Snap Store proprietario di Canonical, puoi installare Glow con:
sudo snap installare incandescenza
Per chi non ha installato Snap o non sa come funziona, consulta la nostra guida dettagliata su installazione e utilizzo di Snap Store su Linux.
Utilizzo di Glow per leggere i documenti Markdown nel tuo terminale
Il modo più semplice per usare Glow è passargli un file Markdown come argomento:
incandescenza Questo-documento.md
Come puoi vedere, Glow ha reso un documento altrimenti difficile, completo di grassetto e corsivo, testo citato, tabelle, elenchi e collegamenti con testo di ancoraggio.
È abbastanza carino e Glow viene fornito anche con un'interfaccia utente terminale. Puoi attivarlo con:
incandescenza
... e Glow ti presenterà un elenco ricorsivo di file Markdown locali. Puoi navigare nell'elenco con i tasti freccia della tastiera e premere Ritorno per selezionarne uno. Colpire Esc ti riporterà al menu principale.
Puoi avviare Glow in qualsiasi directory aggiungendo il percorso della directory come argomento:
bagliore ~/my/markdown/file/dump/
Glow ti consente di archiviare facilmente i file Markdown per un rapido riferimento in seguito. Basta aprire qualsiasi documento Markdown con Glow TUI e premere S sulla tua tastiera.
In alternativa, se non ti piace aprire l'interfaccia utente completa per nascondere un documento Markdown che è proprio di fronte a te, esegui:
bagliore scorta Questo-documento.md
Puoi trovare i tuoi articoli nascosti dalla TUI principale, utilizzando il Scheda tasto per passare alla scheda "scorta".
Usa Glow per leggere i documenti Markdown online
Glow funziona perfettamente con i file README di GitHub e se conosci il nome del repository che desideri, allora:
bagliore github.com/charmbracelet/glow
... comporterà il recupero del README di Glow da GitHub e il rendering come output standard.
Se il tuo file Markdown è altrove, puoi utilizzare:
bagliore https://host.tld/file.md
Personalizza il bagliore per visualizzare il markdown nel terminale
Glow funziona bene così com'è e tenterà di rilevare la combinazione di colori del terminale prima di presentarti con Markdown formattato. Puoi modificare le impostazioni predefinite se lo desideri e puoi scegliere tra un tema chiaro o scuro con l'interruttore di stile -S.
bagliore di luce
Oppure passa alla modalità oscura con:
bagliore - buio
Se hai un foglio di stile personalizzato, puoi usarlo facilmente anche con Glow:
incandescenza-Sil mio stile.json
Glow semplifica il rendering dei documenti Markdown
Leggere i documenti Markdown nel tuo terminale è un enorme miglioramento della qualità della vita e significa che non è necessario spendere risorse di sistema per aprire un'altra app o browser basato su GUI.
Se hai voglia di fare una pausa dalla lettura di lunghi documenti Markdown, puoi anche cercare i video di YouTube dal tuo terminale!