Il y a quelque temps, j'ai écrit un guide qui décrivait comment parcourir Arch Wiki depuis votre terminal en utilisant un script de ligne de commande nommé arch-wiki-cli . En utilisant ce script, n'importe qui peut facilement naviguer sur l'ensemble du site Web Arch Wiki et le lire avec un navigateur de texte de votre choix. Évidemment, une connexion Internet active est nécessaire pour utiliser ce script. Aujourd'hui, je suis tombé sur un utilitaire similaire nommé "Arch-wiki-man" . Comme son nom l'indique, il est également utilisé pour lire Arch Wiki à partir de la ligne de commande, mais il ne nécessite pas de connexion Internet. Le programme Arch-wiki-man vous aide à parcourir et à lire l'intégralité d'Arch Wiki sous forme de pages de manuel Linux. Il affichera tout article d'Arch Wiki au format des pages de manuel. De plus, vous n'avez pas besoin d'être en ligne pour parcourir Arch Wiki. L'ensemble de l'Arch Wiki sera téléchargé localement et les mises à jour seront poussées automatiquement tous les deux jours. Ainsi, vous disposez toujours d'une copie locale à jour de l'Arch Wiki sur votre système.
Installer Arch-wiki-man
Arch-wiki-man est disponible en AUR , vous pouvez donc l'installer à l'aide de n'importe quel programme d'assistance AUR, par exemple Yay .
$ yay -S arch-wiki-man
Alternativement, il peut être installé à l'aide du gestionnaire de packages NPM comme ci-dessous. Assurez-vous d'avoir installé NodeJS et exécutez la commande suivante pour l'installer :
$ npm install -g arch-wiki-man
Parcourir et lire l'intégralité du wiki Arch sous forme de pages de manuel Linux
La syntaxe typique d'Arch-wiki-man est :
$ awman <search-query>
Laissez-moi vous montrer quelques exemples.
Rechercher avec une ou plusieurs correspondances
Cherchons un guide d'installation d'Arch Linux . Pour ce faire, lancez simplement :
$ awman Installation guide
La commande ci-dessus recherchera les correspondances contenant le terme de recherche "Guide d'installation" dans Arch Wiki. S'il existe plusieurs correspondances pour le terme de recherche donné, un menu de sélection apparaîtra. Choisissez le guide que vous souhaitez lire à l'aide des flèches HAUT/BAS ou les raccourcis clavier de style Vim (j/k ) et appuyez sur ENTER pour l'ouvrir. Le guide résultant s'ouvrira au format des pages de manuel comme ci-dessous.
Lire le guide d'installation d'Arch Linux à partir de la CLI en utilisant Awman
Ici, awman fait référence à a rch w iki m un.
Toutes les options de la commande man sont prises en charge, vous pouvez donc naviguer dans le guide comme vous le feriez lors de la lecture d'une page de manuel. Pour afficher la section d'aide, appuyez sur h .
Pour quitter le menu de sélection sans entrer man , appuyez simplement sur Ctrl+c .
Pour revenir en arrière et/ou quitter man, tapez q .
Rechercher des correspondances dans les titres et les descriptions
Par défaut, Awman recherchera les correspondances dans les titres uniquement. Vous pouvez cependant lui demander de rechercher les correspondances dans les titres et les descriptions également.
$ awman -d vim
Ou,
$ awman --desc-search vim
Rechercher des correspondances dans le contenu
Outre la recherche de correspondances dans les titres et les descriptions, il est également possible d'analyser le contenu d'une correspondance. Veuillez noter que cela ralentira considérablement le processus de recherche.
$ awman -k emacs
Ou,
$ awman --apropos emacs
Ouvrir les résultats de la recherche dans le navigateur Web
Si vous ne souhaitez pas afficher les guides arch wiki au format de page de manuel, vous pouvez l'ouvrir dans un navigateur Web. Pour ce faire, exécutez :
$ awman -w pacman
Ou,
$ awman --web pacman
Cette commande ouvrira la correspondance résultante dans le navigateur Web par défaut plutôt qu'avec la commande man . Veuillez noter que vous avez besoin d'une connexion Internet pour utiliser cette option.
Rechercher dans d'autres langues
Par défaut, Awman ouvrira les pages du wiki Arch en anglais. Si vous souhaitez afficher les résultats dans d'autres langues, par exemple espagnol , faites simplement :
$ awman -l spanish codecs
Arch Wiki en espagnol
Pour afficher la liste des options de langue disponibles, exécutez :
$ awman --list-languages
Mettre à jour la copie locale d'Arch Wiki
Comme je l'ai déjà dit, les mises à jour sont poussées automatiquement tous les deux jours. Si vous souhaitez le mettre à jour manuellement, exécutez simplement :
$ awman-update [email protected] /usr/lib/node_modules/arch-wiki-man └── [email protected] arch-wiki-md-repo has been successfully updated or reinstalled.
Suggestion de lecture :
- Comment créer et gérer vos propres pages de manuel