[RFR] wml://webwml/portuguese/doc/index.wml
--
Augusto Cezar Amaral <augusto.cezar@gmail.com>
#use wml::debian::template title="Documentação"
#use wml::debian::translation-check translation="1.60" translation_maintainer="Gustavo Noronha"
<p>Uma parte importante de um sistema operacional é a documentação, os
manuais técnicos que descrevem o uso e funcionamento dos programas.
Como parte de seus esforços para criar um sistema operacional livre
de alta qualidade, o Projeto Debian está se esforçando para fornecer
a todos os seus usuários documentação apropriada em uma forma facilmente
acessível.</p>
<p>Se você é <em>novato</em> no Debian, nós recomendamos que comece lendo
as <a href="$(HOME)/releases/stable/releasenotes">Notas de Lançamento</a>,
o <a href="$(HOME)/releases/stable/installmanual.wml">Guia de Instalação</a>
e o <a href="manuals/debian-faq/">FAQ do Debian GNU/Linux</a> antes
de fazer sua primeira instalação do Debian, esses documentos contêm respostas
para várias perguntas e irão ajudá-los a trabalhar com seu novo sistema Debian.
Após a instalação, talvez você queira dar uma olhada na
<a href="manuals/reference/">Referência Debian</a> e em outros
<a href="user-manuals">manuais</a>.
Outra boa fonte de informação para novos usuários é o
<a href="http://wiki.debian.org/";>Debian Wiki</a>.
<p>Se você quer começar a desenvolver pacotes para o Debian, nós
recomendamos que dê uma olhada no <a href="manuals/maint-guide/">Guia dos
Novos Mantenedores Debian</a> e, em seguida, na
<a href="manuals/developers-reference">Referência do Desenvolvedor Debian</a>.
Depois você pode ler outros <a href="devel-manuals">manuais para desenvolvedores</a>.
<p>A maior parte da documentação incluída no Debian foi escrita para o
GNU/Linux em geral. Há também alguma documentação escrita especificamente
para o Debian. Esses documentos vêm nas categorias básicas abaixo:
<ul>
<li><a href="#manuals">manuais</a>
<li><a href="#howtos">HOWTOs</a>
<li><a href="#faqs">FAQs</a>
<li><a href="#other">outros documentos mais curtos</a>
</ul>
<H2><a name="manuals">Manuais</a></H2>
<p>Os manuais lembram livros porque eles descrevem tópicos importantes
compreensivelmente.
<h3>Manuais específicos do Debian</h3>
<table><tr valign=top>
<td width="50%">
<p><strong><font size="+1">M</font>anuais do usuário</strong>
<br>
<ul>
<li><a href="user-manuals#faq">FAQ do Debian GNU/Linux</a>
<li><a href="user-manuals#install-sarge">Guia de Instalação Debian</a>
<li><a href="user-manuals#relnotes">Notas de Lançamento do Debian</a>
<li><a href="user-manuals#quick-reference">Referência Debian</a>
<li><a href="user-manuals#apt-howto">Como Usar o APT</a>
<li><a href="user-manuals#dselect">Documentação do dselect para Iniciantes</a>
<li><a href="user-manuals#users-guide">Guia do Usuário (da Progeny)</a>
<li><a href="user-manuals#usersguide">Guia do Usuário Debian Linux</a>
<li><a href="user-manuals#euro-support">Suporte ao Euro no Debian GNU/Linux</a>
<li><a href="user-manuals#java-faq">FAQ do Debian GNU/Linux e Java</a>
<li><a href="user-manuals#securing">Manual de Segurança Debian</a>
<li><a href="user-manuals#linuxcookbook">O Livro de Receitas do Linux (The Linux Cookbook)</a>
</ul>
</td>
<td width="50%">
<p><strong><font size="+1">M</font>anuais do desenvolvedor</strong>
<br>
<ul>
<li><a href="devel-manuals#policy">Manual de Políticas Debian</a>
<li><a href="devel-manuals#devref">Referência do Desenvolvedor Debian</a>
<li><a href="devel-manuals#maint-guide">Guia dos Novos Mantenedores Debian</a>
<li><a href="devel-manuals#dpkgint">Manual Interno do dpkg</a>
<li><a href="devel-manuals#menu">Sistema de Menu Debian</a>
<li><a href="devel-manuals#i18n">Introdução à i18n</a>
</ul>
<p><strong><font size="+1">M</font>anuais diversos</strong>
<br>
<ul>
<li><a href="misc-manuals#history">História do Projeto Debian</a>
<li><a href="misc-manuals#linuxmag">Revistas Linux</a>
<li><a href="misc-manuals#markup">Manual de Debiandoc-SGML</a>
<li><a href="misc-manuals#sgml-howto">HOWTO do Debian SGML/XML</a>
</ul>
</td>
</tr></table>
<p>A lista completa de manuais do Debian e outros documentos pode ser
encontrada nas páginas do <a href="ddp">Projeto de Documentação Debian</a>.
<p>Há também vários manuais escritos para o Debian GNU/Linux orientados para
os usuários, disponíveis como <a href="books">livros impressos</a>.
<p>Na seção de Documentação da <a href="http://debian-br.alioth.debian.org/";>página
do Debian-BR</a> há vários documentos que podem ajudar os novatos a se habituarem
com o novo sistema. Entre eles estão o
<a href="http://debian-br.alioth.debian.org/view.php?doc=pratico";>Guia Prático para
o Debian GNU/Linux</a> e o
<a href="http://debian-br.alioth.debian.org/view.php?doc=apt-howto-pt_BR";>Como Usar
o APT</a>.
<h3>Manuais para o GNU/Linux em geral</h3>
<p>Alguns dos documentos e manuais mais populares do GNU/Linux são
<a href="http://www.tldp.org/LDP/gs/gs.html";>Linux Installation and
Getting Started</a>,
<a href="http://www.ibiblio.org/pub/Linux/docs/linux-doc-project/users-guide/";>
Linux User's Guide</a>,
<a href="http://www.tldp.org/LDP/nag/nag.html";>Network Administrator's
Guide</a>,
<a href="http://www.tldp.org/LDP/sag/";>System Administrator's
Guide</a>, e outros.
<P>A documentação do GNU/Linux é coordenada pelos esforços do
<a href="http://www.tldp.org/";>Linux Documentation Project</a> (LDP).
Você pode encontrar o conjunto completo de manuais LDP
<a href="http://www.tldp.org/guides.html";>na página web deles</a>,
além de muitos outros documentos, tanto em forma eletrônica quanto
impressa.
<H2><a name="howtos">HOWTOs</a></H2>
<p>Os <a href="http://www.tldp.org/docs.html#howto";>documentos HOWTO</a>,
como diz o nome deles, descreve <em>como fazer</em> alguma coisa,
e eles normalmente cobrem um assunto mais específico.
<p>Alguns dos HOWTOS mais importantes do GNU/Linux:
<ul>
<li><a href="http://www.tldp.org/HOWTO/Hardware-HOWTO/";>Hardware
Compatibility HOWTO</a>,
<li><a href="http://www.tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/";>
Unix and Internet Fundamentals HOWTO</a>,
# currently not available
# <li><a href="http://www.tldp.org/HOWTO/Kernel-HOWTO.html";>Kernel
# HOWTO</a>,
<li><a href="http://www.tldp.org/HOWTO/Filesystems-HOWTO.html";>Filesystems
HOWTO</a>,
<li><a href="http://www.tldp.org/HOWTO/Config-HOWTO/";>Configuration
HOWTO</a>,
<li><a href="http://www.tldp.org/HOWTO/Net-HOWTO/";>Networking
HOWTO</a>,
<li>and <a href="http://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html";>
many others</a>.
</ul>
<p>Eles estão também disponíveis para instalação na sua máquina nos pacotes
<a href="http://packages.debian.org/stable/doc/doc-linux-text";>
doc-linux-text</a> e
<a href="http://packages.debian.org/stable/doc/doc-linux-html";>
doc-linux-html</a>.
Há também <a href="http://ldp-br.conectiva.com.br/documentos/comofazer";>HOWTOs
traduzidos para o português</a> (chamados de Como Fazer). Esses são produzidos
com o esforço coordenado pelo <a href="http://ldp-br.conectiva.com.br";>LDP-BR</a>.
Eles estão disponíveis nos pacotes
<a href="http://packages.debian.org/stable/doc/doc-linux-text";>
doc-linux-text-pt</a> e
<a href="http://packages.debian.org/stable/doc/doc-linux-html";>
doc-linux-html-pt</a>.
# TODO: falar do projeto de documentação português!
<H2><a name="faqs">FAQs</a></H2>
<p>FAQ significa <em>frequently asked questions</em> (perguntas feitas
frequentemente). Um FAQ é um documento que responde a essas perguntas.
<p>O <a href="http://www.tldp.org/FAQ/Linux-FAQ/";>Linux FAQ</a>
contém informações sobre o GNU/Linux em geral.</p>
<p>Perguntas relacionadas especificamente ao Debian são respondidas
na <a href="FAQ/">Debian FAQ</a>. Também está disponível uma <a
href="../CD/faq/">FAQ sobre as imagens de CD/DVD do Debian</a>.</p>
<p>Por favor, veja o <a href="http://www.tldp.org/FAQ/";>índice de FAQs do
LDP</a> para mais informações.
<H2><a name="other">Outros documentos menores</a></H2>
<p>Os documentos seguintes incluem instruções mais rápidas e pequenas:
<dl>
<dt><strong><a href="http://www.tldp.org/docs.html#man";>páginas de manual</a></strong></dt>
<dd>Tradicionalmente, todos os programas Unix são documentados com
<em>páginas de manual</em>, manuais de referência estão disponíveis
pelo comando <tt>man</tt>. Eles não são para novatos, normalmente.
</dd>
<dt><strong>arquivos README variados</strong></dt>
<dd>Os arquivos <em>leia me</em> são comuns, também -- eles são
arquivos de texto simples que descrevem um item único, normalmente
um pacote. Você pode achar muitos deles nos subdiretórios de
<tt>/usr/share/doc</tt> em seu sistema Debian.
</dd>
</dl>
# TODO: the link to installguide is probably misplaced
<p>Você pode estar interessado no
<a href="../releases/potato/installguide/">guia de instalação para o Debian
2.2</a>, que é um tutorial online.
<hrline>
<P>Se você conferiu os recursos acima e ainda não achou respostas para
suas perguntas ou soluções para os seus problemas sobre o Debian, dê uma
olhada na nossa <A HREF="../support">página de suporte</A>.
Reply to: