# Completação de XML

## Introdução

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

O DTD deve existir em formato XML, como o produzido pelo programa em Perl `dtdparse`. O DTD neste formato é chamado de meta DTD. São fornecidos alguns meta DTDs. Estes estão instalados em `$KDEDIR/share/apps/katexmltools/`, o qual também é a directoria por omissão quando seleccionar a opção Atribuir um Meta DTD.... Para produzir os seus próprios meta DTDs, obtenha o `dtdparse` em http://dtdparse.sourceforge.net.

## Como Usar

Inicie o Kate e seleccione Completação XML do Kate o qual aparecerá na secção Aplicação/Plugins sob Configuração Configurar o Kate... Após isto, seleccione 'Plugin' XML Atribuir um Meta DTD. Se o seu documento não contém DOCTYPE ou o doctype é desconhecido, terá que seleccionar um meta DTD no sistema de ficheiros. Senão, o meta DTD que combinar com o DOCTYPE do documento actual será automaticamente carregado.

Pode agora usar o plugin enquanto insere o seu texto:

< (tecla menor que)

- Mostra uma lista dos elementos possíveis a menos que o cursor esteja já dentro de uma marca. Repare que você actualmente não pode usar isto para inserir os elementos do nível mais exterior (por exemplo, <html>).

" (tecla de aspas)

- A tecla de aspas mostra uma lista dos valores possíveis de atributos (se existirem) se você estiver dentro de uma marca.

(barra de espaços)

- Esta tecla mostra uma lista dos atributos possíveis para o elemento actual se você estiver dentro de uma marca.

& (tecla e comercial)

- Mostra a lista de entidades disponíveis.

## Características e Limitações

Pode testar todas as funções e limitações carregando `$KDEDIR/share/apps/katexmltools/testcases.xml` no &kate; e seguindo as instruções. Note que trabalhar com mais de uma visualização por documento ainda não é suportado correctamente por este plugin

## Estrutura do Menu

'Plugin' XML Inserir Elemento...

- Abre um dialogo que lhe permite inserir um elemento XML. Os caracteres <, > e a marca final serão inseridos automaticamente. Se você tiver seleccionado texto quando este item de menu for seleccionado este será cercado pelas marcas inicial e final. O dialogo também oferece completação de todos os elementos que podem ser inseridos na posição actual do cursor se você tiver escolhido um meta DTD usando Atribuir um Meta DTD....

XML Plugin Fechar Elemento

- Pesquisar no texto uma marca que ainda não esteja fechada e irá fecha-la inserindo a marca final correspondente. A pesquisa começa na posição do cursor e vai para a esquerda. Se não foi possível encontrar uma marca aberta nada acontecerá.

'Plugin' de XML Atribuir um Meta DTD...

- Isto irá dizer ao plugin qual o meta DTD que deve ser utilizado no documento actual. Note que esta atribuição não será gravada; terá que repetir este passo quando iniciar o &kate; da próxima vez.

## Agradecimentos e Reconhecimentos

Plugin para o &kate; de Completação de XML copyright 2001,2002 Daniel Naber daniel.naber@t-online.de.

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

Tradução de Pedro Morais morais@kde.org

&underGPL;