<para>O sistema de ajuda do &kde; está desenhado para tornar acessíveis os sistemas de ajuda do &UNIX; (o <application>man</application> e o <application>info</application>), assim como a documentação nativa do &kde; (&XML;). </para>
<para>Todas as aplicações de base do &kde; vêm completamente documentadas, graças aos esforços da equipa de documentação. Se quiser ajudar, escreva para o coordenador de Documentação, a Lauri Watts, em <email>lauri@kde.org</email> para mais informações. Não é necessária experiência, apenas entusiasmo e paciência. </para>
<para>Se quiser ajudar a traduzir a documentação do &kde; para a sua língua nativa, o coordenador de traduções é o Thomas Diehl, <email>thd@kde.org</email>; ele também iria agradecer a ajuda. Podem ser encontradas mais informações, incluindo os coordenadores de cada equipa de tradução, na <ulink url="http://i18n.kde.org">página Web de internacionalização</ulink>, na secção de <link linkend="contact">Contactos</link> deste documento. </para>
<para>O &khelpcenter; é parte integrante da instalação de base do &kde;, e é instalado com todas as cópias do &kde;. Pode ser encontrado no pacote 'tdebase' e está disponível em &kde-ftp; ou no pacote 'tdebase' do seu sistema operativo. </para>
<para>O &khelpcenter; pode ser chamado de várias maneiras: </para>
<variablelist>
<varlistentry>
<term>A partir do menu <guimenu>Ajuda</guimenu></term>
<listitem>
<para>A forma mais comum será, provavelmente, a partir de uma aplicação. Escolha a <menuchoice><guimenu>Ajuda</guimenu> <guimenuitem>Conteúdo</guimenuitem></menuchoice> para abrir o ficheiro de ajuda dessa aplicação, na página de conteúdo. </para>
<para>Escolha o <guiicon>K</guiicon> grande no seu painel e seleccione a <guimenuitem>Ajuda</guimenuitem> para abrir o &khelpcenter;, iniciando na página de boas-vindas por omissão. </para>
<para>O &khelpcenter; pode ser iniciado com um &URL; para mostrar um ficheiro. Foram também adicionados &URL;s para as páginas do <command>info</command> e do <command>man</command>. Podê-las-á usar da seguinte forma: </para>
<para>A interface do &khelpcenter; consiste em duas áreas de informação. </para>
<para>A barra de ferramentas e os menus são explicados posteriormente em <xref linkend="menu-and-toolbar-ref"/>. </para>
<para>Os documentos contêm as suas próprias ferramentas de navegação, o que lhe permite tanto mover sequencialmente por um documento, usando as ligações <guilabel>Próximo</guilabel>, <guilabel>Anterior</guilabel> e <guilabel>Raiz</guilabel>, como mover de uma forma menos estruturada, usando as hiperligações. </para>
<para>As ligações podem levá-lo para outras partes do mesmo documento ou para um documento diferente, podendo usar para tal os ícones <guiicon>Recuar</guiicon> (Seta a apontar para a esquerda) ou <guiicon>Avançar</guiicon> (Seta a apontar para a direita) da barra de ferramentas, de modo a percorrer os documentos que viu nesta sessão. </para>
<para>As duas áreas mostram o conteúdo do sistema de ajuda e os próprios ficheiros de ajuda, à esquerda e à direita, respectivamente. </para>
<title>A Área de <guilabel>Conteúdo</guilabel></title>
<para>A área de <guilabel>Conteúdo</guilabel> do &khelpcenter; é mostrada à esquerda na janela. Como deverá estar à espera, pode mover a barra de separação, para ter a certeza que consegue ler o conteúdo de ambas as áreas confortavelmente. </para>
<para>A área <guilabel>Conteúdo</guilabel> está, por sua vez, dividida em duas secções, contendo uma delas um <link linkend="contents-menu">menu</link> que mostra toda a informação de ajuda que o &khelpcenter; conhece, e contendo a outra o <link linkend="kde-glossary">glossário</link> de termos. </para>
<para>O guia de introdução rápida ao &kde;. Contém uma viagem à interface do &kde;, passando por ajudas específicas e sugestões de como trabalhar de forma mais inteligente com o &kde;. </para>
<para>O Manual de Utilizador do &kde; é uma exploração em detalhe do &kde; e inclui a instalação, a configuração, a personalização e a utilização. </para>
<para>A documentação das aplicações nativas do &kde;. Todas as aplicações do &kde; têm a documentação no formato &XML;, e são convertidas para <acronym>HTML</acronym> quando as vê. Esta secção lista todas as aplicações do &kde; com uma breve descrição e uma ligação para a documentação completa da aplicação. </para>
<para>As aplicações são mostradas numa estrutura em árvore que reflecte a estrutura por omissão do menu <guimenu>K</guimenu>, o que facilita a localização da aplicação que procura. </para>
<para>As páginas de manual do &UNIX; são o formato de documentação 'online' tradicional dos sistemas &UNIX;. A maioria dos programas do seu sistema terão uma página do 'man'. Para além disso, as páginas do 'man' existem para as funções de programação e formatos de ficheiros. </para>
<para>A documentação de TeXinfo é usada por muitas aplicações da &GNU;, incluindo o <command>gcc</command> (o compilador de C/C++), o <command>emacs</command>, entre muitos outros. </para>
<para>As páginas do 'man' são as páginas de manual padrão do &UNIX;, e vêm a ser usadas há muitos anos em vários sistemas operativos. São extremamente descritivas e são o melhor local para obter informações sobre praticamente todos os comandos e aplicações do &UNIX;. Quando as pessoas dizem <quote>RTFM</quote>, o manual a que se referem são, muitas das vezes, as páginas do 'man'.</para>
<para>As páginas do 'man' não são perfeitas. Tendem a ser detalhadas, mas também são muito técnicas, quase sempre escritas pelos programadores e para os programadores. Em alguns dos casos isso torna-as pouco amigáveis, se não impossíveis, para muitos utilizadores compreendê-las. São, todavia, a melhor fonte de informação sólida sobre a maioria das aplicações de linha de comandos, e, em muitos dos casos, a única.</para>
<para>Se já alguma vez se questionou acerca do número que as pessoas indicam, como por exemplo 'man(1)', este indica a secção do manual onde o item está. Verá que o &khelpcenter; usa os números para dividir as diversas páginas de manual nas suas próprias secções, tornando mais fácil localizar a informação que procura, se estiver apenas a navegar.</para>
<para>Também estão disponíveis as páginas do Info, que pretendem ser uma substituição das páginas do 'man'. O criador de algumas das aplicações já não actualiza mais as páginas de 'man'; por isso, se existir tanto uma página do 'man' como do 'info', é mais provável que seja a do 'info' a mais recente. A maioria das aplicações tem uma ou outra, todavia. Se a aplicação que procura é um utilitário da &GNU;, é mais provável que exista uma página do 'info' do que uma do 'man'.</para>
<title>Navegar pelas páginas do <application>Info</application></title>
<para>Os documentos do 'info' organizam-se hierarquicamente, onde cada página é chamada de nó. Todos os documentos do 'info' têm um nó de <guilabel>Topo</guilabel>, isto é, a página de abertura. Você pode voltar ao <guilabel>Topo</guilabel> de um documento do 'info' se carregar no <guilabel>Topo</guilabel>.</para>
<para>O <guibutton>Anterior</guibutton> e o <guibutton>Seguinte</guibutton> são usados para passar para a página anterior/seguinte no nível actual da hierarquia.</para>
<para>Ao carregar num item de menu dentro de um documento, irá passar para um nível inferior da hierarquia. Pode voltar para cima na hierarquia se carregar em <guibutton>Cima</guibutton>.</para>
<para>O 'man' é tratado de forma semelhante ao 'info', onde o índice da secção é o nó de Topo e cada página corresponde ao nível inferior. Os itens do 'man' correspondem a uma página.</para>
<para>O glossário oferece um ponto de referência rápido, onde pode procurar as definições das palavras que possam não ser familiares para si. Estas podem ir das aplicações e tecnologias específicas do &kde; até aos termos de computação genéricos do &UNIX;. </para>
<para>Na área esquerda, verá uma árvore com duas opções. <guilabel>Alfabeticamente</guilabel> ou <guilabel>Por tópico</guilabel>. Ambas contêm as mesmas opções, ordenadas de diferente forma, para lhe permitir encontrar o item de interesse mais depressa. </para>
<para>O &khelpcenter; tem uma interface minimalista, o que lhe permite concentrar-se mais em obter a ajuda em vez de aprender como usar o navegador de ajuda. </para>
<para>Muda a codificação da página actual. Normalmente, a configuração <guimenuitem>Auto</guimenuitem> deve ser suficiente mas, se estiver a ter problemas ao ver as páginas escritas noutras línguas que não o Inglês ou o Português, pode ter de escolher uma codificação específica neste menu. </para>
<para>No fim do menu <guimenu>Ir</guimenu>, pode encontrar uma lista com o histórico das últimas páginas que viu. Ao seleccionar uma, irá directamente de volta para essa página.</para>
