Skip to content

Home

Jump to bottom
Henrik Lissner edited this page May 13, 2017 · 8 revisions

Doom Themes

This wiki will shed some light on exploiting the full potential of doom-themes. If you only use it for the colorscheme, the installation instructions in the README will be enough. Otherwise, there are other features you might like to take advantage of:

Neotree integration

(doom-themes-neotree-config)

This modifies neotree to use icons for folders and files (as shown in the screenshots).

This requires [all-the-icons] and its fonts installed. Run all-the-icons-install-fonts to install its fonts.

Note: this disables neo-vc-integration because the two are incompatible.

Options:

  • doom-neotree-enable-file-icons (default: t)
  • doom-neotree-enable-folder-icons (default: t)
  • doom-neotree-enable-chevron-icons (default: t)
  • doom-neotree-file-icons determines what style of icons to use:
    • t: use the wide range of [all-the-icons] file type icons.
    • 'simple: use a minimialistic set of file icons (most akin to Atom's default iconset).
    • nil: only use the folder icon for directories. No icons for files.
  • Customize the icons with:
    • doom-neotree-enable-type-colors (default: t): if non-nil, and doom-neotree-file-icons is simple, then color files/folders by category (hidden, media, documentation, data or build file). See doom-neotree-file-face-re-alist to configure this, and what face to assign each file type.
    • doom-neotree-project-size (default: 1.4) The :height to display the project icons (at the top) at.
    • doom-neotree-folder-size (default: 1.05) The :height to display folder icons at.
    • doom-neotree-chevron-size (default: 0.8) The :height to display chevron icons at.
    • doom-neotree-line-spacing (default: 2): line-spacing to use in the neotree buffer.
    • doom-neotree-enable-variable-pitch (default: t): if non-nil, file/folder labels will have the variable-pitch face applied to them.
  • These faces can be customized:
    • doom-neotree-dir-face: face for folders
    • doom-neotree-file-face: face for files
  • If doom-neotree-enable-type-colors is non-nil, file and folder entries will be colored with these faces, depending on their "type":
    • doom-neotree-hidden-file-face (dotfiles, *.o, *.pyc, *.elc, etc)
    • doom-neotree-text-file-face (READMEs, LICENSEs, org, md, etc.)
    • doom-neotree-media-file-face (images, video, audio, archives, etc.)
    • doom-neotree-data-file-face (json, xml, toml, yaml, etc.)

Brighter source code (i.e. "real") buffers

;; brighter source buffers (that represent files)
(add-hook 'find-file-hook #'doom-buffer-mode-maybe)
;; ...if you use auto-revert-mode
(add-hook 'after-revert-hook #'doom-buffer-mode-maybe)
;; And you can brighten other buffers (unconditionally) with:
(add-hook 'ediff-prepare-buffer-hook #'doom-buffer-mode)

I prefer that source code buffers are visually distinguishable from non-code buffers, like popup message windows or sidebars. doom-buffer-mode accomplishes this by remapping faces buffer-locally.

Keep in mind this will not work in the terminal, but should degrade gracefully.

Clone this wiki locally