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-fontfont 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
- The cache will be stored and should not be regenerated unless font-related configuration or the versions of relevant packages changes.
This module has no dedicated maintainers. Become a maintainer?
1.2. Module flags
This module has no flags.
No hacks documented for this module.
This module has no external prerequisites.
3. TODO Usage
This module has no usage documentation yet. Write some?
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:
doom-font provides good unicode coverage, use:
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
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
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.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?