This repository has been archived on 2024-10-22. You can view files and clone it, but cannot push or open issues or pull requests.
spacemacs/layers/+fonts/unicode-fonts
2020-10-03 22:24:57 +03:00
..
config.el update copyright to 2020 2020-09-23 21:25:01 +02:00
packages.el update copyright to 2020 2020-09-23 21:25:01 +02:00
README.org documentation formatting: Sat Oct 3 18:54:32 UTC 2020 2020-10-03 22:24:57 +03:00

unicode-fonts layer

Description

This layer adds support for unicode-fonts package. It is recommended to install the fonts listed in the Quickstart section of the unicode-fonts README.

Features:

  • Display unicode glyphs using the best available font.
  • Easily override glyphs or sections of glyphs.
  • Display color emoji on both the macOS port version of Emacs and emacs-plus (with unicode-fonts-force-multi-color-on-mac set to non nil).
  • Enable support for font ligature in Emacs 27 + via ligatures.el.

Install

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

If using emacs-plus, you can set unicode-fonts-force-multi-color-on-mac to enable color emoji.

  (unicode-fonts :variables unicode-fonts-force-multi-color-on-mac t)

If you want ligature support Emacs must be built with Harfbuzz and a ligature font must be installed and configured you can see the upstream docs for a full list of requirements. By default this is not enabled you can enable it with unicode-fonts-enable-ligatures.

  (unicode-fonts :variables unicode-fonts-enable-ligatures t)

By default when ligatures are enabled all modes will have ligatures. You can enable ligatures for specific modes with the unicode-fonts-ligature-modes variable.

  (unicode-fonts :variables unicode-fonts-ligature-modes '(php-mode js-mode))

To enable only for programming modes you can use prog-mode

  (unicode-fonts :variables unicode-fonts-ligature-modes '(prog-mode))

To configure the ligature set that gets used with your font there is a unicode-fonts-ligature-set variable. To only enable the ligatures in if statements you can limit the unicode-fonts-ligature-set

  (unicode-fonts :variables unicode-fonts-ligature-set '("==" "===" "!=" "!==" "||" "&&"))