# 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 (⪚, 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 `$TDEDIR/share/apps/katexmltools/`, o qual também é a pasta 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 `$TDEDIR/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

&Ctrl;Return XML Inserir um Elemento...

- Abre uma janela 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. A janela também oferece a 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....

&Ctrl;< XML Fechar o 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.mail;.

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

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

&underGPL;