[ Resumo ] [ Nota de Copyright ] [ Conteúdo ] [ próximo ]

Guia Prático para o Debian GNU/Linux
Capítulo 1 A Documentação do Debian


1.1 O Sistema de Documentação (doc-base)

O Debian possui um sistema centralizado de documentação. O desenvolvedor do pacote deve "registrar" sua documentação nesse sistema e assim torná-la disponível para o sistema.

O doccentral é um dos programas que têm como função levar o usuário diretamente à documentação, usando o navegador especificado pelo usuário como padrão.

Antes de usá-lo é necessário instalar o pacote doc-central. Veja Como instalar pacotes, Capítulo 2 para maiores informações. Instale também o pacote doc-base.

Para iniciá-lo, basta digitar em um prompt shell:

     $ doccentral

O doc-central procura na variável de ambiente $BROWSER. Se não a encontra usa o navegador que encontrar. Por exemplo, para definir que o navegador a ser utilizado seja o galeon, coloca-se:

     $ export BROWSER=galeon

no arquivo /home/usuário/.bash_profile e/ou no arquivo /home/usuário/.bashrc.

Assim, quando o doc-central for executado iniciará o galeon para navegar na documentação Debian.


1.2 Documentação do Debian via www

O dwww cria um ambiente www para toda a documentação disponível no sistema. Você pode até mesmo ler as manpages através de um browser, o que torna sua leitura extremamente mais agradável.

Para usá-lo instale o pacote dwww e, também o doc-base para ter melhores resultados, já que nem todos os pacotes se registram diretamente com o dwww.

Há duas maneiras de se usar o dwww: como um índice, no qual se navega até achar o que quer, ou como uma consulta rápida à toda a documentação de um pacote. Para ver o índice basta rodar:

     $ dwww

Para ver toda a documentação disponível para um pacote, faça:

     $ dwww pacote

Há outros tipos de programas para acessar a documentação indexada pelo doc-base, o doc-central por exemplo, que também usa um servidor http.


1.3 Documentação Online

O Debian possui ampla documentação na Internet. A principal fonte de documentação é o site do Debian: http://www.debian.org.

Há documentação disponível em várias línguas e existem vários projetos de localização do Debian. Portanto não é difícil encontrar documentação em língua local.

Para os falantes do português existe o Debian-BR, que tem ampla documentação sobre o Debian: http://debian-br.cipsga.org.br.


[ Resumo ] [ Nota de Copyright ] [ Conteúdo ] [ próximo ]
Guia Prático para o Debian GNU/Linux
1.2
Gustavo Noronha Silva kov@debian.org