mirrors/doomemacs
1
Fork 0
mirror of https://github.com/doomemacs/doomemacs.git synced 2026-05-16 08:31:54 -07:00
Code Issues Projects Releases Wiki Activity
doomemacs/modules/ui/zen
History
Exact
Henrik Lissner 8a3f52ba7a
bump: :ui 
emacs-lsp/lsp-focus@e3e666f447 -> emacs-lsp/lsp-focus@675a20610c
emacs-lsp/lsp-treemacs@49df7292c5 -> emacs-lsp/lsp-treemacs@0104931991
tarsius/hl-todo@cdd8a5bc8d -> tarsius/hl-todo@9a147b9a30

lsp-focus and lsp-treemacs dropped Emacs 28.x support.
2026-05-12 18:37:10 -04:00
..
.doommodule feat: add .doommodule files 2024-09-14 20:47:39 -04:00
autoload.el refactor(zen): reformat & minor revisions 2026-03-21 04:00:48 -04:00
config.el refactor(zen): remove unused variable 2026-03-25 05:30:53 -04:00
packages.el bump: :ui 2026-05-12 18:37:10 -04:00
README.org feat(zen): add +focus flag 2026-03-21 17:14:20 -04:00

README.org

:ui zen

Description   unfold

This module provides two minor modes that make Emacs into a more comfortable writing or coding environment. Folks familiar with "distraction-free" or "zen" modes from other editors — or doom-package:olivetti, doom-package:sublimity, and doom-package:tabula-rasa (Emacs plugins) — will feel right at home.

These modes are:

mixed-pitch-mode
Which renders (most) text in a variable pitch font (see doom-variable-pitch-font). Unlike variable-pitch-mode, this will not affect segments of text that are intended to remain in a fixed pitch font, such as code blocks or ASCII tables.
writeroom-mode

Our all-in-one "zen" mode that will:

  1. Center the current buffer.
  2. Remove superfluous UI elements (like the modeline).
  3. Activate mixed-pitch-mode.
  4. Scale up the buffer's text slightly (see +zen-text-scale).
  5. And make the window's borders slightly thicker (see +zen-window-divider-size).

Maintainers

Become a maintainer?

Module flags

+focus
Dims surrounding code or text around the block or sentence you're currently working on. Includes LSP support if doom-module::tools lsp is enabled (without Eglot).

Packages

Hacks

  • Doom has disabled all of writeroom-mode's "global" effects (writeroom-global-effects and writeroom-maximize-window are set to nil), and encapsulated them into the +zen/toggle-fullscreen command, whereas +zen/toggle will only operate on the current buffer. This way, the user may choose how far-reaching they want its effect to be.
  • text-scale has been advised to adjust visual-fill-column's margins, so its text won't "squeeze" as you scale it up (or "spill" when scaled down).

TODO Changelog

This module does not have a changelog yet.

Installation

Enable this module in your doom! block.

This module has no external requirements.

Usage

This module provides two entry points:

  • M-x +zen/toggle (on <leader> t z): toggles writeroom-mode (restricted to the current buffer).
  • M-x +zen/toggle-fullscreen (on <leader> t Z): toggles zen mode in full-screen mode (deletes other windows and full screens the Emacs frame).

Invoke either command again to undo the change.

TODO Configuration

󱌣 This module has no configuration documentation yet. Write some?

Troubleshooting

There are no known problems with this module. Report one?

Frequently asked questions

This module has no FAQs yet. Ask one?

TODO Appendix

󱌣 This module has no appendix yet. Write one?