# Autocomplètement XML

Daniel
Naber

    daniel.naber@t-online.de

2002-07-20
0.90.00

Ce module externe supporte l'écriture de fichiers XML en listant les balises autorisées et autres.

KDE
kate
xml

# Introduction

Ce module vous donne des astuces sur ce qui est autorisé à une position donnée dans un fichier XML, cela en se basant sur le DTD du fichier. Il donnera la liste des éléments, des attributs, des valeurs des attributs ou des entités possibles, selon la position du curseur (toutes les entités sont listées si le caractère à gauche du curseur est &). Il est aussi possible de fermer la balise ouverte la plus proche à gauche.

Le DTD doit exister au format XML, tel que généré par le programme Perl `dtdparse`. Notez que ce DTD au format XML n'est pas le modèle XML. Il est appelé meta DTD. Certains meta DTD sont fournis. Ils sont installés dans `$KDEDIR/share/apps/katexmltools/`, qui est aussi le dossier par défaut lorsque vous choisissez Assigner un meta DTD. Pour fabriquer vos propres meta DTD, procurez-vous `dtdparse` depuis http://dtdparse.sourceforge.net.

## Fonctionnement

Démarrer Kate et sélectionner Complètement XML de Kate qui se trouve dans la sectionéditeur/ Modules externes Configuration Configurer Kate... Après cela Module externe XML Assign Meta DTD. Si votre document ne contient pas de DOCTYPE ou que le doctype est inconnu, vous aurez a sélectionner un meta DTD depuis votre disque dure. Sinon le meta DTD qui correspond au document actuel sera chargé automatiquement.

Vous pouvez maintenant utiliser le module durant votre rédaction :

< (la touche inférieur)

  Ceci déclenchera une liste d'éléments possibles à moins que le curseur soit déjà à l'intérieur d'une balise. Notez qu'actuellement, vous ne pouvez pas l'employer pour insérer un élément de niveau supérieur (par exemple <html>).

" (la touche guillemet)

  La touche guillemet appelle une liste de valeurs possibles d'attribut, s'il y en a et si vous êtes à l'intérieur d'une étiquette.

(la barre espace)

  Cette touche déclenchera une liste d'attributs possibles pour l'élément actuel si vous êtes à l'intérieur d'une balise.

& (touche esperluette)

  Cette touche déclenchera une liste d'entités nommées.

## Fonctions et limitations

Vous pouvez tester toutes les fonctions et limitations en chargeant `$KDEDIR/share/apps/katexmltools/testcases.xml` dans &kate;, en suivant les instructions contenues dans le fichier. Notez que le travail avec plus d'un document n'est pas supporté correctement actuellement par ce module.

## Structure des menus

Module XML Insérer une entité

  Cela ouvre une boîte de dialoguequi vous permet d'insérer un élément XML. Les caractères <, > ainsi que l'étiquette de fermeture sera inséré automatiquement. Si vous avez sélectionné du texte lorsque cette option est sélectionné, le texte sera entouré par les étiquettes ouvrante et fermante. La boîte de dialogue offre de plus d'autocomplètement de tous les éléments pouvant être insérés à la position actuelle du curseur. Cela à condition d'avoir sélectionné un meta DTD. en utilisant Assign Meta DTD....

Module XML Fermer l'élément

  Ceci recherchera une balise pas encore fermée dans votre texte, et la fermera en insérant la balise de fermeture correspondants. La recherche démarre à la position du curseur et va vers la gauche. S'il ne peut pas trouver de balise ouvrante, rien ne se passera.

Module XML Assigner un meta DTD

  Cela précise au module quel meta DTD utiliser pour tous les documents actuellement ouverts. Notez que cette assignation ne sera pas enregistrée, vous aurez à la répéter la prochaine fois que vous démarrerez &kate;.

## Remerciements et mentions

Module externe de &kate; Complètement XML copyright 2001, 2002 Daniel Naber daniel.naber@t-online.de.

Documentation copyright 2001,2002 Daniel Naber

Traduction française par &YvesDessertine;.

Mise à jour par &GoneriLeBouder;.

&underGPL;