# Complementação de XML

## introdução

Este plug-in 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 são listadas se o caractere a esquerda do cursor for &). Também é possível fechar a tag aberta mais próxima a esquerda.

O DTD deve existir em formato XML , como produzido pelo programa Perl `dtdparse`. Chamaremos um DTD neste formato de meta DTD. Alguns meta DTDs são fornecidos. Eles estão instalados em `$TDEDIR/share/apps/katexmltools/`, o qual também é a pasta 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/Plug-ins sob Configuração Configurar Kate... Após isto, selecione Plug-in XML Designar Meta DTD. Se o seu documento não contém 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 plug-in 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 `$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 corretamente por este plug-in.

## Estrutura do Menu

Plug-in XML 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....

Plug-in XML 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á.

Plug-in XML Designar Meta DTD...

- Isto irá dizer ao plug-in 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

Plug-in Complementação de XML do &kate; - copyright 2001,2002 Daniel Naber daniel.naber@t-online.de.

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

Tradução de José Monteiro monteiro@ajato.com.br

&underGPL;