This commit apply the following changes: - Remove leading whitespaces - Apply fill-paragraph to justify answers' paragraphs. - Add question: how to define/change an evil-leader prefix? - Add question: user-init or user-config?
6.5 KiB
- FAQ
- Common
- Which version of Spacemacs am I running ?
- What is the official pronunciation of Spacemacs ?
- Why are packages installed with
package-install
automatically deleted by Spacemacs when it boots ? - The Spacemacs banner is ugly, what should I do ?
- The powerline separators are ugly, how can I fix them ?
- The powerline separators have no anti-aliasing, what can I do ?
- Why is after-init-hook not executed ?
- What is the difference between
spacemacs-base
andspacemacs
distributions ? - How can I change or define an alias for an
evil-leader
prefix ? - Should I place my settings in
user-init
oruser-config
? - Why do some of my
org
-related settings cause problems?
- Windows
- OS X
- Common
FAQ TOC@4
-
- Which version of Spacemacs am I running ?
- What is the official pronunciation of Spacemacs ?
- Why are packages installed with
package-install
automatically deleted by Spacemacs when it boots ? - The Spacemacs banner is ugly, what should I do ?
- The powerline separators are ugly, how can I fix them ?
- The powerline separators have no anti-aliasing, what can I do ?
- Why is after-init-hook not executed ?
- What is the difference between
spacemacs-base
andspacemacs
distributions ? - How can I change or define an alias for an
evil-leader
prefix ? - Should I place my settings in
user-init
oruser-config
? - Why do some of my
org
-related settings cause problems?
Common
Which version of Spacemacs am I running ?
The version is displayed on the upper right corner of the loading screen. You
may also just type SPC f e v
.
What is the official pronunciation of Spacemacs ?
As it is written, that is space then macs.
Why are packages installed with package-install
automatically deleted by Spacemacs when it boots ?
To declare new packages you have to create a new configuration layer, see the quick start guide.
The Spacemacs banner is ugly, what should I do ?
Install the default font supported by Spacemacs or choose a fixed width font. More information in the font section of the documentation.
The powerline separators are ugly, how can I fix them ?
Use the property :powerline-scale
of the variable dotspacemacs-default-font
.
See font section of the documentation for more details.
The powerline separators have no anti-aliasing, what can I do ?
Emacs powerline uses XMP images to draw the separators in a graphical
environment. You can have anti-aliasing if you use the utf8
separator. Note
that by default the utf8
separator is used in a terminal. See the powerline
section in the font section of the documentation.
Why is after-init-hook not executed ?
Don't launch Spacemacs with emacs -q -l init.el
command. This command will run
the hooked function in after-init-hook
before the evaluation of the passed -l
init.el
file.
What is the difference between spacemacs-base
and spacemacs
distributions ?
The distribution
concept was introduced in 0.104.x. You can now choose
between two distributions spacemacs
or spacemacs-base
.
spacemacs-base
contains only a minimal set of packages; whereas spacemacs
is the full Spacemacs experience.
Set the distribution with dotspacemacs-distribution
variable. The default is
spacemacs
. For more information as to what is included,
check out the packages.el
file in the respective folders in the
+distribution
folder of the layers/
directory.
How can I change or define an alias for an evil-leader
prefix ?
It is possible to change an evil-leader
prefix by binding its keymap to
another sequence. For instance, if you want to switch SPC l
(evil-avy-goto-line
) with SPC L
(perspectives
layer) to make the later
easier to reach, you can use:
(evil-leader/set-key
"l" (lookup-key evil-leader--default-map "L")
"L" 'evil-avy-goto-line)
Should I place my settings in user-init
or user-config
?
Any variable that layer configuration code will read and act on must be set
in user-init
, and any variable that Spacemacs explicitly sets but you wish to
override must be set in user-config
.
Anything that isn't just setting a variable should 99% be in user-config
.
Why do some of my org
-related settings cause problems?
Since version 0.104, spacemacs uses the `org` version from the org ELPA repository instead of the one shipped with emacs. Then, any `org` related code should not be loaded before `dotspacemacs/user-config`, otherwise both versions will be loaded and will conflict.
Windows
Why do the fonts look crappy on Windows ?
You can install MacType on Windows to get very nice looking fonts. It is also recommended to disable smooth scrolling on Windows.
Why is there no Spacemacs logo in the startup buffer ?
Why are all packages unavailable?
Check if your Emacs has HTTPS capabilities by doing M-:
and then:
(gnutls-available-p)
If this returns nil
, you need to install the GnuTLS DDL file in the same
directory as Emacs. See here for instructions.
OS X
Why are the powerline colors not correct on OS X ?
This is a known issue as of Emacs 24.4 due to ns-use-srgb-colorspace
defaulting to true. It is recommended to use the emacs-mac-port build. See the
install section in the README for more details.