Cos'è Doom Emacs E Come Installarlo

Doom Emacs è una distribuzione che mira a creare un modo semplice e accessibile per iniziare con Emacs. A causa di centinaia di pagine di documentazione che ne dettagliano le varie funzioni. Emacs, di per sé, può essere scoraggiante.

Questo è utile per l’utente già esperto e per il topo di biblioteca. Tuttavia, questo approccio pratico non aiuta qualcuno che è solo interessato a provarlo.

Doom Emacs mira a ridurre il grasso e distillare l’esperienza Emacs con i suoi punti di forza principali. Consente all’utente di utilizzare l’estendibilità senza la necessità di controllare costantemente un manuale solo per fare le cose di base. Ciò si traduce in una versione di Emacs che può essere facilmente modificata e modificata in base alle esigenze dell’utente.

L’installazione di Doom Emacs è relativamente semplice. Tutto ciò di cui abbiamo bisogno in anticipo sono tre cose:

Un’installazione Emacs 27.1 vaniglia
ripgrep
Idiota

Installazione di Emacs e ripgrep

Emacs e ripgrep sono disponibili in quasi tutti i repository delle principali distribuzioni Linux. Ad esempio, per installare Emacs e ripgrep in Debian e Ubuntu 21.10 puoi usare apt:

sudo apt install emacs-gtk ripgrep

Per Arch Linux, utilizzare pacman:

sudo pacman -Syu emacs ripgrep

In Fedora, usa dnf:

sudo dnf install emacs ripgrep

Per Void Linux, utilizzare xbps:

sudo xbps-install emacs-gtk2 ripgrep

Nel mio caso, sto installando Emacs e ripgrep nel mio sistema Void Linux.

È importante notare che Emacs è disponibile in una varietà di gusti. Per la maggior parte, il gestore dei pacchetti sceglie la versione appropriata di Emacs da installare, ma ci sono rari casi in cui questo processo non riesce.

Pertanto, dovremmo essere a conoscenza della versione che installiamo. Stiamo cercando di installare una versione di Emacs che possa essere eseguita in un ambiente grafico, lasciandoci con:

X11
GTK-2
GTK-3

Successivamente, possiamo procedere con l’installazione di Git.

Installazione di Git

Per installare Doom Emacs, dobbiamo ottenere un repository di codice remoto da Internet. Per fare ciò, installa Git. Ci consente di copiare istantaneamente il codice e, cosa più importante, di aggiornare tra le versioni principali.

Simile a Emacs, Git è comune a tutte le distribuzioni Linux. Per installarlo in Debian e Ubuntu, usa apt:

sudo apt install git

Per Arch Linux, utilizzare pacman:

sudo pacman -Syu git

Per Fedora, usa dnf:

sudo dnf install git

In Void Linux, usa xbps:

sudo xbps-install git

Nel mio caso, sto installando Git in Void Linux.

Installazione di Doom Emacs

Per installare Doom Emacs, dobbiamo solo eseguire alcuni comandi:

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

Questo è un comando Git che recupera il repository Doom Emacs per la nostra macchina.

Il clone funzione significa che stiamo copiando l’ultimo repository quando eseguiamo il comando.
Il depth l’opzione tronca quindi la cronologia del repository alle due versioni più recenti del repository.

In questo comando salviamo anche il repository nella directory di configurazione predefinita di Emacs. Per questo motivo, dobbiamo assicurarci che la directory non esista digitando questo comando:

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

Dopodiché, dobbiamo avviare l’installazione. Lo facciamo digitando il seguente comando:

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

Questo comando installa Doom Emacs sopra l’installazione di Emacs.

Installazione di Doom Emacs 06 completata

Configurazioni successive all’installazione

Dopodiché, ci sono alcune altre cose che dobbiamo fare per assicurarci che la nostra installazione non abbia problemi.

Innanzitutto, imposta la variabile PATH per rilevare la directory “/home/$USER/.emacs.d/doom/bin/”. Fallo aggiungendo la seguente riga al file “/home/$USER/.profile”:

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

Questo aggiornerà la variabile PATH per includere la directory bin per Doom. Dopodiché, dobbiamo solo accedere nuovamente per ricaricare la variabile di ambiente.

Per verificare se la variabile PATH rileva la directory “/home/$USER/.emacs.d/doom/bin”, è necessario eseguire il comando:

doom doctor

Ciò garantisce che l’installazione sia stata eseguita correttamente. Se ci sono problemi durante il processo, ce lo dirà la funzione Doom Doctor.

L’utilità Doom: il tuo compagno in Doom Emacs

Il medico del destino è solo una delle funzioni disponibili nell’utilità del destino. È il programma principale che ci consente di modificare, aggiornare e riparare Doom Emacs.

Pertanto, le funzioni più comuni di cui essere a conoscenza sono:

doom doctor verificherà eventuali incongruenze con la nostra installazione iniziale. È anche particolarmente utile quando incontriamo problemi durante l’utilizzo di Doom Emacs. Controllerà tutte le directory e le configurazioni relative a Doom per potenziali errori.
doom upgrade ci consente di aggiornare in modo indolore la nostra installazione. Controllerà eventuali aggiornamenti nel repository e sincronizzerà la nostra copia con l’ultima e gestirà la migrazione tra le versioni. Per fare ciò, l’aggiornamento di Doom pulisce le nostre attuali configurazioni di Doom e mette in scena l’aggiornamento.
doom purge si occupa di vecchi pacchetti e moduli che sono stati installati nella nostra installazione. Pertanto, se abbiamo rimosso un gruppo di pacchetti, rimuoverà tutte le dipendenze inutilizzate. Ha anche la capacità di comprimere i repository esistenti eseguendolo con il flag -g.
doom sync ci consente di correggere le nostre configurazioni personalizzate. Quando abbiamo installato Doom Emacs, ha creato un file separato per le configurazioni personali in “/home/$USER/.doom.d/”. L’esecuzione della funzione di sincronizzazione abiliterà le configurazioni effettuate su .emacs.d nella directory .doom.d.

Configurazione di Doom Emacs

La directory .doom.d è dove risiedono tutte le configurazioni di Doom. Si compone di tre file:

Il file packages.el indica quali pacchetti installare e da dove.
Il file config.el è dove sono incluse le nostre configurazioni personalizzate. Ciò include le configurazioni sia per Doom che per i pacchetti aggiuntivi che sono stati installati.
Il file init.el è la carne e le patate di Doom Emacs. Qui è dove tutte le funzionalità della distribuzione possono essere abilitate o disabilitate.

Moduli del destino

Doom Emacs ti permette di scegliere più di 150 moduli. Possiamo, quindi, abilitare quei moduli semplicemente selezionando quelli che vogliamo. Questo ci consente di personalizzare Doom in modo che sia il nostro ambiente informatico.

L’aggiunta e la rimozione di moduli da Doom Emacs è solo questione di modificare il file doom! funzione nel file “.doom.d/init.el”. La sintassi generale è simile a questa:

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

Per abilitare un modulo, dobbiamo etichettare la categoria. In questo esempio, per aggiungere il modulo di sintassi, dobbiamo prima aggiungere la categoria delle pedine.

Inoltre, questi moduli contengono anche flag che possono essere attivati per un modulo specifico. Questo è simile a quello di Gentoo USA flag che ti consentono di mettere a punto un programma abilitando solo le funzionalità desiderate.

Per aggiungere un flag per un modulo, aggiungi un segno “+” seguito dal nome del flag. In questo esempio, abbiamo aggiunto il flag journal a org per abilitare il supporto del journal.

Una volta fatto, corri doom sync per reinizializzare Doom Emacs con le impostazioni.

Come installare pacchetti aggiuntivi

Per impostazione predefinita, Doom Emacs viene già fornito con più pacchetti durante l’installazione. Nonostante ciò, possiamo installare altrettanto facilmente software aggiuntivo dai repository. Possiamo farlo usando il package! funzione nel file “.doom.d/packages.el”.

Esistono diversi modi per installare un pacchetto in Doom. Il modo più comune è procurarsi il pacchetto da ELPA e MELPA. Per farlo, dobbiamo solo aggiungere questo codice Lisp a packages.el:

(package! name-of-package)

Questo dirà al package! funzione per controllare ogni repository comune per il pacchetto che abbiamo indicato.

Tuttavia, se il tuo pacchetto non esiste in nessun repository per Emacs, puoi anche installarlo direttamente dal suo repository git:

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

Questo dirà al package! funzione per estrarre quel pacchetto specifico da github nel repository “nome utente/pacchetto”.

Possiamo anche essere particolari su dove nel repository remoto vogliamo estrarre il pacchetto. Ad esempio, possiamo estrarre un pacchetto da una posizione specifica in un repository:

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

Questo è utile quando stiamo installando da un repository con molti pacchetti ordinati in sottodirectory. Usando questo, possiamo specificare cosa vogliamo installare come pacchetto.

Una volta fatto, dobbiamo correre doom sync per reinizializzare Doom Emacs.

Congratulazioni! Ora hai un’installazione di base di Doom Emacs e una comprensione di base di come funziona e come configurarlo ed estenderlo. Se stai cercando alcune applicazioni di produttività in Linux, abbiamo solo l’articolo per te.

Domande frequenti

1. Ho appena installato Doom Emacs e mostra solo una schermata vuota quando lo apro.

Questo è molto probabilmente dovuto al fatto che c’è un problema nella tua directory .doom.d e Doom Emacs non può caricare nessuna delle impostazioni. Un modo per risolvere questo problema è controllare se la directory .doom.d esiste e che i tre file – init.el, packages.el e config.el – esistono.

Questo può accadere anche perché il file init.el che è stato generato non era corretto o non conteneva la funzione di doom. Per risolvere il problema, devi creare un blocco funzione di doom con i moduli che desideri eseguire con Doom Emacs.

2. Sto usando package.el per gestire i miei pacchetti, posso ancora usarlo in Doom Emacs?

No. Doom Emacs utilizza un gestore diverso per mantenere i suoi pacchetti. Dovrai utilizzare la funzione del pacchetto fornita da Doom Emacs per installare software aggiuntivo.