Comment créer des pages de manuel (à partir de la commande man
) dans un navigateur Web pour faciliter la navigation?
J'ai installé le paquetage man2html
puis navigué vers http://localhost/cgi-bin/man/man2html
pour afficher les pages de manuel. Ces pages peuvent être consultées hors ligne, créer des liens vers d'autres pages de manuel et comporter une fonction de recherche.
Source
J'ai fait ce script ici (ce n'est pas court), il navigue directement vers la page Web (à partir de man2html
) pour une certaine page de manuel. Il peut ouvrir plusieurs pages de manuel spécifiées comme arguments de ligne de commande. Enregistrez le script quelque part et donnez-lui les autorisations d'exécution (chmod +x script.sh
). Exécutez-le en tant que ~/script.sh
(en supposant qu'il soit enregistré dans le répertoire ~
) avec les pages à ouvrir en tant qu'arguments. Pour ouvrir quelque chose comme init(8)
, utilisez ~/script "8 init"
.
Installez le paquetage dwww
__ et naviguez vers http://localhost/dwww/man/1
pour rechercher les pages. Ces pages peuvent être consultées hors ligne, créer des liens vers d'autres pages de manuel et comporter une fonction de recherche.
J'ai fait ce script ici (ce n'est pas court), il navigue directement vers la page Web (à partir de dwww
) pour une certaine page de manuel. Il peut ouvrir plusieurs pages de manuel spécifiées comme arguments de ligne de commande. Enregistrez le script quelque part et donnez-lui les autorisations d'exécution (chmod +x script.sh
). Exécutez-le en tant que ~/script.sh page
(en supposant qu'il soit enregistré dans le répertoire ~
) avec les pages à ouvrir en tant qu'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 simplement le nom de la page.
En regardant la page de manuel de man,
man man
Il existe l'option -H
ou son équivalent --html
qui générera le code HTML du manuel et l'ouvrira dans le navigateur.
Avec cette option, groff produira une sortie HTML et l’affichera dans un navigateur Web. Le choix du navigateur est déterminé par l’argument optionnel du navigateur, le cas échéant, par la variable d’environnement $ BROWSER ou par une valeur par défaut lors de la compilation si non défini (généralement lynx). Cette option implique -t et ne fonctionnera qu'avec GNU troff.
Pour ouvrir une page de manuel dans un navigateur, utilisez simplement:
man -Hfirefox <command>
ou
man --html=firefox <command>
Les deux sont les mêmes.
Vous pouvez utiliser firefox
, google-chrome
, chromium-browser
ou tout autre code à la place du firefox
Word.
Avant d'appeler la commande man
, utilisez la commande suivante:
export BROWSER=firefox
De cette façon, vous pouvez simplement utiliser man -H
ou man --html
sans spécifier le navigateur à chaque fois.
man -H ls
Vous pouvez également ajouter la précédente commande export
à votre ~/.bashrc
afin que vous n'ayez pas à la saisir à chaque fois que vous ouvrez un nouveau terminal et que vous utilisiez man -H
.
Si vous avez une erreur en disant quelque chose comme ça:
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 -Thtml
Vous devrez installer le package groff
.
Sudo apt-get install groff
Si un choix de navigateur n'est pas pertinent, vous pouvez utiliser la commande Yelp
qui offre une navigation dans les pages de manuel.
Yelp man:<command>
# example: Yelp man:ls
Vous pouvez également visiter http://manpages.ubuntu.com/ et consulter presque toutes les pages de manuel. Toutes les versions des pages de manuel pour toutes les versions d'Ubuntu sont disponibles ici. Il comporte également une fonctionnalité de recherche.
Bien sûr, l’inconvénient de l’utilisation du site Web est que vous ne pouvez pas y accéder sans être connecté à Internet.
man
peut réellement faire beaucoup de choses tout seul. Vous devez simplement installer groff
pour pouvoir utiliser l’indicateur H
.
Sudo apt-get install groff
man -Hfirefox bash