# Complementação de XML

Daniel
Naber

    daniel.naber@t-online.de

2002-07-20
0.90.00

Este plug-in suporta escrever arquivos XML listando tags permitidas e mais.

KDE
kate
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 `$KDEDIR/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 `$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 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;