Voici comment j'ai embelli la lecture Markdown dans le terminal

Markdown est devenu presque omniprésent en tant que langage de choix pour les fichiers texte simples avec un peu de formatage. Avec un sous-ensemble de sémantique HTML couplé à une syntaxe plus conviviale, vous verrez Markdown dans les fichiers README, d'autres documentations et des formes rudimentaires de données structurées.

Grâce à sa syntaxe épurée, Markdown est lisible par l'homme, mais cela ne signifie pas que le texte brut est sa meilleure forme. Divers éditeurs et téléspectateurs formatent Markdown, mais Glow le fait dans le terminal, avec des résultats spectaculaires.

Qu’est-ce que Glow ?

Glow est l'un de ces utilitaires simples que vous ne recherchez peut-être pas, mais lorsque vous le rencontrez, vous ne pouvez pas imaginer un monde sans lui. Le programme utilise la couleur pour la coloration syntaxique et les caractères spéciaux pour afficher les listes Markdown, les tableaux et bien plus encore :

Glow dispose d'un ensemble de fonctionnalités restreint mais complet qui prend en charge la lecture de Markdown dans un terminal comme une expérience agréable. Même si vous l'installez simplement et l'utilisez en remplacement de cat ou moins, c'est une mise à niveau décente. Mais cela vaut également la peine d'explorer l'interface utilisateur, les nombreuses options de configuration et les moyens de personnaliser l'apparence de Glow.

Comment installer et lancer Glow

Glow prend en charge de nombreux gestionnaires de packages, donc pour l'installer, exécutez simplement brasser installer lueur, Pacman -S lueur, pkg installer lueurou l'alternative appropriée à votre système. Le fichier Glow README contient des instructions pour Linux, Mac et Windows, avec des binaires et des instructions de construction également disponibles.

Une fois que vous l'avez installé, le programme glow devrait être disponible dans un répertoire pertinent appartenant à votre PATH ; sur mon système macOS, c'est dans /opt/homebrew/bin, et sur Ubuntu, c'est /snap/bin. Vous devriez donc pouvoir exécuter Glow simplement en tapant son nom sur votre ligne de commande :

Exécuter Glow sans aucun argument ouvrira la version interactive de TUI, qui affiche les fichiers Markdown dans votre répertoire actuel et ci-dessous. Avec un seul argument de fichier, Glow enverra une sortie formatée directement à votre ligne de commande :

Vous pouvez également exécuter Glow et lui transmettre un chemin de répertoire, auquel cas il ouvrira le TUI et affichera les fichiers dans ce répertoire.

Quelles sont les meilleures fonctionnalités de Glow ?

Glow est une application simple à utiliser, vous n'avez donc pas besoin d'approfondir tout ce qu'elle propose pour en tirer de nombreux avantages. Néanmoins, les fonctionnalités suivantes font partie de mes points forts personnels.

Navigation dans les fichiers

Démarrez Glow sans aucun argument et vous verrez une liste des fichiers markdown du répertoire actuel et de ses sous-répertoires. Un nombre total est affiché en haut et vous pouvez naviguer entre les pages à l'aide des touches fléchées gauche et droite.

Cette fonctionnalité rend le programme particulièrement adapté à la navigation dans des ensembles de fichiers markdown. Si vous avez un journal avec un fichier par jour, un livre avec chaque chapitre sous forme de fichier markdown ou de nombreux référentiels avec des fichiers README.md, vous apprécierez cette fonctionnalité.

Thèmes

Le principal attrait de Glow réside dans ses visuels attrayants, et les thèmes en font sans surprise partie. La plupart du temps, ils modifient le jeu de couleurs spécifique utilisé pour restituer un fichier de démarque, mais ils peuvent également appliquer d'autres mises en forme, notamment le contenu gras, souligné, inversé et généré comme les marqueurs de titre.

Utilisez l'option –style pour spécifier un thème nommé. Par exemple, pour utiliser le thème « Tokyo Night » :

        glow --style "Tokyo Night" README.me

    

Raccourcis clavier

Les raccourcis clavier sont essentiels pour un lecteur de fichiers basé sur un terminal, et le TUI de Glow réutilise de nombreuses combinaisons de touches du pager less.

Comme dans moins, les flèches haut et bas se déplacent d'une ligne à la fois, et b/f avancent et avancent dans votre fichier, une page à la fois. Vous pouvez également utiliser g et G pour vous déplacer respectivement au début ou à la fin du fichier.

Mon raccourci préféré est peut-être la touche e, qui modifie le fichier actuel et l'ouvre immédiatement dans votre éditeur de texte à l'aide de la variable EDITOR. La plupart du temps, j'utilise Glow, c'est pour lire, mais si je repère une faute de frappe ou décide que je dois effectuer tout autre type de modification rapide, cette fonctionnalité est très pratique.

En parlant de téléavertisseurs, vous pouvez également apporter votre téléavertisseur préféré à Glow lorsqu'il fonctionne en mode CLI. Par défaut, glow imprimera le fichier complet sur votre terminal dans ce mode, mais vous pouvez utiliser l'option -p pour lui demander d'utiliser un pager à la place :

        glow -p README.md

    

Avec -p, glow utilisera votre PAGER ou « less -r » si cette variable d'environnement n'est pas définie. Malheureusement, l'option ne vous permet pas de remplacer PAGER, mais vous pouvez le faire en préfixant la commande glow :

        PAGER=bat glow -p README.md

    

Les téléavertisseurs bat et ov fonctionnent tous deux bien avec Glow, mais j'ai reçu une erreur lorsque j'ai essayé le plus grand nombre de téléavertisseurs.

Paramètres et fichier de configuration Glow

La plupart des paramètres de configuration sont des miroirs des options de ligne de commande, le fichier de configuration est donc vraiment pratique. Si vous utilisez souvent Glow avec les mêmes options de ligne de commande, envisagez de les définir dans le fichier de configuration pour modifier le comportement par défaut.

La modification du fichier de configuration de Glow est un processus simple grâce à la commande config :

        glow config

    

Cela ouvrira le fichier de configuration de Glow dans votre ÉDITEUR. L'emplacement du fichier dépendra de votre environnement (sur mon système macOS, il se trouve dans /Users/bobby/Library/Preferences/glow/glow.yml), mais cette commande signifie que vous n'avez pas à vous soucier du chemin spécifique, ce qui est une excellente idée.

Par exemple, si vous avez tendance à utiliser l'option –all=false pour supprimer les fichiers cachés, vous pouvez exécuter configuration de lueur et assurez-vous que la ligne suivante se trouve dans votre fichier :

        all: false