Les documents XML ne sont que de simples documents textes. Il suffit donc d'un éditeur de texte pour les rédiger. Toutefois il est quelque peu rébarbatif de saisir régulièrement les mêmes balises. C'est pourquoi il est intéressant de disposer de quelques raccourcis clavier lors de la saisie.
Pour les utilisateurs de vim, vous trouverez le fichier vim/xml.vim que vous pouvez recopier dans un répertoire ~/.vim. Ce fichier fournit une coloration syntaxique adaptée pour le XML et un ensemble de raccourcis clavier pour le mode insertion. Tous les raccourcis commencent par une virgule. Ainsi « ,xm » permet d'insérer la ligne d'en-tête XML et « ,in » insère un bloc d'en-tête info. Consultez le fichier pour découvrir les autres raccourcis.
Pour utiliser automatiquement cette configuration lorsque vous éditez un fichier .xml il vous faut rajouter ceci dans votre fichier ~/.vimrc :
au BufEnter *.xml so ~/.vim/xml.vim
Il faut être particulièrement vigilant avec les chemins d'accès aux fichiers aussi bien lorsque vous incluez des images (avec la balise image) que des documents (avec la balise include). En effet, le jeu des inclusions peut changer le "répertoire courant" et fausser les données.
Imaginez un répertoire module contenant tous les modules et un répertoire theme contenant l'ensemble des thèmes. Supposez que theme/theme_un.xml inclue un module avec une balise include similaire à celle ci :
<xi:include href="../module/sujet.xml"/>Supposez également que le module sujet.xml inclue une image schema.eps (présente dans le répertoire module) avec un élément :
<image src="schema.eps"/>Que va t'il se passer lorsque l'on va essayer de transformer theme_un.xml ? Et bien theme_un.xml va contenir une balise image listant schema.eps qui n'est pas disponible dans le répertoire theme et il va y avoir une erreur. D'où la nécessité de mettre des chemins d'accès aux fichier plus explicites même si l'image est dans le même répertoire que le module :
<image src="../module/schema.eps"/>
Les images qui sont inclues dans les documents XML doivent être au format « .eps ». Même si ce format ne convient pas pour toutes les sorties (HTML notamment), c'est le format de référence choisi. L'image sera automatiquement convertit en PNG pour les besoins de la version HTML.