Lea Linux - Contributions [fr]

Discussion utilisateur:Ralou

2006-11-10T10:28:19Z

Ralou :

== GNUS et courrier :impossibilité de lire les newsgroups ==

=== Commentaires concernant les newsgroups ===

Commentaires retirés, car modifications apportées au tutoriel.

=== Modifications apportées ===

En effet, selon la configuration donnée dans le tutoriel (très bien, ceci dit) il était impossible de lire les newsgroups, ce qui est un comble pour gnus. D'où l'ajout de backend supplménetaire (le backend pour les newsgroup devant intervenir en premier).

Emacs

2006-11-07T07:12:41Z

Ralou : /* Ecouter des mp3 */

[[Catégorie:Éditeurs de texte]]
= Utilisation d'emacs =

<div class="leatitre">Utilisation d'emacs</div><div class="leapar">par [mailto:tux.le.pengouin@free.fr Fred]</div><div class="leadesc">Emacs est un éditeur qui peut tout faire (mettre en couleur vos sources, gérer vos mails, browser internet, lancer des commandes) et même l'édition de fichier texte <tt><nowiki>;)</nowiki></tt>. <br />NDJCC : Où vous comprendrez bientôt pourquoi on surnomme cet éditeur Escape-Meta-Alt-Control-Shift ;)</div>
----

== Introduction ==

L'objectif de ce document n'est pas de faire de vous un pro d'emacs, mais plutôt de vous montrer que le ''monstre'' qu'est emacs n'est finalement pas si complexe que cela d'utilisation pour peu que l'on connaisse quelques fonctions élémentaires. Cette présentation sera donc fort sommaire. Évidement il faut fournir un petit effort de mémorisation. <br />Mais, vous allez me dire : "Pourquoi utilisez emacs, alors que mes autres éditeurs sont plus simples ?" D'abord parce qu'emacs est présent sur presque toutes les plates-formes (MS DOS, Win$$$, Unix, Linux et même d'autres). Ensuite parce qu'il fonctionne aussi bien en mode texte qu'en mode graphique. Enfin parce que vous êtes allergique à la puissance brutale de vi ! (emacs se prononce émax ...)

== L'écran d'emacs ==

L'écran d'emacs (que ce soit un terminal ou une fenêtre) se divise en (au moins) quatre parties :

* la première ligne de l'écran qui constitue un menu. Celui n'est utile que sous X. (vous pouvez quand même l'appeler en mode terminal par F10, mais son fonctionnement est loin d'être intuitif).
* la dernière ligne de l'écran appelée mini-buffer dans laquelle on tape des commandes
* le reste de l'écran qui présente le texte en train d'être édité. Cette zone peut elle-même être divisée en plusieurs zones. Chacune des zones est suivie d'une ligne présentant les caractéristique de ce qui est présent dans cette zone.

== Les commandes ==

Quand vous utiliserez emacs, il vous arrivera de faire des erreurs dans l'entrée d'une commande, pour abandonner celle-ci tapez deux fois la touche <tt><Echap></tt>. <br />Dans presque toutes les combinaisons de touches, vous pouvez remplacer l'appui sur <tt>Alt</tt> par une pression de <tt>Echap.</tt>

Avec emacs, la plupart des commandes sont entrées avec les modificateurs Ctrl ou/et Alt. Le nombre de commandes disponibles dans emacs étant bien plus important que deux fois le nombre de touches du clavier (même s'il n'est heureusement pas nécessaire de les connaître toutes pour utiliser emacs confortablement), il faut utiliser ces modificateurs d'une façon légèrement différente de celle d'autres logiciels.

Pour les commandes simples, c'est « simple » : vous tapez le modificateur avant la touche de « fonction » et en la maintenant appuyée vous appuyez sur la touche de « fonction ».

<blockquote><u>Exemple</u> : pour utiliser la commande d'effacement de ligne (qui est : <tt>Ctrl+k</tt>) vous appuyez sur <tt>Ctrl</tt>, et en maintenant <tt>Ctrl</tt> appuyée vous appuyez sur <tt>k</tt>, puis vous lâchez les deux touches.</blockquote>

Pour les commandes complexes, un exemple vaut mieux qu'un long discours : <br />Pour annuler une série de changements dans une région, la commande est : <tt>Ctrl+u Ctrl+x u</tt>, cela signifie que vous devez taper :

<blockquote><tt>Ctrl+u</tt>, lâchez les touches (au moins le 'u'), puis : <br /><tt>Ctrl+x</tt>, lâchez les touches, puis : <br /><tt>u</tt></blockquote>

== Le curseur ==

Pour déplacer dans emacs, c'est simple : on utilise les touches fléchées (haut pour aller en haut, etc. ;). Les combinaisons de touches peuvent aussi être utilisées. Notez que les combinaisons précédées de Alt ont une portée plus grande (généralement sur des mots) que celles précédées par Ctrl.

Vous disposez également des combinaisons suivantes : <br />

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+a</tt></center>
|
<center>Début de ligne</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+e</tt></center>
|
<center>Fin de ligne</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+f</tt></center>
|
<center>Un caractère à droite (Forward)</center>
|
<center><tt>Alt+f</tt></center>
|
<center>Un mot à droite</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+b</tt></center>
|
<center>Un caractère à gauche (Backward)</center>
|
<center><tt>Alt+b</tt></center>
|
<center>Un mot à gauche</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+n</tt></center>
|
<center>Une ligne en bas (Next)</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+p</tt></center>
|
<center>Une ligne en haut (Previous)</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+<</tt></center>
|
<center>Début de ligne</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+></tt></center>
|
<center>Fin de ligne (nécessite shift)</center>
|
|
|}

== Effacer du texte ==

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
|- valign="MIDDLE"
|
<center><tt><nowiki><DEL></nowiki></tt></center>
|
<center>Efface le caractère avant le curseur</center>
|
<center><tt>Alt+<nowiki><DEL></nowiki></tt></center>
|
<center>Efface jusqu'au début du mot précédant le curseur</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+d</tt></center>
|
<center>Efface le caractère après le curseur</center>
|
<center><tt>Alt+d</tt></center>
|
<center>Efface jusqu'à la fin du mot suivant le curseur</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+k</tt></center>
|
<center>Efface la ligne sous le curseur (Kill)</center>
|
<center><tt>Alt+k</tt></center>
|
<center>Efface jusqu'à la fin du texte</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x u</tt></center>
|
<center>Annule le dernier changement</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+_</tt> (souligné)</center>
|
<center>Annule le dernier changement</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+u Ctrl+x u</tt></center>
|
<center>Annule une série de changement dans cette région</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+o</tt></center>
|
<center>Efface les lignes blanches suivant le curseur</center>
|
<center><tt>Alt+z <CHAR></tt></center>
|
<center>Efface jusqu'à la prochaine occurrence du caractère <tt><CHAR></tt></center>
|}

== Gestion des fichiers ==

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+f <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre (ou crée s'il n'existe pas) le fichier <tt><NOM></tt></center>
|
<center><tt>Ctrl+x Ctrl+r <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre un fichier en interdisant les changements</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 4 f <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre (ou crée s'il n'existe pas) le fichier <tt><nowiki><NOM></nowiki></tt> dans une autre [#fenetres fenêtre] (partage l'écran)</center>
|
<center><tt>Ctrl+x 5 f <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre (ou crée) le fichier <tt><nowiki><NOM></nowiki></tt> dans un autre cadre (ne partage pas l'écran)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+s</tt></center>
|
<center>Sauve le fichier sous son nom (Save)</center>
|
<center><tt>Ctrl+x s</tt></center>
|
<center>Permet de sauvegarder tous les fichiers ouverts (après confirmation de l'utilisateur)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+w</tt></center>
|
<center>Sauve le fichier sous un autre nom (Write)</center>
|
<center><tt>Ctrl+x b</tt></center>
|
<center>Permet d'afficher un autre fichier déjà ouvert</center>
|
|}

'''Attention :'''

Pour créer un nouveau fichier ne lancez pas emacs sans paramètre. Lancez le en précisant un nom de fichier inexistant ; il sera créé par emacs. Ou lancez emacs sans paramètre, puis ouvrez un fichier inexistant.

== Répétition de commande ==

Vous pouvez préciser à emacs de répéter une commande plusieurs fois. Pour cela vous devez la précéder d'un des préfixes suivants : <br />

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+u <nowiki><NOMBRE></nowiki> <COMMANDE></tt></center>
|
<center>Répète <tt><COMMANDE></tt> <tt><nowiki><NOMBRE></nowiki></tt> fois</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+u <COMMANDE></tt></center>
|
<center>Répète <tt><COMMANDE></tt> quatre fois</center>
|}

Vous pouvez également dire à emacs de répéter la dernière commande en tapant :

<blockquote><tt>Ctrl+x z</tt></blockquote>

à la suite de la dite commande. Exemple :

<blockquote><tt>Ctrl+u 20 Ctrl+d</tt> (efface 20 caractères) <tt>Ctrl+x z z</tt> (efface encore 20 (premier z) + 20 (second z) caractères supplémentaires).</blockquote>

== Les régions ==

=== Création des régions ===

Dans d'autres éditeurs, on peut sélectionner du texte avec le curseur (par exemple en maintenant la touche <shift> enfoncée). On peut évidement sélectionner du texte avec emacs, mais il ne fonctionne pas exactement comme peut s'y attendre l'utilisateur d'autres éditeurs. Dans emacs la zone sélectionnée est toujours définie entre une marque déposée par l'utilisateur et la position précédant le curseur (plus précisément entre la position du curseur et la position précédant celle-ci). Ainsi, pour définir une région, vous déposez une marque (voir ci-dessous) à une extrémité de la région, puis vous déplacez le curseur à l'autre extrémité.

Alors comment déposer cette marque ?

<blockquote><tt>Ctrl+<nowiki><espace></nowiki></tt></blockquote>

ou

<blockquote><tt>Ctrl+@</tt></blockquote>

Attention : la marque est invisible ! Pour voir où elle se trouve, utilisez :

<blockquote><tt>Ctrl+x Ctrl+x</tt></blockquote>

qui échange la position du curseur avec la position de la marque. Utilisez-la une seconde fois pour revenir à la position précédente.

Attention : c'est un échange effectif : la marque devient la position du curseur !

Attention : à partir du moment ou vous avez posé la marque, il existe toujours une région !

=== Copier/Couper/Coller ===

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+w</tt></center>
|
<center>Efface la région et la dépose dans le buffer (idem couper)</center>
|
<center><tt>Alt+w</tt></center>
|
<center>Copie la région dans le buffer</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+y</tt></center>
|
<center>Colle (Yank) le texte précédemment coupé</center>
|
<center><tt>Alt+y</tt></center>
|
<center>Colle tous les textes précédemment coupés</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+Alt+w</tt></center>
|
<center>Ajoute la région à la région déjà présente dans le buffer</center>
|
|
|}

=== Modification des régions ===

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+u</tt></center>
|
<center>Met la région en majuscule (Uppercase)</center>
|
<center><tt>Ctrl+x Ctrl+l</tt></center>
|
<center>Met la région en minuscule (Lowercase)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x <TAB></tt></center>
|
<center>Indente la région</center>
|
|
|}

=== Régions rectangulaires ===

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r k</tt></center>
|
<center>Coupe la région rectangulaire</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r d</tt></center>
|
<center>Efface la région rectangulaire (pas dans le buffer)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r y</tt></center>
|
<center>Colle la région rectangulaire précédemment coupée</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r t <RET> chaîne <RET></tt></center>
|
<center>Ajoute « chaîne » au début de toute les ligne de la région rectangulaire</center>
|}

== Les fenêtres d'emacs ==

Les fenêtres au sens d'emacs, ne sont pas celles que l'on a l'habitude de voir : elles ne peuvent pas se recouvrir ! Si vous voulez utilisez emacs avec des fenêtres qui se recouvrent, il faut voir du côté des cadres (frame) que je ne décrirais pas ici. <br />Les fenêtres d'emacs sont des zones rectangulaires qui divise la fenêtre (au sens X Window) d'emacs verticalement ou horizontalement.

Pour diviser l'écran d'emacs en deux fenêtres et les manipuler, il faut utiliser :

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 2</tt></center>
| pour couper horizontalement en 2 la fenêtre où se trouve le curseur
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 3</tt></center>
| pour couper verticalement en 2 la fenêtre où se trouve le curseur
|- valign="MIDDLE"
|
<center><tt>Ctrl+x o </tt>(other)</center>
| pour changer de fenêtre active
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 1</tt></center>
| pour ne garder que la fenêtre du curseur
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 4 Ctrl+f <NOM></tt></center>
| pour ouvrir un fichier dans une autre fenêtre
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 4 d <NOM></tt></center>
| pour afficher le contenu d'un répertoire dans une autre fenêtre
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 5 2</tt></center>
| pour ouvrir une nouvelle fenêtre avec le contenu du buffer courant
|- valign="MIDDLE"
|}

== Quelques modes et fonctions d'Emacs ==

par [mailto:helene POINT dumur CHEZ free POINT fr Hélène]

A l'attention de ceux qui utilisent ce "couteau suisse" et qui ne parlent pas un mot de Lisp !.

=== Généralités ===

Un mode d'Emacs est schématiquement, une fonction, qui serait appelée à chaque chargement d'un fichier donné, ou automatiquement au lancement d'Emacs. Dans ce cas, une ligne sera rajoutée dans le fichier de configuration .emacs.

On pourrait aussi parler de bibliothèque, de librairies, qui sont ajoutées au programme principal pour en augmenter les fonctionnalités.

Cette "fonction" se présente comme un fichier .el écrit en Lisp, (parfois d'une archive de plusieurs fichiers), qui sera copié dans un sous-répertoire donné où Emacs pourra aller le lire et l'utiliser.

Que fait-on avec ce fichier (cette archive) une fois téléchargée ?

# '''S'il s'agit d'un fichier seul (c'est le cas le plus simple)'''
#* copier ce fichier dans le sous-répertoire adéquat <code>/usr/share/emacs/site-lisp/</code> par exemple
#* lire les commentaires au début du fichier, qui vous fourniront pas mal d'indications sur les modalités d'utilisation et d'installation du programme.
On peut aussi, pour des raisons de rapidité et d'efficacité, compiler le programme, avec l'instruction <span class="key">M-x</span> <code>byte-compile-file NOM-DU-FICHIER</code> <span class="key">RET</span>, ou, en mode Dired avec <span class="key">B</span> sur le nom du fichier, mais ce n'est pas du tout obligatoire. <div class="note">N.B. Si vous ne savez pas où mettre le fichier .el, regardez où sont les autres fichiers .el dans votre arborescence... ou, si vous voulez le mettre ailleurs, il ne faudra pas oublier de rajouter dans le .emacs une ligne qui ressemblerait à ça (à adapter à chaque cas personnel) <code>(setq load-path (cons "/home/helen/softs/" load-path))</code></div> Une fois ceci fait, il suffira de rajouter une ligne au .emacs (et de relancer Emacs, bien sûr) pour pouvoir utiliser cette nouvelle fonction.
# '''S'il s'agit d'une archive (.tar.gz)'''
#* Décompresser l'archive selon la méthode habituelle/li>
#* Lire les fichiers README et INSTALL. Dans ce dernier, vous trouverez toutes les indications pour l'installation des différents fichiers requis. La plupart du temps, il suffira d'exécuter les commandes ./configure, make et make install pour que l'installation soit effective.
#* Enfin, bien sûr, on rajoutera les options de configuration dans le .emacs, comme vu ci-dessus.

=== Ecouter des mp3 ===

Emacs est un fantastique éditeur de textes, mais parfois, en travaillant avec lui, on peut avoir envie d'écouter de la musique, et ceci, sans avoir à utiliser un autre programme. La fonction mpg123.el est faite pour ça !

Il faut bien sûr avoir sur son disque dur le programme mpg123, qui est fourni avec la plupart des distributions, ou qui peut être téléchargé et installé sans difficultés (voir la logithèque de Léa), la fonction mpg123.el en sera le front end.

* Une fois récupéré le fichier mpg123.el, le copier dans le sous-répertoire <code>/usr/share/emacs/site-lisp/</code>
* puis, ouvrir son <code>.emacs</code>, et rajouter la ligne : <code>(autoload 'mpg123 "mpg123" "A Front-end to mpg123" t)</code>

La fonction autoload permet de dire à Emacs qu'une fonction existe, et dans quel fichier. Il se chargera ensuite de charger le fichier en question au premier appel de cette fonction.

* Relancer Emacs, pour que le changement de configuration soit pris en compte. (ou simplement taper M-x load-file RET ~/.emacs, ce qui a pour effet d'évaluer le fichier, c'est à dire lire les indications qu'il contient )
* Ensuite, taper <span class="key">M-x</span> <code>mpg123</code> <span class="key">RET</span>. Il vous sera demandé le chemin du fichier (ou du sous-répertoire dans lequel sont les fichiers) à écouter et ''« let's listen the music ! »'' comme il est conseillé dans le minibuffer.

A ce niveau là, on se trouve devant une fenêtre à partir de laquelle on va pouvoir piloter son écoute musicale avec une vingtaine d'options (réglage du son, choix des pistes, pause, retour en arrière, avance, etc...) il suffit de lire et de choisir la touche à taper ! Et bien sûr, personne ne vous empêche de continuer votre travail dans une autre fenêtre !

On peut écouter aussi ses .ogg, puisque le front end fonctionne aussi avec ogg123 (voir la logithèque de Léa).

=== Corriger ses fautes d'orthographe à la volée ===

Ispell est un correcteur orthographique bien connu. Pour l'utiliser en langue française, il est recommandé d'adjoindre à son .emacs la ligne suivante :

<div class="code">(setq ispell-dictionary "francais")</div>

On l'appelera ensuite avec <span class="key">M-x</span> <code>ispell-buffer</code>, ou <code>ispell-region</code> selon ce que l'on souhaite. Mais si on veut qu'au fur et à mesure de la frappe, les fautes soient signalées ? Flyspell est fait pour ça !

Si vous n'avez pas déjà <code>flyspell.el</code> dans votre distribution, vous pouvez le télécharger [http://www-sop.inria.fr/mimosa/Manuel.Serrano/flyspell/flyspell.html à l'INRIA]. Ensuite, vous rajouterez <code>(setq flyspell-default-dictionary "francais")</code> dans votre .emacs, afin de pouvoir l'appeler quand vous en aurez besoin, et avoir un dictionnaire français.

==== Trois façons de l'utiliser ====

On peut simplement taper <span class="key">M-x</span> <code>flyspell-mode</code> <span class="key">RET</span> pour activer le mode de correction à la volée.

Bien entendu, on peut aussi automatiser son chargement en ajoutant

<div class="code">(autoload 'flyspell-mode "flyspell" "On-the-fly spelling checker." t)</div>

au .emacs, ce qui le rendra opérationnel à chaque lancement d'Emacs (mais ce n'est pas forcément souhaitable, à vous de voir..).

Enfin, on peut l'appeler à volonté, en lui affectant une touche : par exemple, après avoir rajouté dans le .emacs

<div class="code"><nowiki>;; Pour que F2 lance flyspell</nowiki><br /> (global-set-key [f2] 'flyspell-mode)</div>

en tapant F2 on lancera le mode de correction automatique.

Flyspell changera la couleur du mot mal orthographié, ou inconnu de son dictionnaire. Un appui sur le bouton du milieu de la souris fera apparaître un menu contextuel qui permet, soit de corriger le mot, en utilisant un de ceux qui sont proposés, soit de l'ajouter au dictionnaire, soit de l'accepter pour cette session ou pour ce buffer uniquement. Les doublons seront marqués d'une autre couleur.

À noter que Flyspell est très pratique en édition LaTeX puisqu'il sait reconnaître les balises TeX et ne pas s'y arrêter. On peut rajouter

<div class="code">(add-hook 'LaTeX-mode-hook 'flyspell-mode)</div>

à cet effet.

=== Editer ses scripts POV confortablement ===

Les scripts POV-ray sont de simples fichiers texte, et bien entendu, un simple éditeur de texte permet de les éditer, donc Emacs le peut ! Mais il peut faire beaucoup plus aussi... On voudrait avoir une coloration syntaxique agréable, bien pratique pour corriger un script et le mettre au point, avoir des indentations automatiques, et aussi lancer le rendu des images sans avoir à ouvrir une seconde fenêtre où on ouvrira un shell ( M-x shell ou eshell selon les habitudes de chacun) pour lancer la commande adéquat. pov-mode.el le fait !

L'installation de ce fichier est identique à ce qui a été vu plus haut, il sera copié à l'endroit où Emacs pourra le retrouver. Ensuite, c'est tout simple, il suffit d'ouvrir un fichier avec l'extension .pov pour bénéficier des avantages de ce mode. Ne pas oublier toutefois d'ajouter ces quelques lignes dans le .emacs :

<div class="code"> (autoload 'pov-mode "pov-mode.el" "PoVray scene file mode" t) (add-hook 'pov-mode-hook 'turn-on-font-lock) pour la coloration syntaxique. </div>

Ensuite, sans quitter le buffer actif, un simple C-c C-c (avec choix possible quant à la qualité, la définition, etc..) lancera le rendu..

Plus de détails sur le site : http://www.acc.umu.se/~woormie/povray/.

=== Avoir des scripts php/html lisibles... ===

Emacs a de nombreux modes pour faire de la programmation en de nombreux langages. Comme pour POV, ils permettent les indentations, la coloration syntaxique, etc... et sont spécifiques au langage choisi (C, lisp, php, html).

Donc, si on édite un fichier .php, il suffit d'avoir <code>php-mode.el</code> et au lancement d'un fichier .php, les fonctionnalités incluses dans ce mode seront immédiatement actives. De même, avec html pour lequel il existe plusieurs modes.

Toutefois, si on édite un fichier html, dans lequel il y a des lignes de php, par exemple, la coloration syntaxique "s'emmêle les pieds", ce que comprend un mode, l'autre l'interprète mal, et le résultat devient bien difficile à lire... C'est là que <code>mmm-mode</code> (ou multi mode, mmm étant l'abréviation de multi major modes) est indispensable.

Ce mode pourra soit être appelé à la demande, soit automatiquement lors du lancement d'Emacs, et dans ce cas, à l'ouverture d'un fichier d'extension .php, il sera opérationnel.

<code>mmm-mode</code> s'installe de façon tout à fait standard : décompresser l'archive, lire le fichier INSTALL, taper successivement :

<div class="code">./configure<br /> make<br /> make install</div>

Normalement, les fichiers doivent être arrivés au bon endroit de l'arborescence pour être trouvés par Emacs.. ensuite, il suffira d'une ligne <code>(require 'mmm-mode)</code> pour que tout soit opérationnel.

À ce niveau, dans votre script html, vous verez vos lignes php surlignées d'une couleur différente, les instructions seront aussi colorisées, etc.. et vous n'aurez plus d'excuse pour générer des erreurs !!!

Plus de renseignements sur le site d'[http://www.xemacs.org/Documentation/packages/html/mmm.html XEmacs].

Bien entendu, si les couleurs ne vous plaisent pas, vous avez tout loisir de les personnaliser, mais là, ça n'a plus rien à voir avec notre sujet, et pourrait faire l'objet d'un autre article.

=== Visualiser des images ===

Le mode <code>thumbs</code> permet d'afficher dans un buffer les vignettes des images contenues dans un sous répertoire<br>
Il utilise les fonctionnalités du programme <code>Convert</code> d'ImageMagick ''(qu'il est donc indispensable d'avoir installé)''<br>
Il fonctionne en mode <code>Dired</code><br>

'''Installation'''

# Télécharger le mode thumbs.el [http://www.emacswiki.org/cgi-bin/emacs-fr/ThumbsModeFrancais ICI]<br>
# Copier ce fichier là où se trouvent les autres .el, par exemple :
#:<code>/usr/share/emacs/site_lisp/thumbs.el</code><br>
# Rajouter dans son .emacs :
#:<code>(autoload 'thumbs-show-all-from-dir "thumbs" "Preview images in a directory." t)</code><br>

'''Fonctionnement'''
;<key>CTRL h m</key> :permet d'afficher l'aide<br>

;<key>CTRL t a</key> :ouvre un buffer contenant toutes les images du sous-répertoire courant<br>

;<key>CTRL t m</key>:ouvre un buffer contenant les seules images marquées auparavant par la commande <code>m</code> (du mode Dired) <br>

;<key>RETURN</key> :sur la vignette active ouvre l'image agrandie dans un buffer<br>

Ensuite, à partir de cette image, quelques raccourcis permettent d'effectuer rapidement et simplement des tâches de base :

{| border='1'
! touche !! action !! remarque
|-
|<key>q</key>
|thumbs-kill-buffer
|
|-
|<key>s</key>
|thumbs-save-current-image
|
|-
|<key>r</key>
|thumbs-resize-interactive
|il est alors demandé la largeur et la hauteur en pixel
|-
|<key>e</key>
|thumbs-emboss-image
|choisir un nombre impair entre 3 et 31
|-
|<key>></key>
|thumbs-rotate-right
|
|-
|<key><</key>
|thumbs-rotate-left
|
|-
|<key>+</key>
|thumbs-resize-image-size-up
|
|-
|<key>-</key>
|thumbs-resize-image-size-down
|
|-
|<key>next</key>
|thumbs-next-image
|
|-
|<key>prior</key>
|thumbs-previous-image
|
|-
|}

D'autres manipulations sont possibles en utilisant les commandes complètes : (utiliser la complétion <code>M-x thumbs... </code>pour le voir toutes et les lancer)

{| border='1'
|thumbs-backward-line
|thumbs-dired
|thumbs-dired-show-all
|-
|thumbs-find-image-at-point-other-window
|thumbs-find-thumb
|thumbs-forward-line
|-
|thumbs-mark
|thumbs-modify-image
|thumbs-negate-image
|-
|thumbs-set-image-at-point-to-root-window
|thumbs-set-root
|thumbs-show-name
|-
|thumbs-delete-images
|thumbs-dired-setroot
|thumbs-dired-show-marked
|-
|thumbs-find-image-at-point
|thumbs-forward-char
|thumbs-monochrome-image
|-
|thumbs-show-all-from-dir
|thumbs-view-image-mode
|
|-
|}

A noter qu'il n'y a pas de raccourci clavier d'origine pour les modes monochrome, et négatif, par exemple, comme <code>e</code> pour emboss.

Pour utiliser l'option modify-image, il est nécessaire de connaître les modifications possibles.. et d'en savoir les paramètres... donc, de connaître les commandes de l'outil Convert d'ImageMagick !

'''Conclusion'''

Un mode d'Emacs rapide, facile à mettre en oeuvre, un outil très utile quand Emacs est votre principal environnement de travail. Voir immédiatement les photos (images) contenues dans un sous-répertoire, les redimensionner, ou les retourner, sans avoir à ouvrir une autre application est bien pratique. Par contre, pour effectuer des manipulations précises et poussées sur des images, il est préférable d'utiliser autre chose, Gimp par exemple.

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa et a été convertie avec HTML::WikiConverter. Elle fut créée par Frédéric Bonnaud le 12/05/2000.</div>

= Copyright =
Copyright © 12/05/2000, Frédéric Bonnaud
{{CC-BY-SA}}

Emacs

2006-11-06T18:27:48Z

Ralou : /* Ecouter des mp3 */

[[Catégorie:Éditeurs de texte]]
= Utilisation d'emacs =

<div class="leatitre">Utilisation d'emacs</div><div class="leapar">par [mailto:tux.le.pengouin@free.fr Fred]</div><div class="leadesc">Emacs est un éditeur qui peut tout faire (mettre en couleur vos sources, gérer vos mails, browser internet, lancer des commandes) et même l'édition de fichier texte <tt><nowiki>;)</nowiki></tt>. <br />NDJCC : Où vous comprendrez bientôt pourquoi on surnomme cet éditeur Escape-Meta-Alt-Control-Shift ;)</div>
----

== Introduction ==

L'objectif de ce document n'est pas de faire de vous un pro d'emacs, mais plutôt de vous montrer que le ''monstre'' qu'est emacs n'est finalement pas si complexe que cela d'utilisation pour peu que l'on connaisse quelques fonctions élémentaires. Cette présentation sera donc fort sommaire. Évidement il faut fournir un petit effort de mémorisation. <br />Mais, vous allez me dire : "Pourquoi utilisez emacs, alors que mes autres éditeurs sont plus simples ?" D'abord parce qu'emacs est présent sur presque toutes les plates-formes (MS DOS, Win$$$, Unix, Linux et même d'autres). Ensuite parce qu'il fonctionne aussi bien en mode texte qu'en mode graphique. Enfin parce que vous êtes allergique à la puissance brutale de vi ! (emacs se prononce émax ...)

== L'écran d'emacs ==

L'écran d'emacs (que ce soit un terminal ou une fenêtre) se divise en (au moins) quatre parties :

* la première ligne de l'écran qui constitue un menu. Celui n'est utile que sous X. (vous pouvez quand même l'appeler en mode terminal par F10, mais son fonctionnement est loin d'être intuitif).
* la dernière ligne de l'écran appelée mini-buffer dans laquelle on tape des commandes
* le reste de l'écran qui présente le texte en train d'être édité. Cette zone peut elle-même être divisée en plusieurs zones. Chacune des zones est suivie d'une ligne présentant les caractéristique de ce qui est présent dans cette zone.

== Les commandes ==

Quand vous utiliserez emacs, il vous arrivera de faire des erreurs dans l'entrée d'une commande, pour abandonner celle-ci tapez deux fois la touche <tt><Echap></tt>. <br />Dans presque toutes les combinaisons de touches, vous pouvez remplacer l'appui sur <tt>Alt</tt> par une pression de <tt>Echap.</tt>

Avec emacs, la plupart des commandes sont entrées avec les modificateurs Ctrl ou/et Alt. Le nombre de commandes disponibles dans emacs étant bien plus important que deux fois le nombre de touches du clavier (même s'il n'est heureusement pas nécessaire de les connaître toutes pour utiliser emacs confortablement), il faut utiliser ces modificateurs d'une façon légèrement différente de celle d'autres logiciels.

Pour les commandes simples, c'est « simple » : vous tapez le modificateur avant la touche de « fonction » et en la maintenant appuyée vous appuyez sur la touche de « fonction ».

<blockquote><u>Exemple</u> : pour utiliser la commande d'effacement de ligne (qui est : <tt>Ctrl+k</tt>) vous appuyez sur <tt>Ctrl</tt>, et en maintenant <tt>Ctrl</tt> appuyée vous appuyez sur <tt>k</tt>, puis vous lâchez les deux touches.</blockquote>

Pour les commandes complexes, un exemple vaut mieux qu'un long discours : <br />Pour annuler une série de changements dans une région, la commande est : <tt>Ctrl+u Ctrl+x u</tt>, cela signifie que vous devez taper :

<blockquote><tt>Ctrl+u</tt>, lâchez les touches (au moins le 'u'), puis : <br /><tt>Ctrl+x</tt>, lâchez les touches, puis : <br /><tt>u</tt></blockquote>

== Le curseur ==

Pour déplacer dans emacs, c'est simple : on utilise les touches fléchées (haut pour aller en haut, etc. ;). Les combinaisons de touches peuvent aussi être utilisées. Notez que les combinaisons précédées de Alt ont une portée plus grande (généralement sur des mots) que celles précédées par Ctrl.

Vous disposez également des combinaisons suivantes : <br />

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+a</tt></center>
|
<center>Début de ligne</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+e</tt></center>
|
<center>Fin de ligne</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+f</tt></center>
|
<center>Un caractère à droite (Forward)</center>
|
<center><tt>Alt+f</tt></center>
|
<center>Un mot à droite</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+b</tt></center>
|
<center>Un caractère à gauche (Backward)</center>
|
<center><tt>Alt+b</tt></center>
|
<center>Un mot à gauche</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+n</tt></center>
|
<center>Une ligne en bas (Next)</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+p</tt></center>
|
<center>Une ligne en haut (Previous)</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+<</tt></center>
|
<center>Début de ligne</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+></tt></center>
|
<center>Fin de ligne (nécessite shift)</center>
|
|
|}

== Effacer du texte ==

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
|- valign="MIDDLE"
|
<center><tt><nowiki><DEL></nowiki></tt></center>
|
<center>Efface le caractère avant le curseur</center>
|
<center><tt>Alt+<nowiki><DEL></nowiki></tt></center>
|
<center>Efface jusqu'au début du mot précédant le curseur</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+d</tt></center>
|
<center>Efface le caractère après le curseur</center>
|
<center><tt>Alt+d</tt></center>
|
<center>Efface jusqu'à la fin du mot suivant le curseur</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+k</tt></center>
|
<center>Efface la ligne sous le curseur (Kill)</center>
|
<center><tt>Alt+k</tt></center>
|
<center>Efface jusqu'à la fin du texte</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x u</tt></center>
|
<center>Annule le dernier changement</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+_</tt> (souligné)</center>
|
<center>Annule le dernier changement</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+u Ctrl+x u</tt></center>
|
<center>Annule une série de changement dans cette région</center>
|
|
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+o</tt></center>
|
<center>Efface les lignes blanches suivant le curseur</center>
|
<center><tt>Alt+z <CHAR></tt></center>
|
<center>Efface jusqu'à la prochaine occurrence du caractère <tt><CHAR></tt></center>
|}

== Gestion des fichiers ==

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
!
<center>Combinaison de touche</center>
!
<center>Effet</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+f <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre (ou crée s'il n'existe pas) le fichier <tt><NOM></tt></center>
|
<center><tt>Ctrl+x Ctrl+r <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre un fichier en interdisant les changements</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 4 f <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre (ou crée s'il n'existe pas) le fichier <tt><nowiki><NOM></nowiki></tt> dans une autre [#fenetres fenêtre] (partage l'écran)</center>
|
<center><tt>Ctrl+x 5 f <nowiki><NOM></nowiki></tt></center>
|
<center>Ouvre (ou crée) le fichier <tt><nowiki><NOM></nowiki></tt> dans un autre cadre (ne partage pas l'écran)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+s</tt></center>
|
<center>Sauve le fichier sous son nom (Save)</center>
|
<center><tt>Ctrl+x s</tt></center>
|
<center>Permet de sauvegarder tous les fichiers ouverts (après confirmation de l'utilisateur)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+w</tt></center>
|
<center>Sauve le fichier sous un autre nom (Write)</center>
|
<center><tt>Ctrl+x b</tt></center>
|
<center>Permet d'afficher un autre fichier déjà ouvert</center>
|
|}

'''Attention :'''

Pour créer un nouveau fichier ne lancez pas emacs sans paramètre. Lancez le en précisant un nom de fichier inexistant ; il sera créé par emacs. Ou lancez emacs sans paramètre, puis ouvrez un fichier inexistant.

== Répétition de commande ==

Vous pouvez préciser à emacs de répéter une commande plusieurs fois. Pour cela vous devez la précéder d'un des préfixes suivants : <br />

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+u <nowiki><NOMBRE></nowiki> <COMMANDE></tt></center>
|
<center>Répète <tt><COMMANDE></tt> <tt><nowiki><NOMBRE></nowiki></tt> fois</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+u <COMMANDE></tt></center>
|
<center>Répète <tt><COMMANDE></tt> quatre fois</center>
|}

Vous pouvez également dire à emacs de répéter la dernière commande en tapant :

<blockquote><tt>Ctrl+x z</tt></blockquote>

à la suite de la dite commande. Exemple :

<blockquote><tt>Ctrl+u 20 Ctrl+d</tt> (efface 20 caractères) <tt>Ctrl+x z z</tt> (efface encore 20 (premier z) + 20 (second z) caractères supplémentaires).</blockquote>

== Les régions ==

=== Création des régions ===

Dans d'autres éditeurs, on peut sélectionner du texte avec le curseur (par exemple en maintenant la touche <shift> enfoncée). On peut évidement sélectionner du texte avec emacs, mais il ne fonctionne pas exactement comme peut s'y attendre l'utilisateur d'autres éditeurs. Dans emacs la zone sélectionnée est toujours définie entre une marque déposée par l'utilisateur et la position précédant le curseur (plus précisément entre la position du curseur et la position précédant celle-ci). Ainsi, pour définir une région, vous déposez une marque (voir ci-dessous) à une extrémité de la région, puis vous déplacez le curseur à l'autre extrémité.

Alors comment déposer cette marque ?

<blockquote><tt>Ctrl+<nowiki><espace></nowiki></tt></blockquote>

ou

<blockquote><tt>Ctrl+@</tt></blockquote>

Attention : la marque est invisible ! Pour voir où elle se trouve, utilisez :

<blockquote><tt>Ctrl+x Ctrl+x</tt></blockquote>

qui échange la position du curseur avec la position de la marque. Utilisez-la une seconde fois pour revenir à la position précédente.

Attention : c'est un échange effectif : la marque devient la position du curseur !

Attention : à partir du moment ou vous avez posé la marque, il existe toujours une région !

=== Copier/Couper/Coller ===

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+w</tt></center>
|
<center>Efface la région et la dépose dans le buffer (idem couper)</center>
|
<center><tt>Alt+w</tt></center>
|
<center>Copie la région dans le buffer</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+y</tt></center>
|
<center>Colle (Yank) le texte précédemment coupé</center>
|
<center><tt>Alt+y</tt></center>
|
<center>Colle tous les textes précédemment coupés</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+Alt+w</tt></center>
|
<center>Ajoute la région à la région déjà présente dans le buffer</center>
|
|
|}

=== Modification des régions ===

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+x Ctrl+u</tt></center>
|
<center>Met la région en majuscule (Uppercase)</center>
|
<center><tt>Ctrl+x Ctrl+l</tt></center>
|
<center>Met la région en minuscule (Lowercase)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x <TAB></tt></center>
|
<center>Indente la région</center>
|
|
|}

=== Régions rectangulaires ===

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r k</tt></center>
|
<center>Coupe la région rectangulaire</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r d</tt></center>
|
<center>Efface la région rectangulaire (pas dans le buffer)</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r y</tt></center>
|
<center>Colle la région rectangulaire précédemment coupée</center>
|- valign="MIDDLE"
|
<center><tt>Ctrl+x r t <RET> chaîne <RET></tt></center>
|
<center>Ajoute « chaîne » au début de toute les ligne de la région rectangulaire</center>
|}

== Les fenêtres d'emacs ==

Les fenêtres au sens d'emacs, ne sont pas celles que l'on a l'habitude de voir : elles ne peuvent pas se recouvrir ! Si vous voulez utilisez emacs avec des fenêtres qui se recouvrent, il faut voir du côté des cadres (frame) que je ne décrirais pas ici. <br />Les fenêtres d'emacs sont des zones rectangulaires qui divise la fenêtre (au sens X Window) d'emacs verticalement ou horizontalement.

Pour diviser l'écran d'emacs en deux fenêtres et les manipuler, il faut utiliser :

{| border="BORDER"
|- valign="MIDDLE"
!
<center>Combinaison de touche</center>
! Effet
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 2</tt></center>
| pour couper horizontalement en 2 la fenêtre où se trouve le curseur
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 3</tt></center>
| pour couper verticalement en 2 la fenêtre où se trouve le curseur
|- valign="MIDDLE"
|
<center><tt>Ctrl+x o </tt>(other)</center>
| pour changer de fenêtre active
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 1</tt></center>
| pour ne garder que la fenêtre du curseur
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 4 Ctrl+f <NOM></tt></center>
| pour ouvrir un fichier dans une autre fenêtre
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 4 d <NOM></tt></center>
| pour afficher le contenu d'un répertoire dans une autre fenêtre
|- valign="MIDDLE"
|
<center><tt>Ctrl+x 5 2</tt></center>
| pour ouvrir une nouvelle fenêtre avec le contenu du buffer courant
|- valign="MIDDLE"
|}

== Quelques modes et fonctions d'Emacs ==

par [mailto:helene POINT dumur CHEZ free POINT fr Hélène]

A l'attention de ceux qui utilisent ce "couteau suisse" et qui ne parlent pas un mot de Lisp !.

=== Généralités ===

Un mode d'Emacs est schématiquement, une fonction, qui serait appelée à chaque chargement d'un fichier donné, ou automatiquement au lancement d'Emacs. Dans ce cas, une ligne sera rajoutée dans le fichier de configuration .emacs.

On pourrait aussi parler de bibliothèque, de librairies, qui sont ajoutées au programme principal pour en augmenter les fonctionnalités.

Cette "fonction" se présente comme un fichier .el écrit en Lisp, (parfois d'une archive de plusieurs fichiers), qui sera copié dans un sous-répertoire donné où Emacs pourra aller le lire et l'utiliser.

Que fait-on avec ce fichier (cette archive) une fois téléchargée ?

# '''S'il s'agit d'un fichier seul (c'est le cas le plus simple)'''
#* copier ce fichier dans le sous-répertoire adéquat <code>/usr/share/emacs/site-lisp/</code> par exemple
#* lire les commentaires au début du fichier, qui vous fourniront pas mal d'indications sur les modalités d'utilisation et d'installation du programme.
On peut aussi, pour des raisons de rapidité et d'efficacité, compiler le programme, avec l'instruction <span class="key">M-x</span> <code>byte-compile-file NOM-DU-FICHIER</code> <span class="key">RET</span>, ou, en mode Dired avec <span class="key">B</span> sur le nom du fichier, mais ce n'est pas du tout obligatoire. <div class="note">N.B. Si vous ne savez pas où mettre le fichier .el, regardez où sont les autres fichiers .el dans votre arborescence... ou, si vous voulez le mettre ailleurs, il ne faudra pas oublier de rajouter dans le .emacs une ligne qui ressemblerait à ça (à adapter à chaque cas personnel) <code>(setq load-path (cons "/home/helen/softs/" load-path))</code></div> Une fois ceci fait, il suffira de rajouter une ligne au .emacs (et de relancer Emacs, bien sûr) pour pouvoir utiliser cette nouvelle fonction.
# '''S'il s'agit d'une archive (.tar.gz)'''
#* Décompresser l'archive selon la méthode habituelle/li>
#* Lire les fichiers README et INSTALL. Dans ce dernier, vous trouverez toutes les indications pour l'installation des différents fichiers requis. La plupart du temps, il suffira d'exécuter les commandes ./configure, make et make install pour que l'installation soit effective.
#* Enfin, bien sûr, on rajoutera les options de configuration dans le .emacs, comme vu ci-dessus.

=== Ecouter des mp3 ===

Emacs est un fantastique éditeur de textes, mais parfois, en travaillant avec lui, on peut avoir envie d'écouter de la musique, et ceci, sans avoir à utiliser un autre programme. La fonction mpg123.el est faite pour ça !

Il faut bien sûr avoir sur son disque dur le programme mpg123, qui est fourni avec la plupart des distributions, ou qui peut être téléchargé et installé sans difficultés (voir la logithèque de Léa), la fonction mpg123.el en sera le front end.

* Une fois récupéré le fichier mpg123.el, le copier dans le sous-répertoire <code>/usr/share/emacs/site-lisp/</code>
* puis, ouvrir son <code>.emacs</code>, et rajouter la ligne : <code>(autoload 'mpg123 "mpg123" "A Front-end to mpg123" t)</code>

La fonction autoload permet de dire à Emacs qu'une fonction existe, et dans quel fichier. Il se chargera ensuite de charger le fichier en question au premier appel de cette fonction.

* Relancer Emacs, pour que le changement de configuration soit pris en compte. (ou simplement taper M-x load-file RET ~/emacs, ce qui a pour effet d'évaluer le fichier, c'est à dire lire les indications qu'il contient )
* Ensuite, taper <span class="key">M-x</span> <code>mpg123</code> <span class="key">RET</span>. Il vous sera demandé le chemin du fichier (ou du sous-répertoire dans lequel sont les fichiers) à écouter et ''« let's listen the music ! »'' comme il est conseillé dans le minibuffer.

A ce niveau là, on se trouve devant une fenêtre à partir de laquelle on va pouvoir piloter son écoute musicale avec une vingtaine d'options (réglage du son, choix des pistes, pause, retour en arrière, avance, etc...) il suffit de lire et de choisir la touche à taper ! Et bien sûr, personne ne vous empêche de continuer votre travail dans une autre fenêtre !

On peut écouter aussi ses .ogg, puisque le front end fonctionne aussi avec ogg123 (voir la logithèque de Léa).

=== Corriger ses fautes d'orthographe à la volée ===

Ispell est un correcteur orthographique bien connu. Pour l'utiliser en langue française, il est recommandé d'adjoindre à son .emacs la ligne suivante :

<div class="code">(setq ispell-dictionary "francais")</div>

On l'appelera ensuite avec <span class="key">M-x</span> <code>ispell-buffer</code>, ou <code>ispell-region</code> selon ce que l'on souhaite. Mais si on veut qu'au fur et à mesure de la frappe, les fautes soient signalées ? Flyspell est fait pour ça !

Si vous n'avez pas déjà <code>flyspell.el</code> dans votre distribution, vous pouvez le télécharger [http://www-sop.inria.fr/mimosa/Manuel.Serrano/flyspell/flyspell.html à l'INRIA]. Ensuite, vous rajouterez <code>(setq flyspell-default-dictionary "francais")</code> dans votre .emacs, afin de pouvoir l'appeler quand vous en aurez besoin, et avoir un dictionnaire français.

==== Trois façons de l'utiliser ====

On peut simplement taper <span class="key">M-x</span> <code>flyspell-mode</code> <span class="key">RET</span> pour activer le mode de correction à la volée.

Bien entendu, on peut aussi automatiser son chargement en ajoutant

<div class="code">(autoload 'flyspell-mode "flyspell" "On-the-fly spelling checker." t)</div>

au .emacs, ce qui le rendra opérationnel à chaque lancement d'Emacs (mais ce n'est pas forcément souhaitable, à vous de voir..).

Enfin, on peut l'appeler à volonté, en lui affectant une touche : par exemple, après avoir rajouté dans le .emacs

<div class="code"><nowiki>;; Pour que F2 lance flyspell</nowiki><br /> (global-set-key [f2] 'flyspell-mode)</div>

en tapant F2 on lancera le mode de correction automatique.

Flyspell changera la couleur du mot mal orthographié, ou inconnu de son dictionnaire. Un appui sur le bouton du milieu de la souris fera apparaître un menu contextuel qui permet, soit de corriger le mot, en utilisant un de ceux qui sont proposés, soit de l'ajouter au dictionnaire, soit de l'accepter pour cette session ou pour ce buffer uniquement. Les doublons seront marqués d'une autre couleur.

À noter que Flyspell est très pratique en édition LaTeX puisqu'il sait reconnaître les balises TeX et ne pas s'y arrêter. On peut rajouter

<div class="code">(add-hook 'LaTeX-mode-hook 'flyspell-mode)</div>

à cet effet.

=== Editer ses scripts POV confortablement ===

Les scripts POV-ray sont de simples fichiers texte, et bien entendu, un simple éditeur de texte permet de les éditer, donc Emacs le peut ! Mais il peut faire beaucoup plus aussi... On voudrait avoir une coloration syntaxique agréable, bien pratique pour corriger un script et le mettre au point, avoir des indentations automatiques, et aussi lancer le rendu des images sans avoir à ouvrir une seconde fenêtre où on ouvrira un shell ( M-x shell ou eshell selon les habitudes de chacun) pour lancer la commande adéquat. pov-mode.el le fait !

L'installation de ce fichier est identique à ce qui a été vu plus haut, il sera copié à l'endroit où Emacs pourra le retrouver. Ensuite, c'est tout simple, il suffit d'ouvrir un fichier avec l'extension .pov pour bénéficier des avantages de ce mode. Ne pas oublier toutefois d'ajouter ces quelques lignes dans le .emacs :

<div class="code"> (autoload 'pov-mode "pov-mode.el" "PoVray scene file mode" t) (add-hook 'pov-mode-hook 'turn-on-font-lock) pour la coloration syntaxique. </div>

Ensuite, sans quitter le buffer actif, un simple C-c C-c (avec choix possible quant à la qualité, la définition, etc..) lancera le rendu..

Plus de détails sur le site : http://www.acc.umu.se/~woormie/povray/.

=== Avoir des scripts php/html lisibles... ===

Emacs a de nombreux modes pour faire de la programmation en de nombreux langages. Comme pour POV, ils permettent les indentations, la coloration syntaxique, etc... et sont spécifiques au langage choisi (C, lisp, php, html).

Donc, si on édite un fichier .php, il suffit d'avoir <code>php-mode.el</code> et au lancement d'un fichier .php, les fonctionnalités incluses dans ce mode seront immédiatement actives. De même, avec html pour lequel il existe plusieurs modes.

Toutefois, si on édite un fichier html, dans lequel il y a des lignes de php, par exemple, la coloration syntaxique "s'emmêle les pieds", ce que comprend un mode, l'autre l'interprète mal, et le résultat devient bien difficile à lire... C'est là que <code>mmm-mode</code> (ou multi mode, mmm étant l'abréviation de multi major modes) est indispensable.

Ce mode pourra soit être appelé à la demande, soit automatiquement lors du lancement d'Emacs, et dans ce cas, à l'ouverture d'un fichier d'extension .php, il sera opérationnel.

<code>mmm-mode</code> s'installe de façon tout à fait standard : décompresser l'archive, lire le fichier INSTALL, taper successivement :

<div class="code">./configure<br /> make<br /> make install</div>

Normalement, les fichiers doivent être arrivés au bon endroit de l'arborescence pour être trouvés par Emacs.. ensuite, il suffira d'une ligne <code>(require 'mmm-mode)</code> pour que tout soit opérationnel.

À ce niveau, dans votre script html, vous verez vos lignes php surlignées d'une couleur différente, les instructions seront aussi colorisées, etc.. et vous n'aurez plus d'excuse pour générer des erreurs !!!

Plus de renseignements sur le site d'[http://www.xemacs.org/Documentation/packages/html/mmm.html XEmacs].

Bien entendu, si les couleurs ne vous plaisent pas, vous avez tout loisir de les personnaliser, mais là, ça n'a plus rien à voir avec notre sujet, et pourrait faire l'objet d'un autre article.

=== Visualiser des images ===

Le mode <code>thumbs</code> permet d'afficher dans un buffer les vignettes des images contenues dans un sous répertoire<br>
Il utilise les fonctionnalités du programme <code>Convert</code> d'ImageMagick ''(qu'il est donc indispensable d'avoir installé)''<br>
Il fonctionne en mode <code>Dired</code><br>

'''Installation'''

# Télécharger le mode thumbs.el [http://www.emacswiki.org/cgi-bin/emacs-fr/ThumbsModeFrancais ICI]<br>
# Copier ce fichier là où se trouvent les autres .el, par exemple :
#:<code>/usr/share/emacs/site_lisp/thumbs.el</code><br>
# Rajouter dans son .emacs :
#:<code>(autoload 'thumbs-show-all-from-dir "thumbs" "Preview images in a directory." t)</code><br>

'''Fonctionnement'''
;<key>CTRL h m</key> :permet d'afficher l'aide<br>

;<key>CTRL t a</key> :ouvre un buffer contenant toutes les images du sous-répertoire courant<br>

;<key>CTRL t m</key>:ouvre un buffer contenant les seules images marquées auparavant par la commande <code>m</code> (du mode Dired) <br>

;<key>RETURN</key> :sur la vignette active ouvre l'image agrandie dans un buffer<br>

Ensuite, à partir de cette image, quelques raccourcis permettent d'effectuer rapidement et simplement des tâches de base :

{| border='1'
! touche !! action !! remarque
|-
|<key>q</key>
|thumbs-kill-buffer
|
|-
|<key>s</key>
|thumbs-save-current-image
|
|-
|<key>r</key>
|thumbs-resize-interactive
|il est alors demandé la largeur et la hauteur en pixel
|-
|<key>e</key>
|thumbs-emboss-image
|choisir un nombre impair entre 3 et 31
|-
|<key>></key>
|thumbs-rotate-right
|
|-
|<key><</key>
|thumbs-rotate-left
|
|-
|<key>+</key>
|thumbs-resize-image-size-up
|
|-
|<key>-</key>
|thumbs-resize-image-size-down
|
|-
|<key>next</key>
|thumbs-next-image
|
|-
|<key>prior</key>
|thumbs-previous-image
|
|-
|}

D'autres manipulations sont possibles en utilisant les commandes complètes : (utiliser la complétion <code>M-x thumbs... </code>pour le voir toutes et les lancer)

{| border='1'
|thumbs-backward-line
|thumbs-dired
|thumbs-dired-show-all
|-
|thumbs-find-image-at-point-other-window
|thumbs-find-thumb
|thumbs-forward-line
|-
|thumbs-mark
|thumbs-modify-image
|thumbs-negate-image
|-
|thumbs-set-image-at-point-to-root-window
|thumbs-set-root
|thumbs-show-name
|-
|thumbs-delete-images
|thumbs-dired-setroot
|thumbs-dired-show-marked
|-
|thumbs-find-image-at-point
|thumbs-forward-char
|thumbs-monochrome-image
|-
|thumbs-show-all-from-dir
|thumbs-view-image-mode
|
|-
|}

A noter qu'il n'y a pas de raccourci clavier d'origine pour les modes monochrome, et négatif, par exemple, comme <code>e</code> pour emboss.

Pour utiliser l'option modify-image, il est nécessaire de connaître les modifications possibles.. et d'en savoir les paramètres... donc, de connaître les commandes de l'outil Convert d'ImageMagick !

'''Conclusion'''

Un mode d'Emacs rapide, facile à mettre en oeuvre, un outil très utile quand Emacs est votre principal environnement de travail. Voir immédiatement les photos (images) contenues dans un sous-répertoire, les redimensionner, ou les retourner, sans avoir à ouvrir une autre application est bien pratique. Par contre, pour effectuer des manipulations précises et poussées sur des images, il est préférable d'utiliser autre chose, Gimp par exemple.

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa et a été convertie avec HTML::WikiConverter. Elle fut créée par Frédéric Bonnaud le 12/05/2000.</div>

= Copyright =
Copyright © 12/05/2000, Frédéric Bonnaud
{{CC-BY-SA}}

Discussion utilisateur:Ralou

2006-11-06T15:12:55Z

Ralou :

== GNUS et courrier :impossibilité de lire les newsgroups ==

=== Commentaires concernant les newsgroups ===

Commentaires retirés, car modifications apportées au tutoriel.

=== Modifications approtées ===

En effet, selon la configuration donnée dans le tutoriel (très bien, ceci dit) il était impossible de lire les newsgroups, ce qui est un comble pour gnus. D'où l'ajout de backend supplménetaire (le backend pour les newsgroup devant intervenir en premier).

Discussion utilisateur:Ralou

2006-11-06T15:10:50Z

Ralou : GNUS et courrier :impossibilité de lire les newsgroups

Commentaire retiré, car modification apportée au tutoriel selon le commentaire.

== GNUS et courrier :impossibilité de lire les newsgroups ==

En effet, selon la configuration donnée dans le tutoriel (très bien, ceci dit) il était impossible de lire les newsgroups, ce qui est un comble pour gnus. D'où l'ajout de backend supplménetaire (le backend pour les newsgroup devant intervenir en premier).

Discussion utilisateur:Ralou

2006-11-06T15:06:43Z

Ralou :

Commentaire retiré, car modification apportée au tutoriel selon le commentaire.

Discussion:Software-soft message-gnus

2006-11-06T14:51:27Z

Ralou : /* Traiter les news */

=Commentaires de : JeanBaptisteNote=
posté le 2004-10-10 16:50:50

Super-page.
Attention cependant, un petit problème, j'ai essayé de l'utiliser avec une configuration déjà existante (fetchmail + procmail + mutt, le tout en maildir) : le backend utilisé va vider vos maildirs et placer tous vos mails dans ses propres containers... C'est récupérable avec cat et procmail, donc relativement sans danger, mais ça fait peur...

J'utilise donc plutôt le backend nnmaildir, qui n'est peut-etre pas le "fastest on earth", mais qui va préserver votre configuration existante :) Le changement est donc le suivant :
<code multi>
(setq gnus-select-method '(nnnil ""))
(setq gnus-secondary-select-methods '((nnmaildir "principal"
(directory "~/Maildir")
(get-new-mail nil)
(expire-age never)
))
)
</code>

= Commentaire d'Alex =

Juste pour info, c'est totalement illisible comme documentation...

Les retours à la ligne dans les fichiers de conf et parametres ne seraient pas superflu... Je n'ai pas le temps de les rajouter la, mais bon... ca fait crade :)

Enfin, merci quand meme :)

A+

Alex

[[Utilisateur:Fred (phorum)|Fred (phorum)]]> pour info ça m'a pris 1 min, ça aurait été plus efficace de le faire toi même plutot que de poster ce commentaire. Pour info la raison de la mauvaise mise en page est : le traducteur html->wiki qui a mis des <nowiki><nowiki></nowiki> à la place de tag <nowiki><code></nowiki>
<cadre type=aparte>PS: la documentation du wiki de Léa est pour une bonne part issue de l'ancienne version html de Léa et contient de gros défaut de mise en page.</cadre>

Software-soft message-gnus

2006-11-06T14:39:41Z

Ralou : /* Arrivée du courrier */

[[Category:Messagerie]]
= Lire ses courrier avec Gnus =

<div class="leatitre">Lire ses courrier avec Gnus</div>
<div class="leapar">par [mailto:yeupou at gnu.org Mathieu Roy]</div>
<cadre type=aparte>Emacs is not built by hate of vi. vi is irrelevant. It is no more then a strange punishment that the unbelievers submit themselves to</cadre>
<div class="leadesc">Accessoirement, on ne peut lire ses courriels avec un gnus sous vi. </div>
----

== Pourquoi gnus ? ==

Gnus est un lecteur de ''newsgroups'' (quel anglicisme horrible !) qui est fournit avec GNU Emacs. Il peut aussi servir de lecteur de courriel. Les avantages que j'y trouve sont les suivants :

* même comportement du lecteur de courriel en mode graphique et mode texte
* extensible...

== Prérequis ==

Evidemment, il est de ''bon goût'' d'avoir Emacs installé sur son ordinateur. Il est aussi préférable d'être un peu familier avec Emacs. Nous allons aussi faire usage de procmail et fetchmail, matériel qui devrait être présent sur tout GNU/Linux décent.

L'épreuve demande un peu de tenacité. Mais ça doit être jouable.

Restez loggué et faites toutes les manips avec votre utilisateur normal (sauf précision contraire).

== Télécharger les courriers ==

Vous êtes en train de le comprendre : Emacs ne va pas télécharger vos courriers, nous allons faire appel à fetchmail (télécharge) et procmail (distribue). Autant laisser faire chaque outil ce qu'il fait parfaitement. Cela vous permettra d'utiliser votre conf fetchmail et procmail avec d'autres lecteurs de courriel, si une folle envie vous en prennait.

=== Le .forward ===

Ce fichier définit qui doit gérer la redistribution de courrier arrivé en local pour l'utilisateur. Tapez ce qui suit, cela suffira :

<code>echo "|/usr/bin/procmail" > ~/.forward</code>

=== Le .procmailrc ===

Premièrement, il faut créer un dossier où procmail stockera les courriers arrivés, dans différents fichiers selon la configuration. Ici, il s'agit de ~/.mail-gnus

<code>mkdir ~/.mail-gnus</code>

Ensuite, il faut créer un fichier ~/.procmailrc de configuration comme celui-ci :

<code> PATH=/usr/bin:/bin:/usr/local/bin:.
MAILDIR=$HOME/.mail-gnus # You'd better make sure it exists
DEFAULT=$MAILDIR/inbox
LOGFILE=$HOME/.from_procmail
LOCKFILE=$HOME/.lockmail

# Tout les courriers venant ou allant vers une adresse chez gnu.org
# sont posés dans une boîte appellée gnu-devel.
:0
* ^[From|To|Cc].*@gnu.org
gnu-devel

# Tout les autres courriers iront dans $DEFAULT,
# c'est-à-dire inbox.
</code>

=== Le .fetchmailrc ===

Après avoir configuré la redistribution de courrier en local, nous allons maintenant configurer le téléchargement de courrier.

Voici un exemple pour un compte pop3. Il faut bien entendu substituer ''moa'' par l'utilisateur local destinataire, ''yeupou'' par le login free.fr et ''nibelungen'' par le nom de la machine hôte (''hostname'' quoi).

<code> # Général
set syslog
set bouncemail
set no spambounce
set properties ""

# Chaque compte sur chaque serveur
poll pop.free.fr with proto POP3
user 'yeupou' there with password 'xxx' is 'moa@nibelungen' here
</code>

Ensuite, il faudrait que fetchmail tourne en démon. La commande suivante devrait faire l'affaire :

<code>fetchmail -d60 --fetchmailrc /home/moa/.fetchmailrc --norewrite</code>

L'idéal est d'avoir ce démon au démarrage de la machine (ajoutez cette ligne dans <code>/etc/rc.local</code>) ou lors de votre login (ajoutez cette ligne dans le fichier qui gère votre session - par exemple <code>~/.Xclients</code> ou <code>~/.xinitrc</code>).

Si fetchmail tourne et que vous avez reçu du courrier, alors il devrait se trouver dans un (ou des) fichier(s) dans le dossier ~/.mails-gnus

== Adapter son .emacs ==

Nous allons maintenant signaler à Emacs l'existence de gnus. Il suffit de copier-coller ce qui suit dans votre ~/.emacs.

<code> ;; Definit Gnus comme lecteur courriel
(custom-set-variables
'(read-mail-command (quote gnus))
'(message-directory "~/.Mail/"))

;; Definit Galeon comme brouteur web, pour suivre les liens
(setq browse-url-browser-function 'browse-url-generic
browse-url-generic-program "galeon")
</code>

== Créer son .gnus ==

Et nous sommes maintenant dans le vif du sujet, la configuration de gnus. Tout ce qui suit doit être ajouté dans le fichier ~/.gnus

=== Identité ===

Corrigez nom et adresse courriel.

<code> ;;**** BASIC IDENTITY
(setq user-full-name "Votre Nom"
user-mail-address "votre@courriel.org"
mail-user-agent (quote message-user-agent))

;; Def charset
(setq gnus-default-charset (quote iso-8859-15)
gnus-default-posting-charset (quote iso-8859-15))

(message "gnus.el: BASIC IDENTITY initialized")
</code>

=== Arrivée du courrier ===

Rien à changer si vous avez suivi ce qui précède.

<code> ;;*******************
;;***** GETTING MAILS

;; In mail-source, procmail store files that
;; We store mails here - this is also defined in my .emacs,
;; it's the only way I found to avoid apparition of ~/Mail/.
(setq gnus-directory "~/.News/")
(setq message-directory "~/.Mail/")

;; fetchmail previously downloaded.
(setq mail-sources
(list '(directory
:path "~/.mail-gnus/"
:suffix ""
))
)

;; We choose nnml: everybody says it's the fastest backend on earth.
;; GNUS est avant tout un lecteur de news, autant ne pas s'en priver
(setq gnus-select-method '(nntp "news.free.fr"))
;;veillez à changer le nom du serveur de news de votre FAI
;; et pour les mails
(add-to-list 'gnus-secondary-select-methods '(nnml ""))

;; We trash duplicates mails.
(setq nnmail-treat-duplicates 'delete)

;; We just read mail, no newsgroups.
(setq gnus-check-new-newsgroups t)

(message "gnus.el: GETTING MAILS initialized")
</code>

=== Mime Types ===

Rien à changer si vous avez suivi ce qui précède. Je ne pourrais pas vous donner de détails à ce propos, que je n'ai fait que copier-coller à partir d'un autre .emacs (mais ça marche bien).

<code> ;;************************
;; MIME Settings for PGnus
(require 'mm-util)
(defun mm-read-charset (prompt)
"Return a charset."
'iso-8859-15)
(setq gnus-default-posting-charset (quote iso-8859-15))
(setq gnus-article-decode-mime-words t)
(setq gnus-article-decode-charset 1)
(setq gnus-mime-view-all-parts t) ; View all the MIME parts in current article
(setq gnus-ignored-mime-types
'("text/x-vcard"))
(setq gnus-unbuttonized-mime-types nil) ; MIME type -> no buttons when rendered
(setq
;; Add buttons
gnus-treat-buttonize t
;; Add buttons to the head
gnus-treat-buttonize-head 'head
;; Emphasize text
gnus-treat-emphasize t
;; Fill the article
gnus-treat-fill-article nil
;; Remove carriage returns
gnus-treat-strip-cr 'last
;; Hide headers
gnus-treat-hide-headers 'head
;; Hide boring headers
gnus-treat-hide-boring-headers 'head
;; Hide the signature
gnus-treat-hide-signature nil
;; Hide cited text
gnus-treat-hide-citation nil
;; Strip PGP signatures
gnus-treat-strip-pgp 'last
;; Strip PEM signatures
gnus-treat-strip-pem 'last
;; Highlight the headers
gnus-treat-highlight-headers 'head
;; Highlight cited text
gnus-treat-highlight-citation 'last
;; Highlight the signature
gnus-treat-highlight-signature 'last
;; Display the Date in UT (GMT)
gnus-treat-date-ut nil
;; Display the Date in the local timezone
gnus-treat-date-local nil
;; Display the date in the original timezone
gnus-treat-date-original nil
;; Strip trailing blank lines
gnus-treat-strip-trailing-blank-lines 'last
;; Strip leading blank lines
gnus-treat-strip-leading-blank-lines 'last
;; Strip multiple blank lines
gnus-treat-strip-multiple-blank-lines 'last
;; Strip all blank lines
;; gnus-treat-strip-blank-lines nil
;; Treat overstrike highlighting
gnus-treat-overstrike 'last
)
;;* show the text/plain part before the text/html part in multpart/alternative
(require 'mm-decode)
;;;-- no way do compile with this
;;;--(push "text/plain" mm-alternative-precedence)
;;;--(setq mm-alternative-precedence "text/plain")

(message "gnus.el: MIME initialized")
</code>

=== Archives ===

Rien à changer si vous avez suivi ce qui précède. Je ne pourrais pas vous donner de détails à ce propos, que je n'ai fait que copier-coller à partir d'un autre .emacs (mais ça marche bien).

<code> ;;***********************
;; ARCHIVES: one file per month
(setq gnus-message-archive-group
'((if (message-news-p)
"misc-news"
(concat "mail." (format-time-string
"%Y-%m" (current-time)))))
)

(message "gnus.el: ARCHIVES initialized")
</code>

=== Interface ===

Rien à changer si vous avez suivi ce qui précède. Logiquement ça marche, lisez les commentaires pour personnaliser.

<code> ;;***********************
;;************* INTERFACE

;; Here I define how to display subject lines etc...
;; I wanna see thoses groups everytime
(setq gnus-permanently-visible-groups
"^nnml\\|^nnfolder\\|^inbox\\|^gnu-devel\\|^savannah-hackers\\|^trash")

;; I like it verbose
(setq gnus-verbose 2000)

;; I wanna be able to access my previous post
(setq gnus-fetch-old-headers t)

;; I wanna keep track of the last time I rode a group
(add-hook 'gnus-select-group-hook 'gnus-group-set-timestamp)

;; *Group* buffer: how to format each group entry.
(setq gnus-group-line-format
"%M%m %4N/%4t non-lus: %(%-20,20g%) depuis le %2,2~(cut 6)\
d/%2,2~(cut 4)d à %2,2~(cut 9)dh%2,2~(cut 11)d\n"
;;
;; %var details C-h i
;;`M' An asterisk if the group only has marked articles.
;;'N' Number of unread articles.
;;`t' Estimated total number of articles.
;;`G' Group name.
;;`D' Newsgroup description.
;;`m' `%' (`gnus-new-mail-mark') if there has arrived new mail to the
;; group lately.
;;`D' Last time the group as been accessed.
;;
;; For the record, a default group line format
;;(setq gnus-group-line-format "%M\%S\%p\%P\%5y: %(%-40,40g%) %6,6~(cut 2)d\n")
)

;; *Summary*: how to format each mail entry.
(setq gnus-summary-line-format
"%-1R %-1U %-15,15n | %2,2~(cut 6)o/%2,2~(cut 4)o %2,2~(cut 9)oh%2,2~(cut 11)\
o | %I%(%0,40s%)\n"
gnus-summary-same-subject ">>>"
gnus-summary-mode-line-format "%V: %%b"
;; %var details C-h i
;; `s' Subject if the article is the root of the thread or the previous
;; article had a different subject, `gnus-summary-same-subject'
;; otherwise. (`gnus-summary-same-subject' defaults to `""'.)
;; `n' The name (from the `From' header).
;; `L' Number of lines in the article.
;; `I' Indentation based on thread level (*note Customizing Threading::).
;; `>' One space for each thread level.
;; `<' Twenty minus thread level spaces.
;; `U' Unread.
;; `R' This misleadingly named specifier is the "secondary mark". This
;; mark will say whether the article has been replied to, has been
;; cached, or has been saved.
;; `D' `Date'.
;; `d' The `Date' in `DD-MMM' format.
;;`o' The `Date' in YYYYMMDD`T'HHMMSS format.
;;
;; For the record the default string is
;; `%U%R%z%I%(%[%4L: %-20,20n%]%) %s\n'.
)

;; I remove mailing list identifiers for mail from list I read often, that
;; are already stored in a particular directory
(setq gnus-list-identifiers
'( "\\[savannah-hackers\\]"
"\\[savannah-dev\\]"
))

;; I do not like graphics smileys.
(setq gnus-treat-display-smileys nil)

;; I wanna particular dimensions while reading mails
(setq
gnus-build-sparse-threads 'some
gnus-use-trees t
gnus-generate-tree-function 'gnus-generate-horizontal-tree
gnus-tree-minimize-window nil)

(if (or (not (getenv "DISPLAY"))
(string-match ":0" (getenv "DISPLAY")))
(progn
(gnus-add-configuration
'(article
(vertical 1.0
(summary 0.40 point)
(article 1.0)
)
)))
(progn
(gnus-add-configuration
'(article
(vertical 1.0
(summary 0.40 point)
(article 1.0)
)
)))
)

(setq font-lock-maximum-decoration t
font-lock-maximum-size nil)
(require 'font-lock)
(set-face-foreground 'gnus-summary-normal-ticked-face "pale violet red")
(set-face-foreground 'gnus-summary-high-ticked-face "pale violet red")

(message "gnus.el: INTERFACE initialized")
</code>

=== Réponses ===

Corrigez nom et adresse courriel.

<code> ; Hey, please remove my address from To: and Ccc: while I do a
;; wide reply.
;; seen at http://www.gnusfr.org/gen.php3/2002/04/02/36,0,1,0.html
(setq message-dont-reply-to-names
"utilisateur@\$gnu\\|free\$.\$org\\|fr\$")

;; I want my replies to begin with something like "<user> writes:"
(defun message-insert-citation-line ()
"La fonction qui insere une ligne aux reponses"
(when message-reply-headers
;; In savannah-hackers group, we talk english
(if (string-equal gnus-newsgroup-name "savannah-hackers")
(insert (mail-header-from message-reply-headers) " said:\n\n")
(insert (mail-header-from message-reply-headers) " a tapoté :\n\n")
)))

(message "gnus.el: REPLY initialized")
</code>

=== Plusieurs Identités ===

Pour utiliser ceci, vous devez mettre la main sur gnus-pers.el dispo http://www.comsecmilnavpac.net/elisp/ en théorie. Vous devez modifier ce contenu en lien avec votre utilisation. Dans la première partie, on associe des identités à des groupes.

<code> (custom-set-variables
;; This is the hash "group name => identity"
'(gnus-personality-electric-headers (quote
(
(any ".*u-strasbg.*" "formel")
(any ".*gnu.*" "gnu")
)))
;; There are my identities
'(gnus-personalities (quote
(
; usual
("default"
"mathieu <yeupou@coleumes.org>"
""
"~/.signature"
)
; GNU voluteering
("gnu"
"Mathieu Roy <yeupou@gnu.org>"
""
"~/.signature_gnu"
)
; Formal, neutral
("formel"
"Mathieu Roy <mathieu.roy@coleumes.org>"
""
"~/.signature_formel"
)
)))
'(gnus-pers-cc-fix nil)
)
(require 'gnus-pers)
(gnus-personality-init)

(message "gnus.el: IDENTITIES initialized")
</code>

== Utiliser gnus ==

Et voilà, le stade de la configuration est passé. Il suffit de lancer emacs, et d'y lancer gnus, en tapant M-x gnus (M = Meta, donc alt).

=== Envoyer un courriel ===

Une fois gnus lancé, tapez <code>m</code>. Remplissez les champs qui vont bien. Par exemple, envoyez vous un courrier, pour tester le tout. Vous pouvez changer votre identité en tapant <code>C-cC-l</code>. Pour finir, tapez <code>C-c C-c</code> pour envoyer le courrier.

=== Consulter les courriels reçus ===

Il faut maintenant dire quels groupes (en fait, fichiers crées par procmail, selon le .procmailrc) vous desirez lire. Vous regardez dans le menu "Groups" -> "Subscribe" -> "Subscribe to a group". Il vous est demandé de taper le nom du groupe. Tapez tabulation. Si un courriel à bien été reçu, au moins un groupe doit être disponible. Sélectionnez le... Rentrez dans le groupe en tapant entrée... Utilisez les menus et apprennez les raccourcis claviers :)

== FDL ==

Ce document est libre, selon les termes de la licence GNU FDL

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par Mathieu Roy le 04/10/2002.</div>

= Copyright =
Copyright © 04/10/2002, Mathieu Roy
{{FDL}}

Software-soft message-gnus

2006-11-06T14:38:24Z

Ralou : /* Arrivée du courrier */

[[Category:Messagerie]]
= Lire ses courrier avec Gnus =

<div class="leatitre">Lire ses courrier avec Gnus</div>
<div class="leapar">par [mailto:yeupou at gnu.org Mathieu Roy]</div>
<cadre type=aparte>Emacs is not built by hate of vi. vi is irrelevant. It is no more then a strange punishment that the unbelievers submit themselves to</cadre>
<div class="leadesc">Accessoirement, on ne peut lire ses courriels avec un gnus sous vi. </div>
----

== Pourquoi gnus ? ==

Gnus est un lecteur de ''newsgroups'' (quel anglicisme horrible !) qui est fournit avec GNU Emacs. Il peut aussi servir de lecteur de courriel. Les avantages que j'y trouve sont les suivants :

* même comportement du lecteur de courriel en mode graphique et mode texte
* extensible...

== Prérequis ==

Evidemment, il est de ''bon goût'' d'avoir Emacs installé sur son ordinateur. Il est aussi préférable d'être un peu familier avec Emacs. Nous allons aussi faire usage de procmail et fetchmail, matériel qui devrait être présent sur tout GNU/Linux décent.

L'épreuve demande un peu de tenacité. Mais ça doit être jouable.

Restez loggué et faites toutes les manips avec votre utilisateur normal (sauf précision contraire).

== Télécharger les courriers ==

Vous êtes en train de le comprendre : Emacs ne va pas télécharger vos courriers, nous allons faire appel à fetchmail (télécharge) et procmail (distribue). Autant laisser faire chaque outil ce qu'il fait parfaitement. Cela vous permettra d'utiliser votre conf fetchmail et procmail avec d'autres lecteurs de courriel, si une folle envie vous en prennait.

=== Le .forward ===

Ce fichier définit qui doit gérer la redistribution de courrier arrivé en local pour l'utilisateur. Tapez ce qui suit, cela suffira :

<code>echo "|/usr/bin/procmail" > ~/.forward</code>

=== Le .procmailrc ===

Premièrement, il faut créer un dossier où procmail stockera les courriers arrivés, dans différents fichiers selon la configuration. Ici, il s'agit de ~/.mail-gnus

<code>mkdir ~/.mail-gnus</code>

Ensuite, il faut créer un fichier ~/.procmailrc de configuration comme celui-ci :

<code> PATH=/usr/bin:/bin:/usr/local/bin:.
MAILDIR=$HOME/.mail-gnus # You'd better make sure it exists
DEFAULT=$MAILDIR/inbox
LOGFILE=$HOME/.from_procmail
LOCKFILE=$HOME/.lockmail

# Tout les courriers venant ou allant vers une adresse chez gnu.org
# sont posés dans une boîte appellée gnu-devel.
:0
* ^[From|To|Cc].*@gnu.org
gnu-devel

# Tout les autres courriers iront dans $DEFAULT,
# c'est-à-dire inbox.
</code>

=== Le .fetchmailrc ===

Après avoir configuré la redistribution de courrier en local, nous allons maintenant configurer le téléchargement de courrier.

Voici un exemple pour un compte pop3. Il faut bien entendu substituer ''moa'' par l'utilisateur local destinataire, ''yeupou'' par le login free.fr et ''nibelungen'' par le nom de la machine hôte (''hostname'' quoi).

<code> # Général
set syslog
set bouncemail
set no spambounce
set properties ""

# Chaque compte sur chaque serveur
poll pop.free.fr with proto POP3
user 'yeupou' there with password 'xxx' is 'moa@nibelungen' here
</code>

Ensuite, il faudrait que fetchmail tourne en démon. La commande suivante devrait faire l'affaire :

<code>fetchmail -d60 --fetchmailrc /home/moa/.fetchmailrc --norewrite</code>

L'idéal est d'avoir ce démon au démarrage de la machine (ajoutez cette ligne dans <code>/etc/rc.local</code>) ou lors de votre login (ajoutez cette ligne dans le fichier qui gère votre session - par exemple <code>~/.Xclients</code> ou <code>~/.xinitrc</code>).

Si fetchmail tourne et que vous avez reçu du courrier, alors il devrait se trouver dans un (ou des) fichier(s) dans le dossier ~/.mails-gnus

== Adapter son .emacs ==

Nous allons maintenant signaler à Emacs l'existence de gnus. Il suffit de copier-coller ce qui suit dans votre ~/.emacs.

<code> ;; Definit Gnus comme lecteur courriel
(custom-set-variables
'(read-mail-command (quote gnus))
'(message-directory "~/.Mail/"))

;; Definit Galeon comme brouteur web, pour suivre les liens
(setq browse-url-browser-function 'browse-url-generic
browse-url-generic-program "galeon")
</code>

== Créer son .gnus ==

Et nous sommes maintenant dans le vif du sujet, la configuration de gnus. Tout ce qui suit doit être ajouté dans le fichier ~/.gnus

=== Identité ===

Corrigez nom et adresse courriel.

<code> ;;**** BASIC IDENTITY
(setq user-full-name "Votre Nom"
user-mail-address "votre@courriel.org"
mail-user-agent (quote message-user-agent))

;; Def charset
(setq gnus-default-charset (quote iso-8859-15)
gnus-default-posting-charset (quote iso-8859-15))

(message "gnus.el: BASIC IDENTITY initialized")
</code>

=== Arrivée du courrier ===

Rien à changer si vous avez suivi ce qui précède.

<code> ;;*******************
;;***** GETTING MAILS

;; In mail-source, procmail store files that
;; We store mails here - this is also defined in my .emacs,
;; it's the only way I found to avoid apparition of ~/Mail/.
(setq gnus-directory "~/.News/")
(setq message-directory "~/.Mail/")

;; fetchmail previously downloaded.
(setq mail-sources
(list '(directory
:path "~/.mail-gnus/"
:suffix ""
))
)

;; We choose nnml: everybody says it's the fastest backend on earth.
;; GNUS est avant tout un lecteur de news, autant ne pas s'en priver
(setq gnus-select-method '(nntp "news.free.fr"))
;;veillez à changer le nom du serveur de news de votre FAI
;; et pour les mails
(add-to-list 'gnus-secondary-select-methods '(nnml ""))

;; We trash duplicates mails.
(setq nnmail-treat-duplicates 'delete)

;; We just read mail, no newsgroups.
;;(setq gnus-check-new-newsgroups nil)

(message "gnus.el: GETTING MAILS initialized")
</code>

=== Mime Types ===

Rien à changer si vous avez suivi ce qui précède. Je ne pourrais pas vous donner de détails à ce propos, que je n'ai fait que copier-coller à partir d'un autre .emacs (mais ça marche bien).

<code> ;;************************
;; MIME Settings for PGnus
(require 'mm-util)
(defun mm-read-charset (prompt)
"Return a charset."
'iso-8859-15)
(setq gnus-default-posting-charset (quote iso-8859-15))
(setq gnus-article-decode-mime-words t)
(setq gnus-article-decode-charset 1)
(setq gnus-mime-view-all-parts t) ; View all the MIME parts in current article
(setq gnus-ignored-mime-types
'("text/x-vcard"))
(setq gnus-unbuttonized-mime-types nil) ; MIME type -> no buttons when rendered
(setq
;; Add buttons
gnus-treat-buttonize t
;; Add buttons to the head
gnus-treat-buttonize-head 'head
;; Emphasize text
gnus-treat-emphasize t
;; Fill the article
gnus-treat-fill-article nil
;; Remove carriage returns
gnus-treat-strip-cr 'last
;; Hide headers
gnus-treat-hide-headers 'head
;; Hide boring headers
gnus-treat-hide-boring-headers 'head
;; Hide the signature
gnus-treat-hide-signature nil
;; Hide cited text
gnus-treat-hide-citation nil
;; Strip PGP signatures
gnus-treat-strip-pgp 'last
;; Strip PEM signatures
gnus-treat-strip-pem 'last
;; Highlight the headers
gnus-treat-highlight-headers 'head
;; Highlight cited text
gnus-treat-highlight-citation 'last
;; Highlight the signature
gnus-treat-highlight-signature 'last
;; Display the Date in UT (GMT)
gnus-treat-date-ut nil
;; Display the Date in the local timezone
gnus-treat-date-local nil
;; Display the date in the original timezone
gnus-treat-date-original nil
;; Strip trailing blank lines
gnus-treat-strip-trailing-blank-lines 'last
;; Strip leading blank lines
gnus-treat-strip-leading-blank-lines 'last
;; Strip multiple blank lines
gnus-treat-strip-multiple-blank-lines 'last
;; Strip all blank lines
;; gnus-treat-strip-blank-lines nil
;; Treat overstrike highlighting
gnus-treat-overstrike 'last
)
;;* show the text/plain part before the text/html part in multpart/alternative
(require 'mm-decode)
;;;-- no way do compile with this
;;;--(push "text/plain" mm-alternative-precedence)
;;;--(setq mm-alternative-precedence "text/plain")

(message "gnus.el: MIME initialized")
</code>

=== Archives ===

Rien à changer si vous avez suivi ce qui précède. Je ne pourrais pas vous donner de détails à ce propos, que je n'ai fait que copier-coller à partir d'un autre .emacs (mais ça marche bien).

<code> ;;***********************
;; ARCHIVES: one file per month
(setq gnus-message-archive-group
'((if (message-news-p)
"misc-news"
(concat "mail." (format-time-string
"%Y-%m" (current-time)))))
)

(message "gnus.el: ARCHIVES initialized")
</code>

=== Interface ===

Rien à changer si vous avez suivi ce qui précède. Logiquement ça marche, lisez les commentaires pour personnaliser.

<code> ;;***********************
;;************* INTERFACE

;; Here I define how to display subject lines etc...
;; I wanna see thoses groups everytime
(setq gnus-permanently-visible-groups
"^nnml\\|^nnfolder\\|^inbox\\|^gnu-devel\\|^savannah-hackers\\|^trash")

;; I like it verbose
(setq gnus-verbose 2000)

;; I wanna be able to access my previous post
(setq gnus-fetch-old-headers t)

;; I wanna keep track of the last time I rode a group
(add-hook 'gnus-select-group-hook 'gnus-group-set-timestamp)

;; *Group* buffer: how to format each group entry.
(setq gnus-group-line-format
"%M%m %4N/%4t non-lus: %(%-20,20g%) depuis le %2,2~(cut 6)\
d/%2,2~(cut 4)d à %2,2~(cut 9)dh%2,2~(cut 11)d\n"
;;
;; %var details C-h i
;;`M' An asterisk if the group only has marked articles.
;;'N' Number of unread articles.
;;`t' Estimated total number of articles.
;;`G' Group name.
;;`D' Newsgroup description.
;;`m' `%' (`gnus-new-mail-mark') if there has arrived new mail to the
;; group lately.
;;`D' Last time the group as been accessed.
;;
;; For the record, a default group line format
;;(setq gnus-group-line-format "%M\%S\%p\%P\%5y: %(%-40,40g%) %6,6~(cut 2)d\n")
)

;; *Summary*: how to format each mail entry.
(setq gnus-summary-line-format
"%-1R %-1U %-15,15n | %2,2~(cut 6)o/%2,2~(cut 4)o %2,2~(cut 9)oh%2,2~(cut 11)\
o | %I%(%0,40s%)\n"
gnus-summary-same-subject ">>>"
gnus-summary-mode-line-format "%V: %%b"
;; %var details C-h i
;; `s' Subject if the article is the root of the thread or the previous
;; article had a different subject, `gnus-summary-same-subject'
;; otherwise. (`gnus-summary-same-subject' defaults to `""'.)
;; `n' The name (from the `From' header).
;; `L' Number of lines in the article.
;; `I' Indentation based on thread level (*note Customizing Threading::).
;; `>' One space for each thread level.
;; `<' Twenty minus thread level spaces.
;; `U' Unread.
;; `R' This misleadingly named specifier is the "secondary mark". This
;; mark will say whether the article has been replied to, has been
;; cached, or has been saved.
;; `D' `Date'.
;; `d' The `Date' in `DD-MMM' format.
;;`o' The `Date' in YYYYMMDD`T'HHMMSS format.
;;
;; For the record the default string is
;; `%U%R%z%I%(%[%4L: %-20,20n%]%) %s\n'.
)

;; I remove mailing list identifiers for mail from list I read often, that
;; are already stored in a particular directory
(setq gnus-list-identifiers
'( "\\[savannah-hackers\\]"
"\\[savannah-dev\\]"
))

;; I do not like graphics smileys.
(setq gnus-treat-display-smileys nil)

;; I wanna particular dimensions while reading mails
(setq
gnus-build-sparse-threads 'some
gnus-use-trees t
gnus-generate-tree-function 'gnus-generate-horizontal-tree
gnus-tree-minimize-window nil)

(if (or (not (getenv "DISPLAY"))
(string-match ":0" (getenv "DISPLAY")))
(progn
(gnus-add-configuration
'(article
(vertical 1.0
(summary 0.40 point)
(article 1.0)
)
)))
(progn
(gnus-add-configuration
'(article
(vertical 1.0
(summary 0.40 point)
(article 1.0)
)
)))
)

(setq font-lock-maximum-decoration t
font-lock-maximum-size nil)
(require 'font-lock)
(set-face-foreground 'gnus-summary-normal-ticked-face "pale violet red")
(set-face-foreground 'gnus-summary-high-ticked-face "pale violet red")

(message "gnus.el: INTERFACE initialized")
</code>

=== Réponses ===

Corrigez nom et adresse courriel.

<code> ; Hey, please remove my address from To: and Ccc: while I do a
;; wide reply.
;; seen at http://www.gnusfr.org/gen.php3/2002/04/02/36,0,1,0.html
(setq message-dont-reply-to-names
"utilisateur@\$gnu\\|free\$.\$org\\|fr\$")

;; I want my replies to begin with something like "<user> writes:"
(defun message-insert-citation-line ()
"La fonction qui insere une ligne aux reponses"
(when message-reply-headers
;; In savannah-hackers group, we talk english
(if (string-equal gnus-newsgroup-name "savannah-hackers")
(insert (mail-header-from message-reply-headers) " said:\n\n")
(insert (mail-header-from message-reply-headers) " a tapoté :\n\n")
)))

(message "gnus.el: REPLY initialized")
</code>

=== Plusieurs Identités ===

Pour utiliser ceci, vous devez mettre la main sur gnus-pers.el dispo http://www.comsecmilnavpac.net/elisp/ en théorie. Vous devez modifier ce contenu en lien avec votre utilisation. Dans la première partie, on associe des identités à des groupes.

<code> (custom-set-variables
;; This is the hash "group name => identity"
'(gnus-personality-electric-headers (quote
(
(any ".*u-strasbg.*" "formel")
(any ".*gnu.*" "gnu")
)))
;; There are my identities
'(gnus-personalities (quote
(
; usual
("default"
"mathieu <yeupou@coleumes.org>"
""
"~/.signature"
)
; GNU voluteering
("gnu"
"Mathieu Roy <yeupou@gnu.org>"
""
"~/.signature_gnu"
)
; Formal, neutral
("formel"
"Mathieu Roy <mathieu.roy@coleumes.org>"
""
"~/.signature_formel"
)
)))
'(gnus-pers-cc-fix nil)
)
(require 'gnus-pers)
(gnus-personality-init)

(message "gnus.el: IDENTITIES initialized")
</code>

== Utiliser gnus ==

Et voilà, le stade de la configuration est passé. Il suffit de lancer emacs, et d'y lancer gnus, en tapant M-x gnus (M = Meta, donc alt).

=== Envoyer un courriel ===

Une fois gnus lancé, tapez <code>m</code>. Remplissez les champs qui vont bien. Par exemple, envoyez vous un courrier, pour tester le tout. Vous pouvez changer votre identité en tapant <code>C-cC-l</code>. Pour finir, tapez <code>C-c C-c</code> pour envoyer le courrier.

=== Consulter les courriels reçus ===

Il faut maintenant dire quels groupes (en fait, fichiers crées par procmail, selon le .procmailrc) vous desirez lire. Vous regardez dans le menu "Groups" -> "Subscribe" -> "Subscribe to a group". Il vous est demandé de taper le nom du groupe. Tapez tabulation. Si un courriel à bien été reçu, au moins un groupe doit être disponible. Sélectionnez le... Rentrez dans le groupe en tapant entrée... Utilisez les menus et apprennez les raccourcis claviers :)

== FDL ==

Ce document est libre, selon les termes de la licence GNU FDL

<div class="merci">Cette page est issue de la documentation 'pré-wiki' de Léa a été convertie avec HTML::WikiConverter. Elle fut créée par Mathieu Roy le 04/10/2002.</div>

= Copyright =
Copyright © 04/10/2002, Mathieu Roy
{{FDL}}

Discussion:Software-soft message-gnus

2006-11-06T14:34:37Z

Ralou : /* Commentaire d'Alex */

Discussion:Software-soft message-gnus

2006-11-06T14:33:23Z

Ralou : Traiter les news

Discussion:Software-soft message-gnus

2006-10-12T14:04:08Z

Ralou :

Discussion:Software-soft message-gnus

2006-10-12T14:02:38Z

Ralou : /* Commentaire d'Alex */

Discussion:Software-soft message-gnus

2006-10-12T13:36:44Z

Ralou :