# Trabalhando com plugins

O &kate; oferece diversos tipos de plugin. Existem plugins para o componente de edição do &kate;, que ficam disponíveis para qualquer aplicativo que use esse componente, como o KDevelop, o Quanta, o Kile, o &kwrite;, entre muitos outros. Existem também plugins que só estão disponíveis no editor &kate; propriamente dito. Existem dois tipos desses plugins: alguns são escritos em C++ nativo, enquanto outros são escritos na linguagem de programação Python. Existem diferenças sutis entre eles, que são descritas abaixo.

Você poderá ativar qualquer tipo de plugin na caixa de diálogo de configuração, a qual também oferece acesso às opções de configuração adicionais dos plugins que necessitem delas.

Existem vários plugins para vários fins e você poderá procurar mais na Web. Alguns plugins são fornecidos com o componente de edição, para fazer inserção automática de parênteses, inserção de arquivos e exportação de texto como &HTML;.

## Extensões do componente de edição

Para obter informações sobre os plugins disponíveis, consulte a seção Extensões do Componente de Edição do Manual do &katepart;.

## Plugins do aplicativo &kate;

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

O plugins do aplicativo disponíveis são:

- Navegador de estouros - Janela da ferramenta de navegação dos estouros

- Plugin de compilação - Compila ou executa o Make e processa as mensagens de erro

- Fechamento com exclusão/inclusão - Fecha um grupo de documentos com base em uma extensão ou caminho comuns

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

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

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

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

- Seletor de ícones - Carrega o seletor de ícones Cuttlefish

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

- Abrir cabeçalho - Abre o arquivo .h/[.cpp|.c] correspondente

- Plugin de projeto - Plugin de projetos para o Kate

- Replicode

- Completação de código Rust - Completação para código-fonte em Rust

- Pesquisar e substituir - Pesquisa ou substitui padrões nos documentos abertos ou em arquivos no disco

- Área da ferramenta Trechos - Uma janela que incorpora o gerenciamento de trechos

- Plugin do SQL - Executa pesquisas em bancos de dados SQL

- Visualizador de símbolos - Extrair e mostrar os símbolos de referência do código

- Área da ferramenta Terminal - Uma janela que incorpora um widget de terminal

- Filtro de texto - Filtragem simples de texto

- Completamento de &XML;- Apresenta os elementos de &XML;, os seus atributos, valores e entidades permitidas pela DTD

## Completamento &XML;

Este plugin dá pistas sobre o que é permitido em determinada posição de um arquivo &XML;, de acordo com o DTD do arquivo. Ele lista elementos, atributos, valores de atributos ou entidades válidas, dependendo da posição do cursor (⪚, todas as entidades são mostradas se o caractere à esquerda do cursor for &). Também é possível fechar a marca aberta mais próxima à esquerda.

O DTD deve existir em formato &XML;, como produzido pelo programa Perl `dtdparse`. Chamaremos um DTD neste formato de meta DTD. Alguns meta DTDs são fornecidos. Eles estão instalados em `$KDEDIR/share/apps/katexmltools/`, que também é a pasta padrão quando você escolhe Designar Meta DTD.... Para produzir seus próprios meta DTDs, baixe o `dtdparse` em http://dtdparse.sourceforge.net.

### Como usar

Inicie o &kate; e abra a janela de configuração em Configurações Configurar o &kate;.... Depois, selecione o Completamento de &XML; que irá aparecer na seção Aplicativo/Plugins, fechando depois a janela. Depois disso, selecione a opção do menu &XML;Atribuir uma Meta-DTD.... Se o seu documento não tiver nenhum DOCTYPE ou se ele for desconhecido, você terá que selecionar uma meta-DTD no sistema de arquivos. Caso contrário, será carregada automaticamente a meta-DTD que corresponder ao DOCTYPE do documento atual.

Você pode agora usar o plugin enquanto digita seu texto:

< (chave menor que)

- Isto disparará uma lista dos elementos possíveis a menos que o cursor esteja já dentro de uma tag. Note que você atualmente não pode usar isto para inserir os elementos de nível mais alto (⪚ <html>).

</ (tecla 'menor que' + barra)

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

" (chave de citação)

- A chave de citação disparará uma lista dos valores de atributos possíveis (se existirem) se você estiver dentro de uma tag.

(chave espaço)

- Isto disparará uma lista dos atributos possíveis para o elemento atual se você estiver dentro de uma tag.

& (chave E comercial)

- Isto disparará uma lista de entidades nomeadas.

### Características e limitações

Você pode testar todas as funções e limitações carregando `$KDEDIR/share/apps/katexmltools/testcases.xml` no &kate; e seguindo as instruções.

### Estrutura do Menu

&Ctrl;Return &XML; Inserir elemento...

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

&Ctrl;< &XML; Fechar elemento

- Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fechá-la inserindo a tag de fechamento correspondente. A pesquisa inicia na posição do cursor e vai para a esquerda. Se não puder encontrar uma tag aberta nada acontecerá.

&XML; Designar Meta DTD...

- Isto irá dizer ao plugin qual meta DTD usar para o documento atual. Note que esta designação não será salva. Você terá que repetir isto quando você iniciar o &kate; na próxima vez.

### Agradecimentos e reconhecimento

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

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

Copyright da Documentação 2001,2002 por &Daniel.Naber;

## Exportação

### Estrutura do Menu

Arquivo Exportar como &HTML;...

- Exporta o seu arquivo para o formato &HTML;, para que o documento possa ser visto como uma página Web.

Editar Copiar como &HTML;...

- Copia o texto selecionado com o realce de sintaxe como texto &HTML;.

## Procurar e substituir

### Introdução

O plugin Pesquisar e substituir do &kappname; permite-lhe procurar por um texto ou expressões regulares em vários arquivos de uma só vez. Você pode procurar em todos os arquivos abertos, todos os arquivos de uma pasta e, opcionalmente, suas subpastas, ou todos os arquivos do projeto atual. Você pode até mesmo filtrar por nome de arquivo, para por exemplo procurar somente em arquivos que terminam com uma extensão de arquivo específica.

### Interface

#### Parâmetros da pesquisa

As opções a seguir são exibidas sempre no topo da ferramenta Pesquisar nos arquivos:

Nova aba

- Você pode ter tantas pesquisas quanto desejar abertas ao mesmo tempo. Basta clicar no botão Nova aba no canto superior esquerdo da ferramenta de Pesquisa e uma nova aba de resultados será aberta, permitindo que você realize outra pesquisa.

Alternar resultados

- A seta para baixo no canto superior direito da ferramenta Pesquisar nos arquivos alternará a metade inferior da ferramenta entre exibir opções adicionais para o modo Pesquisar na pasta e os resultados de sua pesquisa.

Localizar

- Aqui é onde você digita o que deseja encontrar. Você pode inserir um texto padrão ou uma expressão regular, se este recurso estiver ativo.

Substituir (campo de texto)

- O texto de substituição que será adicionado ao(s) arquivo(s), em vez do texto no campo Localizar.

Pesquisar

- Quando você tiver terminado de configurar tudo, basta pressionar o botão Pesquisar para que a pesquisa seja realizada. Você pode também pressionar o &Enter; na caixa de texto Localizar para obter o mesmo efeito.

Substituir

- Quando você tiver terminado de configurar tudo, basta clicar no botão Substituir para substituir o texto introduzido no campo Localizar pelo conteúdo do campo Substituir. Você também pode pressionar &Enter; no campo Substituir para fazer o mesmo.

Próxima

- Vai para a próxima ocorrência da sua pesquisa, mudando de arquivo se necessário.

Substituir as verificadas

- Igual ao Substituir, mas só irá efetuar as substituições nos arquivos assinalados no painel abaixo.

#### Opções do Pesquisar na pasta

Estas opções são exibidas abaixo das opções de consulta mencionadas anteriormente. Se os resultados da pesquisa estiverem sendo exibidos, pressione o botão Alternar resultados para exibi-las.

Diferenciar maiúsculas de minúsculas

- Restringe os resultados da pesquisa apenas aos que tiverem a combinação exata 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 resultados

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

Pesquisar

- Há três opções. Selecione nos arquivos abertos para pesquisar em todos os arquivos atualmente abertos no &kappname;. Selecione na pasta para pesquisar em uma pasta e opcionalmente suas subpastas. Selecione no projeto para procurar em todos os arquivos existentes no projeto aberto no momento.

Pasta

- Você pode inserir a localização da pasta que deseja pesquisar. Por exemplo, você pode inserir `~/development/kde/kate/` se deseja pesquisar no código-fonte do &kate;. Esta opção só fica disponível ao usar o modo na pasta.

Janela de abertura de arquivo

- Clique nesse botão para localizar a pasta no navegador de pastas do seu computador. Esse botão só funciona quando estiver usando o modo na pasta.

Acima

- Clique neste botão para mudar a Pasta para a pasta pai da atualmente selecionada. Esse botão só funciona quando estiver usando o modo na pasta.

Restaurar pasta atual

- Este botão definirá a entrada Pasta para a pasta na qual o documento atual está localizado. Esse botão só funciona quando estiver usando o modo na pasta.

Filtro

- Isto permite que você pesquise somente por nomes de arquivos que correspondam a um determinado padrão. Por exemplo, para pesquisar somente por arquivos escritos em C++, mude isto para `*.cpp`. Para pesquisar somente por arquivos começando com `kate`, mude isto para `kate*`. Você pode inserir vários filtros separados por vírgula (`,`). Esta opção não está disponível quando estiver usando o modo nos arquivos abertos.

Excluir

- É o oposto do Filtro, impedindo que o &kappname; procure por arquivos que correspondam aos padrões indicados. Como no Filtro, você poderá indicar vários padrões separados por vírgula (`,`). Essa opção não está disponível quando estiver usando o modo nos arquivos abertos.

Recursivo

- Se esta opção estiver ativa, o &kappname; pesquisará também em todas as subpastas da pasta selecionada. Essa opção só está disponível quando estiver usando o modo na pasta.

Incluir ocultos

- Se esta opção estiver ativa, o &kappname; também pesquisará em arquivos ou pastas que estão normalmente ocultos pelo seu &OS;. Essa opção só está disponível quando estiver usando o modo na pasta.

Seguir as ligações simbólicas

- O plugin Pesquisar nos arquivos normalmente não segue ligações simbólicas. Quando esta opção estiver ativa, o plugin as seguirá ao invés de pesquisar dentro dos arquivos ou pastas às quais elas se referem. Essa opção só está disponível quando estiver usando o modo na pasta.

  É possível ligações simbólicas que se referem a uma pasta que é a pai da pasta que estiver atualmente sendo pesquisada, ou que outras pastas contenham ligações simbólicas para seus pais. Se existir este tipo de ligação na pasta que está sendo pesquisada e esta opção estiver ativa, o &kappname; seguirá repetidamente a ligação e pesquisará a pasta, e a pesquisa nunca terminará.

Incluir arquivos binários

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

#### Resultados da pesquisa

Os resultados de sua pesquisa são exibidos abaixo das opções de consulta. Se as opções do modo de Pesquisa em pasta estiverem sendo exibidas, basta pressionar o botão Alternar resultados para exibi-los. Eles também serão automaticamente exibidos tão logo a pesquisa termine.

Os resultados da pesquisa mostram uma lista de arquivos que contêm o texto que corresponde à sua pesquisa, seguido do número de ocorrências encontradas nesse arquivo.

Para ver uma lista das ocorrências nesse arquivo, basta clicar na seta de expansão à esquerda do nome do arquivo. (Se você selecionou a opção Expandir resultados, isso já foi feito). 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á destacado em negrito.

Para abrir o arquivo em que foi encontrado o seu resultado, basta clicar duas vezes sobre ele, para ser aberto pelo &kappname;, se necessário. Você também pode mover o cursor para o local da ocorrência, com um duplo clique nessa lista, em vez de no nome do arquivo.

### Estrutura do Menu

Editar Procurar nos arquivos

- Abre a janela da ferramenta Procurar e substituir.

Editar Ir para a próxima ocorrência

- Vai para a ocorrência seguinte de uma pesquisa efetuada pelo plugin Pesquisar e substituir.

Editar Ir para a ocorrência anterior

- Vai para a ocorrência anterior de uma pesquisa efetuada pelo plugin Pesquisar e substituir.

Exibir Visões da ferramenta Pesquisar e substituir

- Alterna a exibição da ferramenta Pesquisar e substituir do &kappname;.

## Navegador do sistema de arquivos

O navegador do sistema de arquivos é um visualizador de pastas que lhe permite abrir os arquivos a partir da pasta mostrada na janela atual.

### Estrutura do Menu

Exibir Áreas de Ferramentas Mostrar o Navegador no sistema de arquivos

- Liga e desliga o navegador do sistema de arquivos do &kate;.

### Interface

De cima para baixo, o navegador do sistema de arquivos consiste nos seguintes elementos:

Uma barra de ferramentas

- Contém os botões de navegação padrão da ferramenta:

  Voltar

- Faz com que a visão de pastas, com o comando `cd`, vá para a pasta exibida anteriormente no histórico. Este botão ficará desligado, se não existir o item anterior.

Avançar

- Faz com que a visão de pastas, com o `cd`, mostre o próxima pasta do histórico. O botão é desabilitado, caso não exista a próxima pasta.

Favoritos

- Abre um submenu para editar ou adicionar favoritos e para adicionar uma nova pasta de favoritos.

Pasta de documento atual

- Este botão fará com que a visão de pastas, com o comando `cd` , vá para a pasta do documento atualmente ativo, se possível. Este botão é desabilitado se o documento ativo é um arquivo novo ou ainda não salvo, ou se a pasta no qual ele reside não pode ser definida.

Opções

- Visão abreviada

- Mostra apenas os nomes dos arquivos.

Visão detalhada

- Mostra o Nome, Data, Tamanho e Tipo dos arquivos.

Visão em árvore

- Como a visão abreviada, mas as pastas podem ser expandidas para ver seu conteúdo.

Visão em árvore detalhada

- Isto também permite que as pastas sejam expandidas, mas exibe as colunas adicionais disponíveis na visão detalhada.

Mostrar arquivos ocultos

- Mostra os arquivos normalmente ocultos pelo seu &OS;.

Sincronizar automaticamente com o documento atual

- Quando esta opções estiver ativa, o navegador do sistema de arquivos fará um `cd` automaticamente para a pasta do documento atualmente aberto na área de edição toda vez que ele mudar.

Um entrada de localização

- Isto exibe uma navegação no estilo 'trilha de pão' para a pasta atualmente aberta, como no &dolphin;. Você pode clicar em qualquer pasta para navegar nela, ou clicar em uma das setas à esquerda de uma pasta para selecionar qualquer pasta a partir dela. Você pode também selecionar a partir de sua lista de locais clicando no ícone mais à esquerda na navegação em 'trilha de pão', que exibe um ícone que representa seu Local atual.

  Você pode também clicar na trilha de pão para mudar para uma caixa de texto de onde pode digitar a localização de uma pasta para navegar. O campo da &URL; mantém uma lista dos campos introduzidos anteriormente. Para escolher um, utilize o botão da seta à direita do campo.

  O campo da &URL; tem o completamento automático das pastas. O método de completamento pode ser definido usando o menu do &RMB; do campo.

Uma visão de pastas

- Esta é uma janela de pastas padrão do &kde;.

Uma entrada de filtro

- A entrada de Filtro permite a você digitar um filtro para arquivos exibidos na visão de pastas. O filtro está usando padrões, que devem estar separados por espaço em branco. Exemplo: `*.cpp *.h *.moc`

  Para exibir todos os arquivos, digite um único asterisco - `*`.

  O campo do filtro salva os últimos 10 filtros inseridos entre sessões. Para usar um, clique no botão de setas à direita do campo e selecione o filtro desejado. Você poderá desativar o filtro se clicar no botão Limpar o texto à esquerda do botão de autocompletamento.

### Configuração

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

Barra de ferramentas

- Configure os botões no navegador do sistema de arquivos, movendo os que deseja ativar para a lista de Ações selecionadas e ordenando-os com as setas ao lado da lista.

## Plugin de compilação

### Introdução

O plugin Compilação permite-lhe executar ações, tais como a compilação ou limpeza de um projeto.

### Usando o plugin de compilação

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

A área do Resultado da compilação tem três abas:

- Configurações do alvo

- Saída

- Erros & avisos

#### Aba das configurações do alvo

A aba de configurações do alvo pode ser usada para configurar diversos alvos de compilação.

Cada alvo contém quatro opções de configuração:

Pasta de trabalho

- Você pode definir a localização do projeto aqui. Deixe-a em branco para usar a pasta onde documento atual está localizado.

Compilar

- Esta opção permite-lhe definir o comando de compilação. Ela está configurada como `make` por padrão.

Limpar

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

Compilação rápida

- Esta opção permite-lhe definir o comando de compilação rápida. Ela está configurada como `gcc -Wall -g %f` por padrão.

Pode-se criar um novo alvo com o botão Novo. O botão Copiar pode ser usado para criar uma cópia de um alvo existente. Para excluir um alvo, use o botão Excluir.

#### Aba de resultado

A aba Resultado mostra o resultado na linha de comando gerado pelo último comando.

#### Erros e avisos

A aba Erros e avisos apresenta os erros e avisos gerados pelo último comando.

Cada linha contém uma mensagem, o nome e o número da linha do arquivo, se disponíveis. Se clicar no erro ou aviso será aberto o arquivo apropriado e o cursor será colocado no número de linha correspondente.

Existem botões para Erros, Avisos e Outros no topo, que lhe permitem mostrar ou ocultar essas categorias no resultado.

Para ir ao erro anterior, pressione &Ctrl;&Alt;Esquerda. Para ir ao próximo erro, pressione &Ctrl;&Alt;Direita.

### Estrutura do Menu

Compilar Compilar

- Executa o comando Compilar para o alvo atualmente selecionado.

Compilar Limpar

- Executa o comando Limpar para o alvo atualmente selecionado.

Compilar Compilação rápida

- Executa o comando Compilação rápida para o alvo atualmente selecionado.

&Ctrl;&Alt;Esquerda Compilar Erro anterior

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

&Ctrl;&Alt;Direita Compilar Erro seguinte

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

Compilar Alvos

- Selecione um item da lista de alvos configurados pelo usuário.

Compilar Alvo seguinte

- Muda para o próximo alvo configurado pelo usuário.

### Agradecimentos e reconhecimento

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

Agradecimento especial a Salma Sultana, participante do Google Code-In 2011, por escrever grande parte desta seção.

## Plugin do SQL

### Introdução

O SQL (Structured Query Language) é uma linguagem especializada para atualizar, excluir e solicitar informações de bancos de dados.

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

- Criar um banco de dados

- Conectar-se a bancos de dados existentes

- Inserir e excluir dados do banco de dados

- Executar consultas

- Exibir resultados em uma tabela

### Conectar-se a um banco de dados

Selecione a opção Adicionar conexão do menu SQL ou na barra de ferramentas e depois selecione o controlador de banco de dados do Qt que você deseja usar (incluindo QSQLITE, QMYSQL3, QMYSQL, QODBC3, QODBC, QPSQL7 e QPSQL). Se você não conseguir ver o controlador desejado, será necessário instalar. Depois, clique em Próximo.

Se o banco de dados que você selecionar usar um arquivo, basta indicar a localização do banco de dados e clicar no botão Próximo. Se ele precisar conectar-se a um servidor, você precisa indicar o nome do servidor, o seu usuário e senha, e quaisquer outras informações necessárias ao controlador. Depois, clique em Próximo.

Finalmente, forneça um nome a sua conexão e clique em Concluir.

### Executando consultas

#### INSERT/DELETE/UPDATE

Você pode inserir, excluir e atualizar dados usando o plugin SQL, como faria a partir da linha de comando ou dentro de um programa. Basta digitar uma pesquisa e clicar em Executar consulta.

##### Alguns exemplos de consultas

`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 consulta `SELECT`, você poderá ver o resultado como uma tabela, que aparecerá na área de ferramentas Resultado dos dados em SQL na parte inferior do &kappname; ou como texto no Resultado do texto em SQL. Se ocorrer um erro, você poderá ver no resultado de texto.

##### Exemplo de consulta `SELECT`

    SELECT * FROM nome_tabela

Na área de ferramentas Resultado dos dados em SQL existem diversos botões:

Ajustar as colunas ao conteúdo

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

Ajustar as linhas ao conteúdo

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

Copiar

- Seleciona 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 arquivo, para a área de transferência ou para o documento atual, no formato de valores separados por vírgulas (CSV).

Limpar

- Remove tudo da área da tabela

Você pode agora alterar as cores apresentadas na tabela, na seção SQL da opção Configurações Configurar o &kate; .

### Navegação

Você pode navegar pelo seu banco de dados com a ferramenta de Navegador de esquemas do SQL no lado esquerdo. A informação apresentada varia de acordo com o controlador de banco de dados que você estiver usando.

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

### Estrutura do Menu

SQL Adicionar conexão...

- Adiciona uma nova conexão usando um controlador de banco de dados.

SQL Remover conexão

- Remove a conexão selecionada.

SQL Editar conexão...

- Edita as configurações da conexão atual.

Conexões

- Todas as conexões ao banco de dados que você criou são apresentadas entre os itens do menu Editar conexão e Executar consulta. Selecione uma para executar pesquisas ou efetuar modificações sobre elas.

&Ctrl;E SQL Executar consulta

- Executa a sua consulta.

### Agradecimentos e reconhecimento

O plugin SQL foi criado por Marco Mentasti.

Agradecimentos especiais ao participante Ömer Faruk ORUÇ do Google Code-In 2011 pela escrita de grande parte desta seção.

## Plugin do &gdb;

### Introdução

O plugin do &gdb; para o &kappname; oferece uma interface simples para o conhecido depurador do Projeto &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;.

Você poderá ativar o plugin do &gdb; na seção Plugins da configuração do &kappname;.

Para o plugin funcionar corretamente, você deverá ter um arquivo de código (de qualquer tipo suportado pelo &gdb;) e um executável.

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

Depois de efetuar estas preparações, abra o arquivo de código no &kappname;, indique a localização do executável na aba Configurações da área de Depuração e selecione a opção do menu Depuração Iniciar depuração para começar.

### Estrutura do Menu e da Barra de Ferramentas

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

Exibir Áreas de ferramentas Mostrar a área de depuração

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

Exibir Áreas de ferramentas Mostrar as locais

- Mostra uma lista com todas as variáveis carregadas no momento e os seus valores.

Exibir Áreas de ferramentas Mostrar a pilha de chamadas

- Mostra um registro de chamadas do &gdb;.

Depurar Alvos

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

Depurar Listas de argumentos

- Um submenu que contém todas as listas de argumentos.

Depurar Iniciar depuração

- Inicia o &gdb; com um determinado alvo.

Depurar Matar / Parar depuração

- Para o &gdb;.

Depurar Reiniciar depuração

- Reinicia o &gdb;.

Depurar Comutar o ponto de parada

- Define um ponto de parada na posição atual do cursor.

Depurar Avançar para

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

Depurar Avançar sobre

- Executa a instrução atual (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 atual do cursor.

Depurar Continuar

- Ignora os pontos de parada 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 no momento.

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

- Alvo

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

Pasta de trabalho

- A pasta de trabalho conferida ao alvo.

Lista de argumentos

- Os argumentos passados ao programa.

Manter o foco

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

Direcionar a E/S

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

A Página de Configurações A página de Configurações.

A página Configurações 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 comando onde pode inserir 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 registros de chamadas que são devolvidos pelo &gdb;.

A Área de Registros de Chamadas do &gdb; A área de ferramentas para o registro 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 do programa carregadas no momento, 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 reconhecimento

Agradecimentos especiais ao participante Martin Gergov do Google Code-In 2011 pela escrita de grande parte desta seção.

## Plugin da área da ferramenta Terminal

O Emulador de Terminal integrado é uma cópia do aplicativo &konsole; do &kde;; para sua conveniência. Ele está disponível no item de menu Exibir Ferramenta de Visualização Mostrar Terminal e receberá o foco se exibido. Adicionalmente, se a opção Sincronizar automaticamente o terminal com o documento ativo se possível estiver habilitada, ele irá para a pasta do documento atual, se possível, quando for exibido ou quando o documento atual for modificado.

A localização padrão na janela do &kate; estará na base, abaixo da área de edição.

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

O emulador de terminal embutido é fornecido pelo plugin de Ferramenta de Visualização de Terminal, que está ativo por padrão.

### Estrutura do Menu

Exibir Áreas de ferramentas Mostrar o Terminal

- Alterna para a exibição de um emulador de terminal integrado.

  Quando ativado pela primeira vez, o terminal será criado.

  Quando o emulador de terminal for mostrado, ele obterá o foco, e assim você pode iniciar imediatamente a digitação de comandos. Se a opção Sincronizar automaticamente o terminal com o documento ativo quando possível estiver habilitada na página Terminal do Diálogo principal de configuração, a sessão shell irá para a pasta do documento ativo, se ele for um arquivo local.

Ferramentas Encaminhar para Terminal

- Fornece o texto selecionado ao emulador de terminal integrado. Não será adicionada nenhuma nova linha após o texto.

Ferramentas Sincronizar o terminal com documento atual

- Isto fará com que o terminal integrado use `cd` para a pasta do documento ativo.

  Alternativamente, você pode configurar o &kappname; para sempre manter o terminal em sincronia com o documento atual. Veja em konsole-config para mais informações.

Ferramentas Terminal em Primeiro Plano

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

### Configuração

Você pode configurar o plugin da área da ferramenta Terminal na página da caixa de diálogo de configuração.

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

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

- Isto causará a integração do terminal ao comando `cd` dentro da pasta do documento ativo quando lançado, e quando um novo documento obter o foco. Se não estiver habilitado, você terá que fazer toda a sua navegação pelo terminal sozinho.

Definir a variável de ambiente EDITOR como sendo 'kate -b'

- Isto define a variável de ambiente `EDITOR` de modo que programas executados no terminal embutido que abrem automaticamente um arquivo em um editor abrirão estes arquivos no &kate; ao invés do editor configurado em seu shell. Você não será capaz de continuar usando o terminal até que você feche o arquivo no &kate;, de modo que o programa que realizou a requisição saiba que você terminou a edição do arquivo.