# O &khelpcenter;

## 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 estiver interessado em ajudar nos esforços de documentação, junte-se à lista de correio e escreva para a equipa em kde-doc-english@kde.org. Não é necessária qualquer experiência, apenas entusiasmo e paciência.

Se quiser ajudar a traduzir a documentação do &kde; para a sua língua nativa, rever a informação, incluindo os coordenadores de cada equipa de língua, veja a página Web de Localização.

#### Instalação

O &khelpcenter; é uma parte integrante da instalação de base do &kde;, e vem instalado com todas as cópias do &kde;. Poderá ser encontrado no pacote 'kdebase-runtime', estando disponível no &kde-ftp;, ou poderá ser encontrado no pacote 'kdebase-runtime' do seu sistema operativo.

### Invocar a Ajuda

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

A partir do menu Ajuda

- O uso mais comum será provavelmente dentro de uma aplicação. Escolha a opção F1 Ajuda Manual da Aplicação para abri o manual dessa aplicação.

A Partir do Lançador de Aplicações Kickoff

- Escolha o grande K no seu painel e depois a página Aplicações, seleccionando de seguida a Ajuda para abrir o &khelpcenter;, o que irá então abrir com a página inicial por omissão.

A partir 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`. Podê-las-á usar da seguinte forma:

  Um ficheiro de ajuda de uma aplicação

- `khelpcenter` `help:/`kwrite``

  Abre o ficheiro de ajuda do &kwrite;, na página de conteúdo.

Um &URL; local

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

Uma página do Man

- `khelpcenter` `man:/`strcpy``

Uma página do Info

- `khelpcenter` `info:/`gcc``

Se invocar o `khelpcenter` sem quaisquer parâmetros, abre a página inicial 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 menu-and-toolbar-ref.

Os documentos contêm as suas próprias ferramentas de navegação, permitindo-lhe percorrer sequencialmente um documento, usando as referências Seguinte, Anterior e Conteúdo ou então navegar de uma forma menos estruturada, recorrendo às hiperligações.

As ligações podem levá-lo para outras partes do mesmo documento ou para um documento diferente, podendo usar para tal os ícones Recuar (Seta a apontar para a esquerda) ou Avançar (Seta a apontar para a direita) da barra de ferramentas, de modo a percorrer os documentos que viu 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 de Conteúdo

A área de Conteúdo 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.

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 itens por omissão:

Manual do Plasma

- O Manual do &plasma; é a documentação do pilar mais visível do &kde;, a interface de base do ambiente de trabalho.

Ajuda 'Online'

- Uma página com referências para ajuda 'online' e mais algumas informações adicionais fornecidas pela comunidade 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.

Módulos do Centro de Controlo

- Oferece uma lista de referências para vários módulos que estão localizados na aplicação do kde; &systemsettings;.

Módulos do KInfoCenter

- Contém uma lista de referências para vários documentos de módulos do KInfocenter.

Kioslaves

- Contém uma lista de referências para a documentação dos vários módulos do KIO.

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

Scrollkeeper

- A documentação adicional, fora do &kde;, que está instalada no seu sistema.

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

#### As secçõ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 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 RTFM, o manual a que se referem são, 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 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.

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.

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

##### 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' se carregar no Topo.

O Anterior e o Seguinte são usados para passar para a página anterior/seguinte 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 se carregar em Cima.

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.

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

Do lado esquerdo, poderá ver uma zona em árvore com duas opções: Alfabeticamente ou Por Tópico. Ambas contêm os mesmos itens, se bem que ordenados de forma diferente, para que possa encontrar rapidamente o item que lhe interessa.

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

Índice Analítico

- Vai para a página inicial principal do &khelpcenter;.

Recuar

- Vai para a página que tiver visto anteriormente. Assinale a opção ao lado do ícone. Isto irá mostrar uma lista com as páginas vistas anteriormente. Se seleccionar uma, irá directamente de volta para essa página.

Avançar

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

Copiar

- Copia o texto para a área de transferência, de modo a ser colado noutra aplicação.

Procurar

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

Aumentar o Tamanho das Letras

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

Diminuir o Tamanho das Letras

- 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

- &Ctrl;Q Ficheiro Sair

- Fecha e sai do &khelpcenter;

Editar

- &Ctrl;C Editar Copiar

- Copia o texto seleccionado para a área de transferência.

&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 Mudar a Codificação

- Muda a codificação da página actual. Normalmente a opção Predefinição deverá ser suficiente mas, se tiver problemas ao ver as páginas feitas noutras línguas que não o Inglês, poderá ter de escolher uma codificação específica neste menu.

Ir

- &Alt;Home Ir Índice

- Vai para a página inicial principal do &khelpcenter;.

&Ctrl;PgUp Ir Página Anterior

- Vai para a página anterior da documentação actual.

&Ctrl;PgDown Ir Página Seguinte

- Vai para a página seguinte da documentação actual.

&Alt;Esquerda Ir Recuar

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

&Alt;Direita 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.

Configuração

- Configuração Mostrar a Barra de Ferramentas

- Esconde a barra de ferramentas que contém os ícones no topo da aplicação.

Configuração Mostrar a Barra de Estado

- Mostra ou esconde a barra de estado que se localiza no fundo da aplicação.

Configuração Configurar os Tipos de Letra...

- Permite-lhe configurar o tipo e o tamanho de letra usados no &khelpcenter;.

Configuração Configurar os Atalhos...

- Configura as combinações de teclas disponíveis para o &khelpcenter;.

Configuração Configurar as Barras de Ferramentas...

- Configura as barras de ferramentas disponíveis no &khelpcenter;.

### Créditos e Licenças

&khelpcenter;

Criado originalmente por &Matthias.Elter; &Matthias.Elter.mail;

Manutenção actual por &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

Tradução de José Nuno Pires zepires@gmail.com

&underFDL; &underGPL;