Skip to content

Latest commit

 

History

History
129 lines (111 loc) · 4.1 KB

README.org

File metadata and controls

129 lines (111 loc) · 4.1 KB

Theming layer

Table of Contents

Description

This layer allows for a simple way of modifying themes.

Features:

  • Modify themes from your .spacemacs.
  • Tweak face attributes and other aspects of themes.
  • Includes three additional layer variables for tweaking headings.

Install

To use this configuration layer, add it to your ~/.spacemacs. You will need to add theming to the existing dotspacemacs-configuration-layers list in this file.

Usage

To use this layer, set the value of theming-modifications (a good place is inside your .spacemacs in dotspacemacs/user-init()). It should be a list of the following form:

((theme1 (face1 attributes...)
         (face2 attributes...)
         ...)
 (theme2 (face1 attributes...)
         (face2 attributes...)
         ...)
 ...)

Example

(defun dotspacemacs/user-init ()
  (setq theming-modifications
        '((monokai
           ;; Font locking
           (font-lock-comment-face :slant italic)
           (web-mode-html-attr-name-face :inherit font-lock-variable-name-face
                                         :foreground nil)
           ;; Modeline
           (powerline-active1 :box (:color "#999999"
                                    :line-width 1
                                    :style released-button)
                              :background "#5a5a5a")))))

Source: gist

This will apply the given attributes to the relevant faces whenever the appropriate theme is loaded. To update without changing the theme, use SPC SPC spacemacs/update-theme.

Attributes

See face attributes in the Emacs manual for more information. Some of the more common attributes you might want to tweak are the following:

  • the name of a face to inherit attributes from
  • Hexadecimal color strings
  • typically a floating point number (1.0 gives the same height as the underlying face)
  • typically bold or normal
  • typically nil or t
  • typically oblique, italic or normal
  • set to t to draw a box around characters in the foreground

Faces

To see a list over all loaded faces and what they look like, use SPC SPC list-faces-display. You can also use SPC h d c (describe character) on a character to see its face.

Some of the most common faces to modify are the syntactical elements:

  • font-lock-builtin-face
  • font-lock-comment-delimiter-face
  • font-lock-comment-face
  • font-lock-constant-face
  • font-lock-doc-face
  • font-lock-function-name-face
  • font-lock-keyword-face
  • font-lock-preprocessor-face
  • font-lock-string-face
  • font-lock-type-face
  • font-lock-variable-name-face
  • font-lock-warning-face

As well as the mode-line faces for the active and inactive windows:

  • powerline-active1
  • powerline-active2
  • powerline-inactive1
  • powerline-inactive2
  • mode-line
  • mode-line-inactive

Headers

This layer includes three additional layer variables for tweaking headings. Allowed values are a list of themes in which the given effect should happen, or the symbol all to apply it on all themes.

  • inherits all headings from the default face to avoid non-monospaced fonts
  • sets the :height attribute to one on all headings to give them the same size as the rest of the text
  • sets the :weight attribute to bold on all headings

Example

An example of how to set the default font colour to be black in a custom theme leuven:

(defun dotspacemacs/user-init ()

  ; custom theme modification - overriding default font colour
  (setq-default
    theming-modifications
      '((leuven
          (default :foreground "#000000")
       ))
  )

)