Emacs (Français) - ArchWiki

Jump to content
État de la traduction: Cet article est la version francophone de Emacs. Date de la dernière traduction: 2022-04-03. Vous pouvez aider à synchroniser la traduction s'il y a eu des changements dans la version anglaise.

Emacs est un éditeur d'affichage en temps réel extensible, personnalisable et auto-documenté. Au cœur d'Emacs se trouve un interprète Emacs Lisp, le langage dans lequel la majorité des fonctionnalités intégrées et des extensions d'Emacs sont implémentées. GNU Emacs utilise GTK comme sa boîte à outils X, bien qu'il fonctionne aussi bien dans un environnement CLI.

## Installation

Pour la version stable de GNU Emacs, installez le paquet emacs. Les variantes incluent :

- emacs28-gitAUR : Pré-test pour la future version 28.1 d'Emacs. Inclut la prise en charge de la compilation native, qui a été fusionnée en amont. En février 2022, il est assez stable.
- emacs-gitAUR : Branche de développement de GNU Emacs. Depuis juin 2021, elle prend en charge la compilation native fusionnée depuis la branche d'Emacs `feature/native-comp`.
- emacs-pgtk-native-comp-gitAUR ou emacs-native-comp-git-enhancedAUR : Un fork non officiel combinant la branche de développement de GNU Emacs (y compris la compilation native) avec le nouveau moteur de rendu PGTK.
- emacs-nox : GNU Emacs sans prise en charge de X11, pour une utilisation dans un terminal. Cette variante a des limitations, notamment moins de couleurs, moins de fonctionnalités pour la gestion des polices (changement de taille en direct, différentes tailles dans un document, etc.), et des limitations avec des fonctionnalités avancées comme la barre de vitesse ou GUD (l'environnement de débogage). Elle est également plus lente lors de la manipulation de faces complexes (l'apparence visuelle du texte dans Emacs).

## Exécuter Emacs

Avant de lancer emacs, vous devez savoir comment le fermer (surtout si vous l'exécutez dans un terminal) : utilisez la séquence de touches `Ctrl+x` `Ctrl+c` séquence de touches.

Pour lancer Emacs, exécutez :

    $ emacs

ou, pour l'utiliser depuis la console :

    $ emacs -nw

ou, pour un chargement rapide (sans .emacs) et une édition dans la CLI :

    $ emacs -Q -nw

Si vous avez installé la version nox, 'emacs' et 'emacs -nw' seront les mêmes.

Un nom de fichier peut également être fourni pour ouvrir ce fichier immédiatement :

    $ emacs nomfichier.txt

### Sans couleurs

Par défaut, Emacs démarre avec un thème de couleurs montrant les hyperliens en bleu foncé. Pour démarrer Emacs sur un terminal texte sans aucun thème ou schéma de couleurs :

    $ emacs -nw --color=no

Ceci fera apparaître tout le texte dans la couleur de premier plan du terminal — normalement du texte blanc sur un fond noir, ou du texte noir sur un fond blanc.

### En tant que daemon

Afin d'éviter de recharger le fichier de configuration d'Emacs à chaque fois qu'Emacs démarre, vous pouvez exécuter Emacs en tant que daemon :

    $ emacs --daemon

Vous pouvez ensuite vous connecter au daemon en exécutant :

    $ emacsclient -nc

Ce qui crée un nouveau cadre `-c` (utilisez `-t` si vous préférez l'utiliser dans le terminal) et ne monopolise pas le terminal `-n` (`--no-wait`). Notez que certains programmes comme Mutt ou Git (pour les messages de commit) attendent que l'éditeur se termine, vous ne pouvez donc pas utiliser le paramètre `-n`. Si votre éditeur par défaut est configuré pour l'utiliser, vous devrez spécifier un éditeur alternatif (e.g. `emacsclient -a "" -t`) pour ces programmes.

### En tant qu'unité de systemd

Une unité systemd est incluse dans Emacs 26.1. L'unité est installée avec Emacs, mais elle doit être activée en tant qu'unité utilisateur (et non pas à l'échelle du système) après avoir installé Emacs.

Après le démarrage du service, Emacs est prêt.

Notez que les unités utilisateur de systemd n'héritent pas des variables d'environnement d'un shell de connexion (comme `~/.bash_profile`). Consultez Systemd (Français)/User (Français)#Variables d'environnement pour plus d'informations.

Si vous démarrez emacs en tant que daemon, vous pouvez définir les variables d'environnement `VISUAL` et `EDITOR` à `emacsclient` afin que les programmes qui démarrent un éditeur utilisent emacsclient au lieu de démarrer une nouvelle instance complète de l'éditeur. Les programmes qui utilisent un éditeur externe comprennent les programmes de messagerie (pour éditer le message), Git (pour éditer le message commit) et less (la commande `v` pour éditer le fichier affiché). N'utilisez pas la commande `-n` (`--nowait`) à emacsclient, car les programmes s'attendent généralement à ce que l'édition soit terminée lorsque l'éditeur se termine.

Il est également recommandé de modifier toute entrée du menu de démarrage de l'interface graphique (ou équivalent) pour Emacs afin de pointer vers emacsclient au lieu d'emacs, de sorte que le daemon emacs soit utilisé au lieu de démarrer un nouveau processus emacs.

## Obtenir de l'aide

Emacs a un tutoriel intégré auquel on peut accéder en cliquant sur le premier lien de l'écran d'accueil et en sélectionnant Aide->Tutoriel Emacs dans le menu ou en appuyant sur `C-h t`.

Emacs est auto-documenté par conception. En tant que tel, une grande quantité d'informations est disponible pour déterminer le nom d'une commande spécifique ou sa combinaison de touches, par exemple. Consultez tous les raccourcis d'aide contextuelle avec `C-h C-h`.

Emacs comprend également un ensemble de cartes de référence, utiles pour les débutants comme pour les experts, consultez `/usr/share/emacs/<version>/etc/refcards/` (remplacez <version> par votre version d'emacs).

### Les manuels

Si vous voulez vraiment maîtriser Emacs, la source de documentation la plus recommandée reste les manuels officiels :

- Emacs : le manuel complet de l'utilisateur d'Emacs.
- Emacs FAQ.
- Emacs Lisp Intro : si vous n'avez jamais utilisé de langage de programmation auparavant.
- Elisp : si vous êtes déjà familier avec un langage de programmation.

Vous pouvez y accéder en tant que PDF à partir de GNU.org ou directement à partir d'Emacs lui-même grâce au lecteur 'info' intégré : `C-h i`. Appuyez sur `m` pour choisir un livre.

Certains utilisateurs préfèrent lire des livres en utilisant 'info' à cause de ses raccourcis pratiques, de ses paragraphes qui s'adaptent à la largeur de la fenêtre et de la police adaptée à la résolution de l'écran. Certains la trouvent moins irritante pour les yeux. Enfin, vous pouvez facilement copier le contenu du livre dans n'importe quel tampon Emacs, et vous pouvez même exécuter des extraits de code Lisp directement à partir des exemples.

Vous pouvez lire le livre Info pour en savoir plus : `C-h i m info <RET>`. Appuyez sur `?` en mode info pour obtenir une liste rapide de raccourcis.

## Personnalisation

L'une des principales caractéristiques d'Emacs est son extensibilité et sa facilité de configuration. Emacs a un moteur de personnalisation intégré. Vous pouvez faire `M-x customize` qui affiche une liste d'options de personnalisation. Pour savoir comment utiliser cette interface, consultez le noeud d'information sur la personnalisation facile : `(info "(emacs) Easy Customization")`. Vous pouvez définir les options de personnalisation ouvertes pour une seule session Emacs ou les enregistrer dans un #Fichier de configuration afin qu'elles soient sauvegardées dans toutes les sessions Emacs. Notez que c'est ce que fait l'interface de personnalisation si vous sélectionnez "Appliquer et sauvegarder".

### Fichier de configuration

Quand Emacs est lancé, il essaie normalement de charger un programme Lisp à partir d'un "fichier d'initialisation", ou "fichier init" pour faire court. Ce fichier, s'il existe, spécifie comment initialiser Emacs pour vous. Emacs recherche votre fichier d'initialisation en utilisant les noms de fichiers '~/.emacs', '~/.emacs.el', '~/.emacs.d/init.el', ou '~/.config/emacs/init.el'. Consultez le nœud d'information "Fichier d'initialisation" pour en savoir plus : `(info "(emacs) Init File")`

## Trucs et astuces

### TRAMP

TRAMP (Transparent Remote Access, Multiple Protocols) est une extension qui, comme son nom l'indique, fournit un accès transparent aux fichiers distants à travers un certain nombre de protocoles. Lorsqu'on vous demande un nom de fichier, la saisie d'un formulaire spécifique invoquera TRAMP. Quelques exemples :

Pour demander le mot de passe root avant d'ouvrir /etc/hosts avec les droits root :

    C-x C-f /sudo::/etc/hosts

Pour se connecter à 'remotehost' en tant que 'vous' via SSH et ouvrir le fichier ~/exemple.txt :

    C-x C-f /ssh:you@remotehost:~/exemple.txt

Le chemin d'accès de TRAMP est généralement de la forme '/[protocole] :[[user@]host]:<file>'.

Pour se connecter à 'myhost' en tant que 'you' et éditer /etc/hosts avec sudo :

    /ssh:you@remotehost|sudo:remotehost:/etc/hosts

TRAMP prend en charge bien plus que ce que les exemples ci-dessus pourraient indiquer. Pour plus d'informations, reportez-vous au manuel TRAMP info, qui est distribué avec Emacs.

### Utilisation d'Emacs comme git mergetool

Par défaut, Git prend en charge l'utilisation du mode Emerge d'Emacs comme outil de fusion. Cependant, vous pouvez préférer le mode Ediff. Malheureusement, ce mode n'est pas pris en charge par git pour des raisons techniques. Il existe néanmoins un moyen de l'utiliser en évaluant du code elisp lors de l'appel à Emacs.

    .gitconfig

    [mergetool.ediff]
        cmd = emacs --eval \" (progn (defun ediff-write-merge-buffer () (let ((file ediff-merge-store-file)) (set-buffer ediff-buffer-C) (write-region (point-min) (point-max) file) (message \\\"Merge buffer saved in: %s\\\" file) (set-buffer-modified-p nil) (sit-for 1))) (setq ediff-quit-hook 'kill-emacs ediff-quit-merge-hook 'ediff-write-merge-buffer) (ediff-merge-files-with-ancestor \\\"$LOCAL\\\" \\\"$REMOTE\\\" \\\"$BASE\\\" nil \\\"$MERGED\\\"))\"

    [merge]
    	tool = ediff

Notez que la commande doit être sur une seule ligne. Dans l'exemple ci-dessus, nous lançons une nouvelle instance d'Emacs. Vous pourriez vouloir utiliser emacsclient pour un démarrage plus rapide ; ce n'est cependant pas recommandé car l'appel à Ediff n'est pas vraiment propre : il pourrait perturber votre session Emacs actuelle.

Si vous voulez un démarrage instantané, vous pouvez utiliser le paramètre `-q`. Si vous voulez lancer Emacs rapidement tout en préservant au moins une partie de votre configuration, vous pouvez appeler Emacs avec

     emacs -q -l ~/.emacs-light

où le fichier de configuration light ne charge que ce dont vous avez besoin pour Ediff.

Consultez kerneltrap.org et stackoverflow pour plus de détails sur cette astuce et le problème Ediff.

### Utilisation du verrouillage des majuscules comme touche de contrôle

Certains utilisateurs apprécient ce comportement pour éviter le fameux "pinky" d'emacs. Si vous voulez l'essayer sous X, exécutez simplement

    $ setxkbmap -option ctrl:nocaps.

Alternativement, pour intervertir ces touches, lancez

    $ setxkbmap -option 'ctrl:swapcaps'.

Pour définir cette option de manière permanente, pensez à l'ajouter à votre fichier `.xinitrc`.

Maintenant, si vous avez besoin de mettre en valeur une région, utilisez simplement le raccourci clavier par défaut `C-x C-u`, qui appelle la fonction `upcase-region`.

Consultez [1] pour une approche alternative.

Si la fonction de verrouillage des majuscules vous manque, mappez-la en tant que "Shift" en même temps.

    $ setxkbmap -option "shift:both_capslock" (en anglais)

Certains environnements de bureau incluent des outils graphiques pour simplifier les réaffectations de clavier. Par exemple, dans Plasma 5, ouvrez les Paramètres système et cliquez sur Périphériques d'entrée. Sélectionnez Clavier et dans l'onglet Avancé, vous trouverez le paramètre Comportement du verrouillage des majuscules sous lequel vous pouvez sélectionner Caps Lock is also a Ctrl.

### Multiplexage d'emacs et d'emacsclient

L'ouverture d'un nouveau fichier dans la même `emacs-session` nécessite l'utilisation de `emacsclient`. La commande `emacs` peut être elle-même enveloppée pour faire le travail plus intelligent d'ouvrir le fichier si la session existe.

Pour démarrer la session, vous devez utiliser `start-server`. Cet extrait va créer un serveur dans la première session d'emacs. Ajoutez ceci à votre fichier de configuration `emacs`.

    .emacs or .emacs.d/init.el

    (require 'server)
    (unless (server-running-p)
      (server-start))

La méthode de l'alias du shell n'est pas adéquate pour cela puisque vous devez également passer des variables ou démarrer une session indépendante de votre propre chef. Ajoutez ceci au `.bashrc` ou à tout fichier rc de votre shell. Cela fera en sorte que votre commande `$ emacs` se comporte comme emacsclient si l'argument est passé.

    function emacs {
        if [[ $# -eq 0 ]]; then
            /usr/bin/emacs # "emacs" is function, will cause recursion
            return
        fi
        args=($*)
        for ((i=0; i <= ${#args}; i++)); do
            local a=${args[i]}
            # NOTE: -c for creating new frame
            if [[ ${a:0:1} == '-' && ${a} != '-c' && ${a} != '--' ]]; then
                /usr/bin/emacs ${args[*]}
                return
            fi
        done
        setsid emacsclient -n -a /usr/bin/emacs ${args[*]}
    }

Si vous voulez l'exécuter dans une nouvelle session, faites simplement `emacs <file> -`.

### Configurations multiples

Vous pouvez utiliser plusieurs configurations et dire à Emacs de charger l'une ou l'autre.

Par exemple, définissons deux fichiers de configuration.

    .emacs

    (load "~/.emacs.d/main" nil t)
    (load "~/.emacs.d/functions" nil t)
    (load "~/.emacs.d/modes" nil t)
    (load "~/.emacs.d/plugins" nil t)
    (load "~/.emacs.d/theme" nil t)

C'est la configuration complète que nous chargeons pour le daemon. Mais le fichier plugins est énorme et lent à charger. Si nous voulons créer une nouvelle instance d'Emacs qui n'a pas besoin des fonctionnalités des plugins, il peut être fastidieux de le charger à chaque fois à la longue.

    .emacs-light

    ].
    (load "~/.emacs.d/main" nil t)
    (load "~/.emacs.d/functions" nil t)
    (load "~/.emacs.d/modes" nil t)
    (load "~/.emacs.d/theme" nil t)

Et maintenant nous lançons Emacs avec

    emacs -q -l ~/.emacs-light

Vous pouvez créer un alias pour faciliter l'appel.

### Variables locales et personnalisées

Vous pouvez définir des variables dans votre fichier de configuration qui pourront être modifiées ultérieurement en local pour un fichier.

    (defcustom my-compiler "gcc" "Some documentation")

Maintenant, dans n'importe quel fichier, vous pouvez définir des variables locales de deux manières, consultez le manuel pour plus de détails.

- En utilisant `M-x add-file-local-variable-prop-line`, qui ajoute une ligne commentée au début similaire à :

    // -*- my-compiler:g++; mode:c++ -*-

- Ou vous pouvez utiliser `M-x add-file-local-variable` pour ajouter des lignes vers la fin du fichier :

    // Local Variables:
    // my-compiler: g++
    // mode: c++
    // End:

Notez que pour que les valeurs prennent effet, vous devrez appeler `M-x revert-buffer`.

Les variables personnalisées sont considérées comme non sûres par défaut. Si vous essayez d'ouvrir un fichier qui contient des variables locales redéfinissant des variables personnalisées, Emacs vous demandera une confirmation.

Vous pouvez déclarer la variable comme sûre, supprimant ainsi la demande de confirmation d'Emacs. Vous devez spécifier un prédicat que toute nouvelle valeur doit vérifier pour qu'elle puisse être considérée comme sûre.

    (defcustom my-compiler "gcc" "Some documentation" :safe 'stringp)

Dans l'exemple précédent, si vous tentez de définir autre chose qu'une chaîne de caractères, Emacs le considérera comme non sécurisé.

### Couleurs et thème personnalisés

Les couleurs peuvent être facilement personnalisées en utilisant la fonction face.

    (set-face-background 'region "color-17")
    (set-face-foreground 'region "white")
    (set-face-bold-p 'font-lock-builtin-face t )

Vous pouvez laisser Emacs vous indiquer le nom de la face où se trouve le point. Utilisez la fonction customize-face pour cela. Cette fonction vous montrera comment définir les couleurs, le gras, le soulignement, etc.

Emacs en console peut gérer 256 couleurs, mais vous devrez utiliser un terminal approprié pour cela. Par exemple, URxvt prend en charge 256 couleurs. Vous pouvez utiliser la fonction list-colors-display pour obtenir une liste complète des couleurs prises en charge. Ceci est fortement dépendant du terminal.

Consultez également

- https://www.emacswiki.org/emacs/ColorThemes
- https://www.gnu.org/software/emacs/manual/html_node/emacs/Custom-Themes.html

### Prise en charge de SyncTeX

Emacs est un puissant éditeur LaTeX. Ceci est principalement dû au fait que vous pouvez adapter ou créer un mode LaTeX pour répondre au mieux à vos besoins.

Néanmoins, il peut y avoir quelques défis, comme la prise en charge de SyncTeX. Vous devez d'abord vous assurer que votre distribution TeX en dispose. Si vous avez installé TeX Live manuellement, vous devrez peut-être installer le paquet synctex.

    # umask 022 && tlmgr install synctex

La prise en charge de SyncTeX dépend de la visionneuse. Ici nous utiliserons Zathura comme exemple, donc le code doit être adapté si vous voulez utiliser un autre visualisateur de PDF.

    (defcustom tex-my-viewer "zathura --fork -s -x \"emacsclient --eval '(progn (switch-to-buffer  (file-name-nondirectory \"'\"'\"%{input}\"'\"'\")) (goto-line %{line}))'\""
      "PDF Viewer for TeX documents. You may want to fork the viewer
    so that it detects when the same document is launched twice, and
    persists when Emacs gets closed.

    Simple command:

      zathura --fork

    We can use

      emacsclient --eval '(progn (switch-to-buffer  (file-name-nondirectory \"%{input}\")) (goto-line %{line}))'

    to reverse-search a pdf using SyncTeX. Note that the quotes and double-quotes matter and must be escaped appropriately."
    :safe 'stringp)

Nous définissons ici notre variable personnalisée. Si vous utilisez AucTeX ou le mode LaTeX par défaut d'Emacs, vous devrez définir le visualisateur en conséquence.

Maintenant, ouvrez un fichier source LaTeX avec Emacs, compilez le document, et lancez le visualisateur. Zathura apparaîtra. Si vous appuyez sur `Ctrl+Clic gauche`. Emacs devrait placer le point à la position correspondante.

### Coloration syntaxique pour les fichiers systemd

Vous pouvez utiliser systemd-mode.

Alternativement, vous pouvez simplement indiquer à emacs de colorer les fichiers systemd (services, timer, etc.), en ajoutant ceci à votre fichier init :

     (add-to-list 'auto-mode-alist '("\\.service\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.timer\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.target\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.mount\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.automount\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.slice\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.socket\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.path\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.netdev\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.network\\'" . conf-unix-mode))
     (add-to-list 'auto-mode-alist '("\\.link\\'" . conf-unix-mode))

### Prise en charge du presse-papiers pour emacs-nox

Pour utiliser le presse-papiers de Xorg dans emacs-nox, installez xclip et ajoutez la fonction suivante à `~/.emacs` [2]

    ;; use xclip to copy/paste in emacs-nox
    (unless window-system
      (when (getenv "DISPLAY")
        (defun xclip-cut-function (text &optional push)
          (with-temp-buffer
    	(insert text)
    	(call-process-region (point-min) (point-max) "xclip" nil 0 nil "-i" "-selection" "clipboard")))
        (defun xclip-paste-function()
          (let ((xclip-output (shell-command-to-string "xclip -o -selection clipboard")))
    	(unless (string= (car kill-ring) xclip-output)
    	  xclip-output )))
        (setq interprogram-cut-function 'xclip-cut-function)
        (setq interprogram-paste-function 'xclip-paste-function)
        ))

Astuce: Vous pouvez également activer la prise en charge de la souris du terminal en ajoutant :

    ;; xterm mouse support
    (require 'mouse)
    (xterm-mouse-mode t)

Consultez également mwheel.el.

## Paquets

Les fonctionnalités d'Emacs peuvent être étendues avec des paquets tiers. Le gestionnaire de paquets intégré `package.el` est le moyen officiellement pris en charge pour ce faire, bien qu'il existe plusieurs autres gestionnaires de paquets écrits par des membres de la communauté Emacs. `package.el` s'appuie sur la variable `package-archives` pour trouver des paquets. Par défaut, il s'agit de Emacs Lisp Package Archive (ELPA). `M-x list-packages` créera un tampon listant tous les paquets connus de votre Emacs. Le manuel (`(info "(emacs) Packages")`) contient beaucoup plus d'informations.

Des archives de paquets tiers peuvent être ajoutées. La plus utilisée d'entre elles est MELPA.

Un certain nombre d'extensions populaires sont disponibles sous forme de paquets dans le dépôt `[community]`, et plus encore, via l'AUR. Le nom de ces paquets a généralement un préfixe 'emacs-' (par exemple, emacs-lua-mode), mais pas toujours (par exemple, auctexAUR).

Astuce: Les contributeurs du Wiki d'Arch Linux peuvent être intéressés par le paquet Emacs Mediawiki.

Certains paquets peuvent nécessiter des modifications de votre fichier de configuration afin de les activer pour que leurs fonctionnalités soient disponibles pendant une session Emacs. Par exemple, si vous installez auctexAUR, vous devrez ajouter

    (load "auctex.el" nil t t)
    (load "preview-latex.el" nil t t)

à votre fichier de configuration. Les autres paquets devraient vous indiquer comment les activer dans la section commentaire de leur code source ou dans leur README.

## Dépannage

### Emacs ne démarre pas avec le message d'erreur 'Undefined color : "WINDOW_FOREGROUND"'

Vous devez installer soit le paquet mcpp, soit le paquet gcc. Le préprocesseur C cpp est utilisé pour prétraiter les X resources par xrdb. Si un préprocesseur C n'est pas installé sur le système, xrdb ignore silencieusement l'exécution du préprocesseur C et le symbole WINDOW_FOREGROUND n'est pas développé en un code couleur hexadécimal.

### Le service Emacs systemd ne démarre pas lors de l'utilisation de Gccemacs

Lorsque vous utilisez Gccemacs (soit la branche `emacs-native-comp` ou `pgtk-nativecomp`) et que vous essayez de démarrer un service systemd pour celui-ci, un message d'erreur indiquant qu'un fichier `.eln` n'a pas été trouvé peut être enregistré :

    $ journalctl --user -xb -g eln

    emacs[7507]: emacs: ../native-lisp/28.0.50-x86_64-pc-linux-gnu-fc9c33938bf279333039c28064d363e8/lisp-mode-410874a46ab8852855281f021ca61fe7-1738806322de892570d69dfc55b437c2.eln: cannot open shared object file: No such file or directory

Comme palliatif, éditez la ligne `WorkingDirectory` de `emacs.service` dans la section `[Service]`.

    emacs.service

    [Service]
    ...
    WorkingDirectory=/usr/lib/emacs/28.0.50/x86_64-pc-linux-gnu/
    ...

Note: Le paramètre `WorkingDirectory` doit être défini avant un éventuel paramètre `Restart` existant.

### Problèmes de sortie colorée

Par défaut, le shell Emacs affiche les séquences d'échappement brutes utilisées pour imprimer des couleurs. En d'autres termes, il affichera des symboles étranges à la place de la sortie colorée souhaitée.

L'inclusion de ce qui suit dans `~/.emacs` résout le problème :

    (add-hook 'shell-mode-hook 'ansi-color-for-comint-mode-on)

### Problèmes d'affichage des caractères dans X Windows

Si lorsque vous démarrez emacs dans X windows, tous les caractères de la fenêtre principale sont des boîtes blanches avec des bordures noires (celles que vous consultez si vous essayez d'afficher des caractères pour lesquels vous n'avez pas installé la bonne police), vous devez installer xorg-fonts-75dpi et/ou xorg-fonts-100dpi et redémarrer X windows.

### Démarrage lent

Astuce: Pour éliminer le temps de démarrage, les utilisateurs peuvent envisager d'exécuter Emacs #En tant qu'unité de systemd.

Les temps de démarrage lents sont souvent causés par l'une des deux choses suivantes.

Pour déterminer laquelle, exécutez Emacs avec :

    $ emacs -q

- Des erreurs, particulièrement dans `/etc/hosts`, résulteront souvent en un délai de 5+ secondes au démarrage d'Emacs. Reportez-vous à Network configuration#Set the hostname pour plus d'informations.

- Vous devrez peut-être surveiller les paquets réseau envoyés depuis votre ordinateur (à l'aide d'un programme comme Wireshark) pour consulter tout comportement étrange.

- Une manière simple de rechercher la cause est de commenter (c'est-à-dire de préfixer les lignes par " ;") les sections suspectes de votre `~/.emacs`. (ou `~/.emacs.d/init.el`) puis de relancer Emacs pour consulter les changements éventuels. Gardez à l'esprit que l'utilisation de "require" et "load" peut ralentir le démarrage, surtout lorsqu'ils sont utilisés avec des extensions plus importantes. Ils ne devraient, en règle générale, être utilisés que lorsque leur cible est soit : nécessaire une fois qu'Emacs démarre ou fournit un peu plus que des "autoloads" pour une extension. Sinon, utilisez directement la fonction 'autoload. Par exemple, au lieu de :

    (require 'anything)

vous pouvez utiliser :

    (autoload 'anything "anything" "Select anything" t)

### Impossible d'ouvrir le fichier de chargement : ...

La cause la plus fréquente de cette erreur est que la variable 'load-path' n'inclut pas le chemin du répertoire dans lequel se trouve l'extension. Pour résoudre ce problème, ajoutez le chemin approprié à la liste à rechercher avant de tenter de charger l'extension :

     (add-to-list 'load-path "/path/to/directory/")

Si vous tentez d'utiliser des paquets pour des extensions et qu'Emacs a été configuré avec un préfixe autre que '/usr', le chemin de chargement devra être mis à jour. Placez ce qui suit dans `~/.emacs` avant les instructions fournies par le paquet :

     (add-to-list 'load-path "/usr/share/emacs/site-lisp")

Si vous compilez Emacs à la main, gardez à l'esprit que le préfixe par défaut est '/usr/local'.

### Problème des touches d'accentuation morte : '<dead-acute> is undefined'

En cherchant ce bug sur Google, on trouve ce lien : https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00167.html

Explication du problème : dans les versions récentes de b72

    Emacs, the normal way to use accent keys does not work as expected. Trying to accent a word like 'fiancé' will produce the message above.

Une façon de résoudre ce problème est de mettre la ligne ci-dessus dans votre fichier de démarrage, `~/.emacs` :

      (require 'iso-transl)

Et non, ce n'est pas un bug, mais une fonctionnalité des nouvelles versions d'Emacs. En lisant les messages ultérieurs à ce sujet sur la liste de diffusion, on trouve ceci (https://lists.gnu.org/archive/html/help-gnu-emacs/2009-05/msg00179.html) :

  Il semble que rien ne soit chargé automatiquement car il y a un choix entre iso-transl et iso-acc. Les deux semblent fournir une méthode d'entrée avec le préfixe C-x 8 ou Alt-<accent>, mais ce que vous et moi faisons, c'est juste appuyer sur une touche morte (^, ', `, ~, ¨) pour l'accent et ensuite une autre touche pour "composer" le caractère accentué. Et il n'y a pas de touche Alt utilisée dans ce cas ! Et selon la documentation, ça semble être approprié pour les encodages 8 bits, donc ça devrait être assez inutile en UTF-8. J'ai signalé ce bogue lorsqu'il a été introduit, mais il semble que le bogue soit classé comme une fonctionnalité ... Peut-être que c'est juste parce que le fichier est auto-chargé bien qu'assez inutile.

### C-M-% et certaines autres raccourcis ne fonctionnent pas dans emacs nox

C'est parce que les terminaux sont plus limités que Xorg. Certains terminaux peuvent cependant gérer plus de raccourcis que d'autres. Deux solutions :

- soit utiliser la version graphique,
- soit changer le raccourcis pour un raccourcis prise en charge.

Exemple :

    .emacs

    (global-set-key (kbd "C-M-y") 'query-replace-regexp)

### Emacs s'arrête

En raison de sa nature «single-thread», de nombreuses opérations bloquent Emacs. Cela peut se produire de plusieurs façons. Par exemple, Emacs peut être en attente d'une entrée de votre part (par exemple, vous avez ouvert le minibuffer dans une image mais vous essayez de travailler dans une autre). Il se peut aussi qu'Emacs soit en train d'exécuter un code qui prend simplement du temps à se terminer. Ou peut-être avez-vous rencontré un bogue. Il existe plusieurs façons d'essayer de débloquer Emacs sans tuer le processus Emacs.

- Essayez d'appuyer sur `C-g`. Selon ce que fait Emacs, vous devrez peut-être appuyer plusieurs fois sur cette touche.
- Essayez d'appuyer sur `ESC ESC ESC`.
- Depuis un autre terminal, exécutez `killall -SIGUSR2 emacs`.

### La sortie d'Emacs-nox devient désordonnée

Lorsque vous travaillez dans un terminal, la couleur, l'indentation, ou tout ce qui est lié à la sortie peut devenir fou. C'est (probablement ?) parce qu'Emacs a reçu un caractère spécial à un moment donné qui peut entrer en conflit avec le terminal actuel. Si cela arrive, vous pouvez faire `M-x redraw-display`, qui redessinera l'affichage du terminal. Si ce problème se produit fréquemment, vous pouvez lier la commande à une touche, par exemple en mettant quelque chose comme

    (global-set-key (kbd "<f7>") 'redraw-display)

dans votre fichier .emacs.

Emacs graphique ne souffre pas de ce problème.

### Affichage des nombres échappés étranges (utf-8) dans le terminal emacs

Exportez ces valeurs dans votre `.bashrc` ou `.zshrc` :

    $ ~/.bashrc ou ~/.zshrc

    export LANG\='en_US.UTF-8'
    export LC_ALL\="en_US.UTF-8"
    export TERM\=xterm-256color

Cela peut être une source d'erreurs car dans les distributions Linux, les valeurs correctes utilisent utf en minuscule (par exemple, `en_US.utf-8`).

Pour afficher toutes les locales disponibles, utilisez `locale -a`.

### Les touches Shift + Flèche ne fonctionnent pas dans emacs avec tmux

Activez les touches xterm dans votre configuration tmux :

    ~/.tmux.conf

    setw -g xterm-keys on

Comme cela va casser d'autres combinaisons de touches, mettez ce qui suit dans votre configuration emacs.

    ~/.emacs

    (defadvice terminal-init-screen
      ;; The advice is named `tmux', and is run before `terminal-init-screen' runs.
      (before tmux activate)
      ;; Docstring.  This describes the advice and is made available inside emacs;
      ;; for example when doing C-h f terminal-init-screen RET
      "Apply xterm keymap, allowing use of keys passed through tmux."
      ;; This is the elisp code that is run before `terminal-init-screen'.
      (if (getenv "TMUX")
        (let ((map (copy-keymap xterm-function-map)))
        (set-keymap-parent map (keymap-parent input-decode-map))
    (set-keymap-parent input-decode-map map))))

Consultez la FAQ de tmux pour plus de détails.

### Redimensionnement incorrect des fenêtres dans KDE

Les utilisateurs de KDE peuvent observer que la fenêtre Emacs ne se redimensionne pas correctement, mais plutôt que la partie redimensionnée est transparente et les clics de souris sont envoyés à la fenêtre sous-jacente. Pour corriger ce comportement, modifiez le thème GTK3 de KDE à quelque chose d'autre que oxygen-gtk. Par exemple, utilisez le thème Emacs qui est inclus dans gtk3.

Pour forcer Emacs à s'agrandir complètement dans KDE, cliquez sur l'icône Emacs dans la barre de titre, et sélectionnez More Actions > Special Window Settings. Ensuite, dans l'onglet "Size & Position", sélectionnez "Obey geometry restrictions", choisissez "Force" dans le menu déroulant et sélectionnez "No" dans les boutons radio à droite.

## Alternatives

Il existe de nombreuses "petites" implémentations d'Emacs. GNU/Emacs est probablement la plus populaire. Quelques alternatives légères compatibles avec Emacs sont listées ici :

- mg — implémentation légère d'Emacs écrite en C. Notez qu'elle ne prend pas en charge UTF-8.

  https://homepage.boetes.org/software/mg/[dead link 2022-09-17 ⓘ] || mg

- Zile — "Zile Is Lossy Emacs", un clone léger écrit pour être aussi similaire que possible à Emacs. Zile ne prend pas en charge UTF-8.

  https://www.gnu.org/software/zile/ || zile

- uemacs — Une version de "Micro-emacs" personnalisée par Linus Torvalds.

  https://git.kernel.org/pub/scm/editors/uemacs/uemacs.git || uemacs-gitAUR

- emacs-ng — Une nouvelle approche d'Emacs - incluant TypeScript, Threading, Async I/O, et WebRender.

  https://github.com/emacs-ng/emacs-ng || emacs-ng-gitAUR

## Voir aussi

- Page d'accueil de GNU Emacs
- Manuel de GNU Emacs
- Wiki d'Emacs
- WikEmacs - un wiki Emacs plus lisible, mais moins complet.
- Introduction utile à Emacs et à ses raccourcis.
- L'Église d'Emacs (via Google drive)
- Carte de référence officielle
- EXWM, le gestionnaire de fenêtres X d'Emacs

Categories:

- Text editors (Français)
- Console applications (Français)
- GNU (Français)

Hidden category:

- Pages with dead links