Distraction-free mode for the ever distracted
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 olivetti, sublimity, and tabula-rasa – will feel right at home.
These modes are:
- Which renders (most) text in a variable pitch font (see
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.
- Our all-in-one “zen” mode that will:
- Center the current buffer.
- Remove superfluous UI elements (like the modeline).
- Scale up the buffer’s text slightly (see
- And make the window’s borders slightly thicker (see
1.1. Module flags
This module has no flags.
- Doom has disabled all of writeroom-mode’s “global” effects
writeroom-maximize-windoware set to
nil), and encapsulated them into the
+zen/togglewill only operate on the current buffer. This way, the user may choose how far-reaching they want its effect to be.
text-scalehas 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).
This module has no external prerequisites.
This module provides two entry points:
writeroom-mode(restricted to the current buffer).
- toggles zen mode in full-screen mode (deletes other windows and full screens the Emacs frame).
Invoke either command again to undo the change.
This can be activated with SPC t z for evil users. Non-evil users can use C-c t z or ’M-x writeroom-mode’.
4. TODO Configuration
This module’s configuration documentation is incomplete. Complete it?
There are no known problems with this module. Report one?
6. TODO Appendix
This module has no appendix yet. Write one?