# Lidar com 'Plugins'

O &kate; oferece diversos tipos de 'plugins'. Existem dois desses tipos de 'plugins': alguns são escritos em C++ nativo, enquanto outros são programados em Python. Existem diferenças subtis entre eles, descritas mais abaixo.

Poderá activar ambos os tipos de 'plugins' na janela de configuração, a qual também oferece acesso às opções de configuração adicionais dos 'plugins' que necessitem deles.

## 'Plugins' da Aplicação &kate;

Os 'plugins' do &kate; são funções adicionais para o editor &kate;. Eles poderão adicionar menus e atalhos extra, assim como extender as funcionalidades do &kate;. Poderá instalar ou desinstalar os que quiser, dentro do &kate;. Abra a janela de configuração do &kate; com a opção Configuração Configurar o &kate;.... Seleccione o Aplicação'Plugins' para escolher os 'plugins' desejados.

Os 'plugins' de aplicações disponíveis são:

- Navegador de registos de chamadas - Ferramenta de navegação em chamadas a funções

- 'Plugin' de Compilação - Compila o projecto e processa as mensagens de erro

- Fechar Excluindo/Incluindo - Fecha um grupo de documentos com base numa extensão ou localização comuns

- CTags - Procurar definições/declarações com o CTags

- Selector de documentos - Mudança rápida de documentos com o comportamento do &Alt;

- Navegador do sistema de ficheiros - Ferramenta de navegação no sistema de ficheiros

- Documentos - Mostra os ficheiros abertos numa árvore de ficheiros

- &gdb; - Oferece uma interface simples para o &gdb;

- Lumen - o Lumen é um 'plugin' de completação automática para o D, usando o servidor DCD

- Abrir o Ficheiro de Inclusão - Abre o ficheiro .h/[.cpp|.c] correspondente

- 'Plugin' de Projectos - 'Plugin' de gestão de projectos para o Kate

- Replicode

- Completação de código Rust - Ajuda na finalização de código-fonte em Rust

- Pesquisa & Substituição - Pesquisa ou substitui padrões nos documentos abertos ou nos ficheiros em disco

- Área de excertos - uma janela que incorpora a gestão de excertos de texto

- 'Plugin' de SQL - Executa pesquisas sobre bases de dados em SQL

- Visualizador de Símbolos - Extrair e apresentar símbolos de referência em código-fonte

- Área de terminal - uma janela que incorpora um emulador de terminal

- Filtro de Texto - Filtragem de texto simples

- Completação de &XML;- Apresenta os elementos de &XML;, os seus atributos, valores e entidades permitidas pela DTD

- Validação de &XML; - Valida os ficheiros em &XML; com o 'xmllint'

## 'Plugin' de Navegação em Registos de Chamadas

### Usar o 'Plugin' de Navegação de Registos de Chamadas

Este 'plugin' destina-se aos programadores e poderá ser de pouca utilidade para utilizadores comuns. Ele mostra um registo de chamadas gerado pelo 'gdb' numa lista especial no &kate;. Se carregar sobre um item, irá abrir o ficheiro seleccionado, saltando para o número de linha correcto. Funciona para os registos de chamadas gerados na sua própria máquina, mas também irá funcionar para os registos de chamadas de outras pessoas, &ie; com o `/home/teste/qt-copy/…/qwidget.cpp`, o mesmo também poderá existir noutras máquinas. Para isso funcionar, tem de indexar as pastas em que se localiza o código-fonte.

Em algumas vezes existem diversos ficheiros com o mesmo nome, ⪚

- `kdegraphics/okular/generators/dvi/config.h`
- `kdepim-runtime/resources/gmail/saslplugin/config.h`

Para escolher a opção correcta, o 'plugin' recolhe as duas últimas partes do URL, sendo que neste caso seria

- `dvi/config.h`
- `saslplugin/config.h`

E então normalmente o 'plugin' descobre o correcto.

A indexação do 'master' e de algumas ramificações irá obviamente conduzir a um conflito.

### Configuração

Na página de configuração, adicione as pastas que contêm o código-fonte.

Gestor de Estoiros
Área de ferramentas de Configuração de Localizações no Registos de Chamadas

Se carregar em OK, irá iniciar a indexação. Quando esta terminar, abra a área de ferramentas do Navegador de Registos de Chamadas.

Agora poderá carregar um registo de chamadas a partir da área de transferência (⪚. quando carregou em Copiar para a Área de Transferências no DrKonqi) ou de um ficheiro.

## 'Plugin' de Compilação

### Introdução

O 'plugin' de Compilação permite-lhe executar passos como a compilação ou limpeza de um projecto.

### Usar o 'Plugin' de Compilação

O plugin' de compilação adiciona uma área de ferramentas Resultado da Compilação no fundo e um submenu Compilar no menu principal. A área de ferramentas poderá ser usada para configurar as opções do alvo de compilação, enquanto o menu pode ser usado para executar as acções de compilação e limpeza.

Resultado da Compilação

A área do Resultado da Compilação tem duas páginas:

- Configuração do Alvo

- Resultado

#### Página de Configuração do Alvo

A página de configuração do alvo pode ser usada para configurar diversos alvos de compilação e definir conjuntos para os mesmos.

Para mudar os nomes ou os comandos, faça duplo-click sobre os elementos na tabela e use a lista para seleccionar o conjunto de alvos activo. Use a opção de marcação à frente de cada alvo para criar uma predefinição.

Um novo conjunto de alvos contém diversas opções de configuração:

Pasta de Trabalho

- Poderá definir a localização do projecto aqui. Deixe-a em branco para usar a pasta onde se encontra o documento actual.

Compilar

- Esta opção permite-lhe definir o comando de compilação. Está configurada como `make` por omissão.

Limpar

- Esta opção permite-lhe definir o comando de limpeza. Está configurada como `make clean` por omissão.

Configuração

- Esta opção permite-lhe definir o comando de limpeza. Está configurada como `cmake -DCMAKE_BUILD_TYPE=Debug -DCMAKE_INSTALL_PREFIX=/usr/local ../` por omissão.

No topo, este 'plugin' tem uma barra de ferramentas com os seguintes botões :

- Compilar o alvo seleccionado
- Adicionar um novo alvo de compilação
- Criar um novo conjunto de alvos de compilação
- Copiar um comando ou conjunto de alvos
- Apagar o comando actual ou o conjunto de alvos

#### Página do Resultado

A página do Resultado mostra o resultado na consola gerado pelo último comando.

Use a barra no topo para mostrar ou esconder as categorias do resultado:

Resultado Completo, Resultado Processado, Erros e Avisos ou Apenas os Erros

Cada linha contém uma mensagem, o nome e o número da linha do ficheiro, se estiver disponível. Se carregar no erro ou aviso irá para o ficheiro apropriado e coloca o cursor no número de linha correspondente.

Para ir para o erro anterior, carregue em &Ctrl;&Alt;Esquerda. No caso do erro seguinte, carregue em &Ctrl;&Alt;Direita.

### Estrutura do Menu

Compilar Seleccionar o Alvo

- Seleccione um item da lista de alvos configurados pelo utilizador.

Compilar Compilar o Alvo Por Omissão

- Compila o alvo definido por omissão no conjunto de alvos activo.

Compilar Compilar o Alvo Anterior

- Muda para o alvo anterior que estiver configurado pelo utilizador.

Compilar Parar

- Interrompe a compilação de um alvo.

&Ctrl;&Alt;Esquerda Compilar Erro Anterior

- Move o cursor para o local do erro anterior no documento.

&Ctrl;&Alt;Direita Compilar Erro Seguinte

- Move o cursor para a posição do erro seguinte no documento.

### Agradecimentos e Reconhecimentos

O 'Plugin' de Compilação do &kate; foi criado por Kåre Särs.

Muito obrigado ao participante no Google Code-In de 2011, Salma Sultana, por escrever a maior parte desta secção.

## 'Plugin' de Fecho com Exclusão/Inclusão

### Introdução

Este 'plugin' permite-lhe fechar um grupo de documentos com base numa extensão ou localização comuns.

### Usar o 'Plugin' de Fecho de Inclusão/Exclusão

Assumindo que tem estes documentos abertos no &kate;:

- /tmp/subpastas/teste.h
- /tmp/teste.cpp
- /tmp/teste.txt

Então terá as seguintes opções para fechar os documentos, como representado na imagem:

Fechar Excluindo

Use a opção de marcação no último item da lista para activar ou desactivar uma janela de confirmação. A opção seleccionada será aplicada a ambas as acções de fecho.

### Estrutura do Menu

Ficheiro Fechar Excluindo

- Fecha todos os documentos abertos, excepto os que corresponderem à localização ou extensão de ficheiros seleccionada no submenu.

Ficheiro Fechar do Tipo

- Fecha todos os documentos abertos que corresponderem à localização ou extensão de ficheiros seleccionada no submenu.

## 'Plugin' do CTags

### Introdução

O CTags gera um ficheiro de índice (ou de marcas) com os objectos da linguagem descobertos nos ficheiros de código, o que permite que estes itens sejam localizados de forma rápida e simples, usando este 'plugin' no &kate;.

Uma marca corresponde a um objecto da linguagem para o qual está disponível um elemento do índice (ou, em alternativa, o elemento do índice criado para esse objecto).

A geração de marcas é suportada para estas linguagens de programação.

### Configuração

O 'plugin' do CTags usa dois ficheiros de bases de dados diferentes para o índice.

Na página de configuração do CTags, na configuração do &kate;, poderá adicionar ou remover pastas que contêm o código-fonte e voltar a gerar a base de dados comuns do CTags.

#### Índice Comum

Configuração do CTags
Configurar a Base de Dados Global do CTags

No fundo da página de configuração, poderá adaptar o comando CTags.

Para mais informações sobre todas as opções disponíveis, leia por favor a página de manual do CTags. Esta página de manual está disponível no &khelpcenter;. podendo também introduzir directamente o &URL; man/:ctags no &konqueror;

Se carregar em Actualizar, irá iniciar a indexação. Quando esta terminar, feche a janela.

#### Índice da Sessão

Para configurar o índice da sessão, abra a área do CTags.

Destinos do Índice

- Nesta página, poderá adicionar ou remover pastas que contêm o código-fonte, gerando de novo manualmente a base de dados do CTags específica da sessão.

Base de Dados

- Configuração da Base de Dados
  Configurar a Base de Dados de Sessões do CTags

  Seleccione um outro ficheiro de base de dados do CTags, configure o comando CTags ou reponha o comando por omissão.

### Usar o 'Plugin' do CTags

Poderá colocar o cursor do rato no objecto da linguagem, por exemplo a função, símbolo, &etc; em que está interessado, seleccionando depois uma das acções no menu CTags para saltar para a linha e ficheiro onde se encontra definido ou declarado o objecto.

Por omissão, as acções do menu CTags não têm combinações de teclas associadas. Use o editor de atalhos do teclado para configurar os seus próprios atalhos.

Em alternativa, use o campo de pesquisa da página Pesquisa na área do CTags.

A introdução de caracteres no campo de pesquisa irá iniciar a mesma e apresentará os nomes dos objectos da linguagem, como as funções, classes, símbolos &etc;, em conjunto com o tipo e nome do ficheiro.

Seleccione um item na lista para ir para a linha correspondente no ficheiro de código.

### Estrutura do Menu

CTags Recuar um passo

- Recua um passo no histórico para a última marca visitada.

CTags Procurar o Texto Actual

- Abre a página Pesquisa da área do CTags e mostra todos os objectos da linguagem que correspondem à selecção de texto actual na lista.

CTags Ir para a Declaração

- Se o cursor estiver num objecto de definição, isto irá abrir o documento que contém a declaração correspondente, caso necessário, activar a sua visualização e colocando o cursor no início da declaração.

CTags Ir para a Definição

- Se o cursor estiver num objecto de declaração, isto irá abrir o documento que contém a definição correspondente se necessário, activar a sua visualização e colocar o cursor no início da definição.

## 'Plugin' de Mudança de Documentos

### Estrutura do Menu

&Ctrl; Ver Últimas Vistas Usadas

- Abre uma lista com os últimos documentos visualizados:

  Últimos documentos visualizados

  Mantenha a combinação de teclas &Ctrl; carregada, podendo usar as teclas Cima, Baixo, Home ou End para navegar na lista. Se carregar num carácter, irá consecutivamente circular por todos os itens que correspondam ao mesmo na lista. Se libertar as teclas de atalho, a vista irá mudar para o documento seleccionado na lista.

## Navegador no Sistema de Ficheiros

O Navegador do Sistema de Ficheiros é um visualizador de pastas que lhe permite abrir os ficheiros de uma pasta visível na área actual.

### Estrutura do Menu

Ver Áreas de Ferramentas Mostrar o Navegador do Sistema de Ficheiros

- Activa/desactiva a visualização do Navegador do Sistema de Ficheiros do &kate;.

### Interface

De cima para baixo, o Navegador do Sistema de Ficheiros consiste nos seguintes elementos:

Uma Barra de Ferramentas

- Esta contém os botões de navegação comuns:

  Recuar

- Faz com que a área de pastas faça um `cd` para a pasta anteriormente apresentada no histórico. Este botão está desactivado caso não exista nenhum item anterior.

Avançar

- Faz com que a área de pastas faça um `cd` para a pasta seguinte apresentada no histórico. Este botão está desactivado caso não exista nenhum item posterior.

Favoritos

- Abre um submenu para editar ou adicionar favoritos, bem como para adicionar uma nova pasta de favoritos.

Pasta Actual do Documento

- Este botão fará com que a área de pastas faça um `cd` para a pasta do documento activo de momento, se possível. Este botão está desactivado se o documento activo for um ficheiro novo e não-gravado ou se a pasta onde reside não puder ser acedida.

Opções

- Vista Abreviada

- Mostra apenas os nomes dos ficheiros.

Vista Detalhada

- Mostra o Nome, a Data e o Tamanho dos ficheiros.

Vista em Árvore

- Como a Vista Curta, só que poderá expandir as pastas para ver o seu conteúdo.

Árvore Detalhada

- Isto também permite expandir as pastas, mas mostra as colunas adicionais que estão disponíveis na Vista Detalhada.

Mostrar os Ficheiros Escondidos

- Mostra os ficheiros normalmente escondidos pelo seu &OS;.

Sincronizar automaticamente com o documento actual

- Quando esta opção estiver activa, o navegador do sistema de ficheiros fará um `cd` automático para a pasta do documento aberto de momento na área de edição, sempre que esta alterar.

Um Item de Localização

- Isto mostra a navegação pelas pastas constituintes da localização completa da pasta aberta de momento, como no &dolphin;. Poderá carregar em qualquer pasta para navegar para dentro dela ou carregar numa das setas para seleccionar qualquer pasta abaixo dela. Seleccione a primeira seta para escolher dentro da sua lista de Locais, a qual lhe mostrará um ícone que representa o seu local actual.

  Poderá também carregar à direita da área de navegação para que esta mude para um campo de texto, no qual poderá escrever a localização da pasta a navegar. O item do &URL; mantém uma lista com as localizações escritas anteriormente. Para escolher uma, use o botão da seta à direita do campo.

  O item do &URL; tem activada a completação automática das pastas. O método de completação pode ser definido com o menu do &RMB; do campo de texto.

Uma Área de Pastas

- Esta é uma área de pastas normal do &kde;.

Um Item de Filtragem

- O campo do Filtro permite-lhe indicar um filtro para os ficheiros apresentados na área de pastas. O filtro usa padrões globais normais, separados por espaços em branco. Exemplo: `*.cpp *.h *.moc`

  Para mostrar todos os ficheiros, indique um simples asterisco `*`.

  O campo do filtro grava os últimos 10 filtros introduzidos entre sessões. Para usar um, carregue no botão de setas à direita do campo e seleccione o filtro desejado. Poderá desactivar o filtro se carregar no botão Limpar o texto à esquerda do botão de auto-completação.

### Configuração

Este 'plugin' pode ser configurado na página do Navegador do Sistema de Ficheiros da configuração do &kate;.

Barra de Ferramentas

- Configure os botões da barra do navegador, movendo os que deseja activar para a lista de Acções Seleccionadas, ordenando-os com os botões das setas ao lado da lista.

## A Lista de Documentos

### Introdução

A lista de documentos apresenta uma lista com todos os documentos abertos de momento no &kate;. Os ficheiros modificados irá ter um pequeno ícone de disquete à sua esquerda para indicar esse estado.

No topo da lista de Documentos, existe uma barra de ferramentas com os seguintes botões:

- Criar um novo documento
- Abrir um documento existente
- Documento Anterior
- Documento Seguinte
- Gravar o documento actual
- Gravar o documento actual com um novo nome

Por omissão, a lista de Documentos aparece no Modo em Árvore, que apresenta a estrutura de pastas que rodeia todos os documentos abertos de momento. Também está disponível o Modo em Lista, que apresenta uma lista simples com todos os documentos abertos. Poderá mudar de modos se carregar com o botão direito sobre a lista e os seleccionar no menu Modo de Visualização.

Se dois ou mais ficheiros com o mesmo nome (em pastas diferentes) estiver abertos no Modo de Lista, os nomes dos seguintes terão um (2) adicional e assim por diante. A dica para o ficheiro irá mostrar o seu nome completo, incluindo a localização, permitindo-lhe escolher o que pretende realmente.

Para mostrar um documento na página activa de momento, carregue no nome do documento na lista.

O menu de contexto tem algumas acções comuns do menu Ficheiro.

Para além disso, existem acções de gestão de ficheiros para mudar o nome ou remover o ficheiro. Com a opção Copiar o Nome do Ficheiro, poderá copiar a localização completa do documento para a área de transferência.

Poderá ordenar a lista de diferentes formas, carregando para tal com o botão direito na lista e seleccionando a opção Ordenar Por do menu. As opções são:

Nome do Documento

- Apresenta os documentos por ordem alfabética do seu nome.

Localização do Documento

- Apresenta os documentos por ordem alfabética da sua localização.

Ordem de Abertura

- Apresenta os documentos pela ordem da sua abertura.

A lista de documentos irá por omissão visualizar o seu histórico, sombreando os itens mais recentes com uma determinada cor de fundo. Se o documento foi editado, será misturada uma cor extra. O documento mais recente tem a cor mais forte, pelo que poderá encontrar facilmente os documentos em que está a trabalhar. Esta funcionalidade poderá ser desactivada na página de Documentos da janela de configuração.

A localização predefinida da lista de documentos na janela do &kate; é à esquerda da área de edição.

### Estrutura do Menu

&Ctrl;&Alt;Cima Ver Documento Anterior

- Abre o documento apresentado acima do documento aberto de momento na lista de Documentos.

&Ctrl;&Alt;Baixo Ver Documento Seguinte

- Abre o documento apresentado abaixo do documento aberto de momento na lista de Documentos.

Ver Mostrar o Activo

- Mostra o documento aberto de momento na lista de Documentos.

### Configuração

Sombra do Fundo

- Esta secção permite-lhe activar ou desactivar a visualização sombreada do fundo face à sua actividade recente, escolhendo quais as cores a usar se estiver activa.

Ordenar Por

- Defina como deseja ordenar a lista de documentos. Isto também poderá ser feito a partir do menu do &RMB; na lista documentos.

Modo de Visualização

- Isto oferece duas opções que afectam a visualização da área de Documentos. A opção da Vista em Árvore irá apresentar os documentos numa árvore por baixo da pastas em que se encontram, enquanto a Vista em Lista irá apresentar uma lista simples de documentos.

Mostrar a Localização Completa

- Quando a vista em Árvore e esta opção estiverem activadas, os itens da pasta apresentados na área de Documentos irão apresentar a localização completa da pasta, para além do nome da pasta. Não fará qualquer efeito na vista em Árvore.

## 'Plugin' do &gdb;

### Introdução

O 'plugin' do &gdb; para o &kate; oferece uma interface simples para o conhecido depurador do Projecto &GNU;.

Recomenda-se alguma experiência anterior com o &gdb;. Para mais informações sobre a utilização do &gdb;, visite a página Web do &gdb;.

Poderá activar o 'plugin' do &gdb; na secção 'Plugins' da configuração do &kate;.

Para o 'plugin' funcionar correctamente, deverá ter um ficheiro de código (de qualquer tipo suportado pelo &gdb;) e um executável.

Se compilar com o &gcc;/`g++`, poderá querer usar o argumento da linha de comandos ``-ggdb``.

Depois de efectuar estas preparações, abra o ficheiro de código no &kate;, indique a localização do executável na página de Configuração da área de Depuração e seleccione a opção do menu Depuração Iniciar a Depuração para começar.

### Estrutura do Menu e da Barra de Ferramentas

Todas estas opções estão disponíveis nos menus do &kate;, estando também muitas disponíveis na barra de Depuração.

Ver Áreas de Ferramentas Mostrar a Área de Depuração

- Mostra uma área de ferramentas que contém o resultado do &gdb;, a linha de comandos usada pelo &gdb; e outras opções.

Ver Áreas de Ferramentas Mostrar os Locais e Pilha

- Mostra uma lista com todas as variáveis carregadas de momento e os seus valores, bem como um registo de chamadas do &gdb;.

Depurar Alvos

- Um submenu que contém uma lista de alvos (executáveis).

Depurar Iniciar a Depuração

- Inicia o &gdb; com um dado alvo.

Depurar Matar / Parar a Depuração

- Pára o &gdb;.

Depurar Reiniciar a Depuração

- Reinicia o &gdb;.

Depurar Comutar o Ponto de Paragem

- Define um ponto de paragem na posição actual do cursor.

Depurar Avançar Para

- Executa a instrução actual (a chamada à função será depurada).

Depurar Avançar Sobre

- Executa a instrução actual (a chamada à função não será depurada).

Depurar Sair De

- Prossegue a execução até que o programa em execução termine.

Depurar Mover o PC

- Move o contador do programa (execução seguinte).

Depurar Executar Até ao Cursor

- Executa o programa até que atinja a posição actual do cursor.

Depurar Continuar

- Ignora os pontos de paragem e executa o programa até que termine (com sucesso ou não).

Depurar Imprimir o Valor

- Imprime o valor da variável para onde aponta o cursor de momento.

Configuração Barras de Ferramentas Visíveis'Plugin' do &gdb;

- Mostra a barra de depuração.

### Área de Depuração

A Área de Depuração consiste em várias páginas:

Resultado do &gdb;

- Contém o resultado do &gdb; e uma linha de comandos também do &gdb;.

  A Página do Resultado A página do Resultado.

  A página do Resultado mostra o resultado de uma sessão de depuração.

Configuração

- Executável

- Localização do alvo (executável) para depuração.

Pasta de Trabalho

- A pasta de trabalho conferida ao alvo.

Argumentos

- Os argumentos passados ao programa.

Manter o foco

- Mantém a linha de comandos do &gdb; em primeiro plano.

Direccionar a E/S

- Abre uma nova página de E/S na Janela de Depuração, onde poderá ver os resultados e introduzir dados no programa em execução.

A janela de Configuração A janela de Configuração

A página Configuração mostra as definições de uma sessão de depuração.

E/S

- Contém uma área que mostra os resultados do programa em execução e uma linha de comandos onde pode introduzir dados para ele.

  A Página de E/S A página de E/S.

  A página do E/S mostra o resultado de um programa de testes simples.

### Pilha de Chamadas e Variáveis Locais

A área da Pilha de Chamadas contém uma lista dos registos de chamadas que são devolvidos pelo &gdb;.

A Área de Registos de Chamadas do &gdb; A área de ferramentas para o registo de chamadas.

A área da Pilha de Chamadas do 'plugin' do &gdb;.

A área de Locais contém uma lista com todas as variáveis carregadas de momento do programa, bem como os seus valores correspondentes.

A Área de Variáveis Locais do &gdb; A área de ferramentas de Variáveis Locais.

A área de Variáveis Locais do 'plugin' do &gdb;.

### Agradecimentos e Reconhecimentos

Muito obrigado ao participante no Google Code-In de 2011, Martin Gergov, por escrever a maior parte desta secção.

## 'Plugin' do Lumen

O Lumen é um 'plugin' que oferece a completação de código para a linguagem de programação D. É apenas uma interligação entre o editor e o Servidor de Completação de D (um servidor que fornece todas as as informações), chamado de DCD. O 'plugin' suporta todas as funcionalidades importantes do servidor de completação: fornecer o servidor com ficheiros de importação, apresentar a documentação e diversos tipos de completação:

Importações:

Importações

Completação Básica:

Completação Básica

Completação (Função substituída):

Completação (Função substituída)

Dica de chamadas:

Dica de chamadas

Para que o Lumen funcione, terá de instalar o DCD, usando a informação fornecida pela comunidade do D.

Depois de instalar o DCD, edite o `~/.config/dcd/dcd.conf` (crie-o se não existir já) e adicione uma localização dos seus ficheiros de inclusão/importação do D ⪚ `/usr/include/dlang/dmd` ou `/usr/include/d`.

Para além disso, o Lumen irá tentar ler um `.lumenconfig` em cada pasta-mãe do ficheiro de código em D aberto de momento e adiciona todas as linhas neste ficheiro como locais de inclusão no servidor DCD. Adicione todas as dependências do seu projecto actual a este ficheiro.

Agora inicie o servidor de completação com o `dcd-server`, active o 'plugin' do Lumen na sua configuração e poderá ter a completação de código da linguagem de programação D no &kate;

## 'Plugin' de Abertura de Ficheiros de Inclusão

### Usar o 'Plugin' para Abrir o Ficheiro de Inclusão

Ao editar código em C ou C++, este comando irá alternar entre um ficheiro de inclusão e o seu ficheiro de código em C/C++ e vice-versa.

Por exemplo, se estiver a editar o ficheiro `classe.cpp`, esta acção irá mudar para o `classe.h` se este ficheiro estiver disponível na mesma pasta.

Os pares das seguintes extensões de ficheiros irão funcionar:

- Ficheiros de inclusão: h, H, hh, hpp
- Ficheiros de código: c, cpp, cc, cp, cxx

### Estrutura do Menu

F12 Ficheiro Abrir o .h/.cpp/.c

- Abre os ficheiros de inclusão ou de código correspondentes para o documento activo.

## 'Plugin' de Projectos

### Introdução

A ideia básica do 'plugin' do Projecto é ter uma lista estrutura dos ficheiros que pertencem ao projecto, com as seguintes propriedades:

1. Oferece uma vista estruturada dos ficheiros

2. Tornar mais rápida e simples a mudança de projectos

3. Suporte para a pesquisa/substituição num projecto

4. Oferta de uma completação automática simples

5. Facilitar a abertura rápida de ficheiros no projecto

6. Suporte para a compilação do projecto

### Vista Estrutura dos Ficheiros

Assim que o 'plugin' do Projecto for carregado na página de configuração do &kate;, abra um ficheiro num projecto para que apareça uma barra lateral que apresenta todos os projectos, assim como os ficheiros do projecto, da seguinte forma:

Área do Projecto

Como poderá ver, o projecto activo de momento é o Kate, e o seu conteúdo está apresentado na árvore. Se carregar nos ficheiros da vista em árvore, irá abrir o ficheiro no editor. Para além disso, será oferecido um menu de contexto com o qual poderá abrir os ficheiros com outras aplicações, como poderá acontecer com um ficheiro `.ui` no Qt Designer.

Poderá filtrar os itens, escrevendo parte do nome do ficheiro que está a tentar procurar na barra de pesquisa que existe no fundo da lista.

### Mudança de Projectos

A ideia é que nunca teria de abrir um projecto manualmente; isto até nem é suportado de todo. Como tal, o que acontece é que, se abrir um ficheiro, o 'plugin' do Projecto analisa rapidamente a pasta e as suas pastas-mãe à procura de um ficheiro `.kateproject`. Se o encontrar, o projecto será carregado automaticamente.

Para além disso, se abrir outro documento no &kate; que pertença a outro projecto, o 'plugin' de Projecto muda automaticamente o projecto actual. Assim, de forma intuitiva, estará sempre activo o projecto correcto. Obviamente, também poderá mudar o projecto activo de momento com a lista.

### Procurar e Substituir nos Projectos

O &kate; tem um 'plugin' de Pesquisa e Substituição que aparece na barra lateral inferior. Se for carregado um projecto, abra a barra de Pesquisa e Substituição e mude para o modo respectivo para pesquisar e substituir no projecto actual:

Pesquisar nos Projectos

### Completação Automática Simples

Com o conhecimento de todos os ficheiros que pertencem a um projecto, o 'plugin' de Projectos oferece algumas capacidades simples de completação automática com base no CTags. Se um projecto estiver inicialmente aberto, o CTags processa todos os ficheiros do projecto em segundo plano, gravando a informação do CTags na pasta `/tmp`. Este ficheiro será então usado para preencher a área de completação automática no &kate;.

Em contraste, sem esta completação automática, o &kate; só será capaz de apresentar os itens de completação automática com base nas palavras do ficheiro actual. Como tal, a completação automática fornecida pelo 'plugin' de Projectos é muito mais poderosa.

Completação nos Projectos

Se o CTags estiver em falta, irá aparecer uma mensagem de aviso passiva a avisar desse facto. Também de notar que o ficheiro do CTags na pasta `/tmp` é apagado quando o &kate; sair, pelo que o 'plugin' não polui nenhuma pasta com ficheiros indesejados.

### Abertura Rápida dos Ficheiros

Dado que carregar nos ficheiros da árvore não é a forma mais rápida de abrir um ficheiro, o &kate; oferece um mecanismo de abertura rápida incorporado, que poderá activar com a combinação &Ctrl;&Alt;O. O que irá obter é uma lista como a seguinte:

Abertura Rápida

Também poderá filtrar se escrever partes do nome do ficheiro que está à procura, podendo também navegar com as teclas de cursores e com a tecla Page Up/Down na lista. Se carregar em &Enter;, irá activar o ficheiro seleccionado, enquanto o &Esc; esconde a área de abertura rápida de novo.

Para além disso, a abertura rápida recorda o ficheiro anterior. Como tal, quando muda para a área de abertura rápida, o ficheiro activado anteriormente é seleccionado automaticamente, pelo que só terá de carregar em &Enter;, o que se torna muito útil às vezes.

### Suporte para a Compilação do Projecto

Outra funcionalidade é ter o suporte para o 'Plugin' de Completação, para que o mesmo seja configurado de forma correcta e automática.

### Criar Projectos

#### Carregar os Projectos Automaticamente

O 'plugin' do Projecto tem uma funcionalidade de carregamento automático. Poderá ler a lista de ficheiros a partir do sistema de controlo de versões. Para esse fim, o carregamento automático do sistema de controlo de versões respectivo tem de estar activado na configuração (como acontece por omissão):

Configuração do 'Plugin' de Projectos

#### Criar Projectos Manualmente

Apenas terá de criar um ficheiro `.kateproject` na pasta de topo do projecto. Por exemplo, o ficheiro `.kateproject` do Kate parece-se com o seguinte:

    {
      "name": "Kate"
    , "files": [ { "git": 1 } ]
    }

O conteúdo do ficheiro é escrito com a sintaxe do JSON. O nome do projecto é Kate, e os ficheiros que contém deverão ser lidos a partir do Git.

Também é suportado, em vez do `git`, o Subversion através do `svn` e o Mercurial com o `hg`. Se não quiser ler a partir de um sistema de controlo de versões, poderá dizer para ele carregar os ficheiros de forma recursiva a partir das pastas, da seguinte forma:

    {
      "name": "Kate"
    , "files": [ { "directory": "kate", "filters": ["*.cpp", "*.h", "*.ui", "CMakeLists.txt", "Find*.cmake"], "recursive": 1 } ]
    }

Aqui, as sub-pastas e filtros definem o que faz parte do projecto. Também poderá misturar o controlo de versões e os ficheiros, com base nos filtros.

Se quiser adicionar o suporte para o 'plugin' de Compilação, poderá criar um ficheiro `.kateproject` como o seguinte:

    {
      "name": "Kate"
    , "files": [ { "git": 1 } ]
    , "build": {
        "directory": "build"
      , "build": "make all"
      , "clean": "make clean"
      , "install": "make install"
      }
    }

### Projecto Actual

Se usar a opção &Alt;1 Projectos Ir Para, poderá abrir a área do Projecto Actual no fundo da janela do editor com quatro páginas:

Projecto Actual

Terminal

- Emulador de terminal - a iniciar na pasta de topo do projecto.

Índice do Código

- A introdução de caracteres no campo de pesquisa irá iniciar a procura e apresentação dos nomes das funções, classes, símbolos, &etc; correspondentes, em conjunto com o tipo, nome do ficheiro e número de linha.

  Seleccione um item na lista para ir para a linha correspondente no ficheiro de código.

Análise de Código

- Carregue em Iniciar a Análise para executar uma análise estática do código para C e C++, usando o `cppcheck`, e para gerar um relatório que mostra o nome do ficheiro, o número da linha, a criticidade (estilo, aviso, &etc;) e o problema detectado.

  Seleccione um item na lista para ir para a linha correspondente no ficheiro de código.

Notas

- O texto introduzido nesta página será gravado no ficheiro ``nome-projecto`.kateproject.notes`.

### O Menu de Projectos

O menu Projectos permite-lhe mudar directamente entre os vários projectos abertos de momento. É apresentado pelo 'plugin' do Projecto.

&Ctrl;&Alt;Esquerda Projectos Recuar

- Mudar para o projecto anterior.

&Ctrl;&Alt;Direita Projectos Avançar

- Mudar para o projecto seguinte.

&Alt;1 Projectos Ir Para

- Abre a área do Projecto Actual, no fundo da janela de edição.

## 'Plugin' de completação de código em Rust

Este 'plugin' oferece a completação de código para a linguagem de programação Rust.

Assim que tiver activado o item de completação de código em Rust, na página do 'plugin', irá aparecer uma nova página na janela de configuração do seu &kate;.

Configuração do Rust

Edite o comando para executar o Racer, um utilitário que pretende oferecer a completação de código em Rust para os editores.

Também precisa do código-fonte do Rust e terá de indicar a localização do mesmo.

Ao escrever o código, aparece uma lista com os itens possíveis:

Completação de Rust

Para além das janelas de completação de código, o 'plugin' também instala uma acção Ir Para a Definição no menu Editar e no menu de contexto. Também poderá configurar uma combinação de teclas para a mesma.

Esta acção irá abrir o documento que contém a definição, se necessário, activando a sua visualização e colocando o cursor no início da definição.

## Procurar & Substituir

### Introdução

O 'plugin' do &kate; para Procurar & Substituir permite-lhe procurar por um dado texto ou expressão regular em diversos ficheiros ao mesmo tempo. Poderá procurar em todos os ficheiros abertos, em todos os ficheiros de uma pasta e, opcionalmente, nas suas sub-pastas. Poderá até filtrar pelo nome do ficheiro, por exemplo, para procurar apenas nos ficheiros que terminem com uma dada extensão.

### Interface

#### Consulta de Pesquisa

As seguintes opções aparecem sempre no topo da ferramenta para Procurar nos Ficheiros:

- Poderá efectuar tantas pesquisas quantas desejar ao mesmo tempo. Basta carregar no botão de Nova Página no canto superior-esquerdo na ferramenta de Pesquisa, para que apareça uma nova página de resultados, onde poderá efectuar outra pesquisa.

- O botão no canto superior-direito da ferramenta para Procurar nos Ficheiros, irá activar ou desactivar a metade inferior da área de ferramentas, mostrando as opções adicionais da ferramenta ou os resultados da sua pesquisa.

Procurar

- Aqui é onde poderá escrever o que deseja procurar. Poderá indicar texto normal ou uma expressão regular, caso esta última opção esteja activa.

Substituir (campo de texto)

- O texto de substituição que será adicionado aos ficheiros, em vez do texto no campo Procurar.

Procurar

- Quando acabar de configurar tudo, basta carregar no botão Procurar para efectuar a sua pesquisa. Poderá também carregar em &Enter; no campo Procurar para fazer o mesmo.

Substituir

- Quando acabar de configurar tudo, basta carregar no botão Substituir para substituir o texto introduzido no campo Procurar pelo conteúdo do campo Substituir. Poderá também carregar em &Enter; no campo Substituir para fazer o mesmo.

Seguinte

- Vai para a ocorrência seguinte da sua pesquisa, mudando de ficheiros se necessário.

Substituir as verificadas

- Igual ao Substituir, mas só irá efectuar as substituições nos ficheiros assinalados na área em baixo.

#### Opções de Pesquisa na Pasta

Estas opções aparecem debaixo das opções de pesquisa acima mencionadas. Se os resultados da pesquisa estiverem a serem apresentados em alternativa, carregue no botão para os apresentar.

Pesquisar em

- Isto tem três opções. Seleccione os Ficheiros Abertos para procurar em todos os ficheiros abertos de momento no &kate;. Seleccione a Pasta para procurar dentro de uma pasta e, opcionalmente, sobre as suas sub-pastas. Seleccione o Projecto para procurar em todos os ficheiros que constem no projecto aberto de momento.

  Se o 'plugin' de Projectos for carregado, também poderá pesquisar no Projecto Actual ou em Todos os Projectos Abertos.

Corresponder à capitalização

- Restringe os resultados da pesquisa apenas aos que tiverem a combinação exacta de letras maiúsculas e minúsculas do texto da sua pesquisa.

Expressões regulares

- Permite-lhe usar expressões regulares, em vez de texto simples, no seu texto de pesquisa.

Expandir os resultados

- Mostra todos os resultados encontrados em cada ficheiro, em vez de apenas uma lista dos ficheiros que contêm o texto da pesquisa.

Pasta

- Poderá indicar a localização da pasta onde deseja procurar. Por exemplo, poderá indicar `~/desenvolvimento/kde/kate/` se desejar procurar algo no código-fonte do &kate;. Esta opção só fica disponível quando usar o modo Na Pasta.

Abrir a janela de ficheiros

- Carregue neste botão para procurar pela pasta no navegador de pastas do seu ambiente de trabalho. Este botão só funciona quando usar o modo na Pasta.

- Carregue neste botão para mudar a Pasta para a mãe da pasta seleccionada de momento. Este botão só funciona quando usar o modo da Pasta.

- Este botão irá mudar a Pasta para a pasta onde se encontra o documento aberto de momento. Este botão só funciona quando usar o modo da Pasta.

Filtro

- Isto permite-lhe procurar pelos nomes de ficheiros que correspondam a um dado padrão. Por exemplo, para procurar apenas pelos ficheiros escritos em C++, mude o valor para `*.cpp`. Para procurar apenas pelos ficheiros que comecem por `kate`, mude-o para `kate*`. Poderá indicar vários filtros separados por vírgulas (`,`). Esta opção não está disponível se estiver a usar o modo dos Ficheiros Abertos.

Excluir

- Sendo o oposto do Filtro, isto impede que o &kate; procure por ficheiros que correspondam aos padrões indicados. Como no Filtro, poderá indicar vários padrões separados por vírgulas (`,`). Esta opção não está disponível quando usar o modo dos Ficheiros Abertos.

Recursivo

- Se esta opção estiver seleccionada, o &kate; irá também pesquisar em todas as sub-pastas da pasta seleccionada. Esta opção só está disponível quando usar o modo da Pasta.

Incluir os escondidos

- Se esta opção estiver activa, o &kate; irá também pesquisar nas pastas ou ficheiros que estejam escondidos pelo seu &OS;. Esta opção só está disponível quando usar o modo da Pasta.

Seguir as ligações simbólicas

- O 'plugin' de Pesquisa nos Ficheiros normalmente não seguem as ligações simbólicas. Quando esta opção estiver activada, o 'plugin' segui-las-á e irá pesquisar dentro dos ficheiros ou pastas que estas referenciam. Esta opção só está disponível quando usar o modo da Pasta.

  É possível as ligações simbólicas fazerem referência a uma pasta-mãe da pasta actualmente a ser pesquisada ou então outras pastas que contenham ligações simbólicas para a sua pasta-mãe. Se existir uma dessas ligações na pasta a pesquisar, e caso esta opção esteja activa, o &kate; irá seguir de forma repetida a ligação e procurar nessa pasta, algo que fará com que a pesquisa nunca termine.

Incluir os ficheiros binários

- Se esta opção estiver seleccionada, o &kate; irá também pesquisar nos ficheiros que não parecem ser de texto.

#### Resultados da Procura

Os resultados da sua pesquisa são apresentados por baixo das opções da pesquisa. Se as opções do modo de Pesquisa na Pasta estiverem visíveis, basta carregar no botão para os mostrar. Serão também apresentados assim que efectuar uma pesquisa.

Os resultados da pesquisa mostram uma lista dos ficheiros que contêm o texto correspondente à sua pesquisa, seguido do número de ocorrências encontradas nesse ficheiro.

Para ver uma lista das ocorrências nesse ficheiro, basta carregar na seta de expansão à esquerda do nome do ficheiro. (Se tiver seleccionado a opção Expandir os resultados, isso já terá sido feito por si). Será apresentado o número da linha em que foi encontrada a ocorrência, seguido do conteúdo dessa linha, onde o texto da sua pesquisa será realçado a negrito.

Para abrir o ficheiro em que foi encontrado o seu resultado, basta fazer duplo-click sobre ele. O &kate; irá abrir o ficheiro se necessário, colocando o cursor no início do texto indicado na sua listagem em vez do nome do ficheiro.

### Estrutura do Menu

Editar Pesquisar nos Ficheiros

- Invoca a janela para Procurar e Substituir.

Editar Ir para a Ocorrência Seguinte

- Vai para a ocorrência seguinte de uma pesquisa efectuada pelo 'plugin' de Pesquisa e Substituição.

Editar Ir para a Ocorrência Anterior

- Vai para a ocorrência anterior de uma pesquisa efectuada pelo 'plugin' de Pesquisa e Substituição.

Ver Áreas de Ferramentas Mostrar a Pesquisa e Substituição

- Activa/desactiva a visualização da ferramenta do &kate; para Procurar e Substituir.

## Excertos do Kate

### Introdução

Os Excertos do Kate é um 'plugin' usado para lhe poupar algum tempo, adicionando o suporte para os excertos (código-fonte, código-máquina ou texto reutilizável). O 'plugin' também suporta a completação de código e o JavaScript.

### Estrutura do Menu

Ver Áreas de Ferramentas Mostrar os Excertos

- Mostra o painel de excertos que contém todos os excertos no seu repositório que digam respeito ao tipo de ficheiro aberto de momento.

Ferramentas Criar um Excerto

- Cria um novo excerto, que é um bloco de texto reutilizável que poderá inserir em qualquer parte de um documento qualquer.

### Painel de excertos

Painel de Excertos do Kate O painel de excertos do &kate;.

O painel para os excertos do &kate;.

No painel, deverá ver uma lista de repositórios de excertos, em conjunto com as opções para criar os seus próprios, obtê-los da Internet ou carregá-los a partir de um ficheiro local. Cada repositório tem uma opção de marcação que poderá ser usada para o activar ou desactivar. Existem também botões para editara e apagar os repositórios existentes.

#### Carregamento dos Ficheiros do Repositório de Excertos

Poderá obter repositórios de excertos a partir da Internet. Basta carregar em Obter Novos Excertos para abrir uma janela com uma lista de repositórios de excertos. Depois de obter o excerto desejado, certifique-se que o activou.

#### Criar e Editar Repositórios

Para criar um novo repositório de excertos, carregue em Adicionar um Repositório. Deverá agora ver uma janela que lhe pede o nome, licença e autor do ficheiro de excertos. Depois de escolher as opções desejadas, carregue em OK.

Editor de Excertos O editor de repositórios.

A interface do editor de repositórios.

O editor do repositório de excertos contém as seguintes opções:

Nome

- Aparece na lista de excertos na área de ferramentas e também é pesquisada quando é usada a funcionalidade de completação do código.

Espaço de nomes

- O prefixo usado quando aplicar a completação de código.

Licença

- Seleccione a licença para o seu repositório de excertos.

Autores

- Indique o nome do autor ou autores do ficheiro do excerto.

Tipos de ficheiros

- Seleccione os tipos de ficheiros onde quer que o repositório de excertos se aplique. Está configurado como por omissão, pelo que o repositório se aplica a todos os ficheiros. Poderá configurar como algo do tipo `C++`, por exemplo, ou seleccione numa lista, carregando no &Shift;, enquanto adiciona os tipos.

#### Criar e Editar Excertos

Editor de Excertos O editor de excertos.

A interface do editor de excertos.

Nome

- O nome será apresentado na lista de completações.

Atalho

- Se carregar neste atalho, irá inserir o excerto no documento.

Excertos

- O texto que o seu excerto irá inserir no documento.

  Um excerto poderá conter campos para edição. Poderá circular por eles, carregando para tal em . Poderá usar as seguintes expressões no texto do modelo para criar os campos:

  `${`nome_campo`}` cria um campo simples e editável. Todas as ocorrências subsequentes do mesmo `nome_campo` irão replicar o conteúdo do primeiro durante a edição.

  O `${`nome_campo=valor_predefinido`}` pode ser usado para definir um valor por omissão para o campo. O `valor_predefinido` poderá ser qualquer expressão em JavaScript.

  Use o `${`nome_campo`=`texto`}` para definir um texto fixo como valor por omissão.

  O `${func(`outro_campo1`, `outro_campo2`, ...)}` pode ser usado para criar um campo que avalia uma função em JavaScript para cada edição e que possui o seu conteúdo. Veja a página de Programas para mais informações.

  O `${cursor}` pode ser usado para marcar a posição final do cursor, depois de estar tudo preenchido.

Programas

- Funções utilitárias em JavaScript para usar nos seus excertos.

  Todas as funções em JavaScript deverão devolver o conteúdo que deseja colocar num campo do modelo como texto.

  As funções são invocadas num âmbito que contém os dados de todos os campos editáveis do modelo como variáveis locais. Por exemplo, num excerto que contém `${`campo`}`, existirá uma variável chamada `campo` que contém o conteúdo actualizado do campo do modelo. Estas variáveis tanto poderão ser usados na função a nível estático ou passados como argumentos, usando a sintaxe `${func(campo)}` ou `${`campo2=func(campo)`}` no texto do excerto.

  Poderá usar a API de programação do &kate; para obter o texto seleccionado, o texto completo, o nome do ficheiro, entre outras coisas, usando os métodos apropriados dos objectos `document` e `view`. Consulte a documentação da API de programação para saber mais informações.

### Usar os Excertos

Excertos do Kate em Acção Aceder aos Excertos do &kate; a partir de uma área de ferramentas e de uma lista.

Seleccione um item da lista de excertos.

Poderá invocar os excertos de duas formas:

- Escolhendo-os na área de ferramentas.

- Enquanto escreve, poderá carregar em &Ctrl; Espaço, para mostrar todos os excertos numa janela conveniente onde poderá efectuar a selecção. Esta combinação de teclas oferece uma funcionalidade semelhante à completação de código.

Se o excerto tiver variáveis (para além do `${cursor}`), o cursor irá ficar colocado automaticamente sobre a primeira ocorrência de uma variável, esperando que você escreva algo. Quando terminar, poderá carregar em passe para a variável seguinte, e assim por diante.

### Agradecimentos e Reconhecimentos

Os Excertos do &kate; foram escritos por Joseph Wenninger.

Muito obrigado ao participante no Google Code-In de 2011, Martin Gergov, por escrever a maior parte desta secção.

## 'Plugin' de SQL

### Introdução

O SQL ('Structured Query Language') é uma linguagem especializada para actualizar, apagar e pedir informações das bases de dados.

O 'plugin' de SQL do &kate; permite-lhe:

- Criar uma base de dados

- Ligar a bases de dados existentes

- Inserir e apagar dados na base de dados

- Executar pesquisas

- Mostrar os resultados numa tabela

### Ligar a uma Base de Dados

Seleccione a opção Adicionar uma Ligação do menu SQL ou na barra de ferramentas; depois, seleccione o controlador de base de dados do Qt que deseja usar (isto inclui o QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 e o QPSQL). Se não conseguir ver o controlador desejado, terá de o instalar. Depois, carregue em Seguinte.

Se a base de dados que seleccionar usar um ficheiro, basta indicar a localização da base de dados e carregar no botão Seguinte. Se precisar de se ligar a um servidor, terá de indicar o nome do servidor, o seu utilizador e senha, bem como qualquer outra informação que o controlador necessite em particular. Depois, carregue em Seguinte.

Finalmente, dê um nome à sua ligação e carregue em Terminar.

### Executar Pesquisas

#### INSERT/DELETE/UPDATE

Poderá inserir, apagar e actualizar dados com o 'plugin' de SQL, como faria a partir da linha de comandos ou dentro de um programa. Basta indicar uma pesquisa e carregar em Executar a pesquisa, na barra de ferramentas, ou usar a opção SQL Executar uma pesquisa (&Ctrl;E).

##### Algumas Pesquisas de Exemplo

`INSERT`

-     INSERT INTO nome_tabela ("campo1", "campo2", "campo3", "campo4", "campo5")
      VALUES ("valor1", "valor2", "valor3", "valor4", "valor5" )

`DELETE`

-     DELETE FROM nome_tabela WHERE nome = "texto"

`UPDATE`

-     UPDATE nome_tabela SET "campo1" = "texto", "campo2" = "texto", "campo3" = "texto", "campo4" = "texto", "campo5" = "texto"

#### SELECT

Depois de executar uma instrução `SELECT`, poderá ver o resultado como uma tabela, aparecendo esta na área de ferramentas Resultado dos Dados em SQL no fundo do &kappname; ou como texto no Resultado do Texto em SQL. Se ocorrer um erro, podê-lo-á ver no resultado de texto.

##### Pesquisa `SELECT` de Exemplo

    SELECT * FROM nome_tabela

Na área do Resultado dos Dados em SQL, existem alguns botões:

Ajustar as colunas ao conteúdo

- Muda o tamanho das colunas para caber o seu conteúdo.

Ajustar as linhas ao conteúdo

- Muda o tamanho das linhas para caber o seu conteúdo.

Copiar

- Selecciona todo o conteúdo da tabela e copia-o para a área de transferência.

Exportar

- Exporta todo o conteúdo da tabela para um ficheiro, para a área de transferência ou então o documento actual, no formato de valores separados por vírgulas (CSV).

Limpar

- Remove tudo da área da tabela

Poderá agora ver as cores que são apresentadas na tabela, na secção SQL da opção Configuração Configurar o &kate; .

### Navegação

Poderá navegar pela sua base de dados com a ferramenta de Navegação do Esquema no lado esquerdo. A informação apresentada varia de acordo com o controlador de bases de dados que estiver a usar.

Para actualizar esta lista, carregue com o botão direito em qualquer lado da área da ferramenta e seleccione a opção Recarregar. Para gerar uma pesquisa sobre qualquer item da lista, carregue com o botão direito sobre um item, seleccione Gerar e seleccione o tipo de instrução (SELECT, UPDATE, INSERT ou DELETE) no submenu que aparece.

### Estrutura do Menu

SQL Adicionar uma ligação...

- Adiciona uma nova ligação que usa um dos vários controladores de bases de dados disponível.

SQL Remover a ligação

- Remove a ligação seleccionada.

SQL Editar a ligação...

- Edita a configuração da ligação actual.

Ligações

- Todas as ligações às bases de dados que tiver criado estão apresentadas entre os itens do menu Editar a ligação e Executar a pesquisa. Seleccione uma para executar pesquisas ou efectuar modificações sobre elas.

&Ctrl;E SQL Executar a pesquisa

- Executa a sua pesquisa.

### Agradecimentos e Reconhecimentos

O 'Plugin' de SQL foi criado por Marco Mentasti.

Muito obrigado ao participante no Google Code-In de 2011, Ömer Faruk ORUÇ, por escrever a maior parte desta secção.

## 'Plugin' de Visualização de Símbolos

### Usar o 'Plugin' de Fecho de Inclusão/Exclusão

Permite aos programadores ver os símbolos (funções, macros e estruturas) do código-fonte.

Ao carregar na informação processada, poderá navegar facilmente pelo código.

De momento, são suportadas as seguintes linguagens:

C/C++, Java, Perl, PHP, Python, Ruby, XSLT, Tcl/Tk, Fortran

Lista de funcionalidades:

- Modo em lista/árvore
- Activar/desactivar a ordenação
- Esconder/Mostrar os parâmetros das funções
- Expandir/recolher o modo em árvore
- Auto-actualizar em caso de mudança do documento
- O processamento do código baseia-se na plataforma de Realce de Sintaxe das &kde-frameworks;

### Estrutura do Menu

&Ctrl;\ Ver Áreas de Ferramentas Mostrar a Lista de Símbolos

- Activa/desactiva a visualização da Lista de Símbolos do &kate;, que apresenta as funções, macros e estruturas do código-fonte no documento activo.

### Configuração

Visualizador de Símbolos

Escolha as opções de processamento por omissão

## 'Plugin' na Área do Terminal

O Terminal Incorporado é uma cópia da aplicação de terminal &konsole; do &kde;, para sua conveniência. Está disponível na opção do menu Ver Áreas de Ferramentas Mostrar o Terminal, para que obtenha o foco sempre que for apresentado. Adicionalmente, se a opção Sincronizar automaticamente o terminal com o documento actual, se possível estiver activa, irá mudar para a pasta do documento actual se possível, quando estiver visível, ou quando o documento actual mudar.

A localização predefinida na janela do &kate; é no fundo, por baixo da área de edição.

Poderá configurar o &konsole; com o seu menu do &RMB;; para mais informações, veja o manual do &konsole;.

O emulador de terminal incorporado é oferecido pelo 'plugin' do Terminal.

### Estrutura do Menu

Ver Áreas de Ferramentas Mostrar o Terminal

- Activa/desactiva a visualização do emulador de terminal incorporado.

  Quando for activado pela primeira vez, será criado o terminal.

  Quando o emulador de terminal estiver visível, irá ficar em primeiro plano, para que possa começar a escrever comandos imediatamente. Se a opção Sincronizar automaticamente o terminal com o documento actual, quando possível na página Terminal da janela de configuração principal, a sessão da consola irá mudar para a pasta do documento activo, se for um ficheiro local.

Ferramentas Encaminhar para o Terminal

- Fornece o texto seleccionado de momento ao emulador de terminal incorporado. Não será adicionada nenhuma mudança de linha a seguir ao texto.

Ferramentas Sincronizar o Terminal com o Documento Actual

- Isto fará com que o terminal incorporado faça `cd` para a pasta do documento activo.

  Em alternativa, poderá configurar o &kate; para manter sempre o terminal sincronizado com o documento actual. Veja mais informações em konsole-config.

Ferramentas Focar/Desfocar o Terminal

- Muda o foco do documento actual para o terminal e vice-versa.

### Configuração

Este 'plugin' pode ser configurado na página do Terminal da janela de configuração.

Estão disponíveis as seguintes opções:

Sincronizar automaticamente o terminal com o documento actual se possível

- Isto fará com que o terminal incorporado faça `cd` para a pasta do documento activo, quando for lançado, e quando um documento novo fica em primeiro plano. Se não estiver activo, terá de fazer toda a sua navegação no terminal a seu gosto.

Mudar a variável de ambiente EDITOR para 'kate -b'

- Isto configura a variável de ambiente `EDITOR`, para que os programas que se executem no terminal incorporado e que abram automaticamente um ficheiro num editor, o façam no &kate; em vez do editor predefinido que está configurado na sua consola. Não será capaz de continuar a usar o terminal até que tenha fechado o ficheiro no &kate;, para que o programa que o invocou sabia que acabou de editar o ficheiro.

## 'Plugin' do Filtro de Texto

### Usar o 'Plugin' do Filtro de Texto

Poderá usar este 'plugin' para executar comandos na consola. Será usada uma selecção como argumento para o comando da consola, sendo que o resultado irá substituir essa selecção ou será copiado para a área de transferência.

### Exemplos:

- `less /etc/fstab` - cola o conteúdo deste ficheiro ou copia-o para a área de transferência

- `wc` - conta as linhas, palavras e caracteres da selecção, colando estes dados no documento ou copiando-os para a área de transferência

- `sort` - ordena as linhas da selecção e cola o resultado no documento ou copia-o para a área de transferência

### Estrutura do Menu

&Ctrl;\ Ferramentas Filtrar o Texto

- Abre a janela do Filtro de Texto:

  Janela do Filtro de Texto

  Indique o comando da consola na lista ou seleccione um comando anterior no histórico.

  Copiar o resultado em vez de o colar

- Copia o resultado para a área de transferência, deixando um documento inalterado.

Reunir o STDOUT e o STDERR

- Se estiver assinalado, será reunido o resultado do STDOUT e STDERR, não sendo comunicados nenhuns erros. Caso contrário, o STDERR será apresentado como uma mensagem passiva.

## Validação de &XML;

Este 'plugin' efectua a validação sintáctica e semântica dos ficheiros &XML;.

Este 'plugin' verifica o ficheiro actual. Irá aparecer uma lista de avisos e erros no fundo da janela principal do &kate;. Poderá carregar sobre uma mensagem de erro para saltar para o local correspondente no ficheiro. Se o mesmo tiver um DOCTYPE, o DTD indicado com este tipo de documento será usado para verificar a validade do ficheiro. Espera-se que o DTD esteja numa posição relativa ao ficheiro actual, ⪚ se o DOCTYPE fizer referência a DTD/xhtml1-transitional.dtd e o ficheiro for `/home/ze/teste.xml`, espera-se que o DTD esteja localizado em `/home/ze/DTD/xhtml1-transitional.dtd`. Contudo, os DTD's remotos por HTTP também são suportados.

Se o ficheiro não tiver um DOCTYPE associado, será verificado se tem uma estrutura/formatação correcta.

Para aprender mais sobre o &XML;, verifique as páginas oficiais do &XML; .

Internamente, este 'plugin' invoca o comando externo `xmllint`, que faz parte da 'libxml2'. Se este comando não estiver instalado correctamente no seu sistema, o 'plugin' não irá funcionar.

Para carregar este 'plugin', abra a janela de configuração do &kate; em Configuração Configurar o &kate;.... Depois, seleccione a Validação de &XML;, que irá aparecer na secção Aplicação / 'Plugins' e feche a janela.

### Estrutura do Menu

&XML; Validar o &XML;

- Isso irá iniciar a verificação, como descrito em cima.

### Agradecimentos e Reconhecimentos

Plugin para o &kate; de Validação de XML com 'copyright' 2002 de &Daniel.Naber; &Daniel.Naber.mail;.

Documentação com 'copyright' 2002 de &Daniel.Naber;

## Completação de &XML;

Este 'plugin' dá-lhe algumas sugestões sobre o que é permitido numa dada posição de um ficheiro &XML;, de acordo com a DTD do ficheiro. Irá apresentar os elementos, atributos, valores de atributos ou entidades possíveis, dependendo da posição do cursor (⪚ todas as entidades aparecem se o carácter à esquerda do cursor for o &). Também é possível fechar a marca aberta mais próxima à esquerda.

A DTD deverá existir no formato &XML;, como é produzido pelo programa em Perl `dtdparse`. Iremos chamar a uma DTD neste formato uma meta-DTD. São fornecidas algumas meta-DTD's. As mesmas estão instaladas na pasta `katexmltools/` em ``qtpaths` `--paths GenericDataLocation`` , que também é a pasta predefinida quando escolhe a opção Atribuir uma Meta-DTD.... Para produzir as suas próprias meta-DTD's, obtenha o `dtdparse` em http://dtdparse.sourceforge.net.

### Como Usar

Inicie o &kate; e abra a janela de configuração em Configuração Configurar o &kate;.... Depois, seleccione a Completação de &XML; que irá aparecer na secção Aplicação/'Plugins', fechando depois a janela. Depois disso, seleccione a opção do menu &XML;Atribuir uma Meta-DTD.... Se o seu documento não tiver nenhum DOCTYPE ou se este for desconhecido, terá de seleccionar uma meta-DTD no sistema de ficheiros. Caso contrário, será carregada automaticamente a meta-DTD que corresponder ao DOCTYPE do documento actual.

Pode agora usar o 'plugin' enquanto escreve o seu texto:

< (tecla 'menor que')

- Isto irá despoleta uma lista com os elementos possíveis, a menos que o cursor já esteja dentro de uma marca. Lembre-se que não pode usar isto para inserir o elemento de topo (⪚ <html>).

</ (tecla 'menor que' + barra)

- Se introduzir estes caracteres, irá oferecer o fecho do elemento actual (o mais próximo do que se encontra à esquerda do cursor). Carregue em &Enter; para aceitar a sugestão. Ao contrário do item Fechar o Elemento, isto funciona apenas com uma DTD atribuída.

" (tecla de 'aspas')

- A tecla de aspas irá despoletar uma lista com os valores possíveis dos atributos (se existirem), caso esteja dentro de uma marca.

(tecla de espaço)

- Esta tecla irá despoletar uma lista com os atributos possíveis para o elemento actual, caso esteja dentro de uma marca.

& (tecla de 'e-comercial')

- Esta tecla irá despoletar uma lista com as entidades conhecidas.

### Funcionalidades e Limitações

Poderá testar todas as funções e limitações se carregar o ficheiro `katexmltools/testcases.xml` em ``qtpaths` `--paths GenericDataLocation`` no &kate; e seguir as instruções descritas.

### Estrutura do Menu

&Ctrl;Return &XML; Inserir um Elemento...

- Isto irá abrir uma janela que lhe permite introduzir um elemento em &XML;. Os caracteres <, > e a marca de fecho serão inseridos automaticamente. Se tiver seleccionado algum texto quando tiver seleccionado este item do menu, o texto seleccionado será rodeado pela marca de abertura e de fecho. A janela também oferece a completação de todos os elementos que poderão ser inseridos na posição actual do cursor, caso tenha atribuído uma meta-DTD com a opção Atribuir uma Meta-DTD....

&Ctrl;< &XML; Fechar o Elemento

- Isto irá procurar no seu texto por uma marca que ainda não tenha sido fechada, fechando-a então ao introduzir a marca de fecho correspondente. A procura começa na posição do cursor e segue para a esquerda. Se não encontrar nenhuma marca aberta, não irá acontecer nada.

&XML; Atribuir uma Meta-DTD...

- Isto irá indicar ao 'plugin' qual a meta-DTD a usar para o documento actual. Lembre-se que esta associação não será gravada. Terá de a repetir quando iniciar o &kate; da próxima vez.

### Agradecimentos e Reconhecimentos

Plugin para o &kate; de Completação de XML com 'copyright' 2002 de &Daniel.Naber; &Daniel.Naber.mail;.

Versão para o KDE SC 4 com 'copyright' 2010 de Tomáš Trnka

Documentação com 'copyright' 2001,2002 de &Daniel.Naber;