Documentation

Commentary

Presentation mode is a global minor mode that provides a distraction-free
environment for live demos.  It scales text across all buffers and provides
hooks to automate UI changes, such as toggling line numbers or switching themes.

Key features:
- Global text scaling for high visibility on projectors/screen-sharing.
- `presentation-on-hook' and `presentation-off-hook' for UI automation.
- Persistence of scale size between sessions.
- Optional integration with Emacs 29's `global-text-scale-adjust'.

## How to use

 1. Execute `M-x presentation-mode' to start the presentation.
 2. Adjust scale size using `C-x C-+' or `C-x C--'.
    (See: https://www.gnu.org/software/emacs/manual/html_node/emacs/Text-Scale.html )
 3. Execute `M-x presentation-mode' again to end and restore your UI.
 4. Toggling the mode back on will automatically reproduce the last used scale.
 5. To set a permanent default scale, customize `presentation-default-text-scale'.

## Technical Notes

### Permanent font changes

This mode is NOT intended for permanent font configuration.  If you wish to
change the default font size of Emacs frames permanently, please refer to:
https://www.gnu.org/software/emacs/manual/html_node/elisp/Parameter-Access.html

## Comparison

- vs `default-text-scale': Use `default-text-scale' for permanent global
  scaling.  Use `presentation.el' for temporary demo environments.
- vs `org-tree-slide' / `org-present': These are specific to Org-mode slides.
  `presentation.el' is for general Emacs usage and live-coding.

Requires

Dependencies

Consumers

Reverse Dependencies

No reverse dependencies recorded.