Completamento XML

Daniel Naber

Este plugin 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 (por exemplo, todas as entidades são mostradas se o caractere à 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 katexmltools/ no qtpaths --paths GenericDataLocation , 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çõesConfigurar o Kate.... Depois, selecione o Completamento de XML que irá aparecer na página AplicativoPlugins e feche a janela. Depois disso, selecione a opção do menu XMLAtribuir uma Meta-DTD.... Se o seu documento não tiver nenhum DOCTYPE ou se ele for desconhecido, você terá que selecionar uma meta-DTD no sistema de arquivos. Caso contrário, será carregada automaticamente a meta-DTD que corresponder ao DOCTYPE do documento atual.

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 (por exemplo <html>).

</ (tecla 'menor que' + barra)

Inserir estes caracteres irá oferecer o fechamento do elemento atual (o mais próximo do que se encontra à esquerda do cursor). Pressione Enter para aceitar a sugestão. Ao contrário do item Fechar o elemento, isto funciona apenas com uma DTD atribuída.

" (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 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 katexmltools/testcases.xml em qtpaths --paths GenericDataLocation no Kate e seguindo as instruções.

Estrutura do menu

XMLInserir elemento... (Ctrl+Enter)

Isto irá abrir uma janela que lhe permite inserir um elemento em XML. Os caracteres <, > e a marca de fecho serão inseridos automaticamente. Se você tiver selecionado algum texto quando tiver selecionado este item do menu, o texto selecionado será rodeado pela marca de abertura e de fecho. A janela também oferece o completamento de todos os elementos que poderão ser inseridos na posição atual do cursor, caso tenha atribuído uma meta-DTD com a opção Atribuir uma Meta-DTD....

XMLFechar elemento (Ctrl+<)

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á.

XMLDesignar Meta DTD...

Isto irá 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 reconhecimento

Plugin para o Kate de Completação de XML copyright 2001,2002 Daniel Naber .

Versão para o KDE SC 4 com direitos autorais de 2010 de Tomáš Trnka

Copyright da Documentação 2001,2002 Daniel Naber