2002-02-03
0.08.00

# Manual do Usuário do Sistema de Ajuda do &kde;

## Sistema de Ajuda do &kde;

O sistema de ajuda do &kde; está desenhado para tornar acessíveis os sistemas de ajuda do &UNIX; (o man e o info), assim como a documentação nativa do &kde; (&XML;).

Todos os aplicativos de base do &kde; vêm completamente documentados, graças aos esforços da equipe de documentação. Se quiser ajudar, escreva para o coordenador da Documentação, a Lauri Watts, em lauri@kde.org para mais informações. Não é necessária experiência, apenas entusiasmo e paciência.

Se quiser ajudar a traduzir a documentação do &kde; para o seu idioma nativo, o coordenador de traduções é o Thomas Diehl, thd@kde.org; ele também iria agradecer a ajuda. Podem ser encontradas mais informações, incluindo os coordenadores de cada equipe de tradução, no Site Web de internacionalização, na seção de Contactos deste documento.

### Instalação

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 kdebase, e está disponível em &kde-ftp; ou será encontrado no pacote kdebase do seu sistema operacional.

## Invocar Ajuda

O &khelpcenter; pode ser chamado de várias maneiras:

A partir do menu Ajuda

  A forma mais comum será provavelmente a partir de um aplicativo. Escolha Ajuda Conteúdo para abrir o arquivo de ajuda desse aplicativo, na página de conteúdo.

A partir do menu K

  Escolha o K grande no seu painel, e selecione Ajuda para abrir o &khelpcenter;, iniciando na página de boas-vindas padrão.

Do painel

  Por padrão, o painel &kicker; contém por padrão um ícone para chamar o &khelpcenter;. Novamente, é mostrada a página de boas-vindas.

Da linha de comando

  O &khelpcenter; pode ser iniciado com um &URL; para mostrar um arquivo. Foram também adicionados &URL;s para as páginas do `info` e do `man`. Você pode usá-las da seguinte forma:

  Um arquivo de ajuda de um aplicativo

    `khelpcenter` `help:/kedit`

    Abre o arquivo de ajuda do &kedit; na página de conteúdo.

  Um &URL; local

    `khelpcenter` `file:/ usr/local/src/qt/html/index.html`

  Uma página Man

    `khelpcenter` `man:/strcpy`

  Uma página Info

    `khelpcenter` `info:/gcc`

  Invocando `khelpcenter` sem parâmetros abre a janela de boas-vindas padrão.

## A interface do &khelpcenter;

A interface do &khelpcenter; consiste em duas áreas de informação.

A barra de ferramentas e os menus são explicados posteriormente em .

Os documentos contêm as suas próprias ferramentas de navegação, o que lhe permite mover quer sequencialmente por um documento, usando os links Próximo, Anterior e Raiz ou mover de uma forma menos estruturada, usando os hiperlinks.

Os links podem levar você para outras partes do mesmo documento, ou para um documento diferente, e você pode usar os ícones Recuar (Seta apontando para a esquerda) ou Avançar (Seta apontando para a direita) da barra de ferramentas para mover pelos documentos vistos numa sessão.

As duas áreas mostram o conteúdo do sistema de ajuda, e os próprios arquivos de ajuda, à esquerda e à direita respectivamente.

### A Área Conteúdo

A área Conteúdo do &khelpcenter; é mostrada à esquerda na janela. Como você deve imaginar, você pode mover a barra de separação, para ter a certeza que consegue ler o conteúdo de ambas as áreas confortavelmente.

A área Conteúdo está por sua vez dividida em duas seções, contendo uma delas um menu que mostra toda a informação de ajuda que o &khelpcenter; conhece, e contendo a outra o glossário de termos.

#### O Menu Conteúdo

O Conteúdo contém os seguintes registos padrão:

Introdução

  Bem-vindo ao &kde; - uma introdução ao Ambiente de Trabalho K.

Introdução ao &kde;

  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;.

Manual do Usuário do &kde;

  O manual de Usuário do &kde; é uma exploração em detalhe do &kde;, e que inclui a instalação, a configuração, a personalização e a utilização.

Manuais dos aplicativos

  A documentação dos aplicativos nativos do &kde;. Todas os aplicativos do &kde; têm a documentação no formato &XML;, e são convertidas para HTML quando da visualização. Esta seção lista todos os aplicativos do &kde; com uma breve descrição e um link para a documentação completa do aplicativo.

  Os aplicativos são mostradas numa estrutura em árvore que reflete a estrutura padrão do menu K, o que facilita a localização da aplicativo procurado.

Páginas de manual do Unix

  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'. Além disso, as páginas do 'man' existem para as funções de programação e formatos de arquivos.

Navegação das páginas 'info'

  A documentação de TeXinfo é usada por muitas aplicativos da &GNU;, incluindo o `gcc` (o compilador de C/C++), o `emacs`, entre muitos outros.

Tutoriais

  Tutoriais curtos, baseados nas tarefas ou informativos.

A FAQ do &kde;

  As perguntas mais frequentes sobre o &kde; e as suas respostas.

O &kde; na Web

  Links para o &kde; na Web, quer no Site Web oficial do &kde;, quer em muitos outros sites úteis.

Informação de Contatos

  Informações sobre como contactar os programadores do &kde;, e de como juntar-se às listas de correio do &kde;.

Suportar o &kde;

  Como ajudar e como se envolver no projeto.

### As seções do Man e do Info

As páginas do 'man' são as páginas de manual padrão do Unix, e vêm sendo usadas há muitos anos em vários sistemas operacionais. São extremamente descritivas e são o melhor local para obter informações sobre praticamente todos os comandos e aplicativos do &UNIX;. Quando as pessoas dizem RTFM, o manual a que se referem é muitas das vezes as páginas do 'man'.

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 usuários compreendê-las. São, todavia, a melhor fonte de informação sólida sobre a maioria dos aplicativos de linha de comando, e em muitos dos casos a única.

Se já alguma vez se questionou sobre o número que as pessoas indicam, como por exemplo man(1), este indica a seçã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 seções, tornando mais fácil localizar a informação que procura, se estiver apenas navegando.

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 alguns dos aplicativos já não atualiza 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 dos aplicativos tem uma ou outra. Se o aplicativo que procura é um utilitário da &GNU;, é mais provável que exista uma página do 'info' do que uma do 'man'.

#### Navegar pelas páginas do Info

Os documentos do 'info' organizam-se hierarquicamente, onde cada página é chamada de nó. Todos os documentos do 'info' têm um nó de Topo, isto é, a página de abertura. Você pode voltar ao Topo de um documento do info clicando em Topo.

O Anterior & o Seguinte são usados para passar para a página anterior/segunite no nível atual da hierarquia.

Ao clicar num item de menu dentro de um documento, irá passar para um nível inferior da hierarquia. Pode voltar para cima na hierarquia clicando em Cima.

O 'man' é tratado de forma semelhante ao 'info', em que o índice da seção é o nó de Topo e em que cada página se encontra no nível inferior. Os itens do 'man' correspondem a uma página.

### O glossário do &kde;

O glossário oferece um ponto de referência rápido, onde pode procurar as definições das palavras que podem não ser familiares para você. Estas podem ir dos aplicativos e tecnologias específicas do &kde; até aos termos de computação genéricos do &UNIX;.

Na área esquerda verá uma árvore com duas opções. Alfabeticamente ou Por tópico. Ambas contêm as mesmas opções, ordenadas de diferente forma, para lhe permitir encontrar o item de interesse mais depressa.

Navegue pelas árvores à esquerda, de modo a mostrar os itens por você selecionados à direita.

### Os menus e a barra de ferramentas

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.

Os ícones disponíveis para você na barra de ferramentas são os seguintes:

#### Ícones da Barra de Ferramentas

Recuar

  Vai para a página anterior que visitou.

Avançar

  Avança uma página. Este ícone só está ativo se já usou alguma vez o ícone Recuar.

Imprimir

  Imprime o conteúdo da página visível no momento.

Procurar

  Procura uma ou mais palavras na página visível no momento.

Aumentar Fonte

  Aumenta o tamanho do texto na área de visualização.

Diminuir Fonte

  Diminui o tamanho do texto na área de visualização. Este ícone só está ativo se tiver aumentado anteriormente o texto.

Os menus contêm as seguintes opções:

Arquivo
  Arquivo Imprimir...

    Imprime o conteúdo da página visível no momento.

  &Ctrl;Q Arquivo Sair

    Fecha e sai do &khelpcenter;

Editar
  &Ctrl;A Editar Selecionar Tudo

    Seleciona todo o texto na página atual.

  &Ctrl;F Editar Procurar...

    Procura uma ou mais palavras na página visível no momento.

Ver
  Ver Ver o Código do Documento

    Ver o código HTML da página que está vendo no momento.

  Ver Mudar a Codificação

    Muda a codificação da página atual. Normalmente, a configuração Auto deve ser suficiente, mas se estiver tendo problemas vendo as páginas escritas em outros idiomas que não o Inglês ou o Português, pode ter de escolher uma codificação específica neste menu.

Ir Recuar

  Volta para a página anterior que o usuário estava vendo.

Ir Avançar

  Se tiver recuado uma página através do ícone ou da opção do menu, pode voltar para a frente de novo com esta opção.

Ir ...

  No fim do menu Ir, pode encontrar uma lista com o histórico das últimas páginas que viu. Ao selecionar uma irá diretamente de volta para essa página.

## Créditos e Licenças

&khelpcenter;

Criado originalmente por Matthias Elter me@kde.org

Mantido atualmente por Matthias Hoelzer-Kluepfel mhk@kde.org

&underFDL; &underGPL;