[LCFC] wml://www.debian.org/doc/index.wml
Olá.
Pronto para o commit.
Abraços,
Albino
#use wml::debian::template title="Documentação"
#use wml::debian::translation-check translation="1.96" maintainer="Felipe Augusto van de Wiel (faw)"
<p>Uma parte importante de qualquer 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>
<h2>Início rápido</h2>
<p>Se você é <em>novato</em> no Debian, nós recomendamos que comece lendo
primeiro:</p>
<ul>
<li><a href="$(HOME)/releases/stable/installmanual">Guia de Instalação</a></li>
<li><a href="manuals/debian-faq/">FAQ do Debian GNU/Linux</a></li>
</ul>
<p>Tenha estes à mão quanto fizer sua primeira instalação Debian, eles
provavelmente responderão a várias questões e te ajudarão a trabalhar com
seu novo sistema Debian. Posteriormente você pode querer ir para:</p>
<ul>
<li><a href="manuals/debian-reference/">Referência Debian</a></li>
<li><a href="$(HOME)/releases/stable/releasenotes">Notas de Lançamento</a>,
para pessoas que estão fazendo uma atualização</li>
<li><a href="http://wiki.debian.org/";>Wiki do Debian</a>, uma boa fonte de
informação para os recém chegados</li>
</ul>
<p>Finalmente, certifique-se de imprimir e ter em mãos o <a
href="http://www.debian.org/doc/manuals/refcard/refcard";>Cartão de Referência
Debian GNU/Linux</a>, uma listagem dos mais importantes comandos para
sistemas Debian.</p>
<p>Se você quer começar a desenvolver pacotes para o Debian, nós
recomendamos que você veja:</p>
<ul>
<li><a href="manuals/maint-guide/">Guia de Novos Mantenedores Debian</a></li>
<li><a href="manuals/developers-reference/">Referência do Desenvolvedor Debian</a></li>
</ul>
<p>Há uma quantia razoável de outras documentações listadas abaixo.</p>
<h2>Tipos de documentação</h2>
<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:</p>
<ul>
<li><a href="#manuals">manuais</a></li>
<li><a href="#howtos">HOWTOs</a></li>
<li><a href="#faqs">FAQs</a></li>
<li><a href="#other">outros documentos mais curtos</a></li>
</ul>
<h3 id="manuals">Manuais</h3>
<p>Os manuais lembram livros, porque eles descrevem tópicos importantes
compreensivelmente.</p>
<h3>Manuais específicos do Debian</h3>
<div class="line">
<div class="item col50">
<h4>Manuais do usuário</h4>
<ul>
<li><a href="user-manuals#faq">FAQ do Debian GNU/Linux</a></li>
<li><a href="user-manuals#install">Guia de Instalação Debian</a></li>
<li><a href="user-manuals#relnotes">Notas de Lançamento do Debian</a></li>
<li><a href="user-manuals#quick-reference">Referência Debian</a></li>
<li><a href="user-manuals#securing">Manual de Segurança Debian</a></li>
<li><a href="user-manuals#java-faq">FAQ do Debian GNU/Linux e Java</a></li>
</ul>
</div>
<div class="item col50 lastcol">
<h4>Manuais do desenvolvedor</h4>
<ul>
<li><a href="devel-manuals#policy">Manual de Políticas Debian</a></li>
<li><a href="devel-manuals#devref">Referência do Desenvolvedor Debian</a></li>
<li><a href="devel-manuals#maint-guide">Guia dos Novos Mantenedores Debian</a></li>
<li><a href="devel-manuals#packaging-tutorial">Introdução ao empacotamento Debian</a></li>
<li><a href="devel-manuals#menu">Sistema de Menu Debian</a></li>
<li><a href="devel-manuals#i18n">Introdução à i18n</a></li>
</ul>
<h4>Manuais diversos</h4>
<ul>
<li><a href="misc-manuals#history">História do Projeto Debian</a></li>
<li><a href="misc-manuals#markup">Manual de Marcação Debiandoc-SGML</a></li>
<li><a href="misc-manuals#sgml-howto">HOWTO de SGML/XML do Debian</a></li>
</ul>
</div>
</div>
<p class="clr">A lista completa de manuais do Debian e outros documentos
pode ser encontrada nas páginas web do <a href="ddp">Projeto de Documentação
Debian</a>.</p>
<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>
<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>
<p>A documentação do 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.</p>
<h3 id="howtos">HOWTOs</h3>
<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>
<p>Alguns dos HOWTOS mais importantes do Linux:</p>
<ul>
<li><a href="http://www.tldp.org/HOWTO/Hardware-HOWTO/";>Hardware
Compatibility HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Unix-and-Internet-Fundamentals-HOWTO/";>\
Unix and Internet Fundamentals HOWTO</a>,</li>
# currently not available
# <li><a href="http://www.tldp.org/HOWTO/Kernel-HOWTO.html";>Kernel
# HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Filesystems-HOWTO.html";>Filesystems
HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Config-HOWTO.html";>Configuration
HOWTO</a>,</li>
<li><a href="http://www.tldp.org/HOWTO/Net-HOWTO/";>Networking
HOWTO</a>,</li>
<li>e <a href="http://www.tldp.org/HOWTO/HOWTO-INDEX/categories.html";>
muitos outros</a>.</li>
</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>.</p>
# TODO: make a note about the translated doc-linux-* packages...
<h2 id="faqs">FAQs</h2>
<p>FAQ significa <em>frequently asked questions</em> (perguntas feitas
freqüentemente). Um FAQ é um documento que responde a essas perguntas.</p>
<p>O <a href="http://www.tldp.org/FAQ/Linux-FAQ/";>FAQ do Linux</a>
contém informações sobre o GNU/Linux em geral.</p>
<p>Perguntas relacionadas especificamente ao Debian são respondidas
no <a href="manuals/debian-faq/">FAQ do Debian</a>. Também há separado
um <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.</p>
<h3 id="other">Outros documentos menores</h3>
<p>Os documentos seguintes incluem instruções mais rápidas e pequenas:</p>
<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
através do comando <tt>man</tt>. Eles normalmente não são para novatos.
Você pode buscar e ler as páginas de manual disponíveis no Debian
em <a href="http://manpages.debian.net/cgi-bin/man.cgi";>http://manpages.debian.net/</a>.
</dd>
<dt><strong><a href="http://www.gnu.org/software/texinfo/manual/texinfo/html_node/index.html";>arquivos info</a></strong></dt>
<dd>Muitos programas GNU são documentados através de <em>arquivos info</em>
ao invés de páginas de manual. Esses arquivos incluem informação
detalhada sobre o programa, opções e exemplos de uso e estão
disponíveis através do comando <tt>info</tt>
</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. Cada pacote de software
tem um subdiretório com seus próprios arquivos leia me ("read me"), e pode
também incluir exemplos de configuração. Note que, para programas grandes,
a documentação é normalmente fornecida em um pacote separado (de mesmo nome
do pacote original, mas terminando com <em>-doc</em>).
</dd>
<dt><strong>cartões de referência rápida</strong></dt>
<dd>
<p>Cartões de referência rápida são resumos bem curtos de um certo
(sub)sistema. Usualmente, um cartão de referência fornece os comandos
mais usados em uma única folha de papel. Algumas coleções e cartões de
referência notáveis incluem:</p>
<dl>
<dt><a href="http://www.debian.org/doc/manuals/refcard/refcard";>Cartão de
Referência Debian GNU/Linux</a></dt>
<dd>Esse cartão, que pode ser impresso em uma única folha de papel,
fornece uma lista dos comandos mais importantes e é uma boa
referência para novos usuários do Debian que querem se
familiarizar com eles. É necessário, pelo menos, um conhecimento
básico de computadores, arquivos, diretórios e linha de comando.
usuários novatos podem querer ler primeiro a
<a href="user-manuals#quick-reference">Referência Debian</a>.
</dd>
<dt><a href="http://refcards.com/";>refcards.com</a></dt>
<dd>Uma coleção de cartões de referência rápidos voltados
principalmente para Software de Código Fonte Aberto e Livre</dd>
<dt><a href="http://www.digilife.be/quickreferences/quickrefs.htm";>Cartões de Referência Rápidos</a></dt>
<dd>Uma coleção de cartões de referência rápidos para os programas e
linguagens de programação mais populares</dd>
</dl>
</dd>
</dl>
<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>.</p>
Reply to: