Comment les utilisateurs types sont-ils censés lire la documentation contenue dans /usr/share/doc ?

Il est peut-être trop tard pour répondre, mais j'ai trouvé la meilleure solution (tant du point de vue de la facilité d'utilisation que de l'exhaustivité)

• Installer dwww

Un système Linux typique dispose d'une documentation sous de nombreux formats (pages de manuel), fichiers Info, README, etc.). dwww permet d'accéder à tous ces formats par l'intermédiaire de via la même interface, un navigateur WWW. Cela facilite l'utilisation de la documentation. d'utiliser la documentation.

dwww est une interface web qui permet d'accéder à l'ensemble de la documentation en ligne d'un système Debian. Il construit des pages web qui listent tous les documents installés installés, et convertit tous les documents en HTML. La conversion est effectuée lorsque l'utilisateur demande le document.

• Activer le module CGI, qui n'est plus activé par défaut dans les versions récentes d'Ubuntu/Apache :

  sudo a2enmod cgi
  sudo service apache2 restart

• Ouvrez votre navigateur et pointez sur : http://localhost/dwww/

• ¡Hecho!

Tous vos info pages, man pages, /usr/share/doc dossiers et description du paquet en un seul endroit ! Votre site de documentation personnel !

Installez d'abord apache2

sudo apt-get install apache2 apache2-doc  

apache2-doc est le cas particulier. Il vous permet de parcourir votre documentation /usr/share/doc/ par l'intermédiaire de votre navigateur web. http://localhost/doc/ .

Mais cela ne fonctionne pas correctement. Vous devez modifier la configuration d'Apache pour qu'il décompresse et affiche les fichiers *.gz en texte brut.

J'ai posté sur Stack Overflow pour obtenir un moyen d'utiliser Apache pour afficher le contenu des documents *.gz dans la fenêtre /usr/share/doc/ répertoire. C'est ce qui a été affiché comme solution possible.

Voici ces instructions en bref. Elles indiquent à Apache comment traiter les fichiers .gz pour les traiter comme du texte brut et les envoyer au navigateur comme du texte brut.

sudo a2enmod headers   
sudo a2enmod deflate  
gksu gedit /etc/apache2/sites-enabled/000-default 

Allez au bas du fichier et trouvez la section avec Alias /doc/ "/usr/share/doc/" et modifiez-le pour qu'il ressemble à ceci.

Alias /doc/ "/usr/share/doc/"
<Directory /usr/share/doc>
    Options Indexes MultiViews FollowSymLinks
    AllowOverride None
    Order deny,allow
    Deny from all
    Allow from 127.0.0.0/255.0.0.0 ::1/128

    AddEncoding gzip gz
    <FilesMatch "\.gz$">
      ForceType text/plain
      Header set Content-Encoding: gzip
    </FilesMatch>
</Directory>   

Redémarrez ensuite Apache :

sudo apache2ctl restart

gunzip file.gz tente de décompresser file.gz a file , en supprimant file.gz . C'est pourquoi vous obtenez une erreur "Permission refusée", vous n'êtes pas autorisé à écrire dans /usr/share/doc . Pour obtenir le contenu d'un fichier, utilisez gunzip -c file.gz ou zcat file.gz .

La lecture de fichiers texte compressés par gzip peut se faire avec zless . Comme son nom l'indique, il s'agit d'un less mais pour les fichiers compressés par gzip.

使用例です：

zless /usr/share/doc/bash/NEWS.gz

En .gz peut également être omis :

zless /usr/share/doc/bash/NEWS

J'ai pu lire de tels fichiers avec la commande man sur Debian Stretch (bind9 dans mon cas)

man /usr/share/doc/bind9/README.Debian.gz