# 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.

Exportador

- 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

- GDB - Fornece uma interface simples para o GDB

- 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

- 'Plugin' de SQL - Executa uma pesquisa em bases de dados SQL

- 'Plugin' de Pesquisa - Procurar um padrão nos ficheiros

- Barra de Páginas - Adiciona uma barra de páginas normal à 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 - Ferramenta de navegação no 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 - Enviar os ficheiros por e-mail

- Barra de Páginas Multi-Linha - Adiciona uma barra de páginas com várias linhas à janela principal do &kate;

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

- 'Plugin' de Texto-para-Fala do Jovie - 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;

## Mudança Rápida de Documentos

### Estrutura do Menu

&Ctrl;1 Ir Mudança Rápida

- Abre a janela de Selecção Rápida de Documentos com um campo de pesquisa e uma lista dos ficheiros aberto. Ao introduzir texto no campo de pesquisa, são pesquisados os nomes e os URL's dos documentos à procura do texto correspondente. Ao introduzir o texto no campo de pesquisa, poderá usar as teclas de cursores Cima e Baixo para navegar pela lista. Se sair da janela com o OK, o 'plugin' muda a vista para o documento seleccionado na lista. Isto facilita a mudança de documentos, caso tenha muitos abertos.

## Exportador

### Estrutura do Menu

Ficheiro Exportar como HTML...

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

Editar Copiar como HTML...

- Copia o texto seleccionado com realce de sintaxe como um texto em HTML.

## Procurar nos Ficheiros

### Estrutura do Menu

Editar Procurar nos Ficheiros...

- Invoca a janela para Procurar nos Ficheiros, que lhe permite procurar por texto nos ficheiros de uma pasta.

Ver Áreas de Ferramentas Mostrar o 'Procurar nos Ficheiros'

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

## Enviar os Ficheiros por E-Mail

### Estrutura do Menu

Ficheiro Enviar por E-Mail...

- Abre o seu cliente de e-mail e anexa o ficheiro na mensagem.

## 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, o Tamanho e o Tipo 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 sistema operativo.

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.

  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.

## Ferramentas Externas

No menu Ferramentas, irá encontrar um submenu chamado Ferramentas Externas, se as tiver activado na configuração do &kate;. Estas ferramentas invocam aplicações externas com dados relacionados com o documento actual, como por exemplo o seu URL, pasta, texto ou selecção.

As ferramentas externas são definidas pelo utilizador; poderá adicionar, editar ou remover ferramentas com o painel de configuração das Ferramentas Externas.

### Estrutura do Menu

Ferramentas Ferramentas Externas

- Este submenu contém todas as ferramentas externas que tiver configurado.

### Configuração

As ferramentas externas são configuradas na página Ferramentas Externas da configuração do &kate;. Estas ferramentas invocam as aplicações externas com dados relacionados com o documento actual, como por exemplo o seu URL, pasta, texto ou selecção. Esta página permite-lhe gerir o menu e editar, remover ou adicionar ferramentas novas.

Cada ferramenta externa é um comando da consola que contém macros que representam os dados do documento. Quando estiver activo, as macros são substituídas por dados do documento activo.

### Comandos Disponíveis

Novo

- Adiciona uma nova ferramenta externa à lista. Isto irá invocar a folha de propriedades descrita abaixo, onde poderá configurar uma ferramenta externa.

Editar

- Edita a ferramenta externa seleccionada de momento, usando a folha de propriedades descrita em baixo.

Inserir um Separador

- Adiciona uma linha separadora que aparece no menu por baixo do item seleccionado de momento.

Cima

- Sobe o item seleccionado de momento para cima do anterior.

Baixo

- Desce o item seleccionado de momento para baixo do anterior.

### Propriedades das Ferramentas Externas

Legenda

- Uma legenda amigável que irá aparecer no menu de Ferramentas Externas.

Ícone

- Permite-lhe seleccionar o ícone que aparece ao lado da legenda no menu de Ferramentas Externas.

Programa

- O programa a executar quando activar a ferramenta. Antes de passar o comando à consola, são substituídas as seguintes macros:

  `%URL`

- O URL completo do documento actual ou um texto vazio, caso o documento não tenha sido gravado.

`%URLs`

- Uma lista, separada por espaços, dos URL's de todos os documentos abertos (excepto os não gravados).

`%directory`

- A componente da pasta do URL do documento actual, ou um texto vazio, caso o documento actual não esteja gravado.

`%filename`

- O nome do ficheiro do documento actual sem a localização, ou um texto vazio, caso o documento actual não esteja gravado.

`%line`

- O número da linha do cursor de inserção, onde se encontra no documento actual.

`%column`

- O número da coluna do cursor de inserção, onde se encontra no documento actual.

`%selection`

- O texto seleccionado no documento actual, ou um texto vazio, caso não esteja seleccionado nenhum texto

`%text`

- O texto completo do documento actual. Tenha em atenção que este poderá exceder o tamanho máximo do comando permitido pelo seu sistema. Use com cuidado.

Executável

- O executável principal do programa. Isto é obrigatório e é usado para testar se o comando pode ser executado de todo. É permitida uma localização completa, no caso de o seu executável não se encontrar incluído na sua variável de ambiente `PATH`.

Tipos MIME

- Uma lista, separada por ponto-e-vírgula, dos tipos MIME que deverão estar activos para este comando.

Gravar

- Poderá optar por gravar o documento actual ou todos os documentos antes de executar o programa. Isto é útil se o seu programa ler o ficheiro do disco.

Nome da linha de comandos

- Se preencher isto, a ferramenta ficará disponível na linha de comandos do editor como `exttool-`Nome da Linha de Comandos`` (o texto que indicar aqui, antecedido de exttool-).