2002-02-03
0.08.00

# Manual de Utilizador 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;).

Todas as aplicações de base do &kde; vêm completamente documentadas, graças aos esforços da equipa de documentação. Se quiseres ajudar, escreve para o coordenador de 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 quiseres ajudar a traduzir a documentação do &kde; para a tua língua nativa, 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 equipa de tradução, no 'site' Web de internacionalização, na secção de Contactos deste documento.

### Instalação

## Invocar a Ajuda

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

A partir do menu Ajuda

A partir do menu K

  Escolhe o K grande no teu painel, e selecciona Ajuda para abrir o &khelpcenter;, iniciando na página de boas-vindas por omissão.

Do painel

Da linha de comandos

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

  Um ficheiro de ajuda de uma aplicação

    `khelpcenter` `help:/kedit`

    Abre o ficheiro 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`

  A invocação do `khelpcenter` sem parâmetros abre a janela de boas-vindas por omissã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 as ligações Próximo, Anterior e Raiz ou mover de uma forma menos estruturada, usando as hiper-ligações.

As ligações podem levar-te para outras partes do mesmo documento, ou para um documento diferente, e podes usar os ícones Recuar (Seta a apontar para a esquerda) ou Avançar (Seta a apontar para a direita) da barra de ferramentas para mover pelos documentos que viste nesta sessão.

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

### A Área Conteúdo

A área Conteúdo do &khelpcenter; é mostrada à esquerda na janela. Como deves estar à espera, podes mover a barra de separação, para teres a certeza que consegues ler o conteúdo de ambas as área confortavelmente.

A área Conteúdo está por sua vez dividida em duas secçõ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 por omissã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 utilizador do &kde;

Manuais das aplicações

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

  As aplicações são mostradas numa estrutura em árvore que reflecte a estrutura por omissão do menu K, o que facilita a localização da aplicação que procura.

Navegação das páginas do 'info'

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

Tutoriais

  Tutoriais curtos, baseados nas tarefas ou informacionais.

A FAQ do &kde;

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

O &kde; na Web

  Ligações para o &kde; na Web, quer no 'site' Web oficial do &kde;, quer em muitos outros 'sites' úteis.

Informação de Contactos

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

Suportar o &kde;

  Como ajudar e como se envolver no projecto.

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

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.

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 procuras é 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ó dde Topo, isto é, a página de abertura. Podes voltar ao Topo de um documento do info carregando em Topo.

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

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 carregando em Cima.

O 'man' é tratado de forma semelhante ao 'info', em que o índice da secção é o nó de Topo e em que cada página se encontra o 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 si. Estas podem ir das aplicações 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 depessa.

Navegue pelas árvores à esquerda, de modo a mostrar os itens por si seleccionados à 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 si na barra de ferramentas são os seguintes:

#### Ícones da Barra de Ferramentas

Recuar

  Vai para a página anterior que visitou.

Avançar

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 o Tipo de Letra

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

Diminuir o Tipo de Letra

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

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

Ficheiro
  Ficheiro Imprimir...

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

  &Ctrl;Q Ficheiro Sair

    Fecha e sai do &khelpcenter;

Editar
  &Ctrl;A Editar Seleccionar Tudo

    Selecciona todo o texto na página actual.

  &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á a ver no momento.

  Ver Mudar a Codificação

    Muda a codificação da página actual. Normalmente, a configuração Auto deve ser suficiente, mas se estiver a ter problemas a 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.

Ir Recuar

  Volta para a página anterior que o utilizador estava a ver.

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

## Créditos e Licenças

&khelpcenter;

Criado originalmente por Matthias Elter me@kde.org

Manutenção actual por Matthias Hoelzer-Kluepfel mhk@kde.org

&underFDL; &underGPL;