Qu'est-ce que Doom Emacs et comment l'installer

Doom Emacs est une distribution qui vise à créer un moyen simple et accessible de démarrer avec Emacs. Grâce à des centaines de pages de documentation détaillant ses différentes fonctions. Emacs, en soi, peut être intimidant.

Ceci est utile pour l'utilisateur déjà familier et le rat de bibliothèque. Cependant, cette approche non interventionniste n’aide pas quelqu’un qui souhaite simplement l’essayer.

Doom Emacs vise à réduire le gras et à distiller l'expérience Emacs avec ses principaux atouts. Il permet à l'utilisateur d'utiliser l'extensibilité sans avoir besoin de consulter constamment un manuel juste pour effectuer des tâches de base. Il en résulte une version d'Emacs qui peut facilement être changée et modifiée pour répondre aux besoins de l'utilisateur.

Au fait, téléchargez notre aide-mémoire sur les raccourcis clavier Emacs pour augmenter votre productivité.

L'installation de Doom Emacs est relativement simple. Tout ce dont nous avons besoin au préalable, ce sont trois choses :

Une installation vanille Emacs 27.1
Ripgrep
Git

Contenu

Installer Emacs et ripgrep
Installer Git
Installation de Doom Emacs
Configurations post-installation
L'utilitaire Doom : votre compagnon dans Doom Emacs
Configuration de Doom Emacs
Comment installer des packages supplémentaires
Questions fréquemment posées

Lire aussi : Comment utiliser IRC dans Emacs avec ERC

Installer Emacs et ripgrep

Emacs et ripgrep sont disponibles dans presque tous les référentiels des principales distributions Linux. Par exemple, pour installer Emacs et ripgrep dans Debian et Ubuntu 21.10, vous pouvez utiliser apt :

sudo apt install emacs-gtk ripgrep

Pour Arch Linux, utilisez pacman :

sudo pacman -Syu emacs ripgrep

Dans Fedora, utilisez dnf :

sudo dnf install emacs ripgrep

Pour Void Linux, utilisez xbps :

sudo xbps-install emacs-gtk2 ripgrep

Dans mon cas, j'installe Emacs et ripgrep sur mon système Void Linux.

Il est important de noter qu'Emacs est disponible dans une variété de versions. Pour la plupart, le gestionnaire de paquets choisit la version appropriée d'Emacs à installer, mais il existe de rares cas où ce processus échoue.

Par conséquent, nous devons connaître la version que nous installons. Nous cherchons à installer une version d'Emacs pouvant fonctionner dans un environnement graphique, nous laissant avec :

X11
GTK-2
GTK-3

Après cela, nous pouvons procéder à l’installation de Git.

Lire aussi : Comment configurer le nom d'utilisateur et l'adresse e-mail Git dans Ubuntu

Installer Git

Pour installer Doom Emacs, nous devons obtenir un référentiel de code distant sur Internet. Pour ce faire, installez Git. Cela nous permet de copier instantanément le code et, plus important encore, de mettre à jour entre les versions majeures.

Semblable à Emacs, Git est commun à toutes les distributions Linux. Pour l'installer dans Debian et Ubuntu, utilisez apt :

sudo apt install git

Pour Arch Linux, utilisez pacman :

sudo pacman -Syu git

Pour Fedora, utilisez dnf :

sudo dnf install git

Dans Void Linux, utilisez xbps :

sudo xbps-install git

Dans mon cas, j'installe Git dans Void Linux.

Lire aussi : Comment utiliser Emacs comme lecteur USENET avec Gnus

Installation de Doom Emacs

Pour installer Doom Emacs, il suffit d'exécuter quelques commandes :

git clone --depth 1 https://github.com/hlissner/doom-emacs ~/.emacs.d

Il s'agit d'une commande Git qui récupère le référentiel Doom Emacs pour notre machine.

La fonction clone signifie que nous copions le dernier référentiel lorsque nous exécutons la commande.
L'option profondeur tronque ensuite l'historique du référentiel aux deux versions les plus récentes du référentiel.

Dans cette commande, nous enregistrons également le référentiel dans le répertoire de configuration par défaut d'Emacs. Pour cette raison, nous devons nous assurer que le répertoire n'existe pas en tapant cette commande :

rm -rf /home/$USER/.emacs.d/

Après cela, nous devons démarrer l'installation. Nous faisons cela en tapant la commande suivante :

/home/$USER/.emacs.d/bin/doom install

Cette commande installe Doom Emacs au-dessus de l'installation d'Emacs.

Lire aussi : 5 fonctionnalités cachées que vous pouvez utiliser pour améliorer Emacs

Configurations post-installation

Après cela, nous devons faire encore quelques choses pour nous assurer que notre installation ne rencontrera aucun problème.

Tout d'abord, configurez la variable PATH pour détecter le répertoire "/home/$USER/.emacs.d/doom/bin/". Pour ce faire, ajoutez la ligne suivante au fichier "/home/$USER/.profile" :

export PATH=$PATH:$HOME/.emacs.d/doom/bin

Cela mettra à jour la variable PATH pour inclure le répertoire bin pour Doom. Après cela, il suffit de se reconnecter pour recharger la variable d'environnement.

Pour tester si la variable PATH détecte le répertoire "/home/$USER/.emacs.d/doom/bin", nous devons exécuter la commande :

doom doctor

Cela garantit que l’installation a été effectuée correctement. S’il y a des problèmes au cours du processus, la fonction Doom Doctor nous le dira.

Lire aussi : Comment créer de superbes diapositives Beamer avec Emacs

L'utilitaire Doom : votre compagnon dans Doom Emacs

Le docteur doom n'est qu'une des fonctions disponibles dans l'utilitaire doom. C'est le programme principal qui nous permet de modifier, mettre à jour et réparer Doom Emacs.

Ainsi, les fonctions les plus courantes à connaître sont :

doom doctor vérifiera toute incohérence avec notre installation initiale. C'est également particulièrement utile lorsque nous rencontrons des problèmes lors de l'utilisation de Doom Emacs. Il vérifiera tous les répertoires et configurations liés à Doom pour détecter les erreurs potentielles.
doom Upgrade nous permet de mettre à jour notre installation sans douleur. Il vérifiera toutes les mises à jour dans le référentiel, synchronisera notre copie avec la dernière et gérera la migration entre les versions. Pour ce faire, la mise à niveau de Doom nettoie nos configurations Doom actuelles et organise la mise à niveau.
doom purge traite des anciens packages et modules installés dans notre installation. En tant que tel, si nous avons supprimé un tas de packages, cela supprimera toutes les dépendances inutilisées. Il a également la capacité de compresser les référentiels existants en l'exécutant avec l'indicateur -g.
doom sync nous permet de corriger nos configurations personnalisées. Lorsque nous avons installé Doom Emacs, il a créé un fichier séparé pour les configurations personnelles sous "/home/$USER/.doom.d/". L'exécution de la fonction de synchronisation activera les configurations effectuées sur .emacs.d dans le répertoire .doom.d.

Configuration de Doom Emacs

Le répertoire .doom.d est l'endroit où se trouvent toutes les configurations Doom. Il est composé de trois fichiers :

Le fichier packages.el indique quels packages installer et à partir de quel endroit.
Le fichier config.el est l'endroit où nos configurations personnalisées sont incluses. Cela inclut les configurations de Doom et les packages supplémentaires installés.
Le fichier init.el est la viande et les pommes de terre de Doom Emacs. C'est ici que toutes les fonctionnalités de la distribution peuvent être activées ou désactivées.

Modules funestes

Doom Emacs vous permet de choisir parmi plus de 150 modules. Nous pouvons alors activer ces modules en choisissant simplement ceux que nous voulons. Cela nous permet de personnaliser Doom pour qu'il devienne notre propre environnement informatique.

Ajouter et supprimer des modules de Doom Emacs consiste simplement à modifier la fonction doom! dans le fichier ".doom.d/init.el". La syntaxe générale ressemble à ceci :

(doom! :checkers
       (syntax)
       :editor
       (evil)
       :lang
       (org +journal))

Pour activer un module, nous devons étiqueter la catégorie. Dans cet exemple, pour ajouter le module de syntaxe, nous devons d'abord ajouter la catégorie checkers.

De plus, ces modules contiennent également des indicateurs qui peuvent être activés pour un module spécifique. Ceci est similaire aux options USE de Gentoo qui vous permettent d'affiner un programme en activant uniquement les fonctionnalités souhaitées.

Pour ajouter un indicateur pour un module, ajoutez un signe "+" suivi du nom de l'indicateur. Dans cet exemple, nous avons ajouté l'indicateur de journal à org pour activer la prise en charge des journaux.

Une fois terminé, exécutez doom sync pour réinitialiser Doom Emacs avec les paramètres.

Lire aussi : Comment réparer les packages cassés sous Linux

Comment installer des packages supplémentaires

Par défaut, Doom Emacs est déjà livré avec plusieurs packages lors de l'installation. Malgré cela, nous pouvons tout aussi facilement installer des logiciels supplémentaires à partir de référentiels. Nous pouvons le faire en utilisant la fonction package! dans le fichier ".doom.d/packages.el".

Il existe plusieurs façons d'installer un package dans Doom. Le moyen le plus courant consiste à obtenir le package auprès d’ELPA et de MELPA. Pour ce faire, il suffit d'ajouter ce code Lisp à packages.el :

(package! name-of-package)

Cela indiquera à la fonction package! de vérifier chaque référentiel commun pour le package que nous avons indiqué.

Cependant, si votre package n'existe dans aucun référentiel pour Emacs, vous pouvez également l'installer directement depuis son référentiel git :

(package! name-of-git-package
          :recipe (:host github :repo "username/package")

Cela indiquera à la fonction package! d'extraire ce package spécifique de github sous le référentiel "username/package".

Nous pouvons également préciser où dans le référentiel distant nous voulons extraire le package. Par exemple, nous pouvons extraire un package d'un emplacement spécifique dans un référentiel :

(package! another-git-package
          :recipe (:host github :repo "username/package"
                        :files ("package.el" "path/of/*.el")))

Ceci est utile lorsque nous installons à partir d'un référentiel avec de nombreux packages triés dans des sous-répertoires. En utilisant cela, nous pouvons spécifier ce que nous voulons installer en tant que package.

Une fois cela fait, nous devons exécuter doom sync pour réinitialiser Doom Emacs.

Toutes nos félicitations! Vous disposez désormais d'une installation de base de Doom Emacs ainsi que d'une compréhension de base de son fonctionnement et de la manière de le configurer et de l'étendre. Si vous recherchez des applications de productivité sous Linux, nous avons exactement l'article qu'il vous faut.

Questions fréquemment posées

1. Je viens d'installer Doom Emacs et il n'affiche qu'un écran vide lorsque je l'ouvre.

Cela est probablement dû au fait qu'il y a un problème dans votre répertoire .doom.d et que Doom Emacs ne peut charger aucun des paramètres. Une façon de résoudre ce problème consiste à vérifier si le répertoire .doom.d existe et que les trois fichiers - init.el, packages.el et config.el - existent.

Cela peut également se produire parce que le fichier init.el généré était mal formé ou ne contenait pas la fonction doom. Pour résoudre ce problème, vous devez créer un bloc fonctionnel doom avec les modules que vous souhaitez exécuter avec Doom Emacs.

2. J'utilise package.el pour gérer mes packages, puis-je toujours l'utiliser dans Doom Emacs ?

Non. Doom Emacs utilise un gestionnaire différent pour gérer ses packages. Vous devrez utiliser la fonction du package fournie par Doom Emacs pour installer des logiciels supplémentaires.

3. J'ai installé ce package dans Doom Emacs et je n'en veux plus. Comment puis-je le désinstaller ?

Supprimer un package dans Doom Emacs est relativement trivial. Il vous suffit d'exécuter ce morceau de code Lisp dans votre .doom.d/packages.el :

(package! some-package :disable t)

Après cela, vous devez exécuter Doom Sync pour recharger Doom Emacs. Lorsque vous vous reconnecterez, ce package sera désinstallé.