Originalmente desenvolvido para a distribuição Debian e posteriormente portado para distribuições *Ubuntu, o pacote
dwww (abreviação de "Debian WWW") possibilita acessar as páginas manuais (os manuais que compõem a documentação do sistema Linux e que, em inglês, são denominados
manpages) diretamente no navegador web (browser), bastando para tanto acessar
http://localhost/dwww/index.html - e isso torna o acesso e a leitura das
manpages muito mais fácil, rápida, prática, versátil e confortável.
No entanto, pelo menos na versão
1.13.1, dois problemas ocorrem durante a instalação do
dwww:
1) O módulo CGI do servidor web Apache não é ativado, embora a ativação dele seja necessária para o correto funcionamento do
dwww, tendo em vista que o
dwww essencialmente cria um website baseado em CGI (páginas dinamicamente geradas a partir de scripts) e necessita do servidor web Apache instalado, ativo (em execução) e com suporte a CGI ativado, para que o Apache possa executar esse website do
dwww a partir de um servidor virtual; e
2) Contém um erro de grafia no parâmetro
Last modified do script
dwww-convert, o que impossibilita o funcionamento do módulo CGI do Apache, quando esse módulo está ativado.
É graças ao problema
1 que qualquer tentativa de acesso ao
dwww fará com que o navegador web mostre a seguinte mensagem de erro:
Not Found
The requested URL /cgi-bin/dwww was not found on this server.
...e é graças ao problema
2 que, quando o problema
1 for resolvido (e, portanto, o
dwww estiver funcionando), qualquer tentativa de acessar uma página manual via
dwww fará o navegador web mostrar uma mensagem de erro que começa assim:
Internal Server Error
The server encountered an internal error or misconfiguration and was unable to complete your request.
Para resolver o problema 1, abra uma janela do emulador de terminal do shell Linux e execute este supercomando:
sudo a2enmod cgid ; sudo service apache2 restart
...que instruirá o servidor Apache a ativar o
cgid, que é o
daemon (serviço de ativação automática) do módulo CGI, e em seguida reiniciar a si mesmo, de modo que essa ativação do CGI surta efeito no servidor Apache.
Para resolver o problema 2, retorne à janela do emulador de terminal do shell Linux e execute este supercomando:
sudo sed -i -e 's|Last modified: |Last-modified: |' "/usr/sbin/dwww-convert" ; sudo service apache2 restart
...que renomeará o parâmetro
Last modified para
Last-modified, dentro do script
dwww-convert, e em seguida reiniciará o servidor Apache, para que essa modificação surta efeito. Por incrível que pareça, essa pequena diferença de grafia do parâmetro é a culpada pelo problema
2.
Uma vez sanados os dois problemas acima, o
dwww deverá funcionar normalmente.
Nota de rodapé:Caso os comandos da dica acima não tenham resolvido o problema, certifique-se de que o Apache esteja instalado e em execução. Você pode desinstalar o Apache e o dwww, em seguida instalá-los novamente e então colocá-los em execução por intermédio deste supercomando, a ser executado no terminal do shell:
sudo apt-get purge apache2 dwww -y ; sudo apt-get update ; sudo apt-get check ; sudo apt-get autoremove -y ; sudo apt-get clean ; sudo apt-get install apache2 dwww --reinstall -y ; sudo service apache2 stop; sudo service apache2 start
...e então experimente repetir os comandos da dica acima, para se certificar de que os problemas
1 e
2 não ocorram após o Apache e o dwww serem reinstalados.