web-dev-qa-db-fra.com

Comment puis-je ouvrir des pages de manuel dans un navigateur Web?

Comment créer des pages de manuel (à partir de la commande man) dans un navigateur Web pour faciliter la navigation?

39
kiri

man2html

Pour rechercher des pages de manuel

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

Pour ouvrir directement une page (à partir de la ligne de commande)

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".


dwww

Pour rechercher des pages de manuel

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.

Pour ouvrir directement une page (à partir de la ligne de commande)

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.

6
kiri

Utiliser le programme homme

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.

Sélectionner définitivement un navigateur par défaut

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.

Dépanner

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

Utiliser Yelp

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

Utilisation du référentiel de pages de manuel Ubuntu

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.

52
Dan

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
13
Oli