Forum Linux.debian/ubuntu Comment rendre les pages de manuel accessibles en ligne ?

Posté par  .
Étiquettes : aucune
0
16
mar.
2009
Bonjour,

comment puis-je rendre accessible en ligne, au format HTML, l'intégralité des pages de manuel présentes sur mon ordinateur ?

En cherchant un peu, j'ai trouvé man2html, mais je cherche plutôt une solution automatique/globale, sans avoir à faire une opération pour chaque application, et avoir la page de manuel correspondante disponible en ligne immédiatement lorsque j'installe un nouveau programme.

J'ai vu que par défaut, Apache crée un alias /doc -> /usr/share/doc, dont je ne comprends d'ailleurs pas vraiment l'intérêt... à moins de lire le binaire couramment, ou de vouloir à chaque fois télécharger l'archive .gz, et la décompresser en local pour la lire...

Je suppose qu'il existe des solutions simples, mais que je ne connais pas.
Sinon au pire je ferais un script avec man2html.

Merci d'avance !

  • # Sous Konqueror

    Posté par  . Évalué à 5.

    Sous Konqueror, dans la barre d'URL, tu préfixes par "man:", par exemple "man:ldapsearch", pour la page de manuel de "ldapsearch"...

    ... après, avec d'autres environnements, je ne sais pas.

    • [^] # Re: Sous Konqueror

      Posté par  . Évalué à 3.

      c'est pas mal cela.

      Il existe également les pages de man en ligne :

      http://www.linuxmanpages.com:80/man1/ls.1.php

      Only wimps use tape backup: real men just upload their important stuff on megaupload, and let the rest of the world ~~mirror~~ link to it

      • [^] # Re: Sous Konqueror

        Posté par  . Évalué à 2.

        Alors en effet, il existe divers sites de ce genre.
        Mais moi, d'une part j'aimerais héberger ça moi-même, d'autre part j'aimerais exposer ni plus ni moins que les pages de man des paquets installés sur la machine en question.

    • [^] # Re: Sous Konqueror

      Posté par  . Évalué à 2.

      Justement, j'ai connu ça à une époque (quand j'étais sous KDE), et là je voudrais la même chose, accessible en ligne, depuis n'importe quelle machine du réseau local (dans le cadre d'un cours).

  • # w3mman

    Posté par  (site web personnel) . Évalué à 3.

    w3m installe un script cgi /usr/lib/w3m/cgi-bin/w3mman2html.cgi qui permet de lire les pages man sous forme html par w3m (avec l'alias w3mman, ça se fait automatiquement) et transforme les références à des fichiers, des pages web ou d'autres pages man en liens. Il doit être possible de l'adapter un poil pour que ça marche depuis n'importe quel navigateur.

  • # CGI / man2html

    Posté par  . Évalué à 4.

    Il suffit que man2html soit appelé en CGI par Apache ou le serveur web de ton choix.

    • [^] # Re: CGI / man2html

      Posté par  . Évalué à 2.

      Il m'a semblé voir des remarques de ce genre sur le net, en effet.

  • # w3mman2html + url rewriting

    Posté par  . Évalué à 3.

    Suite à vos divers réponses, j'ai mis en place la solution suivante : 
    
- un virtualhost

    < VirtualHost 192.168.1.2:80 >
        DocumentRoot /usr/lib/w3m/cgi-bin/
        ServerName doc.monserveur.net
        ServerAlias doc.monserveur.net
        ScriptAlias /doc/ /usr/lib/w3m/cgi-bin/
< /VirtualHost >

    

    
- un .htaccess (/usr/lib/w3m/cgi-bin/.htaccess)

    RewriteEngine on
RewriteRule ^([\.\-a-z]*)$ /doc/w3mman2html.cgi?man=$1 [L]

    

    
Ainsi, je peux obtenir n'importe quelle page de manuel en saisissant une adresse telle que :

    
http://doc.monserveur.net/update-rc.d

    
Merci pour votre aide !

    

    

    



    • 





Suivre le flux des commentaires




Note :
les commentaires appartiennent à celles et ceux qui les ont postés. Nous n’en sommes pas responsables.