✎ emacs [Wiki ubuntu-fr]

Vous affichez une ancienne révision du document ! Si vous l'enregistrez, vous créerez une nouvelle version avec ce contenu.

----

====== Emacs : le couteau Suisse du développeur ======

**Emacs**, ou Editor MACroS, créé par Richard Stallman est un [[éditeur de texte]] très puissant, extensible et personnalisable.

Bien que d'apparence austère de prime abord, avec un peu de prise en main, Emacs peut servir d'environnement de développement pour beaucoup de langages (LaTeX avec l'extention auctex, python, javascript, html...), de navigateur internet, de client mail, de client irc, de psychanalyste...

{{:spacemacs-magit.png?900 | édition d'un fichier html et inspection des logs de git}}

===== Installation =====
Il y a deux versions d'Emacs disponibles dans les dépôts Ubuntu : la version stable et la version '''snapshot'''!

==== la version stable ====

=== Versions plus récentes ===
[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **[[apt://emacs|emacs]]** ( vous pouvez installer plusieurs versions ).\\
Pour avoir une interface graphique (gtk2) : [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **emacs<version>-gtk**\\
Mais si vous ne voulez pas d'interface graphique : [[:tutoriel:comment_installer_un_paquet|installez le paquet]] **emacs<version>-nox**. Avec emacs<version>-nox, on a les couleurs du profil de **nano** (avec, en plus, la coloration syntaxique).

==== la version ''snapshot'' ====
Emacs n'a pas cessé d'évoluer. Ces changements sont disponibles dans la version de développement d'Emacs qui, bien que considérée comme instable, peut être utilisée quotidiennement.

La version "snapshot" d'Emacs fournie par Ubuntu n'est pas maintenue et est actuellement plus ancienne que la version stable !

=== depuis un dépôt non-officiel ===

[[http://damiencassou.seasidehosting.st/|Damien Cassou]] fournit un dépôt [[ppa|PPA]] contenant un snapshot beaucoup plus récent que celui des dépôts d'Ubuntu et régulièrement mis-à-jour.

Il est quand même important de noter que cette version n'est pas du tout supportée par la communauté Ubuntu. Donc, si vous avez un problème, reportez-le directement à l'auteur du paquet.

Exécutez le code suivant dans un terminal pour ajouter le dépôt :

<code>sudo add-apt-repository ppa:cassou/emacs</code>

Puis, [[:tutoriel:comment_installer_un_paquet|installez les paquets]] **[[apt>emacs-snapshot]]** et **[[apt>emacs-snapshot-el]]**.

Et voilà. Vous pouvez lancer Emacs à partir du menu des applications (choisir la version gtk) ou du terminal en tapant simplement ''emacs''.

En appuyant sur Shift puis en cliquant dans la fenêtre d'Emacs, vous avez la possibilité de grossir la taille de la police.

===== Utilisation =====

<note tip>
Le manuel en français :[[http://www.linux-france.org/article/appli/emacs/manuel/html/index.html]]</note>

Cette section n'a pour but que de vous familiariser avec les fonctions de bases. Il est possible d'en apprendre plus grâce aux liens se trouvant en bas de la page.

==== Principes fondamentaux ====

Contrairement à Vim, il est possible dès le départ et tout au long de l'utilisation d'Emacs d'écrire du texte dans le ou les fichiers ouverts. De plus sous Emacs la notion de fenêtre n'est pas la même que dans les interfaces graphiques. En effet, dans Emacs une fenêtre est un cadre de la "fenêtre" (au sens classique du terme).

=== Les modes ===

Emacs utilise des modes pour l'édition de texte. Il existe 2 types de modes: Le mode **majeur** et le mode **mineur**.

* Le mode majeur définit la manière dont est traité le type de fichier à éditer. Cela implique la gestion de la coloration syntaxique, le comportement de certaines commandes, ajout de fonctionnalités spécifiques ... Il existe un mode majeur pour presque chaque langage de programmation.
  * Le mode mineur quant à lui, permet de modifier le comportement des modes majeurs.

=== Les commandes ===

Emacs se contrôle principalement via des raccourcis/commandes clavier.

C-<lettre>: correspond à **Ctrl+<lettre>**

M-<lettre>: correspond à  **Alt+<lettre>**

<note tip>''M'' correspond à la touche **META** qui est généralement associée à la touche **ALT**</note>

==== Premier contact ====

Emacs propose un tutoriel pour apprendre à utiliser les commandes de base. Pour cela, une fois Emacs lancé tapez :

C-h t

==== Commandes de bases ====

=== Se déplacer ===

Pour se déplacer dans le texte, vous pouvez soit utiliser les touches fléchées ou utiliser les commandes suivantes :

^ commande ^      action       ^
|   C-v    | Avance d'un écran |
|   M-v    | Recule d'un écran |
|   C-n    | Avance d'une ligne  |
|   C-p    | Recule d'une ligne    |
|   C-f    | Avance d'un caractère |
|   C-b    | Recule d'un caractère |
|   M-f    | Avance d'un mot |
|   M-b    | Recule d'un mot |
|   C-a    | Va au début de la ligne |
|   C-e    | Va à la fin de la ligne |
|   M-a    | Va au début de la phrase |
|   M-e    | Va à la fin de la phrase |
|   C+M-f  | Ctr+Alt enfoncé  + f  :  (va a la fermeture de parenthèse correspondante**)_** |
|   C+M-b  | Ctr+Alt enfoncé + b : **_(**va a l'ouverture de parenthèse correspondante) |
|   C-s-w  | Lance la recherche du mot devant le curseur, suivi de C-s [C-r] permet de se déplacer au même mot suivant [précédent] |
|   C-s-w-w  | Lance la recherche du mot en deux parties devant le curseur, suivit de C-s [C-r]...|

=== Éditer du texte ===

=== ouvrir, sauver, quitter===

=== Que faire avec META-x (Alt-x)===
En appuyant sur Alt et x on fait apparaitre le curseur tout en bas de la fenêtre. On peut alors exécuter toutes les fonctions interactives d'emacs. Pour voir la liste de ses fonctions, on peut taper sur Tabulation. D'une manière générale, tabulation complète la fonction que l'on cherche a effectuer. La flèche du haut permet de reprendre les fonctions effectuées récemment.

Par exemple, tapez : M-x got //Tabulation// li //Tabulation// //Entrée// 22 //Entrée//

Et vous arrivez à la ligne 22 en moins d'une seconde si vous y êtes habitué.

**M-x flush-lines ^$**    enlève les lignes vides. (attention tapez deux fois sur le chapeau ^^ )

_________________________________________________________________________________________

Exemple de succession typique : On veut déplacer une ligne dans une autre fonction dont le nom est écrit à coté.

**C-a-k** //;=> on coupe la ligne, puis on déplace le curseur devant le nom de la fonction//

**C-s-w** [C-s] //;=> on lance la recherche, puis on tape autant de fois **C-s**  que nécessaire pour aller à l'endroit que l'on cherche.//

**C-y** //; => Copie le texte coupé précédemment à l'endroit souhaité
//

Remarque générale : la séquence '  **C-a-k** //faire quelque chose (ie:cd..)// **C-y**  ' marche aussi dans n'importe quel shell.

===== Installer des extensions =====

Comme tout éditeur qui se respecte, emacs propose un système d'extensions (ou bien de paquets, "package" en anglais). C'est comme apt-get ou synaptic pour Ubuntu. Cela permet d'obtenir de nouvelles fonctionnalités et de personnaliser son usage très facilement. Avant ce système d'extensions, on devait copier-coller les codes des extensions dans sa configuration… imaginez le bazar. Maintenant, même de petites fonctionnalités sont disponibles dans un paquet.

Le système d'extensions officiel est ''package.el''. En fait, avant son apparition on pouvait utiliser ''el-get''. Il fonctionne toujours et est complémentaire à ''package.el'', mais nous allons nous intéresser à ce dernier.

''package.el'' est inclut de base dans Emacs (depuis la version 24). On a plusieurs commandes à disposition:

* lister les extensions disponibles:  ''M-x package-list-packages''

* installer une extension: ''M-x package-install ENTREE un-paquet ENTREE''

* initialiser (comme "apt-get update"): ''M-x package-initialize''.

En fait, comme toujours, utilisez TAB pour voir la liste des commandes possibles.

Liens:

* package.el: http://wikemacs.org/wiki/Package.el

==== Configurer les sources d'extensions ====

Comme Ubuntu et apt-get, package.el doit connaître des sources d'extensions. Il en a une par défaut, GNU Elpa (emacs lisp package archive). Cependant, ce dépôt ne contient pas les derniers paquets et les plus intéressants. On va donc ajouter MELPA avec ces quelques lignes dans votre configuration (votre init file, ''~/.emacs.d/init.el''):

''
(add-to-list 'package-archives
             '("melpa" . "http://melpa.milkbox.net/packages/") t)''
             
 Pour prendre en compte ces quelques lignes, redémarrez emacs, ou placez-vous après la dernière parenthèse fermante et exécutez ''C-x C-e'' (soit ''M-x eval-last-sexp''), qui permet d'évaluer dans l'environnement d'emacs la dernière expression. Maintenant vous verrez plus de paquets disponibles avec ''M-x package-list-packages'' et on va pouvoir en installer des biens !
             
 Liens:

* MELPA: http://wikemacs.org/wiki/MELPA
  * GNU ELPA: http://wikemacs.org/wiki/ELPA

==== Installez plein d'extensions pratiques ====

Et maintenant, éclatons-nous ! Voici une petite sélection personnelle:

* [[http://wikemacs.org/wiki/Smex | smex]] permet de lancer les commandes avec ''M-x'' plus rapidement, de manière interactive. Lorsqu'on commence à taper une commande on voit la liste des commandes qui correspondent. On voit celles qu'on utilise le plus souvent en premières.
   * [[ https://github.com/bbatsov/projectile | projectile]] est une librairie de gestion de projets. Il permet beaucoup de choses, mais notamment de chercher récursivement des fichiers dans un projet (et toujours interactivement).
   * ido veut dire "Interactively do things" et il porte bien son nom. Il offre un mini-prompt interactif pour presque toutes les commandes qui en ont besoin, ce qui permet de moins taper et d'aller plus vite (pour ouvrir des fichiers, pour répondre à des confirmations oui/non, etc).
   * [[http://wikemacs.org/wiki/Magit | magit ]] pour utiliser git (le gestionnaire de versions) de manière visuelle, interactive et efficace,
   * [[http://wikemacs.org/wiki/Evil | evil-mode]] est une émulation de vim par dessus Emacs. Eh oui, car certains trouvent l'édition modale plus pratique ! (En effet, dans vim on peut supprimer une ligne entière avec ''dd'' lorsqu'avec Emacs de base c'est ''C-a C-k C-k'').
   * [[ http://melpa.org/#/move-text | move-text ]] pour déplacer la ligne ou la région sélectionnée avec M-up et M-down,
   * elscreen pour avoir des onglets (mais pas un unique par fenêtre, cela ne vaut pas le coup lorsqu'on a des dizaines de buffers ouverts),
   * Helm pour une interface interactive à tout (c'est un puits sans fond), dans lequel on trouve helm-swoop qui est une sorte de grep sur le buffer courant mais interactif (on voit la sélection modifée selon notre frappe),
   * mpg123 ou emms pour un lecteur de musique et vidéo,
   * mu4e pour lire ses mails, 
   * des extensions pour org-mode, pour le navigateur de fichiers Dired, pour des moteurs de blogs, pour skype, des jeux, etc. On peut tout programmer en emacs-lisp !

===== Commencer avec une configuration complète =====

On admettra que, de base, Emacs peut sembler rêche, et que cela demande un peu de travail pour installer les extensions dont on a besoin pour travailler. Alors si vous débutez, vous devriez au moins essayer une configuration complète que d'autres ont faite pour vous (on dit des [[http://wikemacs.org/wiki/Starter_Kits | "starter kits"]]).

Une configuration très populaire est [[https://github.com/bbatsov/prelude | emacs-prelude]]. Elle est construite par modules (pour tel language de programmation par exemple) qu'on peut activer et désactiver facilement. Si vous souhaitez construire vous même votre init file, vous pouvez vous en inspirer.

===== Org-mode: gérer sa vie dans un fichier texte =====

Org-mode est un mode majeur d'Emacs extrêmement populaire. C'est souvent une des raisons qui fait basculer des gens vers Emacs. Avant de compléter cette documentation, je vous invite à regarder le site: http://orgmode.org

Il est possible de faire une myriade de choses, mais en fait son utilisation est très simple. Il suffit de créer un fichier avec l'extension ''.org'' (''C-x C-f un-test.org'') et de regarder le menu pour voir comment bouger le contenu, se déplacer, exporter le document en latex, html, txt, markdown ou autre, etc

===== Écrire en LaTeX avec Emacs : exemple de configuration =====

Emacs est 100% configurable. Pour l'adapter à vos besoins, vous devrez créer un répertoire ".emacs.d" dans votre home si cela n'est pas déjà fait, et créer un fichier init.el dans ce répertoire :
<code>mkdir ~/.emacs.d
gedit ~/.emacs.d/init.el</code>
Notez que le fichier init.el sert de fichier de configuration qui s'ouvre à chaque démarrage d'emacs. Pour plus de détails sur le sujet, référez-vous à [[http://www.emacswiki.org/emacs/InitFile|cette page]].

Dans le but de faciliter la configuration d'Emacs pour ceux qui souhaitent l'utiliser pour la première fois, nous donnerons ici un exemple de fichier de configuration pour Emacs, utilisé en particulier pour écrire avec LaTeX  l'aide du plugin AucTeX (installez le via [[:synaptic]]). Dans un but de clarté, nous diviserons ici notre fichier init.el en plusieurs parties, pour commenter les parties qui nous semblent pertinentes.

Voici ici notre partie pour AucTeX :

==AucTex-mode :==

Le mode AucTeX est documenté en anglais principalement (voir le [[http://www.xemacs.org/Documentation/packages/html/auctex_4.html | quickstart-guide]] ). Ce mode permet bien sûr l'édition de fichiers Latex, avec des raccourcis, des listes de commandes connues, par exemple, ainsi qu'en facilitant l'accès à la documentation des paquets. Mais c'est aussi un environnement complet pour développer des codes Latex : il permet de compiler, de naviguer dans la sortie LaTeX, de déboguer son code ou même LaTeX. Les menus permettent de configurer les commandes basiques : indentation, source de noms de commandes connues, etc. Bien entendu, dans la même philosophie qu'Emacs, Auctex est totalement configurable (pour ceux qui ont le temps), et le système de menus permet de personnaliser de nombreux aspects.

Tout d'abord, la documentation d'un paquet est rendue accessible grâce à la commande ** C-c ? **. Comme toutes les commandes auctex qui offrent un choix (ici le nom du paquet), on pourra écrire le début du nom recherché et compléter avec **Tabulation**. Ainsi, ** C-c ? Tabulation** affiche la liste de tous les paquets connus d'AucTeX.

Au niveau de l'édition, **C-c C-s** permet d'introduire une (sous)-section, un paragraphe, etc. **C-c Ret Tabulation** renvoie toutes les commandes connues d'AucTex (une fois le mode installé). **C-c C-e** ouvre un environnement - comme itemize, tabular, etc. - dont il faut donner le nom (compléter à l'aide de tab). On peut alors créer des lignes "\item" avec ** M-Ret**.

L'interface de compilation sous AucTeX permet de compiler et gérer les fichiers de sortie, les messages, etc. La compilation peut se faire de différentes manières : document intégral, partie du document, etc. Une fois une commande de compilation lancée (**C-c C-c** pour tout le document, **C-c C-r** pour la région sélectionnée, etc.), on peut choisir de compiler avec Latex, BibTeX, ... ou encore View (pour visualiser), Clean (pour nettoyer les fichiers intermédiaires), Clean All (pour tout nettoyer, y compris les documents produits). La sortie de compilation est affichée avec **C-c C-l**, et on va à la prochaine erreur avec ** C-c C-`**. On pourra définir ce qui sera considéré comme erreur (notamment parmi les bad-boxes et warnings).

<code>

</code>
<note>Rédaction en cours</note>

==== Avoir des thèmes pour Emacs ====

Vous pouvez changer le thème d'Emacs, c'est-à-dire toutes les couleurs qui sont affichées.

[[:tutoriel:comment_installer_un_paquet|Installez le paquet]] **emacs-goodies-el**

Pour Ubuntu « Gutsy Gibbon » 7.10 il suffit de [[apt://emacs-goodies-el|cliquer ici]].

Relancez Emacs s'il était déjà lancé.

Sous Emacs, tapez la commande ''M-x color-theme-select'' (M-x signifie sur un PC de laisser la touche ALT appuyée et d'appuyer sur la touche x. Tapez ensuite la commande color-theme-select, vous pouvez utiliser la touche de tabulation TAB pour compléter comme dans un terminal).

Vous avez alors toute la liste des thèmes. Pour voir ce que chacun donne, placez le curseur clignotant sur une des lignes et tapez ENTRÉE. Attention à ne pas cliquer sur une adresse email car cela vous ouvrirait l'éditeur d'email intégré à Emacs (C-x k ENTRÉE pour quitter au cas où ça serait déjà fait :-)).

Une fois que vous avez choisi votre thème Emacs préféré, ajoutez les lignes suivantes à la fin de votre fichier ''~/.emacs'' en remplaçant ''color-theme-gnome2'' par le thème que vous avez choisi. Le nom du thème à taper ici est affiché sur la deuxième ligne de la page qui s'affiche quand vous tapez 'd' à la place de taper ENTRÉE sur le thème.

<code lisp>
(require 'color-theme)
(color-theme-gnome2)
</code>

<note tip>Si vous rencontrez une erreur avec emacs22-gtk au lancement, le fichier ''~/.emacs'' doit être configuré comme ceci : 
<code lisp>
(require 'color-theme)
(setq color-theme-is-global t)
(color-theme-gnome2)
</code>
ou comme ceci : 
<code lisp>
(require 'color-theme)
(color-theme-initialize)
(color-theme-gnome2)
</code>
</note>

===== Problèmes =====

Copier/Coller ne marche pas bien sous Ubuntu **entre** Emacs et les autres logiciels (Firefox etc..)
(Copier/coller du type : surligner le texte=copier / bouton du milieu de la souris =coller. ) 
Il semblerait que Metacity (serveur graphique par défaut d'Ubuntu) n'implémente pas la 'Primary Selection' (~clipboard) ou bien que le middle click soit utilisé pour autre chose. Une solution est d'installer //parcellite//. (à débattre)
==== Utilisation à 100% du CPU ====

Si vous utilisez la version '''snapshot''' d'Emacs et que votre CPU est utilisé à 100%, voici une solution :

[[:tutoriel:comment_editer_un_fichier|Éditez le fichier]] /usr/share/emacs/site-lisp/semantic/semantic-idle.el\\ et commentez (ajouter **;;** devant la ligne) ces deux lignes:

ligne 290
<code lisp>
          GJW(semantic-idle-scheduler-kill-timer)
</code>

ligne 294
<code lisp>
      GJW(semantic-idle-scheduler-setup-timer)
)))
</code>
:!: gardez bien les 3 parenthèses :!:

ensuite lancez Emacs en tant que root et tapez dans le mini-buffer
<code>M-x byte-compile-file</code>
puis
<code>/usr/share/emacs/site-lisp/semantic/semantic-idle.el</code>
pour compiler le fichier lisp.

Maintenant, il faut copier le fichier compilé dans le bon dossier pour qu'Emacs l'utilise :
<code>sudo cp -v /usr/share/emacs/site-lisp/semantic/semantic-idle.elc //usr/share/emacs-snapshot/site-lisp/semantic/</code>

sources (anglais): [[http://www.togaware.com/linux/survivor/Emacs_Using.html]]

===== Voir aussi =====
  * [[http://www.linux-france.org/article/appli/emacs/manuel/html/index.html|(fr) Manuel d'Emacs]]
  * [[http://fr.wikibooks.org/wiki/Emacs|Le wikilivre sur emacs]], un projet de manuel collaboratif en Français sur Emacs.
  * [[http://www.tuteurs.ens.fr/unix/editeurs/emacs.html|Tutoriel Emacs sur le site des informaticiens de l'ENS]]
  * [[http://www.traduc.org/docs/HOWTO/vf/Emacs-Beginner-HOWTO.html|Débuter sous Emacs]]
  * [[http://www.gnu.org/software/emacs/|(en) Le site officiel]]
  * [[http://www.emacswiki.org/cgi-bin/emacs-en|Le vieux wiki (multilingue)]]
  * [[http://wikemacs.org/index.php/Main_Page | Le nouveau wiki (en anglais)]]
  * [[http://peadrop.com/blog/2007/01/06/pretty-emacs/|(en) Procédure d'installation]]
  * [[http://www.math.jussieu.fr/~han/emacs/.emacs|Exemple de .emacs ou init.el sur le site de jussieu]]
  * [[http://groups.google.fr/group/fr.comp.text.tex/browse_thread/thread/c3ad96f561ab0957/9fd0c3bb812fde2e?lnk=gst&q=emacs+template#9fd0c3bb812fde2e|Discussion utile sur google group à propos d'une utilisation d'Emacs et de LaTeX]]
  * [[http://www.emacswiki.org/emacs/AUCTeX|Sur AucTeX]]
  * **(fr)** [[http://actual-it.info/2013/emacs-org-mode/|Installation & utilisation simple d'Emacs]] - Plusieurs tutoriels sont disponibles en fin de page.

----

Merci de recopier le code ci-contre pour prouver que vous êtes humain : N W G U L Merci de laisser ce champ vide :

Résumé

Note : En modifiant cette page, vous acceptez que le contenu soit placé sous les termes de la licence suivante : CC Paternité-Partage des Conditions Initiales à l'Identique 3.0 Unported