# Complementação de XML

## introdução

Este plugin dá pistas sobre o que é permitido em certa posição de um arquivo XML, de acordo com o DTD do arquivo. Ele listará possíveis elementos, atributos, valores de atributos ou entidades, dependendo da posição do cursor (por exemplo, todas as entidades Sao listadas se o caracter a esquerda do cursor for &). Tambem é possível fechar a tag aberta mais próxima a esquerda.

O DTD deve existir em formato XML , como produzido pelo programa Perl `dtdparse`. Nos chamaremos um DTD neste formato meta DTD. alguns meta DTDs Sao fornecidos. Eles estão instalados em `$KDEDIR/share/apps/katexmltools/`, o qual também é o diretorio padrão quando você escolhe Designar Meta DTD.... Para produzir seus próprios meta DTDs, pegue o `dtdparse` em http://dtdparse.sourceforge.net.

## Como Usar

Inicie o Kate e selecione Complementação XML do Kate o qual aparecerá na seção Aplicação/Plugins sob Configuração Configurar Kate... Após isto, selecione XML Plugin Designar Meta DTD. Se o seu documento não contem DOCTYPE ou o doctype é desconhecido, você terá que selecionar um meta DTD do sistema de arquivo. Senão, o meta DTD que combinar com o DOCTYPE do documento atual será carregado automaticamente.

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 (isto é <html>).

" (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 de 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. Note que trabalhar com mais de uma visualização por documento ainda não é suportado corretamente por este plugin

## Estrutura do Menu

XML Plugin Inserir Elemento...

- Isto abrirá um dialogo que lhe permite inserir um elemento XML. Os caracteres <, > e a tag de fechamento serão inseridas automaticamente. Se você tiver selecionado texto quando este item de menu for selecionado, o texto selecionado será circundado pelas tags de abertura e fechamento. O dialogo também oferece Complementação de todos os elementos que podem ser inseridos na posição atual do cursor se você tiver designado um meta DTD usando Designar Meta DTD....

XML Plugin Fechar Elemento

- Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fecha-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 Plugin Designar Meta DTD...

- Isto ira 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 Reconhecimentos

&kate; Plugin Complementaçã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 Jose Monteiro monteiro@ajato.com.br

&underGPL;