Comment apprendre Emacs Lisp

Un aperçu pour bien démarrer avec Emacs Lisp à partir de zéro


Débute avec Emacs

Bon, tu as installé Emacs. Et maintenant ?

Tu peux commencer par le tutoriel en appuyant sur C-h t, et ce n'est pas un mauvais point de départ. Le tutoriel t'apprendra les bases de l'édition, de la recherche et de la navigation dans Emacs.

Si tu débutes complètement avec Emacs, il peut être judicieux de récupérer un kit de démarrage, qui arrive avec un ensemble de configurations et de paquets déjà en place.

Le paquet Emacs Prelude offre un ensemble agréable de valeurs par défaut raisonnables et de paquets.

Pour installer Emacs Prelude, exécute la commande suivante dans un terminal :

curl -L https://github.com/bbatsov/prelude/raw/master/utils/installer.sh | sh

et n'oublie pas de consulter le guide d'installation pour plus d'instructions.

Si tu connais bien vim, le kit de démarrage Doom Emacs pourrait t'intéresser : il intègre une émulation de vim propulsée par evil-mode.

Pour installer Doom Emacs, exécute la commande suivante dans un terminal :

git clone --depth 1 https://github.com/doomemacs/doomemacs ~/.emacs.d
~/.emacs.d/bin/doom install

et n'oublie pas de consulter le guide d'installation pour plus d'instructions.

Configurer la vérification syntaxique et l'analyse statique

Il est recommandé de configurer la vérification syntaxique et l'analyse statique avec Flycheck.

Si tu n'as pas encore ajouté le dépôt MELPA à ton Emacs, fais-le en ajoutant ce qui suit à ton fichier d'init

(require 'package)

(add-to-list 'package-archives
             '("MELPA Stable" . "https://stable.melpa.org/packages/") t)
(package-initialize)
(package-refresh-contents)

Pour installer et configurer Flycheck sans use-package, ajoute ce qui suit à ton fichier d'init

(package-install 'flycheck)
(add-hook 'after-init-hook #'global-flycheck-mode)

Pour installer et configurer Flycheck avec use-package, ajoute ce qui suit à ton fichier d'init

(use-package flycheck
  :ensure t
  :init (global-flycheck-mode))

Pour plus d'informations et pour résoudre d'éventuels problèmes, consulte la documentation de Flycheck.

Apprentissage d'Emacs Lisp

La meilleure documentation sur Emacs Lisp est... livrée avec Emacs lui-même ! Pour accéder à la Emacs Lisp Reference, tape C-h i et cherche l'entrée Elisp, ou sélectionne Help → More Manuals → Emacs Lisp Reference. Note que le manuel peut être absent de certaines distributions, auquel cas tu peux le trouver en ligne.

Si tu débutes complètement avec Elisp, tu peux lire l'Introduction to Emacs Lisp, qui s'ouvre de la même façon.

Bonnes pratiques et conventions d'Emacs Lisp

Le manuel d'Emacs contient une section sur les conventions de codage d'Emacs Lisp. Il existe aussi un guide de style porté par la communauté et maintenu sur GitHub.