Manual de Utilizador do Sistema de Ajuda do &kde;

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 quiser ajudar, escreva 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 quiser ajudar a traduzir a documentação do &kde; para a sua 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, na página Web de internacionalização, na secçã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 'tdebase' e está disponível em &kde-ftp; ou no pacote 'tdebase' do seu sistema operativo. Invocar a Ajuda O &khelpcenter; pode ser chamado de várias maneiras: A partir do menu Ajuda A forma mais comum será, provavelmente, a partir de uma aplicação. Escolha a Ajuda Conteúdo para abrir o ficheiro de ajuda dessa aplicação, na página de conteúdo. A partir do menu K Escolha o K grande no seu painel e seleccione a Ajuda para abrir o &khelpcenter;, iniciando na página de boas-vindas por omissão. A partir do painel O painel &kicker; contém, por omissão, um ícone para chamar o &khelpcenter;. É, de novo, mostrada a página de boas-vindas. 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 Abre o ficheiro de ajuda do &kedit; na página de conteúdo. Um &URL; local khelpcenter Uma página do Man khelpcenter Uma página do Info khelpcenter 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 tanto mover sequencialmente por um documento, usando as ligações Próximo, Anterior e Raiz, como mover de uma forma menos estruturada, usando as 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 <guilabel >Conteúdo</guilabel > 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 <guilabel >Conteúdo</guilabel > O Conteúdo contém os seguintes itens 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; 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. 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. 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. 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 em tarefas ou meramente informativos. A FAQ do &kde; As perguntas mais frequentes sobre o &kde; e as suas respostas. O &kde; na Web Referências ao &kde; na Web, quer na página Web oficial do &kde;, quer em muitas outras páginas úteis. Informações de Contacto Informações sobre a forma de contactar a equipa de desenvolvimento do &kde; e de se juntar às listas do correio do &kde;. Apoiar o &kde; Como ajudar e como se envolver no projecto. As secções do <application >Man</application > e do <application >Info</application > 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 <application >Info</application > 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;. 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 si seleccionados à direita. Créditos e Licenças &khelpcenter; Criado originalmente por &Matthias.Elter; &Matthias.Elter.mail; Manutenção actual por &Cornelius.Schumacher; &Cornelius.Schumacher.mail; &underFDL; &underGPL;