BerndPol O &tdevelop; é um IDE muito poderoso e flexível que oferece muitas formas de o ajustar às suas necessidades. Para iniciar a configuração, seleccione ConfiguraçãoConfigurar o KDevelop.... Isto fará com que a janela de configuração se abra, consistindo numa janela de selecção à esquerda e na janela de configuração à direita, cujo conteúdo irá variar de acordo com o item de configuração que seleccionou. Seleccionar um item de configuração Seleccionar um item de configuração Iremos discutir estas configurações por uma ordem diferente, dividindo nos tópicos principais da Configuração Geral, Configurar a Documentação e Configuração Avançada, o que causa uma leitura mais intuitiva. Se quiser ver directamente um certo item de configuração, use uma das seguintes referências. Geral 'Plugins' Formatador de Código Assistente de Novo Ficheiro Interface do Utilizador Editor Abreviaturas O Menu Ferramentas Ferramentas Externas Documentação Excertos de Código Selector de Ficheiros A configuração geral diz respeito às tarefas mais comuns de ajuste do &tdevelop; e consistem em: Configuração Geral Seleccionar a Interface do Utilizador Seleccionar um Editor Seleccionar um Estilo de Formatação de Código Configurar a Ferramenta de Excertos de Código Configurar o Selector de Ficheiros A janela de configuração Geral permite-lhe definir algum comportamento básico do &tdevelop; que irá mudar pouco no dia-a-dia. Isto respeita a: As opções gerais do projecto, como definir uma directoria-mãe por omissão, que o &tdevelop; deverá usar para os projectos novos. decidir se quer que o &tdevelop; carregue automaticamente o projecto onde estava a trabalhar da última vez. Seleccionar um tipo de letra para as janelas de resultados usadas mais frequentemente, nomeadamente: a Janela de Mensagens de Resultado que o &tdevelop; usa para apresentar ⪚ o progresso da compilação e a Janela de Resultado da Aplicação que irá mostrar as mensagens de erro e de estado respeitantes a uma aplicação em execução. Algum comportamento comum respeitante às linhas apresentadas na Janela de Mensagens, como por exemplo: se as linhas compridas serão repartidas e se as mensagens de entrada e saída das directorias geradas pelo Make serão apresentadas. O nível de detalhe das mensagens correspondentes ao processo de compilação mostrado na janela de Mensagens. A janela de configuração geral Ler o último projecto no arranque Assinale esta opção se deseja continuar a trabalhar no último projecto em que trabalhou. Isto fará com que o &tdevelop; carregue automaticamente este projecto no arranque. Será normalmente mostrado no estado em que você deixou o trabalho, para que possa continuar da mesma forma. Pasta de projectos por omissão: Por omissão, o &tdevelop; usa uma directoria de base comum para todos os projectos novos. Indique a localização absoluta desta directoria comum no campo de texto respectivo ou seleccione-a na sua estrutura de directorias. O &tdevelop; irá colocar os projectos novos aqui como sub-pastas desta. Você poderá, obviamente, mudar a localização de um projecto novo na altura em que o configurar no &appwizard;. Tipo de letra da janela: Para seleccionar um tipo de letra adequado para a Janela de Mensagens, carregue no botão do Tipo de Letra da Janela que mostra o tipo de letra actual (na imagem acima, diz Luxi Sans). Irá então aparecer a janela normal do &kde; para Seleccionar o Tipo de Letra, na qual você poderá seleccionar o tipo de letra a ser usado. No primeiro arranque, o &tdevelop; inicializa esta configuração do tipo de letra com base no tipo de letra normal que o seu utilizador do &kde; tem configurada. Esta configuração é fixa, por isso, se você alterar as PreferênciasAparência & TemasTipos de Letra no Centro de Controlo, isto irá afectar esta selecção de tipo de letra do &tdevelop;. Você terá de seleccionar de novo explicitamente o tipo de letra da Janela de Mensagens. Mudança de linha Por omissão, o &tdevelop; irá repartir as linhas compridas na janela de Mensagens, de modo que a informação valiosa não será ignorada com facilidade. Nalguns casos, isto irá gerar listas de mensagens grandes e confusas. Desligue a opção se não quiser que as linhas sejam repartidas. Existe uma forma alternativa de alterar a mudança de linha. Basta carregar com o &RMB; na Janela de Mensagens e assinalar ou desligar o item Mudança de Linha do menu que irá aparecer. Mensagens de navegação em pastas A ferramenta Make normalmente irá mostrar linhas do tipo Entering directory (A entrar na directoria), ou Leaving directory (A sair da directoria), quando ele muda de directoria de trabalho. dado que isto enche a lista de mensagens na janela de Mensagens, o &tdevelop; suprime estas mensagens por omissão. Assinale a opção se quiser saber que directorias o Make processou. As alterações desta opção farão efeito apenas no processamento das mensagens novas. As mensagens antigas de navegação nas directorias ficarão à mesma visíveis quando você desligar esta funcionalidade. Mensagens do Compilador O &tdevelop; faz um pré-processamento que a janela das Mensagens recebe durante os processos de compilação, de modo a filtrar a informação supérflua. Você poderá controlar o nível de detalhe que o &tdevelop; irá mostrar com as opções exclusivas deste campo. Muito Curto Mostra apenas os avisos, erros e os ficheiros que estão a ser compilados. Curto Suprime todas as opções do compilador e forma o resultado para ser mais legível. Completo Mostra todas as mensagens sem modificações. Existe uma forma alternativa de mudar o detalhe do resultado do compilador. Basta carregar com o &RMB; na janela de Mensagens e seleccione o nível de detalhe adequado no menu de contexto. Tipo de Letra da Janela da Saída da Aplicação A janela do Resultado da Aplicação é usada par amostrar as mensagens de erro e de estado das aplicações que são executadas dentro do &tdevelop;. Estas são informações que a aplicação manda normalmente para a consola quando é executada autonomamente. Por isso, não precisa de sair do IDE ao testar a aplicação em que está a trabalhar. Para seleccionar um tipo de letra adequado para a Janela do Resultado da Aplicação, carregue no botão do Tipo de Letra da Janela, que mostra o tipo de letra seleccionado de momento (ele diz Luxi Sans na imagem acima). A janela normal do &kde; para Seleccionar o Tipo de Letra irá aparecer, no qual poderá seleccionar o tipo de letra a usar. No primeiro arranque, o &tdevelop; inicializa esta configuração do tipo de letra com base no tipo de letra normal que o seu utilizador do &kde; tem configurada. Esta configuração é fixa, por isso, se você alterar as PreferênciasAparência & TemasTipos de Letra no Centro de Controlo, isto irá afectar esta selecção de tipo de letra do &tdevelop;. Você terá de seleccionar de novo explicitamente o tipo de letra da Janela de Resultados da Aplicação. interface do utilizador mudar de modos mudar de modo de interface Como já foi dito nos Modos Disponíveis de Interface do Utilizador, existem quatro formas diferentes no &tdevelop; para configurar o espaço de trabalho, sendo eles: Modo IDEAl Modo de Janelas com Sub-molduras Modo por Páginas Modo de Janelas de Topo Para mudar o modo da interface do utilizador, seleccione a Configuração Configurar o KDevelop... no menu. A janela para Configurar o KDevelop irá aparecer, onde então terá de seleccionar Interface do Utilizador no campo do lado esquerdo. Isto levá-lo-á à página de configuração mostrada à direita. Seleccione um modo de interface de utilizador Seleccione um modo de interface de utilizador Seleccione a opção exclusiva para o modo de interface do utilizador que deseja utilizar e carregue em OK. Não se esqueça de reiniciar o &tdevelop; para que estas selecções façam efeito. Você você tiver seleccionado o modo IDEAl ou o modo de páginas, irão ficar disponíveis mais duas secções: a Usar Tabulações e Usar o Fechar ao Passar. Estas permitem-lhe configurar em que circunstâncias é que os separadores das páginas serão mostrados no topo das janelas dos documentos e se você poderá fechar o documento ao carregar no ícone da página. Apenas no modo de janelas IDEAl, existirá ainda mais uma secção de configuração, a Disposição das Páginas, a qual permite de facto seleccionar entre vários tamanhos dos separadores de páginas que rodeiam a área de trabalho principal neste modo. Configurar a Visualização da Barra de Páginas dos Documentos No modo IDEAl e no modo de páginas existirão páginas com nomes no topo dos diferentes documentos por omissão, de modo que possa seleccionar facilmente vários documentos diferentes ao carregar com o &LMB;. Se preferir ter mais espaço para as janelas dos documentos na área de trabalho principal do &tdevelop;, você poderá mudar para outro comportamento na secção de configuração Usa Tabulações. Sempre Este é o modo por omissão — mostra uma página cujo separador tem um ícone e o nome do documento na área de trabalho principal do &tdevelop;. Quando mais que uma Não mostra o documento numa página, quando só existe de facto um documento aberto. Se existir mais do que um, todavia, o &tdevelop; irá mostrar a barra de páginas normalmente como aparece na selecção Sempre. Você poderá seleccionar este modo se trabalhar num único documento na maior parte do tempo, dado que oferece um pouco mais de espaço vertical. Nunca Nunca mostra nenhuma página de selecção de documentos. Você poderá preferir este modo se você usa raramente o rato para mudar de documentos. Fornece mais espaço vertical para todas as janelas de documentos. Para seleccionar outra janela de documento ou fechar alguma, use o menu Janela do &tdevelop;. Configurar para Fechar um Documento com um 'Click' na sua Página Quando você tiver configurado o &tdevelop; para mostrar a barra de páginas dos documentos, seja sempre ou apenas quando é mostrado mais do que um documento na área de trabalho, você poderá adicionar mais funcionalidades aos separadores das páginas para além da sua capacidade de selecção de documentos. Use a secção de configuração Usar o Fecho ao Passar para tal. Não Este é o comportamento normal. Não é adicionada mais nenhuma funcionalidade extra às páginas. Elas poderão ser usadas apenas para seleccionar as janelas dos documentos com o &LMB;. Sim Quando você tiver seleccionado esta opção exclusiva, o &tdevelop; irá permitir fechar uma janela de um documento com um 'click' do &LMB;. Use o rato para apontar para o pequeno ícone do lado esquerdo do separador de páginas. Ele irá mudar para um símbolo de fecho. Agora, carregue com o &LMB; neste símbolo alterado para que o &tdevelop; feche a janela do documento correspondente. Sim, Atrasado Depois de seleccionar esta opção, o &tdevelop; permitirá fechar uma janela de um documento como é mostrado no caso do Sim descrito em cima. O ícone não irá mudar instantaneamente, contudo, havendo neste caso um pequeno atraso antes de o ícone aparecer. Configurar a Disposição das Páginas A secção de configuração Disposição das Páginas estará disponível apenas no modo IDEAl. Use estes botões para configurar a aparência das páginas que rodeiam a área de trabalho principal neste modo. Ícones Cada página irá mostrar apenas um ícone. Se a ferramenta associada estiver visível, a página irá abrir e aparecerá um texto descritivo no seu separador. Você poderá usar este modo se trabalhar num monitor com uma resolução limitada. Os ícones não são muito descritivos, de qualquer forma. Se você quiser saber que ferramenta está associada a uma dada página, coloque o cursor do rato sobre ela e espere um segundo. Irá então aparecer uma dica com o nome da ferramenta. Texto Este é o modo de apresentação das ferramentas por omissão. Cada página mostra o nome da sua ferramenta associada. Texto e Ícones Se as ferramentas normais parecem demasiado planas para si e você está a trabalhar num monitor de alta resolução, você poderá seleccionar esta opção. Fará com que o nome da ferramenta associada seja mostrado em cada página, para além de um ícone à esquerda dele, tornando as páginas mais fáceis de compreender. Veja a imagem das Páginas de Ferramentas Fechadas em baixo para um exemplo. Páginas das Ferramentas Fechadas Se você seleccionou o modo IDEAl, com as páginas a mostrarem os textos (com ou sem os ícones a acompanhar), você não precisa de se preocupar em estar escondido por detrás de uma janela de ferramentas. Se uma das janelas das ferramentas ocupar mais espaço do que está disponível para mostrar todas as páginas (verticais), elas fechar-se-ão como é mostrado nesta figura: As páginas de ferramentas fecham-se para não ficarem escondidas detrás de outra janela As páginas de ferramentas fecham-se para não ficarem escondidas detrás de outra janela A janela de ferramentas activa deverá ser mostrada fixa (sem sobreposição), partilhando a área de trabalho com outras janelas, para permitir esse fecho de páginas. Carregue no pequeno quadrado no contorno da janela para conseguir isto, tal como é mostrado no exemplo. O &tdevelop; permite-lhe seleccionar a sua ferramenta de edição de texto favorita. Marque o item Editor da árvore de selecção da lado esquerdo da janela Configurar o KDevelop. Será mostrada a seguinte janela à direita. Seleccionar um editor Seleccionar um editor Para seleccionar um novo editor, carregue na seta da lista. Dependendo das interfaces dos componentes de edição com que a sua versão do &kde; foi compilada, irá aparecer uma lista dos editores que poderá seleccionar (veja a nota Importante em baixo para tal). Carregue no editor da sua preferência e carregue em OK. De momento, existem três possibilidades: Editor de Texto Avançado Incorporado Esta é a componente de edição normal do &kde;, a Kate. Componente Embebida do Vim Esta oferece a aparência e comportamento do seu editor de base do &Linux; que é o vi. Você precisa de ter uma aplicação Vim adequada instalada. Dê uma vista de olhos no KVim para mais informações. Para além disso, você precisa de configurar o componente KParts do Vim no Centro de Controlo do &kde; (Componentes do KDEConfiguração do Componente Vim) antes de o poder usar. Editor de Texto Baseado no Qt Designer Este é o editor que o &Qt; oferece no seu componente Designer. Estas interfaces de edição estão completamente integradas no conceito de IDE do &tdevelop;. Em particular, a possibilidade de saltar para linha de código-fonte responsável por um dado erro, se carregar no texto da sua mensagem na janela de Mensagens é oferecida por elas. A mudança de editor não irá afectar os ficheiros já abertos. Existem duas possibilidades de prosseguir. Ou fecha todas as janelas de texto abertas e reabre-as uma a uma ou então simplesmente fecha o projecto inteiro e abre-o outra vez. As janelas serão então automaticamente abertas com a nova interface de edição de texto. O &tdevelop; deixa-o usar as interfaces de edição que foram registadas no &kde; e que oferecem uma interface do KatePart. Se você acha que falta uma das selecções mostradas acima, verifique a sua instalação do &kde; para saber se o KPart foi instalado correctamente. O &tdevelop; formata automaticamente o texto de código de um estilo predefinido. Este estilo é altamente configurável. A funcionalidade de nova formatação de código está disponível apenas para o C, o C++ e o &Java;, de momento. Em especial, você não a poderá usar para as linguagens de 'scripting' como o PHP. Isto é porque o &tdevelop; usa a aplicação astyle para implementar esta funcionalidade. Para configurar um estilo de formatação específico, seleccione Configuração Configurar o KDevelop... no menu. A janela para Personalizar o KDevelop irá aparecer, onde terá de seleccionar o Formatador de Código na árvore da esquerda. Isto irá mostrar uma série de três páginas de configuração à direita, nomeadamente uma Configuração Geral da Formatação, uma Configuração do Estilo de Indentação e Outra Configuração de Formatação. Todas as mudanças de estilo aplicam-se apenas ao ficheiro acabado de introduzir. Se você quiser mudar o estilo de formatação de um texto de código já existente, você terá de usar explicitamente o comando EditarReformatar o Código. A consequência exacta destas definições de formatação do estilo dependem do editor que usa. De momento, a maioria das configurações são adequadas para a componente de edição do Kate (o Editor de Texto Avançado Incorporado). Outros editores (⪚ o editor do Qt) poderão basear-se apenas na sua configuração própria. Você terá de experimentar neste caso para saber os efeitos exactos da configuração de estilo oferecida aqui. Poderão existir incompatibilidades entre a configuração do estilo aqui oferecida e o editor que usa, até mesmo nos casos extremos, em que poderá corromper os seus ficheiros. Certifique-se que tem uma cópia de segurança dos seus ficheiros de código antes de tentar usar a sua configuração com um editor incompatível com o &kde;. A página Geral da janela do Formatador de Código permite-lhe seleccionar um de cinco estilos predefinidos de formatação de código. Configuração geral do estilo de formatação de código Configuração geral do estilo de formatação de código Será mostrado um exemplo de código formatado no campo à direita. Se nenhum dos estilos predefinidos é do seu agrado, você poderá carregar na opção de topo Definido pelo utilizador e definir as suas preferências de formatação de código nas outras duas páginas que ficarão disponíveis. De momento, só os estilos de formatação predefinidos é que serão demonstrados com um texto de exemplo. Se você decidir definir o seu próprio estilo, não será apresentado nenhum texto de exemplo. Você terá de experimentar no próprio texto do código actual para ajustar a configuração ao seu gosto. Uma indentação adequada é a forma principal de melhorar a legibilidade do texto do código. Se você seleccionou a página Indentação na janela do Formatador do Código, ser-lhe-á apresentada uma série de opções de formatação, agrupadas em três opções, como as que aparecem a seguir. Configuração do estilo da indentação do código Configuração do estilo da indentação do código Configuração por Omissão As escolhas de formato predefinidas fazem com que o código lembre o estilo de formatação da ANSI: namespace espacoXpto { int Xpto() { if (eOla) { ola(); return 1; } else return 0; } } Definir o Tamanho e os Caracteres da Indentação As opções exclusivas agrupadas no grupo Preenchimento, definem como é que a indentação do código será feita. Usar tabulações Isto fará com que o editor insira um carácter de tabulação por cada nível de indentação. O tamanho da tabulação está predefinido na configuração do editor (é normalmente de 8 ou 4 caracteres). Use o ConfiguraçãoConfigurar o Editor... para o definir de novo. O procedimento de definição da largura da tabulação actual depende do editor que seleccionou no passo de configuração em Seleccionar um Editor. Você terá de ver na ajuda correspondente do editor para descobrir como fazê-lo. Usar espaços Se você seleccionar esta opção, o editor irá introduzir um conjunto de espaços por cada nível de indentação. Mude o número do valor por omissão 2 para o tamanho que preferir. Entidades Indentadas Isto define quais as entidades de (C/C++) que serão formatadas com uma indentação extra para além do nível de indentação actual. Por omissão, só os namespaces (espaços de nomes) e os labels (identificadores) terão uma indentação extra. Você poderá querer experimentar com várias opções para se ajustar a essas indentações extra de acordo com o seu agrado. Continuação As opções aqui agrupadas aplicam-se aos casos em que o sistema de formatação de código reparte automaticamente as linhas de código grandes. Ele tem dois casos especiais em conta, nomeadamente os casos em que as indentações são demasiado grandes e é necessário haver espaço restante para o código e para as condições, que deverão ter níveis de indentação extra para que sejam suficientemente perceptíveis. Isto aplica-se aos casos de mudanças de linha estáticas apenas quando é usado um tamanho de linha máximo fixo no código. Se você configurar o seu editor para repartir dinamicamente as linhas apenas na visualização (o que é possível, na componente de edição do &kate;), os efeitos destas configurações não serão visíveis. Máximo na instrução Esta configuração limita a indentação máxima possível para as linhas de continuação para que sobre espaço suficiente para manter o texto legível. Nenhuma linha de continuação será indentada para além do número de colunas que seleccionar neste campo. O tamanho por omissão está definido como 40 colunas de caracteres (metade de uma página de 80 colunas normal). Você poderá querer aumentar este valor para ter em conta o papel mais largo (⪚ se você usa a impressão no modo paisagem para o seu código) ou então diminui-lo se quiser ter em conta a configuração das margens nas suas impressões. Mínimo nas condições As condições ou o código que se segue ⪚ a um operador de atribuição deverão ter normalmente uma indentação extra nas linhas de continuação para manter o texto legível. A quantidade desta indentação extra é aqui definida. O valor por omissão é igual a Duas vezes o actual, o que significa que as condições continuadas irão ter um nível de indentação extra em relação ao tamanho de indentação normal que seleccionou no grupo Preenchimento. Você poderá alterar esta indentação extra para outro tamanho fixo (incluindo zero), usando as setas ou indicando o valor directamente. Outra configuração do estilo de formatação do código Outra configuração do estilo de formatação do código Controlar a posição das chavetas As opções no grupo (talvez mal chamado) Parêntesis controlam a posição das chavetas que delimitam os blocos no código em C/C++. Existem três possibilidades para você seleccionar. Interrupção Esta insere uma quebra de linha antes de cada chaveta de abertura. Ambas as chavetas delimitadoras de um bloco serão colocadas ao mesmo nível de indentação que a instrução de topo do bloco. namespace espacoXpto { int Xpto() { if (eOla) { ola(); return 1; } else return 0; } } Anexar Isto irá manter a chaveta de abertura de um bloco alinhada com a instrução de topo do bloco. As chavetas de fecho estarão ao mesmo nível de indentação que a instrução de topo do bloco. O else de uma instrução if será mantido em linha com a chaveta de fecho do bloco anterior. namespace espacoXpto { int Xpto() { if (eOla) { ola(); return 1; } else return 0; } } Estilo do Linux Este é um compromisso entre os estilos listados acima. As chavetas de delimitação dos blocos serão colocadas em linhas extra. As chavetas que abrem um bloco numa instrução condicional ou de ciclo serão mantidas na mesma linha. namespace espacoXpto { int Xpto() { if (eOla) { ola(); return 1; } else return 0; } } Controlar os Espaços Extra Por omissão, o &tdevelop; minimiza a utilização dos espaços no código. if (eOla(argXpto)==valorOla) Você poderá aumentar a legibilidade se forçar o sistema de formatação de código a inserir os espaços extra em posições especiais. Adicionar espaços à volta dos parêntesis De facto, o que esta opção pretende fazer é adicionar espaços à volta do texto entre parêntesis. Isto aumenta a legibilidade dos argumentos das funções e das condições. if ( eOla( argXpto )==valorOla ) Adicionar espaços à volta dos operadores Isto irá colocar espaços à volta dos operadores de atribuição e de comparação para aumentar a legibilidade. if (eOla(argXpto) == valorOla) Controlar a formatação das construções de uma linha Existem alguns casos em que você não quer que o sistema de formatação de código divida uma linha em duas. Para o código de C/C++, isto poderá ser controlado aqui. Manter as instruções de uma linha Isto mantém as instruções de uma linha em conjunto, mesmo nas situações em que elas excedem um tamanho máximo de linha. Manter os blocos de uma linha Isto mantém os blocos de uma única linha em conjunto, mesmo nas situações em que elas excedem um tamanho máximo de linha. Ao editar no &tdevelop; você poderá gravar excertos de código usados frequentemente como Excertos de Código. Para configurar as capacidades da componente de excertos de código, seleccione a Configuração Configurar o KDevelop... no menu. A janela para Configurar o KDevelop irá aparecer, onde então terá de seleccionar Excertos de Código no campo do lado esquerdo. Isto levá-lo-á à página de configuração mostrada em baixo. Configurar a ferramenta de excertos de código Configurar a Ferramenta de Excertos de Código Antevisão da Activação de um Excerto Assinale a opção Mostrar o texto do excerto na dica se você quiser ver o texto armazenado numa janela de dica de ferramentas, sempre que você deixar o cursor do rato sobre o título desse excerto de código. Lidar com as Variáveis dos Excertos A ferramenta de Excertos de Código permite a definição de texto variável em locais bem definidos, sempre que desejar inserir um excerto num ficheiro. Para conseguir isto, os Excertos de Código têm o seu próprio mecanismo de variáveis. Você poderá configurar o seu comportamento no grupo Variáveis. Separador A ferramenta de Excertos de Código distingue as variáveis no texto, rodeando os nomes das variáveis com símbolos delimitadores especiais. Para usar o seu próprio delimitador, altere o valor predefinido $ no campo Delimitador. Método de introdução das variáveis Uma janela para cada variável do excerto – irá mostrar uma janela separada para cada variável que a ferramenta encontre ao inserir o excerto de código seleccionado. Uma janela para todas as variáveis do excerto – irá mostrar uma janela comum, onde o utilizador terá de de preencher os valores de todas as variáveis antes de o excerto ser inserido O &tdevelop; oferece um Selector de Ficheiros que, quando é carregado no arranque, permite navegar até chegar a qualquer ficheiro ou directoria do sistema. O selector de ficheiros no modo IDEAl O selector de ficheiros (modo IDEAl) O comportamento do Selector de Ficheiros é altamente configurável. Seleccione a Configuração Configurar o KDevelop... no menu. A janela para Configurar o KDevelop irá aparecer, onde então terá de seleccionar Selector de Ficheiros no campo do lado esquerdo. Isto levá-lo-á à página de configuração mostrada em baixo. Configurar o selector de ficheiros Configurar o selector de ficheiros Configurar a Barra de Ferramentas Existe uma barra de ferramentas no topo do Selector de Ficheiros, que poderá ser configurada como de costume no grupo Barra de Ferramentas. Seleccione um item na lista das Acções seleccionadas à direita, para que a acção nova seja então introduzida. Seleccione a acção a ser introduzida na lista de Acções disponíveis à esquerda. Carregue na seta direita (em cima) entre as duas listas. A acção será removida da lista de Acções disponíveis e será introduzida nas Acções seleccionadas por baixo do item seleccionado. Seleccione o item a ser removido da lista de Acções seleccionadas à direita. Carregue na seta para a esquerda (em baixo) entre as listas. O item seleccionado será removido da lista de Acções seleccionadas e colocada de novo na lista de Acções disponíveis. Seleccione a acção a ser mudada de posição na lista de Acções seleccionadas à direita. Carregue nas setas para cima e para baixo, à direita desta lista. O item seleccionado será movido para cima ou para baixo na lista de Acções seleccionadas. Definir Quando o Conteúdo Deverá Mudar A actualização do conteúdo da janela do Selector de Ficheiros leva tempo e ocupa alguns recursos, especialmente ao mudar para outra directoria. Como tal, o Selector de Ficheiros está configurado por omissão de forma a que o seu conteúdo só se altera a pedido, &ie; quando você selecciona outra directoria ou quando desejar explicitamente actualizar o seu conteúdo. Carregue no botão Actualizar da barra de ferramentas para actualizar o conteúdo do Selector de Ficheiros. Esta barra de ferramentas não está disponível por omissão, todavia. Você precisa de a inserir primeiro. Você poderá configurar o Selector de Ficheiros para reflectir imediatamente certas alterações no seu trabalho. As opções do grupo Auto-Sincronização da janela de configuração são responsáveis por isto. Quando um documento ficar activo Se você seleccionar esta opção, o conteúdo do Selector de Ficheiros será actualizado sempre que for para outro documento aberto, ⪚ quando você carrega na página da janela de edição respectiva no modo IDEAl. Se necessário, o Selector de Ficheiros irá mudar para a directoria a que este ficheiro pertence e actualizará a área visível para mostrar o conteúdo actual da mesma. Quando um documento for aberto Se você seleccionar esta opção, o conteúdo da janela do Selector de Ficheiros será actualizado sempre que um documento é aberto, ⪚ pela opção do menu FicheiroAbrir. Se necessário, o Selector de Ficheiros irá mudar para a directoria a que este ficheiro pertence e irá refrescar a visualização para mostrar o conteúdo actual. Quando o selector de ficheiros ficar visível Se seleccionar esta opção, o conteúdo do Selector de Ficheiros será actualizado sempre que ficar visível de novo. Se necessário, o Selector de Ficheiros irá mudar para a directoria a que este ficheiro pertence e irá refrescar a visualização para mostrar o conteúdo actual. Você poderá combinar estas opções para ajustar o comportamento da actualização do Selector de Ficheiros ao seu gosto. Controlar o Histórico nas Listas Existem duas listas na parte superior e na inferior da janela de conteúdo do Selector de Ficheiros que controlam a directoria a ser mostrada (a lista no topo) e os filtros a serem aplicados à janela de ficheiros (a lista de baixo). Um histórico das opções mais recentes é mantido no campo de selecção de cada lista. Você poderá configurar o número de itens do histórico da seguinte forma. Recordar as localizações Indique aqui o número máximo de selecções de directorias que a lista de cima deverá recordar. Recordar os filtros Indique aqui o número máximo de definições de filtros que a lista em baixo deverá recordar. Controlar o que Deverá Ser Recordado Entre Sessões Por omissão, o Selector de Ficheiros está configurado de forma a que mostre o conteúdo da sessão mais recente no próximo arranque do &tdevelop;. Você poderá alterar este comportamento no grupo de configuração Sessão. Se o &tdevelop; foi reiniciado automaticamente pelo gestor de sessões do &kde;, as alterações a estas opções não farão efeito. Neste caso, a configuração da localização e dos filtros da sessão mais recente do &kde; será sempre reposta. Repor a localização Desligue esta opção se não quiser que a localização apresentada seja guardada entre sessões. Se você seleccionou uma das opções de auto-actualização, a localização apresentada poderá mudar automaticamente, independentemente do que foi recordado da sessão recente. Repor os filtros Desligue esta opção se não quiser que os filtros apresentados sejam guardados entre sessões. (... ainda não escrito ...) O &tdevelop; contém uma funcionalidade de documentação muito poderosa que fornece o acesso a vários tipos de documentação extensa. Por exemplo, no modo IDEAl, você irá encontrar uma página de Documentação do lado direito da área de trabalho. A árvore de documentação do &tdevelop; no modo IDEAl A árvore de documentação do &tdevelop; (modo IDEAl) O &tdevelop; precisa de ter carregado o 'plugin' de Documentação para ver a árvore de documentação. Veja as Ferramentas em 'Plugins' para mais informações. Você poderá configurar o conteúdo desta árvore de documentação se seleccionar a Configuração Configurar o KDevelop... no menu. A janela para Configurar o KDevelop irá aparecer, onde então terá de seleccionar Documentação no campo do lado esquerdo. A página de configuração que é mostrada apresenta um conjunto de páginas de configuração, nomeadamente: Colectâneas de Documentação Pesquisa por Texto Completo Outro A configuração da documentação foi dividida numa série de colectâneas de documentação, em que cada uma fornece o acesso aos ficheiros de documentação de um determinado formato e tipo de conteúdo únicos. Esta configuração controla quais os itens de documentação que serão listados na página de Conteúdo da funcionalidade de Documentação do &tdevelop;, e como é que o utilizador pode aceder aos detalhes da documentação, através de procuras indexadas e pelo texto completo. A página de Documentação oferece uma série de páginas de configuração que são ordenadas verticalmente como uma pilha de cartões de índice. Cada uma das páginas, de cada vez, irá abrir ao carregar no título do seu cartão de índice: Colectânea de Documentação do &Qt; Colectânea de Documentação CHM Colectânea de Documentação do Doxygen Colectânea de Documentação do TOC do &tdevelop; Colectânea de Documentação do DevHelp Colectânea de Documentação Personalizada Configurar as colectâneas de documentação Configurar as colectâneas de documentação Todas as páginas de configuração da página de Documentação usam uma disposição comum. Você irá encontrar os itens de documentação disponíveis de momento, listados na página aberta à esquerda, bem como uma série de botões à direita. Botões de Gestão da Lista de Documentação Existem três botões disponíveis para manter o conteúdo das páginas de configuração da documentação: Adicionar Abre uma janela de Propriedades do Catálogo de Documentação, tal como é mostrado em baixo, na qual poderá seleccionar a localização da fonte de documentação a adicionar, bem como lhe poderá atribuir um nome. Editar Abre uma janela de Propriedades do Catálogo de Documentação, tal como é mostrado em baixo, na qual poderá alterar a localização da fonte de documentação a adicionar, bem como lhe poderá mudar o nome. Remover Remove o item de documentação seleccionado da lista. O item só será removido da lista. Todas as fontes de documentação permanecerão inalteradas. Você terá de as remover explicitamente por outros meios. Adicionar ou alterar um item de documentação O botão à direita do campo de Localização abre uma janela de directorias, cujos itens serão filtrados de acordo com o tipo de ficheiro da página de configuração seleccionada. O campo de Título poderá não estar acessível, dependendo do tipo de documentação a ser mantido. Estrutura da Lista de Documentação Cada página de configuração de documentação mostra os itens de documentação listados numa tabela com quatro colunas: TOC Se esta opção estiver assinalada, este item de documentação irá aparecer na página de Conteúdo da funcionalidade de Documentation do &tdevelop;. Se desligar a opção TOC, esta irá por sua vez desactivar as opções Índice e Procurar (ver em baixo). Como tal, você não poderá ter itens da colectânea de documentação indexados mas que não estejam visíveis no conteúdo. Índice Se esta opção estiver assinalada, será criado um índice interno a partir deste item de documentação. Isto oferece um acesso rápido à documentação, através do uso das páginas de Índice e (opcionalmente) Procurar da funcionalidade de Documentation do &tdevelop;. O índice interno será criado da primeira vez que o utilizador seleccionar a página de Índice. Isto irá atrasar consideravelmente o primeiro acesso, porque o índice será lido do disco e depois é então colocado numa 'cache'. Todas as pesquisas subsequentes irão usar então esta 'cache' e, por isso, irão funcionar muito mais depressa. Procurar Se esta opção estiver assinalada, o conteúdo deste item de documentação será incluído nas localizações de procura por texto completo da página Procurar da funcionalidade de Documentation do &tdevelop;. O &tdevelop; usa a colectânea de aplicações do 'htdig' para efectuar as pesquisas por texto completo. Esta pesquisa é feita sobre um índice interno que a plataforma do 'htdig' tem de criar antes de poder ser usada. Todas as alterações feitas na opção Procurar irão apenas afectar as pesquisas depois de reconstruir o índice da página Procurar da funcionalidade de Documentation do &tdevelop;. Título Este é o nome do item de Documentação que será mostrado na página de Conteúdo da funcionalidade de Documentação do &tdevelop;. As versões anteriores do &tdevelop; permitiam seleccionar os itens de documentação por projecto. Isto já não é mais possível. Nesta página de configuração é configurada toda a documentação do &Qt;. Configurar a colectânea de documentação do &Qt; Configurar a colectânea de documentação do &Qt; Normalmente, o &tdevelop; irá preencher isto no seu primeiro arranque. Ele irá procurar pelos ficheiros de documentação normais *.xml e *.dcf da directoria de instalação do &Qt;. A tabela à esquerda irá listar os ficheiros que o &tdevelop; encontrou pelo seu título normal. Se você tem uma instalação fora do normal, então poderá não existir nenhuma informação indicada, ou então os endereços irão apontar para locais inválidos (⪚ para outra instalação do &Qt; disponível no seu sistema). Você poderá ajustar os itens, usando os botões à direita da lista. O &tdevelop; irá usar os títulos já fornecidos pela documentação do &Qt; instalada. Por isso, o campo Título da janela de Propriedades do Catálogo de Documentação está inacessível. Por omissão, nem toda a documentação do &Qt; estará visível na página de Conteúdo da funcionalidade de Documentation do &tdevelop;. Use a opção TOC na tabela de configuração para seleccionar a documentação a ser apresentada. Se você quiser incluir mais alguma documentação específica do &Qt; nos índices de pesquisa ou na pesquisa por texto completo, use as opções de Índice e Procurar da tabela de configuração. Nesta página de configuração, você poderá recolher a documentação referente à norma de ficheiros de ajuda CHM da &Microsoft;. Configurar os ficheiros de documentação CHM normais da &Microsoft; Configurar os ficheiros de documentação CHM normais da &Microsoft; Por omissão, esta página de configuração estará vazia (como é mostrado acima). Você poderá adicionar novos itens com os botões à direita do campo da lista. O &tdevelop; irá filtrar os ficheiros *.chm na janela de directoria associada aos botões Adicionar e Editar. Para mais informações sobre o formatos dos ficheiros *.chm da &Microsoft;, veja ⪚ a Documentação do PHP - Formato CHM Extendido em http://de2.php.net/docs-echm.php. Nesta página de configuração, toda a documentação da &API; gerada pelo &doxygen; será configurada. Configurar a documentação da &API; gerada pelo Doxygen Configurar a documentação da &API; gerada pelo Doxygen Em resumo, estas &API;s documentam a interface para as funções de certas bibliotecas. Para produzir a documentação da &API; desta página é usada a ferramenta &doxygen;. A documentação da &API; gerada pelo &doxygen; consiste numa série de ficheiros HTML, a começar pelo index.html. Adicionalmente, poderão existir ficheiros tag que contêm informações para se associar a documentações de &API; já existentes. Como tal, o &tdevelop; irá procurar pelo index.html e pelos ficheiros *.tag ao procurar pela documentação de &API; gerada pelo &doxygen;. Existem algumas restrições estruturais assumidas ao procurar pela documentação da &API; gerada pelo &doxygen;. A directoria na qual se encontra o ficheiro index.html deverá conter algumas sub-pastas com colectâneas de documentação separadas. Assume-se que cada uma destas sub-pastas contém um ficheiro .tag e uma subdirectoria html/. Você poderá dar uma vista de olhos em $TDEDIR/share/doc/HTML/en/tdelibs-apidocs para ter um exemplo de uma disposição de documentação de &API; em &doxygen;. O formato de documentação da &API; mais antigo do &kde;, o KDoc, já não é mais suportado directamente. Se quiser usar à mesma essa documentação, você podê-la-á adicionar à mesma na página da Colectânea Personalizada de Documentação. O &tdevelop; terá preenchido numa ligação a &API; actual das Bibliotecas do &kde;, desde que tivesse achado alguma na altura da instalação. Existem várias formas de o &tdevelop; a descobrir: Ou você indicou no comando configure a opção --with-tdelibsdoxy-dir, quando compilou o &tdevelop; (veja o capítulo Como Obter a Documentação da &API; do &tdevelop;). Ou então o comando configure descobriu automaticamente uma &API; das Bibliotecas do &kde; gerada pelo &doxygen; num dos locais normais que ele conhece à partida. Ou, como último recurso, a pasta $TDEDIR/share/doc/HTML/en/tdelibs-apidocs/ foi encontrada no primeiro arranque do &tdevelop;. Se o &tdevelop; não encontrou nenhuma documentação da &API; das Bibliotecas do &kde; gerada pelo &doxygen;, então a lista da Documentação Gerada pelo Doxygen aparecerá vazia. Você poderá adicionar os seus próprios itens de documentação da &API; (⪚ dos seus projectos actuais), usando os botões à direita. Se os quiser incluir na pesquisa indexada ou por texto completo marque as opções Índice ou Procurar da tabela de configuração. O &tdevelop; usa a informação do título do ficheiro index.html. Daí, o campo Título na janela de Propriedades do Catálogo de Documentação estar inacessível. O sistema do &kde; fornece mais documentação da &API; do que apenas a &API; das Bibliotecas do &kde;. Você irá precisar de mais informações de interfaces se quiser, ⪚, incluir a componente do &kate; nos seus programas. Para esta &API; da componente do &kate;, você deverá compilar e instalar a &API; das Bibliotecas de Base do &kde; a partir do código (com os comandos make apidox e make install no código do tdebase), adicionando então um item à lista Documentação Gerada pelo Doxygen como se segue: Adicionar uma &API; de Base do &kde; à Lista Adicionar uma &API; de Base do &kde; à Lista (Claro que deverá substituir a directoria /home/dev/o-meu-kde/ no campo Localização com a localização da sua instalação do &kde;). Você precisa também de colocar a &API; do seu projecto actual nesta Colectânea de Documentação do Doxygen. As versões mais antigas do &tdevelop; colocavam-na na árvore de documentação ao nível do projecto. Isto já não é mais suportado. O bloco principal da árvore de documentação do &tdevelop; fornece o acesso imediato à documentação estruturada, seja esta local ou remota. Você poderá configurar isto na página da Colectânea de Documentação do KDevelopTOC. Fornecer o acesso à documentação estruturada do KDevelopTOC O &tdevelop; vem com um conjunto de ficheiros KDevelopTOC predefinidos que são introduzidos automaticamente na tabela, na altura da instalação. Para manter o ambiente de trabalho fácil de gerir, só a documentação usada com maior frequência é que será marcada inicialmente para ser visualizada. Se você quiser ver outra documentação, marque a opção TOC na tabela de configuração. Os ficheiros KDevelopTOC não podem ser indexados para fazer uma pesquisa por texto completo, porque normalmente apontam para uma localização remota. Por outro lado, qualquer um desses ficheiros .toc poderá ter um índice definido manualmente, usando a marca <index>. Daí, a opção Índice ficará activa apenas quando o &tdevelop; encontrar uma marca <index> no ficheiro .toc. (Para mais detalhes, veja a descrição em baixo na secção de Ficheiros de Índice do &tdevelop;.) A opção Procurar na tabela de configuração ficará sempre desactivada. Você poderá adicionar novos itens com os botões à direita da lista. O &tdevelop; irá filtrar os ficheiros *.toc na janela de directoria associada aos botões Adicionar e Editar. Só nas versões mais antigas do &tdevelop; é que o botão Remover irá alterar os ficheiros *.toc em disco, como tal a operação de remoção é segura agora. Existe uma funcionalidade especial associada a isto. Para ilustrá-la, siga estes passos: Na árvore de documentação, escolha um item ligeiramente abaixo da documentação do &Qt;/&kde; (⪚, o Livro de Programação no KDE2 (kde.org)). Carregue no sinal de mais (+) ao lado dele. Irá abrir uma árvore, na qual você poderá navegar pelos capítulos subsequentes que se encontram vários níveis abaixo, tudo de forma desligada. Porém, se você seleccionar finalmente um dos capítulos, o &tdevelop; irá em muitos dos casos tentar aceder a um ficheiro de documentação remoto. A razão por detrás disto e não só navegar localmente pela documentação remota sem desperdiçar recursos de acesso à rede, mas também para oferecer ao programador um acesso simples e estruturado à documentação que precisa. Com as ferramentas aqui oferecidas, uma pessoa poderá aceder a quase qualquer documentação local ou remota de forma estruturada, mesmo que o documento original seja um só ou a sua estrutura original seja diferente. Tudo o que é preciso é o acesso aos ficheiro e/ou partes dos outros ficheiros que são legíveis no &konqueror;. Esse acesso estruturado é possível com a utilização de ficheiros de índice especiais, os quais são identificados pela extensão .toc. Qualquer um desses ficheiros de índice do &tdevelop; contêm uma descrição estruturada em &XML; do documento a ser acedido. Directoria Normal dos Ficheiros de Índice do &tdevelop; Quando o &tdevelop; foi instalado, normalmente foi colocada uma série de ficheiros .toc predefinidos na directoria $TDEDIR/share/apps/kdevdoctreeview/tocs. Estes são ficheiros de texto estruturado relativamente simples. Você poderá olhar para eles com um editor de texto ou com outra funcionalidade de apresentação de texto. cabeçalho <!DOCTYPE tdeveloptoc> <tdeveloptoc> (título) (endereço de base) (estrutura do conteúdo) (estrutura do índice) </tdeveloptoc> Esta estrutura em &XML; será processada pelo 'plugin' de Documentação do &tdevelop; para configurar o conteúdo da árvore de documentação e para guiar o utilizador na navegação pela documentação. Ele contém toda a informação necessária para mostrar os títulos e aceder ao conteúdo do ficheiro de documentação. title <title> (algum texto de título) </title> Este é o título que o &tdevelop; irá mostrar nos níveis básicos da árvore de documentação. Este título apresentado não pode de momento ser alterado pelo utilizador. Se você quiser mostrar outro texto, você terá de alterar manualmente o item <title> no ficheiro .toc. endereço de base <base href=" (&URL; do documento de base) "/> Este &URL; aponta para a localização em que todos os ficheiros desta documentação se localizam. Será inserida no início de cada &URL; de secção na seguinte lista da estrutura do conteúdo. Por isso, se você ⪚ obter alguma documentação de um servidor remoto, tudo o que precisa para mostrar os ficheiros nesta nova localização é mudar o &URL; da <base>. estrutura do conteúdo <tocsect1 name=" (título da secção) " url=" (&URL; da secção) "> ... <tocsectn name=" (título da secção) " url=" (&URL; da secção) "/> ... </tocsect1> Toda a informação restante de navegação e de acesso é guardada numa série de pares <tocsecti> ... </tocsecti> aninhados. Cada i corresponde a um nível consecutivo de aninhamento abaixo do nível n, correspondente à secção de documentação finalmente apresentada. Todos os itens <tocsecti> devem ter um atributo name="xxx" associado a eles (o "xxx" representa o título actual). Isto será mostrado como o título do nível na árvore de documentação. Ele irá corresponder a uma secção da documentação actual. Poderá existir um atributo url="" associado ao nível de aninhamento i. Quando o utilizador carregar no título de uma secção da documentação, o &tdevelop; irá tentar aceder ao ficheiro na localização indicada pelo endereço de base combinado com o &URL; da secção. O item <tocsectn/> precisa de ter um atributo url="", de qualquer forma. Este <tocsectn/> final não vem aos pares, mas será sim fechado por um / antes do carácter >. Qualquer endereço resultante da combinação do endereço de base e do &URL; da secção precisam de apontar para um ficheiro de texto visível. Normalmente, este será um ficheiro estruturado em HTML. É possível fazer referência a 'âncoras' num desses ficheiros, usando a notação normal do '#', com o formato: /url-de-base/url-da-seccao#ancora. estrutura do índice <index> <entry name=" (título do índice) " url=" (&URL; da secção do índice) "/> </index> O índice é uma lista simples de itens de índice - pares de títulos e &URL;s. O índice não é obrigatório. A documentação do DevHelp é outra forma de aceder à documentação estruturada. Ele usa os ficheiros de índice estruturados identificados por uma extensão .devhelp semelhante aos ficheiros TOC do &tdevelop; para aceder à documentação do ambiente de trabalho do GNOME 2. Você poderá controlar quais os ficheiros do DevHelp que deverão estar acessíveis na página de configuração da Colectânea de Documentação do DevHelp. Fornecer a documentação do DevHelp Os ficheiros do DevHelp originalmente estavam acessíveis no 'site' Web do LiDN, mas estes parece que não são mantido já há algum tempo. A documentação do DevHelp mais recente está disponível na página Web para Obter os Livros do DevHelp. Quando o &tdevelop; é instalado, ele irá tentar procurar todos os ficheiros .devhelp nos locais-padrão do sistema, ⪚ nas sub-pastas de /opt/gnome/share/. Inicialmente, estes ficheiros não serão marcados para serem visualizados. Se quiser ver outra documentação, marque a opção TOC da tabela de configuração. Você poderá adicionar novos itens com os botões à direita da lista. O &tdevelop; irá filtrar os ficheiros *.toc na janela de directoria associada aos botões Adicionar e Editar. Isto é para o seu próprio fim. Você poderá adicionar quase qualquer tipo de documentação, desde que possa ser mostrada pelos 'plugins' do &konqueror;. Fornecer a documentação personalizada Normalmente, esta colecção estará vazia no primeiro arranque do &tdevelop;. Foi preenchido deliberadamente um item para mostrar a estrutura do item. O tratamento é relativamente simples aqui. Use os botões à direita da lista para adicionar, editar ou remover os itens dos documentos. O &tdevelop; não irá filtrar nada da janela de directorias que esteja associado aos botões Adicionar e Editar. Você terá de seleccionar explicitamente os itens para os mostrar na funcionalidade de documentação do &tdevelop;. Marque a opção TOC do item na tabela de configuração. A documentação personalizada não pode ser indexada ou pesquisada. Como tal, as opções Índice e Procurar não farão efeito, como é mostrado acima. (... ainda não escrito ...) Configurar os índices de pesquisa de texto (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...) (... ainda não escrito ...)