# Completamento de &XML;

Daniel
Naber

    &Daniel.Naber.mail;

17-05-2006
3.5.2

Este plug-in suporta escrever arquivos &XML; listando marcas permitidas e mais.

KDE
kate
xml

# Introdução

Este plug-in dá pistas sobre o que é permitido em determinada posição de um arquivo &XML;, de acordo com o DTD do arquivo. Ele lista elementos, atributos, valores de atributos ou entidades válidas, dependendo da posição do cursor (&eg;, 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 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/`, que também é a pasta padrão quando você escolhe Designar Meta DTD.... Para produzir seus próprios meta DTDs, baixe o `dtdparse` em http://dtdparse.sourceforge.net.

## Como Usar

Inicie o &kate; e abra a janela de configuração em Configurações Configurar o &kate;.... Então selecione Completamento XML do Kate que aparecerá na seção Aplicativo/Plug-ins e feche a janela. Após isto, selecione Plug-in XML Atribuir um Meta DTD.... Se o seu documento não contém DOCTYPE ou o doctype é desconhecido, você terá que selecionar um meta DTD no sistema de arquivos. Senão, o meta DTD que combinar com o DOCTYPE do documento atual será automaticamente carregado.

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 (&eg; <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

&Ctrl;Return 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 Completamento 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....

&Ctrl;< XML Fechar Elemento

  Isto irá pesquisar em seu texto por uma tag que não está ainda fechada e irá fechá-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 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 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 José Monteiro monteiro@ajato.com.br

&underGPL;