Ceci est une ancienne révision du document !
nXhtml
Mode nXhtml pour emacs, ajoutant coloration syntaxique, complétion et validation xhtml à cet éditeur.
Pré-requis
- Disposer d'une connexion à Internet configurée et activée.
- Avoir installé le paquet emacs 22 ou plus récent (la version courante au 09/01/2010 est emacs23).
Installation
Téléchargez nXhtml sur cette page : Download Latest EmacsW32+Emacs binaries and nXhtml. Étant sous Ubuntu GNU/Linux, ne prenez pas le paquet avec emacs + l'extension mais seulement l'extension, qui se trouve dans la partie Download latest nXhtml (zip file)
Extrayez l'archive dans ~/.config/emacs (par exemple. Vous pouvez choisir un autre dossier, il faudra juste modifier le code suivant en conséquence).
Configuration
Il est inscrit ceci dans le fichier README.txt:
To install nXhtml put this in your .emacs:(load "YOUR-PATH-TO/nxhtml/autostart.el")where autostart.el is the file in the same directory as this readme.txt file.
Ce qui signifie :
Pour installer nXhtml mettez ceci dans votre .emacs:(load "VOTRE-CHEMIN-VERS/nxhtml/autostart.el")où autostart.el est le fichier dans le même répertoire que ce fichier readme.txt.
Ouvrez le fichier ~/.emacs et rajoutez ce code, en remplaçant .config/emacs par le chemin du dossier nxhtml) :
(load "/home/$USER/.config/emacs/nxhtml/autostart.el")
Utilisation
Déja, lancez emacs.
Les tutos sont en Flash.
Complétion et validation de XHTML
(Sous LMDE, ma touche Meta est Alt, alors que sous Ubuntu il me semble que c'était Echap, donc testez au moins ces deux-là pour trouver la vôtre)
Source : Completion and Validation of XHTML
- Supposons que vous voulez créer un nouveau fichier XHTML. Vous commencez par taper C-x C-f (Control-x Control-f) et entrer le nom de fichier.
- Vous obtenez un buffer vide. L'indicateur de mode indique (en bas à droite)
nXhtml/nxhtml
qui signifie (paraît que c'est important) :- nXhtml : "current major mode, nxhtml-noce"
- nxhtml : "multi major mode nxhtml-mumamo"
- Vous pouvez utiliser la complétion ici, dès le départ. La fonction que vous utilisez pour la complétion en nxhtml mode est "nxml complete" disponible normalement sur M-Tab (Si vous utilisez tabkey2 tapez seulement Tab deux fois) (Oui évidemment qu'il l'utilise. Je veux dire tabkey2-mode. M-Tab ne fonctionne pas s'il utilise Alt comme touche Meta. Pfff. Vous ne savez pas vous. Dites-le seulement bien fort ! ).
- En appuyant sur M-Tab dans un fichier vide, on obtient un squelette de fichier XHTML.
- En tapant ensuite des éléments à la main, la barre d'état donne les éventuelles erreurs, et l'élément s'affiche en rouge (testé avec un
<p>
après body) - Il est souvent plus facile d'utiliser la complétion automatique, le code écrit sera ainsi correct. Astuce : d'abord sélectionner la région qui doit être entourée par la balise et ensuite faire la complétion. Un appui sur Tab indente ensuite la ligne. Les tags sont regroupés par catégorie, ce qui les rend faciles à trouver dans la liste. Faut que je fasse la liste des tags quand même après, yen a plein.
- Pour fermer un tag ouvert, il suffit de taper C-c C-f.
Désinstallation
Pour supprimer l'extension, il suffit d'ouvrir le fichier ~/.emacs, de supprimer le code précédemment rajouté dans le fichier et de supprimer le dossier ~/.config/emacs/nXhtml.
Voir aussi
- (en) Site officiel
- Discussion « Problème avec html-helper-mode pour emacs » sur le forum Ubuntu-fr
Contributeurs principaux : kamui57.
Basé sur nXhtml - Emacs Utilities for Web Development
Partie "complétion et validation" basée sur Completion and Validation of XHTML par Auteur Original.
===== Installation =====
Cette extension pour Emacs sert à éditer du code HTML/XHTML/CSS avec la complétion et la validation notamment, d'après son site web nXhtml - Emacs Utilities for Web Development. Pour l'utiliser, il faut avoir emacs22 ou plus récent. Si vous ne l'avez pas encore fait, vous pouvez installer apt://emacs (la version courante au 09/01/2010 est emacs23).
Téléchargeons nXhtml sur cette page : Download Latest
EmacsW32+Emacs binaries
and nXhtml. Comme nous sommes sous Ubuntu GNU/Linux, nous ne prenons pas le paquet avec emacs+l'extension mais seulement celle-ci, dans la partie Download latest nXhtml (zip file)
Nous pouvons alors l'extraire et lire le README.txt. Il est inscrit ceci :
> To install nXhtml put this in your .emacs: <code>(load "YOUR-PATH-TO/nxhtml/autostart.el")</code> where autostart.el is the file in the same directory as this readme.txt file.
Chez moi le dossier est dans ~/Téléchargements, ce n'est pas un endroit super pour garder ça, donc je mets le dossier dans un dossier ~/.config/emacs. Modifiez ce dossier à votre convenance. Nous pouvons rajouter ce code actualisé dans le fichier .emacs :
<code>(load "/home/$USER/.config/emacs/nxhtml/autostart.el")</code>
===== Complétion et validation de XHTML =====
Le site est sous Copyright © 2008 OurComments.org donc je présume que je n'ai pas le droit de retranscrire tels quels ces tutoriaux. Les tutos sont en Flash. Sous LMDE, ma touche Meta est Alt, alors que sous Ubuntu il me semble que c'était Echap.
Source : Completion and Validation of XHTML
- Supposons que vous voulez créer un nouveau fichier XHTML. Vous commencez par taper C-x C-f (Control-x Control-f) et entrer le nom de fichier.
- Vous obtenez un buffer vide. L'indicateur de mode indique (en bas à droite) nXhtml/nxhtml
qui signifie (paraît que c'est important) :
* nXhtml : "current major mode, nxhtml-noce"
* nxhtml : "multi major mode nxhtml-mumamo"
- Vous pouvez utiliser la complétion ici, dès le départ. La fonction que vous utilisez pour la complétion en nxhtml mode est "nxml complete" disponible normalement sur M-Tab (Si vous utilisez tabkey2 tapez seulement Tab deux fois) (Oui évidemment qu'il l'utilise. Je veux dire tabkey2-mode. M-Tab ne fonctionne pas s'il utilise Alt comme touche Meta. Pfff. Vous ne savez pas vous. Dites-le seulement bien fort ! ).
- En appuyant sur M-Tab dans un fichier vide, on obtient un squelette de fichier XHTML.
- En tapant ensuite des éléments à la main, la barre d'état donne les éventuelles erreurs, et l'élément s'affiche en rouge (testé avec un <p>
après body)
- Il est souvent plus facile d'utiliser la complétion automatique, le code écrit sera ainsi correct. Astuce : d'abord sélectionner la région qui doit être entourée par la balise et ensuite faire la complétion. Un appui sur Tab indente ensuite la ligne. Les tags sont regroupés par catégorie, ce qui les rend faciles à trouver dans la liste. Faut que je fasse la liste des tags quand même après, yen a plein.
- Pour fermer un tag ouvert, il suffit de taper C-c C-f.