# O &khelpcenter;

A Equipe do &kde;
Marcus
Gama

    marcus.gama@gmail.com

Tradução
&FDLNotice;
23/07/2011
&kde; 4.7

O &kde; é uma equipe internacional de tecnologia que cria software livre para computadores de mesa e portáteis. Entre os produtos do &kde;, estão um moderno ambiente de trabalho para as plataformas &Linux; e &UNIX;, pacotes completos de escritório e de trabalho em grupo e centenas de programas abrangendo várias categorias, incluindo aplicativos para Internet, multimídia, entretenimento, educativos, gráficos e desenvolvimento de software.

KDE
kdebase
khelpcenter
kdehelp
ajuda
centro de ajuda
Centro de ajuda do KDE

## 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 básicos do &kde; vêm completamente documentados, graças aos esforços da equipe de documentação. Se você estiver interessado em ajudar com a documentação, inscreva-se na lista de discussão e escreva para a equipe em kde-doc-english@kde.org. Não é necessária experiência, apenas entusiasmo e paciência.

Se você quiser ajudar a traduzir a documentação do &kde; para o seu idioma nativo, revisar as traduções ou contatar os coordenadores de cada equipe de tradução, acesse a página Web de Localização.

#### Instalação

O &khelpcenter; é parte integrante da instalação básica do &kde;, e é instalado com cada cópia do &kde;. Ele pode ser encontrado no pacote 'kdebase-runtime' disponível em &kde-ftp; ou no pacote 'kdebase-runtime' do seu sistema operacional.

### Invocar a ajuda

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

A partir do menu Ajuda

  O uso mais comum será provavelmente de dentro de um aplicativo. Escolha a opção F1 Ajuda Manual do Aplicativo para abrir o manual desse aplicativo.

A partir do lançador de aplicativos Kickoff

  Escolha o grande K no seu painel e depois, na página Aplicativos, selecione a Ajuda para abrir o &khelpcenter;, que será então aberto com a página inicial padrão.

A partir da linha de comando

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

  Um arquivo de ajuda de um aplicativo

    `khelpcenter` `help:/kwrite`

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

  Uma &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`

  Invocar o `khelpcenter` sem parâmetros abre a janela inicial padrão.

### A interface do &khelpcenter;

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

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

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

As hiperligações podem levá-lo a outras partes do mesmo documento ou para um documento diferente, e você pode usar os ícones Voltar (seta apontando para a esquerda) ou Avançar (seta apontando para a direita) da barra de ferramentas, de modo a percorrer os documentos que visualizou na sessão atual.

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

#### A área de Conteúdo

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

A área de Conteúdo está, por sua vez, dividida em duas abas, com uma delas contendo um menu que mostra todas as informações de ajuda disponíveis no &khelpcenter;, e uma outra contendo um glossário de termos.

##### O menu de Conteúdo

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

Manual do Plasma

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

Ajuda on-line

  Uma página com referências para ajuda on-line e mais algumas informações adicionais fornecidas pela comunidade do &kde;.

Manuais dos aplicativos

  A documentação dos aplicativos nativos do &kde;. Todos os aplicativos do &kde; possuem a documentação no formato &XML;, que são convertidas para HTML quando você as visualiza. Esta seção lista todos os aplicativos do &kde; com uma breve descrição e uma ligação para a documentação completa do aplicativo.

  Os aplicativos são mostrados numa estrutura em árvore que reflete a estrutura padrão do menu K, o que facilita a localização do aplicativo que você está procurando.

Módulos do centro de controle

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

Módulos do centro de informações

  Contém uma lista de referências para vários documentos dos 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 on-line 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.

Scrollkeeper

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

Páginas de navegação no Info

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

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

As páginas do 'man' são as páginas de manual padrão do &UNIX;, e tem sido 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 para você RTFM (do inglês, em uma versão mais educada, "Read The Full Manual", que se traduz como "Leia todo o manual"), 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 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 você alguma vez já se questionou sobre o número que as pessoas indicam, como por exemplo 'man(1)', ele indica a seção do manual onde o item está. Você 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'. Os mantenedores de alguns aplicativos já não atualizam 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. No entanto, a maioria dos aplicativos tem uma ou outra. Se o aplicativo que você 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 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' pressionando em Topo.

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

Ao clicar num item de menu dentro de um documento, você irá passar para um nível inferior da hierarquia. Você pode voltar para cima na hierarquia se pressionar em Cima.

O 'man' é tratado de forma semelhante ao 'info', onde o índice da seçã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 você. Elas podem ir dos aplicativos e tecnologias específicos do &kde; até aos termos de computação genéricos do &UNIX;.

Do lado esquerdo, você poderá ter uma visão em árvore com duas opções: Ordem alfabética ou Por tópico. Ambas contêm os mesmos itens, ordenados de forma diferente, para que você possa encontrar rapidamente o item que lhe interessa.

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

##### Ícones da barra de ferramentas

Sumário

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

Voltar

  Vai para a página que tiver visto anteriormente. Clique na seta para baixo ao lado do ícone. Isto irá mostrar uma lista com as páginas vistas anteriormente. Se selecionar uma delas, irá diretamente para essa página.

Avançar

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

Copiar

  Copia o texto para a área de transferência, de modo a ser colado em outro aplicativo.

Localizar

  Localiza uma ou mais palavras na página atualmente exibida.

Aumentar tamanho da fonte

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

Diminuir tamanho da 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
  &Ctrl;Q Arquivo Sair

    Fecha e sai do &khelpcenter;

Editar
  &Ctrl;C Editar Copiar

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

  &Ctrl;A Editar Selecionar tudo

    Seleciona todo o texto na página atual.

  &Ctrl;F Editar Localizar...

    Localiza uma ou mais palavras na página atualmente visível.

Exibir
  Exibir Configurar codificação

    Muda a codificação da página atual. Normalmente a opção Padrão deverá ser suficiente mas, se tiver problemas ao ver as páginas feitas em outros idiomas que não o Inglês, poderá ter que escolher uma codificação específica neste menu.

Ir
  &Alt;Home Ir Sumário

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

  &Ctrl;PgUp Ir Página anterior

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

  &Ctrl;PgDown Ir Próxima página

    Vai para a próxima página da documentação atual.

  &Alt;Esquerda Ir Voltar

    Volta para a página anterior que você estava vendo.

  &Alt;Direita Ir Avançar

    Se tiver recuado uma página, por meio do ícone ou da opção do menu, pode avançar de novo com esta opção.

Configurações
  Configurações Exibir barra de ferramentas

    Mostra ou oculta a barra de ferramentas que contém os ícones no topo do aplicativo.

  Configurações Mostrar barra de status

    Mostra ou oculta a barra de status que se localiza no fundo do aplicativo.

  Configurações Configurar fontes...

    Permite a você configurar a família e o tamanho da fonte usada pelo &khelpcenter;.

  Configurações Configurar atalhos...

    Configura os atalhos de teclado disponíveis para o &khelpcenter;.

  Configurações Configurar 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;

A manutenção atual é de &Cornelius.Schumacher; &Cornelius.Schumacher.mail;

Tradução de Marcus Gamamarcus.gama@gmail.com

&underFDL; &underGPL;