J'ai récemment appris qu'il existe une énorme quantité de documentation /usr/share/doc
.
Il semble qu'une grande partie est gzippée afin de ne pas être directement accessible sans privilèges administratifs:
$ gunzip examples/letter.tex.gz
gzip: examples/letter.tex: Permission denied
Une solution à ce problème consisterait pour chaque utilisateur à dupliquer chaque élément de son répertoire personnel juste pour le lire, mais cet arrangement ne semble guère propice à une navigation régulière.
Comment les gens normaux lisent-ils cette documentation?
Je ne suis pas enclin à croire que l'utilisateur type est censé installer et gérer un serveur Web uniquement pour lire la documentation en texte local.
documentation
usability
ændrük
la source
la source
/usr/share/doc
général et en prêtant une attention particulière au fait que la plupart d’entre elles sont stockées dans un format compressé. S'il se trouve que de la documentation est stockée en tant que LaTeX non typé, je ne l'ai pas encore rencontrée. L'exemple particulier que j'ai cité ci-dessus est un modèle LaTeX du packagetexlive-latex-extra-doc
.Réponses:
La plupart ont été très bien expliquées par jgbelacqua pour une utilisation en terminal. Ajoutons simplement ceci aux personnes qui sont sur un gestionnaire de bureau:
Depuis un bureau graphique (ici GNOME), le moyen le plus simple de lire des documents
/usr/share/doc
consiste à (double) ouvrir les fichiers compressés avec votre gestionnaire d'archives standard (ici File Roller) d'où vous pouvez (double) cliquer pour les ouvrir et les lire. votre éditeur standard (ici Gedit). Aucune autorisation d'écriture n'est nécessaire tant que vous ne décompressez pas les fichiers.la source
Il y a au moins deux problèmes ici:
Pour le n ° 1 , il existe un certain nombre d'applications qui gèrent les fichiers compressés de manière transparente. Un couple que vous pourriez utiliser sont
less
etvim
.view
est un alias pourvim -R
, qui dit simplement d'ouvrir le fichier en lecture seule.Auparavant, avant d'installer moins de logiciels sur mon système, j'utilisais
gzcat
et dirigais la sortie vers un autre utilitaire. Apparemment, il n'est appelé quezcat
maintenant sur Ubuntu, mais vous l'utiliseriez comme ceci, par exemple:zcat est toujours disponible et son utilisation pour diriger des contenus compressés quelque part peut être utile dans certains cas. (Pour les situations avec des fichiers .bz2,
bzcat
est disponible.)Pour # 2 , tous les fichiers que j'ai vus sous / usr / share / doc se trouvent dans des répertoires avec d'autres autorisations + rx, ce qui signifie que tous les utilisateurs peuvent effectuer une recherche dans les répertoires (par exemple, le contenu de la liste) et y lire des fichiers. Ce que vous ne pouvez pas faire (car seul root a l'autorisation d'écriture par défaut), c'est créer des fichiers. Étant donné que vous essayez de décompresser dans ce répertoire, j'imagine qu'il vous donne l'autorisation refusée car vous avez lu, mais pas écrit, les autorisations par défaut.
Pour # 3, je suppose que vous utilisez plus que moi les fichiers .tex. Mais voici une façon de les gérer sans copier à la maison ou dans un fichier temporaire. Pour cela, vous allez créer un canal nommé, mais vous pouvez le réutiliser pour vos autres besoins en traitement et en traitement de texte. Cela devrait aller comme ceci:
pipey
)Vous pouvez évidemment modifier ces étapes si vous utilisez des utilitaires différents ou meilleurs que ceux décrits ici.
Mon exemple utilisera cet
mkfifo
utilitaire pour créer le canal nommépipey
. Le fichier cible à traiter est/usr/share/doc/gdb/refcard.tex.gz
. Vous aurez besoin de deux lignes de commande shell disponibles (via terminal, Alt + F2, ou cependant).Vous allez taper au terminal un:
mkfifo pipey
Vous avez maintenant un canal nommé persistant. Vous pouvez utiliser
ls -l
pour jeter un coup d'oeil.zcat /usr/share/doc/gdb/refcard.tex.gz | tex > pipey
Notez que cette commande ne renverra pas tant que vous ne ferez pas quelque chose avec la sortie qui est passée dans le canal nommé.
Maintenant, au terminal deux, vous allez taper:
tex pipey | xdvi
Et ça marche (enfin, ici quand même). Le processus peut être affiné pour obtenir une sortie plus jolie, mais si vous recherchez une solution rapide et relativement sans dégâts, c’est une façon de le faire.
la source
<Directory "/usr/share/doc/">
déclaration du répertoire Apache (généralement dans/etc/apache2/sites-enabled/000-default
) et je pense que la décompression est gérée par les navigateurs eux-mêmes. (AddEncoding x-gzip gz tgz
etAddType text/plain .gz
)less
. Cela présente l’avantage supplémentaire d’être installé par défaut sur tous les systèmes modernes * nix. Pour l'utilisateur qui sait que les fichiers sont là et veut s'y référer plus de deux fois par an, installer quelque chose comme dwww semble être une excellente solution. En un rien de temps, je ne me souviendrais peut-être pas de dwww, mais je me souviendrai des commandes de base telles que "moins". Ou, comme Takkat l'a dit, Nautilus / fileroller / etc.C’est peut-être trop tard pour répondre, mais j’ai trouvé la meilleure solution (facilité d’utilisation et exhaustivité)
Activez le module CGI, qui n’est plus activé par défaut dans Ubuntu / Apache récent:
Ouvrez votre navigateur et pointez sur: http: // localhost / dwww /
Terminé!
Toutes vos
info
pages,man
pages,/usr/share/doc
fichiers et description du paquet en un seul endroit! Votre site de documentation personnelle!la source
gunzip file.gz
tentatives de Décompresserfile.gz
pourfile
, enleverfile.gz
. C'est pourquoi vous obtenez une erreur "Autorisation refusée", vous n'êtes pas autorisé à écrire/usr/share/doc
. Pour obtenir le contenu d'un fichier, utilisezgunzip -c file.gz
ouzcat file.gz
.Vous pouvez lire des fichiers texte compressés au format gzip
zless
. Comme son nom l’indique, c’est justeless
, mais pour les fichiers compressés au format gzip.Exemple d'utilisation:
Le
.gz
suffixe peut également être omis:la source
zless
, carless
cela le gérera automatiquement.LESSOPEN
etLESSCLOSE
.Installez d'abord apache2
apache2-doc
est le cas particulier ici. Il vous permet de parcourir votre documentation/usr/share/doc/
via votre navigateur Web. vienthttp://localhost/doc/
.Cela ne marche pas bien cependant. Vous devez modifier la configuration d'Apache pour le décompresser et afficher les fichiers * .gz sous forme de texte brut.
J'ai posté sur Stack Overflow pour trouver un moyen d'utiliser Apache pour afficher le contenu des documents * .gz du
/usr/share/doc/
répertoire. C'est ce qui a été affiché comme solution possible.Voici ces instructions en bref. Il indique à Apache comment traiter les fichiers .gz pour les traiter en texte brut et les envoyer au navigateur en texte brut.
Allez au bas du fichier et trouvez la section avec
Alias /doc/ "/usr/share/doc/"
et changez-la pour ressembler à ceci.Puis redémarrez Apache:
la source
AddEncoding x-gzip gz tgz AddType text/plain .gz
à mon<Directory "/usr/share/doc/">
entrée et je crois que la décompression est en réalité gérée du côté client.yelp
peut-être?) Ait un moyen unique de lire la documentation.sudo service apache2 restart
pour des raisons de standardisation. Enfin, les lecteurs doivent être conscients de la fin du caractère "/": ce doit être localhost / doc / , localhost / doc ne fonctionnera pas.Votre ne devrait pas lire les fichiers .tex! Il est au format lisible par l’homme, mais il est conçu pour être traité avant le reanding. Vous pouvez utiliser l'outil tex2pdf pour le convertir en .pdf.
la source
pdflatex
. 3) Cela est lié à la nécessité de gunzip le fichier avant de le lire.