# Lidar com 'Plugins'

O Kate está a usar dois tipos diferentes de 'plugins', nomeadamente os 'plugins' para a aplicação &kate; e os 'plugins' para o componente de edição do &kate;. Os últimos estão disponíveis em qualquer aplicação que use o componente de edição, como o KDevelop, o Quanta, o Kile, o Kwrite e muitos outros, enquanto os 'plugins' da aplicação são específicos apenas do &kate;.

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.

Existem vários 'plugins' para vários fins disponíveis e poderá procurar mais na Web. Alguns 'plugins' são fornecidos com o componente de edição, para fazer completação de palavras, favoritos automáticos, inserções de ficheiros, ferramentas de dados ou a exportação do texto como &HTML;.

## 'Plugins' do Componente de Edição

A página de 'Plugins', na página Extensões, apresenta todos os 'plugins' disponíveis e você poderá assinalar os que deseja usar. Carregue no botão Informação para abrir a janela Acerca deste 'plugin'.

Assim que um 'plugin' configurável esteja assinalado, o botão Configurar fica activo para que possa carregar nele, de modo a configurar o 'plugin' realçado.

Parêntesis Automáticos

- O 'plugin' de parêntesis automáticos substitui a funcionalidade interna do &kate; para Parêntesis Automáticos. Introduz automaticamente um parêntesis de fecho } no início da próxima linha, depois de terminar uma dada linha com um parêntesis de abertura { e carregar na tecla &Enter;.

Ferramentas de Dados

- Activa as ferramentas de dados, como a verificação gramatical e ortográfica (se estiverem instalados). As ferramentas de dados só ficam disponíveis quando tem texto seleccionado, ou quando o botão direito do rato é carregado sobre uma palavra. Se não existirem ferramentas de dados disponíveis, mesmo quando selecciona algum texto, terá de as instalar. Algumas ferramentas de dados fazem parte do pacote &koffice;. Se este 'plugin' estiver activo e se as ferramentas de dados estiverem instalados, irão aparecer alguns itens adicionais no fim do menu do contexto.

Exportação

- Este comando permite-lhe exportar o documento actual com toda a informação de realce para um documento em HTML, usando a opção Ficheiro Exportar como HTML. Para além disso, poderá usar a opção Editar Copiar como HTML para copiar o texto seleccionado de momento como HTML para a área de transferência do sistema.

Inserção de Ícones

- O 'plugin' de inserção de ícones só é usada para os programadores do &kde;: Adiciona um item Inserir um Código de KIcon no menu de contexto do editor. Se estiver activado, o selector de ícones do &kde; irá abrir (mostrando os ícones das aplicações, das acções, &etc;..). Se carregar num, será inserido como texto o nome do ficheiro sem a extensão do mesmo. Só é útil para atribuir ícones, através da plataforma do &kde;, com a classe KIcon().

Codificação louca (não ZEN) de HTML (edição leve)

- Um 'plugin' que faz uma completação de selectores semelhante à codificação Zen. Para mais informações, veja a Codificação Zen.

Inserir um Ficheiro

- Este 'plugin' permite-lhe introduzir o conteúdo de qualquer ficheiro legível na posição do cursor. Se estiver activo, o menu Ferramentas tem uma opção adicional para Inserir um Ficheiro.

## '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:

- Área de ferramentas para procurar nos ficheiros - uma área que permite procurar em todos os ficheiros abertos ou nos ficheiros do sistema de ficheiros

- Navegador de Registos de Chamadas - área de navegação por uma sequência de chamadas

- Selector rápido de documentos - Muda automaticamente para outro documento já aberto

- Barra de Páginas - Adiciona uma barra de páginas à janela principal do &kate;

- Filtro de Texto - Filtragem de texto simples

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

- Navegador do sistema de ficheiros - Uma ferramenta de navegação pelo sistema de ficheiros

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

- 'Plugin' do CTags - Procurar definições/declarações com o CTags

- Modelos de Ficheiros - Criar ficheiros novos a partir de modelos

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

- Ferramentas Externas

- 'Plugin' de Compilação - Compilar e processar as mensagens de erro

- Enviar os ficheiros por e-mail - Envia os ficheiros por e-mail

- Excertos do Kate - 'Plugin' de excertos com o suporte de completação do código

- 'Plugin' do Jovie para o KTextEditor - Adiciona um item de menu para sintetizar o texto

- Validação de &XML;- Faz a validação dos ficheiros em &XML; com o 'xmllint'

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

- Barra de Páginas - Adiciona uma barra de páginas à janela principal do Kate

## Modelos de Ficheiros

O 'plugin' de Modelos de Ficheiros permite-lhe criar ficheiros com base noutros ficheiros.

Quando instalar o Kate da primeira vez, terá de activar o 'plugin':

1. Carregue em Configuração Configurar o Kate

2. Na árvore à esquerda do ecrã, carregue em 'Plugins'.

3. No painel do Gestor de 'Plugins' à direita, seleccione os Modelos de Ficheiros e carregue depois em OK.

O 'plugin' de Modelos de Ficheiros permite-lhe criar ficheiros com base noutros (isto cria uma cópia do ficheiro com um &URL; vazio). Os ficheiros de modelos especiais poderão conter macros para preencher informações como o seu nome e endereço de e-mail, a data actual, entre outros, colocando o cursor numa posição conveniente do ficheiro novo.

Poderá também criar facilmente um novo modelo a partir de um documento aberto.

Os modelos que gravar na pasta de modelos aparecem no item de menu Ficheiro Novo a Partir do Modelo.

A pasta de modelos faz parte do sistema de ficheiros do &kde; e consiste em, pelo menos

- `$`KDEDIR`/share/applications/kate/plugins/katefiletemplates/templates`

- `$`KDEHOME`/share/applications/kate/plugins/katefiletemplates/templates.`

Se a sua variável de ambiente `KDEDIRS` contiver pastas adicionais, estas são pesquisadas por subpastas semelhantes. Se forem encontrados modelos com o mesmo nome, é escolhido o da pasta local (KDEHOME).

### Estrutura do Menu

Ficheiro Novo a Partir do Modelo Qualquer Ficheiro...

- Apresenta-lhe uma janela de Abertura de Ficheiros que lhe permite usar qualquer ficheiro como modelo. Se o ficheiro escolhido tiver a extensão `katetemplate`, ele será processado para a informação e as macros do modelo.

Ficheiro Novo a Partir do Modelo

- O resto dos sub-menus contém referências para os modelos. Carregue num item do menu para criar um ficheiro, tal como é descrito pelo texto do item do menu.

Configuração Gerir os Modelos

- Isto irá lançar uma janela com uma lista com todos os modelos encontrados nas directorias de modelos, em conjunto com as opções para adicionar, editar ou remover os modelos.

### Usar um Modelo do &kate;

Ao criar um ficheiro a partir de um modelo que contenha macros de modelos, algumas das macros aparecem como variáveis editáveis no texto. Essas variáveis aparecem como palavras sublinhadas no texto.

Será seleccionada a primeira variável, como tal só terá de escrever para a editar. Se o texto do documento contiver mais instâncias da mesma variável, podê-las-á alterar à medida que editar. Para mudar para a próxima variável editável, carregue na tecla TAB. Quando for editada a última variável, a lista é fechada e a sua tecla TAB passa a funcionar de forma normal.

### Criar os seus próprios modelos

Para criar um modelo novo, use o item Configuração Gerir os Modelos para lançar a janela de gestão de modelos. Na mesma, carregue em Novo... para lançar o Assistente de Modelos de Ficheiros. Ser-lhe-á pedido um ficheiro opcional para transformar num modelo e a configuração dos dados do modelo, para que seja criado um ficheiro para si.

Em alternativa, você poderá criar um modelo manualmente se adicionar a informação do modelo ao topo de qualquer ficheiro, adicionar o texto, as macros e o marcador da posição do cursor, gravando-o com a extensão `katetemplate`.

O menu do modelo é actualizado automaticamente se você optou por gravar o seu modelo na directoria respectiva.

### Editar os modelos

Para editar um modelo, use a opção Configuração Gerir os Modelos.... Seleccione o modelo com que deseja trabalhar e carregue em Editar..., para que seja aberto o ficheiro de modelo. Feche a janela, edite o ficheiro de modelo como desejar, grave-o e feche-o. As alterações aos modelos têm efeito imediato e você poderá activar o modelo para testar as suas alterações depois de o gravar.

### O Formato dos Modelos do &kate;

Se você usar os ficheiros com a extensão `katetemplate`, eles serão processados no que respeita à informação do modelo, das macros e da posição do cursor.

#### Informação do modelo

Ao ler o ficheiro, o analisador guarda as linhas que começam com a frase `katetemplate:` e procura nelas por informações do modelo no formato NOMEVARIAVEL=VALOR. A primeira linha que não começar por `katetemplate:` será aceite como o início do conteúdo do modelo. O VALOR poderá conter qualquer carácter excepto o sinal de igual (=). Os nomes válidos de variáveis são:

`Modelo`

- Este é o nome do modelo, mostrado no menu Ficheiro A Partir do Modelo.

`Group`

- O grupo coloca o modelo dentro de um sub-menu do Ficheiro A Partir do Modelo.

`Nome`

- Este é o nome que será atribuído ao documento e mostrado na lista de ficheiros e na barra de título. Se o nome contiver um `%N`, este será substituído por um número, o qual será incrementado se existir mais do que um documento com o mesmo nome.

`Highlight`

- O 'plugin' irá tentar configurar o Highlight (realce) para o valor desta variável. O valor deverá ser o nome, tal como consta no menu Ferramentas Realce .

`Description`

- Um breve descrição informativa do modelo. Este é usado de momento para definir um item O Que É Isto para o item do menu, mas poderá ser usado para mais fins no futuro.

Autoria

- Um texto que identifica o autor, por exemplo no formato `Nome <endereço de e-mail>`. Isto é usado de momento para definir um texto de O Que É Isto para o item do menu, mas poderá ser usado para mais fins no futuro.

#### Macros dos Modelos

Ao processar o conteúdo do modelo, as macros no formato `%{NOME}` ou `${NOME}` são expandidas. Se usar o prefixo `$`, a macro expandida será tratada como uma variável editável, quando for criado um documento a partir do modelo, enquanto que se usar o `%` não o será, a menos que a expansão seja mal-sucedida.

São expandidas as seguintes macros:

time

- Expande para a hora actual, no seu formato regional.

date

- Expande para a hora actual, num formato curto.

datetime

- Expande para a data e hora actuais, formatadas como uma cadeia de caracteres de acordo com a sua configuração regional.

year

- O ano actual, como um número de quatro algarismos.

month

- O nome completo do mês actual, de acordo com a sua configuração regional.

day

- Expande para o dia actual do mês.

hostname

- Expande para o nome do seu computador.

index

- Expande para 'i'.

fullname

- Expande para o seu nome completo, tal como está definido no seu livro de endereços normal do &kde;.

firstname

- Expande para o seu primeiro nome, tal como está definido no seu livro de endereços normal do &kde;.

lastname

- Expande para o seu último nome (apelido), tal como está definido no seu livro de endereços do &kde;.

e-mail

- Expande para o seu endereço de e-mail, tal como está definido no seu livro de endereços normal do &kde;.

Todas as macros que não estiverem na lista acima serão tratadas como variáveis editáveis, independentemente do prefixo. Se a mesma variável ocorrer várias vezes no modelo, elas poderão ser editadas de uma vez, depois de criar um documento a partir do modelo.

#### Configurar a posição do cursor

A macro especial `${cursor}` será substituída por uma barra vertical e será adicionada ao fim da lista de variáveis editáveis, independentemente da sua posição no texto.

### Agradecimentos e Reconhecimentos

'Plugin' do &kate; Modelos de Ficheiros com 'copyright' 2004 de &Anders.Lund; &Anders.Lund.mail;.

Documentação copyright 2004 &Anders.Lund;

## Validação de &XML;

Este plugin verifica para consistência e validade de ficheiros &XML;.

Este plugin verifica o ficheiro actual. Uma lista de avisos e erros aparecerá na parte de baixo do janela principal do &kate;. Pode carregar numa mensagem de erro para saltar para o lugar correspondente no ficheiro. Se o ficheiro tiver um DOCTYPE o DTD dado com este doctype será utilizado para validar este arquivo. O DTD é esperado numa posição relativa ao ficheiro actual. Isto é, se o doctype se refere ao DTD/xhtml1-transitional.dtd e o ficheiro é `/home/pedro/test.xml` o DTD deve estar localizado em `/home/pedro/DTD/xhtml1-transitional.dtd`. No entanto, são também suportados DTDs remotos especificados via http.

se o arquivo não tiver um doctype ele será verificado para boa formatação.

Para aprender mais acerca de &XML; consulte as páginas oficiais de &XML; do W3C.

Internamente, este plugin chama o comando externo `xmllint`, o qual é parte de libxml2. Se este comando não estiver instalado correctamente no seu computador o plugin não funcionará.

É necessário escrever um arquivo temporário na mesma pasta do arquivo a ser verificado; por esta razão, é necessário que tenha permissões de escrita naquela pasta.

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

### Estrutura do Menu

Ferramentas Validar XML

- Iniciar a verificação, conforme descrito acima.

### Agradecimentos e Reconhecimentos

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

Copyright da Documentação 2002 por &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 `$KDEDIR/share/apps/katexmltools/`, 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 `$KDEDIR/share/apps/katexmltools/testcases.xml` 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;