Comment puis-je faire en sorte que les pages de manuel (à partir de la commande man) s'ouvrent dans un navigateur Web pour une navigation plus facile ?
Réponses
Trop de publicités?
Ingvald
Points
373
Utilisation du programme man
En regardant la page de manuel de man,
man manIl y a l'option -H, ou son équivalent --html qui générera l'HTML pour le manuel et les ouvrira dans le navigateur.
Cette option fera produire une sortie HTML par groff, qui sera affichée dans un navigateur web. Le navigateur utilisé est déterminé par l'argument optionnel browser s'il est fourni, par la variable d'environnement $BROWSER, ou par un navigateur par défaut défini à la compilation si celui-ci est non défini (généralement lynx). Cette option implique -t, et fonctionnera uniquement avec GNU troff.
Donc pour ouvrir n'importe quelle page de manuel dans le navigateur, utilisez simplement :
man -Hfirefox ou
man --html=firefox Les deux sont identiques.
Vous pouvez utiliser firefox, google-chrome, chromium-browser ou tout autre mot à la place de firefox.
Sélectionner un navigateur par défaut de manière permanente
Avant d'appeler la commande man, utilisez la commande suivante :
export BROWSER=firefoxDe cette manière, vous pouvez simplement utiliser man -H ou man --html sans spécifier le navigateur à chaque fois.
man -H lsVous pouvez également ajouter la commande export précédente à votre ~/.bashrc pour ne pas avoir à la taper à chaque fois que vous ouvrez un nouveau terminal et essayez d'utiliser man -H
Résoudre les problèmes
Si vous obtenez une erreur disant quelque chose comme ceci :
man: command exited with status 3: /usr/bin/zsoelim | /usr/lib/man-db/manconv -f UTF-8:ISO-8859-1 -t UTF-8//IGNORE | preconv -e UTF-8 | tbl | groff -mandoc -ThtmlVous devrez installer le paquet groff.
sudo apt-get install groffUtilisation de Yelp
Si le choix du navigateur n'est pas pertinent, vous pouvez utiliser la commande yelp qui offre une navigation à travers les pages de manuel.
yelp man:
# exemple : yelp man:lsUtilisation du Dépôt de Pages de Manuel Ubuntu
Vous pouvez également visiter https://manpages.ubuntu.com/ et consulter presque toutes les pages de manuel là-bas. Toutes les versions des pages de manuel pour toutes les versions d'Ubuntu sont disponibles là-bas. Il propose également une fonctionnalité de recherche.
Évidemment, l'inconvénient d'utiliser le site web est que vous ne pouvez pas y accéder sans être connecté à Internet.
Mufaka
Points
54
man peut en fait faire beaucoup de choses tout seul. Vous devez simplement installer groff (système de formatage de texte GNU troff) puis vous pouvez utiliser le drapeau H (permet à groff de produire une sortie HTML).
sudo apt install groff
man -Hfirefox bashMan2html
Rechercher les pages de manuel
J'ai installé le paquet man2html puis j'ai navigué vers http://localhost/cgi-bin/man/man2html pour visualiser les pages de manuel. Ces pages peuvent être consultées hors ligne, sont liées à d'autres pages de manuel et disposent d'une fonction de recherche.
Source
Pour ouvrir directement une page (depuis la ligne de commande)
J'ai créé ce script ici (il n'est pas court), il navigue directement vers la page web (depuis man2html) pour une page de manuel spécifique. Il peut ouvrir plusieurs pages de manuel spécifiées en tant qu'arguments de la ligne de commande. Enregistrez le script quelque part et donnez-lui les autorisations d'exécution (chmod +x script.sh). Exécutez-le comme ~/script.sh (en supposant qu'il soit enregistré dans le répertoire ~) avec les pages à ouvrir comme arguments. Pour ouvrir quelque chose comme init(8), utilisez ~/script "8 init".
dwww
Rechercher les pages de manuel
Installez le paquet dwww et naviguez vers http://localhost/dwww/man/1 pour rechercher les pages. Ces pages peuvent être consultées hors ligne, sont liées à d'autres pages de manuel et disposent d'une fonction de recherche.
Pour ouvrir directement une page (depuis la ligne de commande)
J'ai créé ce script ici (il n'est pas court), il navigue directement vers la page web (depuis dwww) pour une page de manuel spécifique. Il peut ouvrir plusieurs pages de manuel spécifiées en tant qu'arguments de la ligne de commande. Enregistrez le script quelque part et donnez-lui les autorisations d'exécution (chmod +x script.sh). Exécutez-le comme ~/script.sh page (en supposant qu'il soit enregistré dans le répertoire ~) avec les pages à ouvrir comme arguments. Pour ouvrir quelque chose comme init(8), utilisez ~/script init/8. Sans pcregrep, vous devez taper le /8 tout le temps, avec lui, tapez juste le nom de la page.
Thomas de Saint Exupery
Points
11
En réponse à Dan et le commentaire de ratijas : vous pouvez forcer firefox à s'ouvrir dans un nouveau processus
man -H"firefox -new-instance -P 'default'" lsPersonnellement, je l'ai aliasé comme suit : man :
alias man="man -H'firefox -new-instance -P default'"
