Différences
Ci-dessous, les différences entre deux révisions de la page.
Les deux révisions précédentes Révision précédente Prochaine révision | Révision précédente | ||
utilisateurs:kamui57:doc:nxhtml [Le 15/01/2011, 21:29] kamui57 |
— (Version actuelle) | ||
---|---|---|---|
Ligne 1: | Ligne 1: | ||
- | {{tag>Karmic Lucid BROUILLON}} | ||
- | ---- | ||
- | ====== 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 [[:tutoriel:comment_installer_un_paquet|installé le paquet]] **[[apt://emacs|emacs]]** 22 ou plus récent (la version courante au 09/01/2010 est emacs23). | ||
- | |||
- | ===== Installation ===== | ||
- | |||
- | Téléchargez nXhtml sur cette page : [[http://ourcomments.org/cgi-bin/emacsw32-dl-latest.pl|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)// | ||
- | |||
- | [[:archivage#graphiquement|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: <code>(load "YOUR-PATH-TO/nxhtml/autostart.el")</code> 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: <code>(load "VOTRE-CHEMIN-VERS/nxhtml/autostart.el")</code> où autostart.el est le fichier dans le même répertoire que ce fichier readme.txt. | ||
- | |||
- | [[:tutoriel:comment_modifier_un_fichier|Ouvrez le fichier]] ~/.emacs et rajoutez ce code, en remplaçant .config/emacs par le chemin du dossier nxhtml) : | ||
- | |||
- | <code>(load "/home/$USER/.config/emacs/nxhtml/autostart.el")</code> | ||
- | |||
- | ===== Utilisation===== | ||
- | |||
- | Déja, lancez emacs. | ||
- | |||
- | |||
- | <note>Le site [[http://ourcomments.org/Emacs/nXhtml/doc/nxhtml.html|nXhtml - Emacs Utilities for Web Development]] est sous Copyright © 2008 OurComments.org donc je présume que je n'ai pas le droit de retranscrire tels quels ces tutoriaux ?</note> | ||
- | |||
- | Les [[http://ourcomments.org/Emacs/nXhtml/tut/tutorials.html|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 : [[http://ourcomments.org/Emacs/nXhtml/tut/xhtml-completion.swf|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'[[:tutoriel:comment_modifier_un_fichier|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)** [[http://ourcomments.org/Emacs/nXhtml/doc/nxhtml.html|Site officiel]] | ||
- | * [[http://forum.ubuntu-fr.org/viewtopic.php?pid=3940392|Discussion « Problème avec html-helper-mode pour emacs »]] sur le forum Ubuntu-fr | ||
- | |||
- | |||
- | ---- | ||
- | //Contributeurs principaux : [[:utilisateurs:kamui57]].// | ||
- | |||
- | //Basé sur [[http://ourcomments.org/Emacs/nXhtml/doc/nxhtml.html|nXhtml - Emacs Utilities for Web Development]] | ||
- | //Partie "complétion et validation" basée sur [[http://ourcomments.org/Emacs/nXhtml/tut/xhtml-completion.swf|Completion and Validation of XHTML]] par Auteur Original.// |