Como os usuários comuns devem ler a documentação em / usr / share / doc?

Eu aprendi recentemente que há uma enorme pilha de documentação no /usr/share/doc.

Parece que grande parte dele foi compactada com gzip para que não seja acessada diretamente sem privilégios administrativos:

$ gunzip examples/letter.tex.gz 
gzip: examples/letter.tex: Permission denied

Embora uma solução para isso seja a cada usuário duplicar cada item em seu diretório inicial apenas para lê-lo, esse arranjo dificilmente parece propício à navegação regular.

Como as pessoas normais leem esta documentação?

Não estou inclinado a acreditar que se espera que o usuário típico instale e mantenha um servidor da Web apenas para ler a documentação de texto local.

A maioria foi dita e bem explicada pelo jgbelacqua para uso no terminal. Basta adicionar isso para pessoas que estão em um gerenciador de desktop:

Em uma área de trabalho gráfica (aqui GNOME), a maneira mais fácil de ler documentos /usr/share/docé (clique duas vezes) abrir os arquivos compactados com seu gerenciador de arquivos padrão (aqui File Roller), de onde você pode (clicar duas vezes) abrir e lê-los em seu editor padrão (aqui Gedit). Não são necessárias permissões de gravação, desde que você não descompacte os arquivos.

Há pelo menos dois problemas aqui:

1. lendo os arquivos .gz sem dor
2. permissões nos diretórios
3. (opcional para arquivos tex)

Para o número 1 , existem vários aplicativos que lidam perfeitamente com os arquivos compactados em gzip. Um casal que você poderia usar é lesse vim.

 less README.gz 
 vim -R README.Debian.gz
 view Important.bits.gz

viewé um apelido para vim -R, que apenas diz para abrir o arquivo somente leitura.

Antigamente, antes de instalar menos no meu sistema, eu usava gzcate canalizava a saída para outro utilitário. Aparentemente, ele só é chamado zcatagora no Ubuntu, mas você o usaria assim, por exemplo:

 /usr/share/doc/xpdf$ zcat changelog.Debian.gz  | more

O zcat ainda está disponível, e usá-lo para canalizar o conteúdo compactado em algum lugar pode ser útil em alguns casos. (Para situações com arquivos .bz2, bzcatestá disponível.)

Na segunda posição , todos os arquivos que eu vi em / usr / share / doc estão em diretórios com outras permissões + rx, o que significa que todos os usuários podem pesquisar os diretórios (por exemplo, listar o conteúdo) e ler os arquivos. O que você não pode fazer (já que apenas o root possui permissão de gravação por padrão) é criar arquivos. Como você está tentando descompactar esse diretório, imagino que ele esteja lhe dando permissão negada porque você leu, mas não tem permissão de gravação por padrão.

Para o número 3, acho que você usa arquivos .tex mais do que eu. Mas aqui está uma maneira de lidar com eles sem copiar para casa ou para um arquivo temporário. Para isso, você criará um pipe nomeado, mas poderá reutilizá-lo para outras necessidades de processamento e tubulação tex. Deve ser assim:

• zcat ou gzcat o texto
• ... e canalize isso para o seu processador TeX
• ... e envie isso para o Named Pipe (aqui, eu vou chamá-lo pipey)
• ... e, em uma tela separada, pegue sua saída do pipey
• ... e envie para um processo de exibição em dvi.

Obviamente, você pode alterar essas etapas se usar utilitários diferentes ou melhores que os aqui.

Meu exemplo usará o mkfifoutilitário para criar o pipe nomeado pipey,. O arquivo de destino a ser processado é /usr/share/doc/gdb/refcard.tex.gz. Você precisará de duas linhas de comando do shell disponíveis (via terminal, Alt + F2 ou, no entanto).

Você digitará o terminal um:

mkfifo pipey

Agora você tem um pipe nomeado persistente. Você pode usar ls -lpara espiar.

zcat /usr/share/doc/gdb/refcard.tex.gz | tex > pipey

Observe que esse comando não retornará até que você faça algo com a saída que foi para o pipe nomeado.

Agora, no terminal dois, você digitará: tex pipey | xdvi

E funciona (bem, aqui de qualquer maneira). O processo pode ser refinado para obter resultados mais bonitos, mas se você estiver procurando por produtos rápidos e relativamente sem bagunça, essa é uma maneira de fazê-lo.

Talvez seja tarde demais para responder, mas eu encontrei a melhor solução (facilidade de uso e integridade)

• Instalar dwww

Um sistema Linux típico possui documentação em vários formatos (páginas de manual, arquivos de informações, READMEs etc.). O dwww torna possível acessar todos eles pela mesma interface, um navegador WWW. Isso facilita o uso da documentação.

dwww é uma interface web para toda a documentação on-line em um sistema Debian. Ele cria algumas páginas da web que listam todos os documentos instalados e converte todos os documentos em HTML. A conversão é feita quando o usuário solicita o documento.

• Ative o módulo CGI, que não é mais ativado por padrão no Ubuntu / Apache recente:

  sudo a2enmod cgi
  sudo service apache2 restart
  

• Abra seu navegador e aponte para: http: // localhost / dwww /

• Feito!

Todas as suas infopáginas, manpáginas, /usr/share/docarquivos e descrição do pacote em um único local! Seu site de documentação pessoal!

gunzip file.gztentativas para descomprimir file.gza file, remoção file.gz. É por isso que você recebe um erro "Permissão negada", não tem permissão para escrever /usr/share/doc. Para obter o conteúdo de um arquivo, use gunzip -c file.gzou zcat file.gz.

A leitura de arquivos de texto compactados com gzip pode ser feita com zless. Como os nomes podem sugerir, é apenas less, mas para arquivos compactados com gzip.

Exemplo de uso:

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

O .gzsufixo também pode ser omitido:

zless /usr/share/doc/bash/NEWS

Primeiro instale o apache2

sudo apt-get install apache2 apache2-doc  

apache2-docé o caso especial aqui. Ele permite que você navegue na sua documentação /usr/share/doc/através do seu navegador da web. para lá http://localhost/doc/.

Isso não funciona direito embora. Você precisa alterar a configuração do Apache para descomprimir e mostrar os arquivos * .gz como texto sem formatação.

Postei no Stack Overflow para obter uma maneira de usar o Apache para mostrar o conteúdo dos documentos * .gz no /usr/share/doc/diretório. Foi isso que foi publicado como possível solução.

Aqui estão essas instruções em breve. Ele informa ao Apache como lidar com arquivos .gz para processá-los como texto sem formatação e enviá-los para o navegador como texto sem formatação.

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

Vá para a parte inferior do arquivo, encontre a seção com Alias /doc/ "/usr/share/doc/" e altere para que fique assim.

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>   

Em seguida, reinicie o Apache:

sudo apache2ctl restart   

Você não deve ler arquivos .tex! Ele está no formato humano e legível, mas foi projetado para ser processado antes da gravação. Você pode usar a ferramenta tex2pdf para convertê-lo em .pdf.