File: modus-themes.el.html
The Modus themes conform with the highest standard for color-contrast accessibility between background and foreground values (WCAG AAA). This file contains all customization variables, helper functions, interactive commands, and face specifications. Please refer to the official Info manual for further documentation (distributed with the themes, or available at: <https://protesilaos.com/emacs/modus-themes>).
The themes share the following customization variables:
modus-themes-completions (alist)
modus-themes-headings (alist)
modus-themes-org-agenda (alist)
modus-themes-bold-constructs (boolean)
modus-themes-deuteranopia (boolean)
modus-themes-inhibit-reload (boolean)
modus-themes-intense-mouseovers (boolean)
modus-themes-italic-constructs (boolean)
modus-themes-mixed-fonts (boolean)
modus-themes-subtle-line-numbers (boolean)
modus-themes-variable-pitch-ui (boolean)
modus-themes-box-buttons (choice)
modus-themes-diffs (choice)
modus-themes-fringes (choice)
modus-themes-hl-line (choice)
modus-themes-lang-checkers (choice)
modus-themes-links (choice)
modus-themes-mail-citations (choice)
modus-themes-markup (choice)
modus-themes-mode-line (choice)
modus-themes-org-blocks (choice)
modus-themes-paren-match (choice)
modus-themes-prompts (choice)
modus-themes-region (choice)
modus-themes-syntax (choice)
There also exist two unique customization variables for overriding color palette values. The specifics are documented in the manual. The symbols are:
modus-themes-operandi-color-overrides (alist)
modus-themes-vivendi-color-overrides (alist)
Check the manual for all supported packages (there are hundreds of them).
For a complete view of the project, also refer to the following files
(should be distributed in the same repository/directory as the
current item):
- modus-operandi-theme.el (Light theme)
- modus-vivendi-theme.el (Dark theme)
Defined variables (0)
Defined functions (0)
Defined faces (103)
modus-themes-active-blue | A blue background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-cyan | A cyan background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-green | A green background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-magenta | A magenta background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-red | A red background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-active-yellow | A yellow background meant for use on the mode line or similar. This is combined with the mode lines primary foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-bold | Generic face for applying a conditional bold weight. This behaves in accordance with `modus-themes-bold-constructs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-box-button | Face for widget buttons (e.g. in the Custom UI). The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-box-button-pressed | Face for pressed widget buttons (e.g. in the Custom UI). The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-completion-match-0 | Face for completions matches 0. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-completion-match-1 | Face for completions matches 1. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-completion-match-2 | Face for completions matches 2. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-completion-match-3 | Face for completions matches 3. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-completion-selected | Face for current selection in completion UIs. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-completion-selected-popup | Face for current selection in completion UI popups. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-added | Combines green colors for the added state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-changed | Combines yellow colors for the changed state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-focus-added | Combines green colors for the focused added state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-focus-changed | Combines yellow colors for the focused changed state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-focus-removed | Combines red colors for the focused removed state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-heading | Combines blue colors for the diff hunk heading. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-refine-added | Combines green colors for word-wise added state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-refine-changed | Combines yellow colors for word-wise changed state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-refine-removed | Combines red colors for word-wise removed state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-diff-removed | Combines red colors for the removed state in diffs. The applied colors are contingent on the value assigned to `modus-themes-diffs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fixed-pitch | Generic face for applying a conditional `fixed-pitch'. This behaves in accordance with `modus-themes-mixed-fonts'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-blue | A blue background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-cyan | A cyan background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-green | A green background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-magenta | A magenta background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-red | A red background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-fringe-yellow | A yellow background meant for use on the fringe or similar. This is combined with the main foreground value. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue | Generic face for `modus-themes-deuteranopia' foreground. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue-active | Face for `modus-themes-deuteranopia' active foreground. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue-background-active | Face for `modus-themes-deuteranopia' active background. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue-background-intense | Face for `modus-themes-deuteranopia' intense background. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue-background-refine | Face for `modus-themes-deuteranopia' refined background. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue-background-subtle | Face for `modus-themes-deuteranopia' subtle background. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-grue-nuanced | Face for `modus-themes-deuteranopia' nuanced foreground. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-0 | General purpose face for use as the document's title. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-1 | General purpose face for use in headings level 1. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-2 | General purpose face for use in headings level 2. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-3 | General purpose face for use in headings level 3. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-4 | General purpose face for use in headings level 4. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-5 | General purpose face for use in headings level 5. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-6 | General purpose face for use in headings level 6. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-7 | General purpose face for use in headings level 7. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-heading-8 | General purpose face for use in headings level 8. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-headings' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-hl-line | General purpose face for the current line. The exact attributes assigned to this face are contingent on the values assigned to the `modus-themes-hl-line' variable. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-blue | Intense blue background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-cyan | Intense cyan background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-green | Intense green background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-magenta | Intense magenta background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-neutral | Intense gray background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-red | Intense red background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-intense-yellow | Intense yellow background combined with the main foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-lang-error | Generic face for linter or spell checker errors. The exact attributes and color combinations are controlled by `modus-themes-lang-checkers'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-lang-note | Generic face for linter or spell checker notes. The exact attributes and color combinations are controlled by `modus-themes-lang-checkers'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-lang-warning | Generic face for linter or spell checker warnings. The exact attributes and color combinations are controlled by `modus-themes-lang-checkers'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-link-broken | Face for `modus-themes-links' broken link. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-link-symlink | Face for `modus-themes-links' symbolic link. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-alt | Combines yellow colors for marking special lines. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-del | Combines red colors for marking deletable lines. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-sel | Combines green colors for marking lines. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-mark-symbol | Applies a blue color and other styles for mark indicators. This is intended for use in modes such as Dired, Ibuffer, Proced. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-markup-code | Face of inline code markup. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-markup-macro | Face of macro markup. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-markup-verbatim | Face of verbatim markup. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-blue | A nuanced blue background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-cyan | A nuanced cyan background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-green | A nuanced green background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-magenta | A nuanced magenta background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-red | A nuanced red background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-nuanced-yellow | A nuanced yellow background. This does not specify a foreground of its own. Instead it is meant to serve as the backdrop for elements such as Org blocks, headings, and any other surface that needs to retain the colors on display. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-prompt | Generic face for command prompts. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-pseudo-header | Generic style for some elements that function like headings. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-blue | Combination of accented blue background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-cyan | Combination of accented cyan background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-green | Combination of accented green background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-magenta | Combination of accented magenta background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-red | Combination of accented red background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-refine-yellow | Combination of accented yellow background and foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-reset-soft | Generic face to set most face properties to nil. This is intended to be inherited by faces that should not retain properties from their context (e.g. an overlay over an underlined text should not be underlined as well) yet still blend in. Also see `modus-themes-reset-hard'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-search-success | Generic face for successful search. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-search-success-lazy | Generic face for successful, lazily highlighted search. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-search-success-modeline | Generic mode line indicator for successful search. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-slant | Generic face for applying a conditional slant (italics). This behaves in accordance with `modus-themes-italic-constructs'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-calm | Combines the special calm background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-cold | Combines the special cold background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-mild | Combines the special mild background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-special-warm | Combines the special warm background and foreground values. This is intended for cases when a neutral gray background is not suitable and where a combination of more saturated colors would not be appropriate. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-blue | Subtle blue background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-cyan | Subtle cyan background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-green | Subtle green background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-magenta | Subtle magenta background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-neutral | Subtle gray background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-red | Subtle red background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-subtle-yellow | Subtle yellow background combined with a dimmed foreground. This is used for general purpose highlighting, mostly in buffers or for completion interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-tab-active | Face of active tab. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-tab-backdrop | Face of backdrop in tabbed interfaces. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-tab-inactive | Face of inactive tab. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-ui-variable-pitch | Face for `modus-themes-variable-pitch-ui'. The actual styling of the face is done by `modus-themes-faces'. |
modus-themes-variable-pitch | Generic face for applying a conditional `variable-pitch'. This behaves in accordance with `modus-themes-mixed-fonts' and/or `modus-themes-variable-pitch-ui'. The actual styling of the face is done by `modus-themes-faces'. |