:ui unicode

Extended unicode support for various languages

1. Description

This module extends Doom’s ability to display non-English unicode. It is primarily useful for non-English Emacs users, for whom Doom’s built-in unicode support in insufficient.

This module relies on the unicode-fonts package. It tries to setup the default emacs fontset to cover as many unicode glyphs as possible by scanning all available glyphs from all available fonts.

When this module is enabled…

  • Emacs will prefer to use the doom-unicode-font font to display non-latin glyphs if it provides coverage for them.
  • The first time you run Emacs a unicode cache will be generated – this will take a while!
  • The cache will be regenerated every time Emacs is made aware of new fonts or you change the font configuration e.g. by modifying doom-unicode-font.
  • The cache will be stored and should not be regenerated unless font-related configuration or the versions of relevant packages changes.

1.1. Maintainers

This module has no dedicated maintainers. Become a maintainer?

1.2. Module flags

This module has no flags.

1.4. Hacks

No hacks documented for this module.

2. Prerequisites

This module has no external prerequisites.

3. TODO Usage

This module has no usage documentation yet. Write some?

4. Configuration

The first font that will be analyzed to see if it contains the glyphs of non-latin characters will be doom-unicode-font. To set this font:

# ⎘
;; add to $DOOMDIR/config.el
(setq doom-unicode-font (font-spec :family "Fira Mono"))

If your doom-font provides good unicode coverage, use:

# ⎘
;; add to $DOOMDIR/config.el
(setq doom-unicode-font doom-font)

If your font does not provide some glyphs, this package will try its best to find another font that does.

4.1. Getting fonts with good coverage

A list of fonts with good unicode coverage can be found on the page of the unicode-fonts package.

4.2. Advanced configuration

Consult the unicode-fonts package documentation for a description of more advanced configuration. The configuration should be placed, as usual, in your private config.el wrapped in an (after! unicode-fonts ...) block. The variable unicode-fonts-blocks contains a list of all unicode block names and their character ranges. The default fonts to search for glyphs are in the variable unicode-fonts-block-font-mapping.

If you want to use the font Symbola for Miscellaneous Symbols by default:

# ⎘
;; add to $DOOMDIR/config.el
(after! unicode-fonts
  (push "Symbola" (cadr (assoc "Miscellaneous Symbols" unicode-fonts-block-font-mapping))))

If you want to redefine several blocks an efficient way would be:

# ⎘
;; add to $DOOMDIR/config.el
(after! unicode-fonts
  (dolist (unicode-block '("Mathematical Alphanumeric Symbols"
			   "Mathematical Operators"
			   "Miscellaneous Mathematical Symbols-A"
			   "Miscellaneous Mathematical Symbols-B"
			   "Miscellaneous Symbols"
			   "Miscellaneous Symbols and Arrows"
			   "Miscellaneous Symbols and Pictographs"))
      (push "DejaVu Math TeX Gyre" (cadr (assoc unicode-block unicode-fonts-block-font-mapping)))))

5. Troubleshooting

5.1. TODO Emacs daemon mode

Currently this module may fail setup fonts when emacs is run in daemon mode. See Bug 3328.

6. TODO Appendix

This module has no appendix yet. Write one?