Spacemacs is a sophisticated and polished Emacs set-up focused on ergonomics, mnemonics and consistency.
Spacemacs is basically a distribution for Emacs packages - it configures and combines them for a great out-of-box experience.
The installation is done by cloning the Spacemacs configuration files git repository to ~/.emacs.d/
First, install GNU Emacs with the correct USE flags:
Install Emacs, or reinstall if USE flags have been changed:
emerge --ask app-editors/emacs
Download and install Spacemacs
Spacemacs is installed by cloning a git repository containing Emacs configuration.
First, backup or delete any old configuration files ~/.emacs.d and ~/.emacs, if they already exist:
mv ~/.emacs.d ~/.emacs.d.bak-$(date +%FT%T)
mv ~/.emacs ~/.emacs.bak-$(date +%FT%T)
Now that old configs are out of the way, clone the Spacemacs git repository into ~/.emacs.d:
git clone https://github.com/syl20bnr/spacemacs ~/.emacs.d
To finish installing Spacemacs, start Emacs (via menu, a launcher or terminal) and follow the install prompt at the bottom of the screen:
Once installation has finished, there may be quite a bit of information from the install logs still showing. The simplest thing, when starting off, may be to close Spacemacs and relaunch by following the next section.
Custom configuration and features can be set in the file ~/.spacemacs, written in Elisp.
To directly open this file in Spacemacs, press the keys ESC -> SPACE f e d.
As Emacs (and Spacemacs) is self-documenting, learn about possible configuration options by pressing SPC h SPC.
Because Spacemacs replaces the main Emacs configuration, by default, simply launch Emacs to open Spacemacs:
- Emacs — a class of powerful, extensible, self-documenting text editors.
- Knowledge Base:Edit a configuration file
- Text editor — a program to create and edit text files.