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 , que também é a pasta padrão quando você escolhe . Para produzir seus próprios meta DTDs, baixe o dtdparse em http://dtdparse.sourceforge.net.--paths GenericDataLocation
Inicie o Kate e abra a janela de configuração em → . Depois, selecione o Completamento de XML que irá aparecer na página → e feche a janela. Depois disso, selecione a opção do menu → . 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 , 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.
Você pode testar todas as funções e limitações carregando katexmltools/testcases.xml em qtpaths no Kate e seguindo as instruções.--paths GenericDataLocation
- → (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 .
- → (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á.
- →
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.