Refile some headings in the manual for better organisation

This commit is contained in:
Protesilaos Stavrou 2023-02-23 09:17:01 +02:00
parent 829d06d9d3
commit c340c5b019
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
2 changed files with 293 additions and 299 deletions

View file

@ -117,10 +117,31 @@ Customization options
* UI typeface:: Toggle the use of variable-pitch across the User Interface
* Palette overrides:: Refashion color values and/or semantic color mappings
Palette overrides
Advanced customization
* Palette override presets::
* Stylistic variants using palette overrides::
* More accurate colors in terminal emulators::
* Range of color with terminal emulators::
* Preview theme colors::
* Per-theme customization settings::
* Get a single color from the palette::
* Use theme colors in code with modus-themes-with-colors::
* Do not extend the region background::
* Add padding to mode line::
* Remap face with local value::
* Font configurations for Org and others::
* Configure bold and italic faces::
* Custom Org todo keyword and priority faces::
* Custom Org emphasis faces::
* Update Org block delimiter fontification::
* Measure color contrast::
* Load theme depending on time of day::
* Backdrop for pdf-tools::
* Toggle themes without reloading them::
* A theme-agnostic hook for theme loading::
* Custom hl-todo colors::
* Add support for solaire-mode::
Stylistic variants using palette overrides
@ -148,30 +169,6 @@ Stylistic variants using palette overrides
* Make diffs use only a foreground::
* Make deuteranopia diffs red and blue instead of yellow and blue::
Advanced customization
* More accurate colors in terminal emulators::
* Range of color with terminal emulators::
* Preview theme colors::
* Per-theme customization settings::
* Get a single color from the palette::
* Use theme colors in code with modus-themes-with-colors::
* Do not extend the region background::
* Add padding to mode line::
* Remap face with local value::
* Font configurations for Org and others::
* Configure bold and italic faces::
* Custom Org todo keyword and priority faces::
* Custom Org emphasis faces::
* Update Org block delimiter fontification::
* Measure color contrast::
* Load theme depending on time of day::
* Backdrop for pdf-tools::
* Toggle themes without reloading them::
* A theme-agnostic hook for theme loading::
* Custom hl-todo colors::
* Add support for solaire-mode::
Face coverage
* Supported packages:: Full list of covered face groups
@ -1295,16 +1292,54 @@ their name, such as fg-removed which complements bg-removed.
watch:
<https://protesilaos.com/codelog/2022-12-17-modus-themes-v4-demo/>.

File: modus-themes.info, Node: Advanced customization, Next: Face coverage, Prev: Customization options, Up: Top
5 Advanced customization
************************
Unlike the predefined customization options which follow a clear pattern
of allowing the user to quickly specify their preference, the themes
also provide a more flexible, albeit difficult, mechanism to control
things with precision (*note Customization Options: Customization
options.).
This section is of interest only to users who are prepared to
maintain their own local tweaks and who are willing to deal with any
possible incompatibilities between versioned releases of the themes. As
such, they are labeled as “do-it-yourself” or “DIY”.
* Menu:
* Palette override presets::
* Stylistic variants using palette overrides::
* More accurate colors in terminal emulators::
* Range of color with terminal emulators::
* Preview theme colors::
* Per-theme customization settings::
* Get a single color from the palette::
* Use theme colors in code with modus-themes-with-colors::
* Do not extend the region background::
* Add padding to mode line::
* Remap face with local value::
* Font configurations for Org and others::
* Configure bold and italic faces::
* Custom Org todo keyword and priority faces::
* Custom Org emphasis faces::
* Update Org block delimiter fontification::
* Measure color contrast::
* Load theme depending on time of day::
* Backdrop for pdf-tools::
* Toggle themes without reloading them::
* A theme-agnostic hook for theme loading::
* Custom hl-todo colors::
* Add support for solaire-mode::

File: modus-themes.info, Node: Palette override presets, Next: Stylistic variants using palette overrides, Up: Palette overrides
File: modus-themes.info, Node: Palette override presets, Next: Stylistic variants using palette overrides, Up: Advanced customization
4.11.1 Palette override presets
-------------------------------
5.1 Palette override presets
============================
This section shows how to refashion the themes by opting in to the
stylistic presets we provide. Those presets override the default color
@ -1355,10 +1390,10 @@ the general idea (extra space for didactic purposes):
,@modus-themes-preset-overrides-intense))

File: modus-themes.info, Node: Stylistic variants using palette overrides, Prev: Palette override presets, Up: Palette overrides
File: modus-themes.info, Node: Stylistic variants using palette overrides, Next: More accurate colors in terminal emulators, Prev: Palette override presets, Up: Advanced customization
4.11.2 Stylistic variants using palette overrides
-------------------------------------------------
5.2 Stylistic variants using palette overrides
==============================================
This section contains practical examples of overriding the palette of
the themes (*note Option for palette overrides: Palette overrides.).
@ -1397,8 +1432,8 @@ Palette override presets::).

File: modus-themes.info, Node: Make the mode line borderless, Next: Make the active mode line colorful, Up: Stylistic variants using palette overrides
4.11.2.1 Make the mode line borderless
......................................
5.2.1 Make the mode line borderless
-----------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1433,8 +1468,8 @@ set their color to that of the underlying background.

File: modus-themes.info, Node: Make the active mode line colorful, Next: Make the tab bar more or less colorful, Prev: Make the mode line borderless, Up: Stylistic variants using palette overrides
4.11.2.2 Make the active mode line colorful
...........................................
5.2.2 Make the active mode line colorful
----------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1475,8 +1510,8 @@ blue mode line for modus-operandi and a red one for modus-vivendi.

File: modus-themes.info, Node: Make the tab bar more or less colorful, Next: Make the fringe invisible or another color, Prev: Make the active mode line colorful, Up: Stylistic variants using palette overrides
4.11.2.3 Make the tab bar more or less colorful
...............................................
5.2.3 Make the tab bar more or less colorful
--------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1526,8 +1561,8 @@ manual.

File: modus-themes.info, Node: Make the fringe invisible or another color, Next: Make links use subtle or no underlines, Prev: Make the tab bar more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.4 Make the fringe invisible or another color
...................................................
5.2.4 Make the fringe invisible or another color
------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1559,8 +1594,8 @@ or continuation lines.

File: modus-themes.info, Node: Make links use subtle or no underlines, Next: Make prompts more or less colorful, Prev: Make the fringe invisible or another color, Up: Stylistic variants using palette overrides
4.11.2.5 Make links use subtle or no underlines
...............................................
5.2.5 Make links use subtle or no underlines
--------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1582,8 +1617,8 @@ that underline mappings can read correctly.

File: modus-themes.info, Node: Make prompts more or less colorful, Next: Make completion matches more or less colorful, Prev: Make links use subtle or no underlines, Up: Stylistic variants using palette overrides
4.11.2.6 Make prompts more or less colorful
...........................................
5.2.6 Make prompts more or less colorful
----------------------------------------
This section contains practical examples of overriding the palette of
the themes (*note Option for palette overrides: Palette overrides.). In
@ -1619,8 +1654,8 @@ prompts.

File: modus-themes.info, Node: Make completion matches more or less colorful, Next: Make comments yellow and strings green, Prev: Make prompts more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.7 Make completion matches more or less colorful
......................................................
5.2.7 Make completion matches more or less colorful
---------------------------------------------------
This section contains practical examples of overriding the palette of
the themes (*note Option for palette overrides: Palette overrides.).
@ -1703,8 +1738,8 @@ colors to two:

File: modus-themes.info, Node: Make comments yellow and strings green, Next: Make code syntax use the old alt-syntax style, Prev: Make completion matches more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.8 Make comments yellow and strings green
...............................................
5.2.8 Make comments yellow and strings green
--------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1745,8 +1780,8 @@ reproduce the effect, but also how to tweak it to ones liking.

File: modus-themes.info, Node: Make code syntax use the old alt-syntax style, Next: Make use of alternative styles for code syntax, Prev: Make comments yellow and strings green, Up: Stylistic variants using palette overrides
4.11.2.9 Make code syntax use the old alt-syntax style
......................................................
5.2.9 Make code syntax use the old alt-syntax style
---------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1825,8 +1860,8 @@ interesting to experiment with faintly red colored comments:

File: modus-themes.info, Node: Make use of alternative styles for code syntax, Next: Make matching parenthesis more or less intense, Prev: Make code syntax use the old alt-syntax style, Up: Stylistic variants using palette overrides
4.11.2.10 Make use of alternative styles for code syntax
........................................................
5.2.10 Make use of alternative styles for code syntax
-----------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1915,8 +1950,8 @@ palette.

File: modus-themes.info, Node: Make matching parenthesis more or less intense, Next: Make box buttons more or less gray, Prev: Make use of alternative styles for code syntax, Up: Stylistic variants using palette overrides
4.11.2.11 Make matching parenthesis more or less intense
........................................................
5.2.11 Make matching parenthesis more or less intense
-----------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1944,8 +1979,8 @@ to enable underlines for those highlights.

File: modus-themes.info, Node: Make box buttons more or less gray, Next: Make TODO and DONE more or less intense, Prev: Make matching parenthesis more or less intense, Up: Stylistic variants using palette overrides
4.11.2.12 Make box buttons more or less gray
............................................
5.2.12 Make box buttons more or less gray
-----------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1970,8 +2005,8 @@ gray from the active buttons and amplifies it for the inactive ones.

File: modus-themes.info, Node: Make TODO and DONE more or less intense, Next: Make headings more or less colorful, Prev: Make box buttons more or less gray, Up: Stylistic variants using palette overrides
4.11.2.13 Make TODO and DONE more or less intense
.................................................
5.2.13 Make TODO and DONE more or less intense
----------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2009,8 +2044,8 @@ subdue them.

File: modus-themes.info, Node: Make headings more or less colorful, Next: Make Org agenda more or less colorful, Prev: Make TODO and DONE more or less intense, Up: Stylistic variants using palette overrides
4.11.2.14 Make headings more or less colorful
.............................................
5.2.14 Make headings more or less colorful
------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2066,8 +2101,8 @@ less intense.

File: modus-themes.info, Node: Make Org agenda more or less colorful, Next: Make inline code in prose use alternative styles, Prev: Make headings more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.15 Make Org agenda more or less colorful
...............................................
5.2.15 Make Org agenda more or less colorful
--------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2125,8 +2160,8 @@ what we show in the other chapters with practical stylistic variants.

File: modus-themes.info, Node: Make inline code in prose use alternative styles, Next: Make mail citations and headers more or less colorful, Prev: Make Org agenda more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.16 Make inline code in prose use alternative styles
..........................................................
5.2.16 Make inline code in prose use alternative styles
-------------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2183,8 +2218,8 @@ not show every possible permutation.

File: modus-themes.info, Node: Make mail citations and headers more or less colorful, Next: Make the region preserve text colors plus other styles, Prev: Make inline code in prose use alternative styles, Up: Stylistic variants using palette overrides
4.11.2.17 Make mail citations and headers more or less colorful
...............................................................
5.2.17 Make mail citations and headers more or less colorful
------------------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2249,8 +2284,8 @@ a message:

File: modus-themes.info, Node: Make the region preserve text colors plus other styles, Next: Make mouse highlights more or less colorful, Prev: Make mail citations and headers more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.18 Make the region preserve text colors, plus other styles
.................................................................
5.2.18 Make the region preserve text colors, plus other styles
--------------------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2288,8 +2323,8 @@ an appropriate foreground value.

File: modus-themes.info, Node: Make mouse highlights more or less colorful, Next: Make language underlines less colorful, Prev: Make the region preserve text colors plus other styles, Up: Stylistic variants using palette overrides
4.11.2.19 Make mouse highlights more or less colorful
.....................................................
5.2.19 Make mouse highlights more or less colorful
--------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2316,8 +2351,8 @@ mapping that covers mouse hover effects and related highlights:

File: modus-themes.info, Node: Make language underlines less colorful, Next: Make line numbers use alternative styles, Prev: Make mouse highlights more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.20 Make language underlines less colorful
................................................
5.2.20 Make language underlines less colorful
---------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2348,8 +2383,8 @@ code linters and prose spell checkers.

File: modus-themes.info, Node: Make line numbers use alternative styles, Next: Make diffs use only a foreground, Prev: Make language underlines less colorful, Up: Stylistic variants using palette overrides
4.11.2.21 Make line numbers use alternative styles
..................................................
5.2.21 Make line numbers use alternative styles
-----------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2389,8 +2424,8 @@ In this section we show how to affect the display-line-numbers-mode.

File: modus-themes.info, Node: Make diffs use only a foreground, Next: Make deuteranopia diffs red and blue instead of yellow and blue, Prev: Make line numbers use alternative styles, Up: Stylistic variants using palette overrides
4.11.2.22 Make diffs use only a foreground
..........................................
5.2.22 Make diffs use only a foreground
---------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2452,8 +2487,8 @@ overrides.

File: modus-themes.info, Node: Make deuteranopia diffs red and blue instead of yellow and blue, Prev: Make diffs use only a foreground, Up: Stylistic variants using palette overrides
4.11.2.23 Make deuteranopia diffs red and blue instead of yellow and blue
.........................................................................
5.2.23 Make deuteranopia diffs red and blue instead of yellow and blue
----------------------------------------------------------------------
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -2500,50 +2535,9 @@ respectively. This is achieved by overriding the “changed” and
(fg-removed-intense "#ff9095")))

File: modus-themes.info, Node: Advanced customization, Next: Face coverage, Prev: Customization options, Up: Top
File: modus-themes.info, Node: More accurate colors in terminal emulators, Next: Range of color with terminal emulators, Prev: Stylistic variants using palette overrides, Up: Advanced customization
5 Advanced customization
************************
Unlike the predefined customization options which follow a clear pattern
of allowing the user to quickly specify their preference, the themes
also provide a more flexible, albeit difficult, mechanism to control
things with precision (*note Customization Options: Customization
options.).
This section is of interest only to users who are prepared to
maintain their own local tweaks and who are willing to deal with any
possible incompatibilities between versioned releases of the themes. As
such, they are labeled as “do-it-yourself” or “DIY”.
* Menu:
* More accurate colors in terminal emulators::
* Range of color with terminal emulators::
* Preview theme colors::
* Per-theme customization settings::
* Get a single color from the palette::
* Use theme colors in code with modus-themes-with-colors::
* Do not extend the region background::
* Add padding to mode line::
* Remap face with local value::
* Font configurations for Org and others::
* Configure bold and italic faces::
* Custom Org todo keyword and priority faces::
* Custom Org emphasis faces::
* Update Org block delimiter fontification::
* Measure color contrast::
* Load theme depending on time of day::
* Backdrop for pdf-tools::
* Toggle themes without reloading them::
* A theme-agnostic hook for theme loading::
* Custom hl-todo colors::
* Add support for solaire-mode::

File: modus-themes.info, Node: More accurate colors in terminal emulators, Next: Range of color with terminal emulators, Up: Advanced customization
5.1 More accurate colors in terminal emulators
5.3 More accurate colors in terminal emulators
==============================================
[ This is based on partial information. Please help verify and/or
@ -2572,7 +2566,7 @@ adapted to shell aliases:

File: modus-themes.info, Node: Range of color with terminal emulators, Next: Preview theme colors, Prev: More accurate colors in terminal emulators, Up: Advanced customization
5.2 Range of color with terminal emulators
5.4 Range of color with terminal emulators
==========================================
[ This is based on partial information. Please help verify and/or
@ -2642,7 +2636,7 @@ colors::):

File: modus-themes.info, Node: Preview theme colors, Next: Per-theme customization settings, Prev: Range of color with terminal emulators, Up: Advanced customization
5.3 Preview theme colors
5.5 Preview theme colors
========================
The command modus-themes-list-colors uses minibuffer completion to
@ -2679,7 +2673,7 @@ and =*modus-operandi-list-mappings* for the semantic color mappings.

File: modus-themes.info, Node: Per-theme customization settings, Next: Get a single color from the palette, Prev: Preview theme colors, Up: Advanced customization
5.4 Per-theme customization settings
5.6 Per-theme customization settings
====================================
If you prefer to maintain different customization options between the
@ -2713,7 +2707,7 @@ of modus-themes-toggle and relevant functions.

File: modus-themes.info, Node: Get a single color from the palette, Next: Use theme colors in code with modus-themes-with-colors, Prev: Per-theme customization settings, Up: Advanced customization
5.5 Get a single color from the palette
5.7 Get a single color from the palette
=======================================
*note Use theme colors in code with modus-themes-with-colors::.
@ -2767,7 +2761,7 @@ with/without overrides and when recursive mappings are introduced.

File: modus-themes.info, Node: Use theme colors in code with modus-themes-with-colors, Next: Do not extend the region background, Prev: Get a single color from the palette, Up: Advanced customization
5.6 Use theme colors in code with modus-themes-with-colors
5.8 Use theme colors in code with modus-themes-with-colors
==========================================================
*note Get a single color from the palette::.
@ -2813,7 +2807,7 @@ exact value of blue-warmer when toggling between modus-operandi to

File: modus-themes.info, Node: Do not extend the region background, Next: Add padding to mode line, Prev: Use theme colors in code with modus-themes-with-colors, Up: Advanced customization
5.7 Do not extend the region background
5.9 Do not extend the region background
=======================================
By the default, the background of the region face extends from the end
@ -2831,8 +2825,8 @@ the region preserve text colors plus other styles.

File: modus-themes.info, Node: Add padding to mode line, Next: Remap face with local value, Prev: Do not extend the region background, Up: Advanced customization
5.8 Add padding to mode line
============================
5.10 Add padding to mode line
=============================
Emacs faces do not have a concept of “padding” for the space between the
text and its box boundaries. We can approximate the effect by adding a
@ -2885,8 +2879,8 @@ state of affairs.

File: modus-themes.info, Node: Remap face with local value, Next: Font configurations for Org and others, Prev: Add padding to mode line, Up: Advanced customization
5.9 Remap face with local value
===============================
5.11 Remap face with local value
================================
There are cases where we need to change the buffer-local attributes of a
face. This might be because we have our own minor mode that re-uses a
@ -2945,7 +2939,7 @@ experimentation up to you.

File: modus-themes.info, Node: Font configurations for Org and others, Next: Configure bold and italic faces, Prev: Remap face with local value, Up: Advanced customization
5.10 Font configurations for Org and others
5.12 Font configurations for Org and others
===========================================
The themes are designed to optionally cope well with mixed font
@ -3015,7 +3009,7 @@ account for those finer increments.

File: modus-themes.info, Node: Configure bold and italic faces, Next: Custom Org todo keyword and priority faces, Prev: Font configurations for Org and others, Up: Advanced customization
5.11 Configure bold and italic faces
5.13 Configure bold and italic faces
====================================
The Modus themes do not hardcode a :weight or :slant attribute in
@ -3103,7 +3097,7 @@ bulk).

File: modus-themes.info, Node: Custom Org todo keyword and priority faces, Next: Custom Org emphasis faces, Prev: Configure bold and italic faces, Up: Advanced customization
5.12 Custom Org todo keyword and priority faces
5.14 Custom Org todo keyword and priority faces
===============================================
Users of org-mode have the option to configure various keywords and
@ -3183,7 +3177,7 @@ Do it if you plan to control face attributes.

File: modus-themes.info, Node: Custom Org emphasis faces, Next: Update Org block delimiter fontification, Prev: Custom Org todo keyword and priority faces, Up: Advanced customization
5.13 Custom Org emphasis faces
5.15 Custom Org emphasis faces
==============================
Org provides the user option org-emphasis-alist which associates a
@ -3304,7 +3298,7 @@ invoke M-x org-mode-restart.

File: modus-themes.info, Node: Update Org block delimiter fontification, Next: Measure color contrast, Prev: Custom Org emphasis faces, Up: Advanced customization
5.14 Update Org block delimiter fontification
5.16 Update Org block delimiter fontification
=============================================
As noted in the section about modus-themes-org-blocks, Org contains a
@ -3344,7 +3338,7 @@ intervention can be circumvented by tweaking the function thus:

File: modus-themes.info, Node: Measure color contrast, Next: Load theme depending on time of day, Prev: Update Org block delimiter fontification, Up: Advanced customization
5.15 Measure color contrast
5.17 Measure color contrast
===========================
The themes provide the functions modus-themes-wcag-formula and
@ -3409,7 +3403,7 @@ themes color palette.

File: modus-themes.info, Node: Load theme depending on time of day, Next: Backdrop for pdf-tools, Prev: Measure color contrast, Up: Advanced customization
5.16 Load theme depending on time of day
5.18 Load theme depending on time of day
========================================
While we do provide modus-themes-toggle to manually switch between the
@ -3436,7 +3430,7 @@ location using the built-in solar.el and then configuring the

File: modus-themes.info, Node: Backdrop for pdf-tools, Next: Toggle themes without reloading them, Prev: Load theme depending on time of day, Up: Advanced customization
5.17 Backdrop for pdf-tools
5.19 Backdrop for pdf-tools
===========================
Most PDF files use a white background for their page, making it
@ -3505,7 +3499,7 @@ to dark mode when modus-themes-toggle is called.

File: modus-themes.info, Node: Toggle themes without reloading them, Next: A theme-agnostic hook for theme loading, Prev: Backdrop for pdf-tools, Up: Advanced customization
5.18 Toggle themes without reloading them
5.20 Toggle themes without reloading them
=========================================
Users who have a stable setup and who only ever need to toggle between
@ -3532,7 +3526,7 @@ their own command which calls enable-theme instead of load-theme:

File: modus-themes.info, Node: A theme-agnostic hook for theme loading, Next: Custom hl-todo colors, Prev: Toggle themes without reloading them, Up: Advanced customization
5.19 A theme-agnostic hook for theme loading
5.21 A theme-agnostic hook for theme loading
============================================
The themes are designed with the intent to be useful to Emacs users of
@ -3583,7 +3577,7 @@ they need to (provided they understand the implications).

File: modus-themes.info, Node: Custom hl-todo colors, Next: Add support for solaire-mode, Prev: A theme-agnostic hook for theme loading, Up: Advanced customization
5.20 Custom hl-todo colors
5.22 Custom hl-todo colors
==========================
The hl-todo package provides the user option hl-todo-keyword-faces:
@ -3618,7 +3612,7 @@ otherwise the defaults are not always legible.

File: modus-themes.info, Node: Add support for solaire-mode, Prev: Custom hl-todo colors, Up: Advanced customization
5.21 Add support for solaire-mode
5.23 Add support for solaire-mode
=================================
The solaire-mode package dims the background of what it considers
@ -5897,123 +5891,123 @@ B.3 Concept index

Tag Table:
Node: Top874
Node: Overview8037
Node: How do the themes look like10435
Node: Learn about the latest changes10794
Node: Installation11182
Node: Install manually from source12112
Node: Install from the archives12937
Node: Install on GNU/Linux13536
Node: Debian 11 Bullseye14029
Node: GNU Guix14439
Node: Dealing with byte compilation errors14722
Node: Enable and load15880
Node: The require-theme for built-in Emacs themes18734
Node: Sample configuration with and without use-package19854
Node: Differences between loading and enabling22702
Node: Customization options24740
Node: Custom reload theme28488
Node: Disable other themes29396
Node: Bold constructs30576
Node: Italic constructs31413
Node: Mixed fonts32184
Node: Command prompts33180
Node: Completion UIs34985
Node: Org mode blocks37775
Node: Heading styles39655
Node: UI typeface44009
Node: Palette overrides44940
Node: Palette override presets49247
Node: Stylistic variants using palette overrides51744
Node: Make the mode line borderless53551
Node: Make the active mode line colorful55159
Node: Make the tab bar more or less colorful57110
Node: Make the fringe invisible or another color59347
Node: Make links use subtle or no underlines60847
Node: Make prompts more or less colorful61850
Node: Make completion matches more or less colorful63520
Node: Make comments yellow and strings green67426
Node: Make code syntax use the old alt-syntax style69335
Node: Make use of alternative styles for code syntax72622
Node: Make matching parenthesis more or less intense76292
Node: Make box buttons more or less gray77734
Node: Make TODO and DONE more or less intense79046
Node: Make headings more or less colorful80755
Node: Make Org agenda more or less colorful83161
Node: Make inline code in prose use alternative styles85899
Node: Make mail citations and headers more or less colorful88446
Node: Make the region preserve text colors plus other styles91147
Node: Make mouse highlights more or less colorful92964
Node: Make language underlines less colorful94277
Node: Make line numbers use alternative styles95729
Node: Make diffs use only a foreground97672
Node: Make deuteranopia diffs red and blue instead of yellow and blue100449
Node: Advanced customization102818
Node: More accurate colors in terminal emulators104348
Node: Range of color with terminal emulators105589
Node: Preview theme colors108303
Node: Per-theme customization settings110148
Node: Get a single color from the palette111494
Node: Use theme colors in code with modus-themes-with-colors113698
Node: Do not extend the region background116031
Node: Add padding to mode line116829
Node: Remap face with local value119385
Node: Font configurations for Org and others121806
Ref: Font configurations for Org and others-Footnote-1124715
Node: Configure bold and italic faces124902
Node: Custom Org todo keyword and priority faces129059
Node: Custom Org emphasis faces132624
Node: Update Org block delimiter fontification137447
Node: Measure color contrast139364
Node: Load theme depending on time of day142062
Node: Backdrop for pdf-tools143072
Node: Toggle themes without reloading them145971
Node: A theme-agnostic hook for theme loading147247
Node: Custom hl-todo colors149669
Node: Add support for solaire-mode151194
Node: Face coverage154105
Node: Supported packages154557
Node: Indirectly covered packages159906
Node: Notes on individual packages161259
Node: Note on calendarel weekday and weekend colors162359
Node: Note on git-gutter in Doom Emacs163507
Node: Note on php-mode multiline comments165851
Node: Note on underlines in compilation buffers166604
Node: Note on inline Latex in Org buffers167441
Node: Note on dimmerel168051
Node: Note on display-fill-column-indicator-mode169536
Node: Note on highlight-parenthesesel170935
Node: Note on mmm-modeel background colors176913
Node: Note for prism179213
Node: Note on company-mode overlay pop-up182381
Ref: Note on company-mode overlay pop-up-Footnote-1183111
Ref: Note on company-mode overlay pop-up-Footnote-2183178
Node: Note on ERC escaped color sequences183233
Ref: Note on ERC escaped color sequences-Footnote-1184661
Node: Note on powerline or spaceline184771
Node: Note on SHR colors185185
Node: Note on SHR fonts185609
Node: Note on Ement colors and fonts186248
Node: Note on pdf-tools link hints187758
Node: Note on the Notmuch logo190218
Node: Note on goto-address-mode faces190756
Node: Frequently Asked Questions191868
Node: Is the contrast ratio about adjacent colors?192499
Node: What does it mean to avoid exaggerations?194006
Node: Why are colors mostly variants of blue magenta cyan?195856
Node: What is the best setup for legibility?200162
Node: Are these color schemes?202807
Node: Port the Modus themes to other platforms?206489
Node: Contributing209261
Node: Sources of the themes209658
Node: Issues you can help with210552
Node: Patches require copyright assignment to the FSF211943
Node: Acknowledgements214163
Node: GNU Free Documentation License218094
Node: Indices243458
Node: Function index243637
Node: Variable index244820
Node: Concept index246719
Node: Overview8017
Node: How do the themes look like10415
Node: Learn about the latest changes10774
Node: Installation11162
Node: Install manually from source12092
Node: Install from the archives12917
Node: Install on GNU/Linux13516
Node: Debian 11 Bullseye14009
Node: GNU Guix14419
Node: Dealing with byte compilation errors14702
Node: Enable and load15860
Node: The require-theme for built-in Emacs themes18714
Node: Sample configuration with and without use-package19834
Node: Differences between loading and enabling22682
Node: Customization options24720
Node: Custom reload theme28468
Node: Disable other themes29376
Node: Bold constructs30556
Node: Italic constructs31393
Node: Mixed fonts32164
Node: Command prompts33160
Node: Completion UIs34965
Node: Org mode blocks37755
Node: Heading styles39635
Node: UI typeface43989
Node: Palette overrides44920
Node: Advanced customization49141
Node: Palette override presets50747
Node: Stylistic variants using palette overrides53243
Node: Make the mode line borderless55100
Node: Make the active mode line colorful56702
Node: Make the tab bar more or less colorful58647
Node: Make the fringe invisible or another color60878
Node: Make links use subtle or no underlines62372
Node: Make prompts more or less colorful63369
Node: Make completion matches more or less colorful65033
Node: Make comments yellow and strings green68933
Node: Make code syntax use the old alt-syntax style70836
Node: Make use of alternative styles for code syntax74117
Node: Make matching parenthesis more or less intense77781
Node: Make box buttons more or less gray79217
Node: Make TODO and DONE more or less intense80523
Node: Make headings more or less colorful82226
Node: Make Org agenda more or less colorful84626
Node: Make inline code in prose use alternative styles87358
Node: Make mail citations and headers more or less colorful89899
Node: Make the region preserve text colors plus other styles92594
Node: Make mouse highlights more or less colorful94405
Node: Make language underlines less colorful95712
Node: Make line numbers use alternative styles97158
Node: Make diffs use only a foreground99095
Node: Make deuteranopia diffs red and blue instead of yellow and blue101866
Node: More accurate colors in terminal emulators104229
Node: Range of color with terminal emulators105521
Node: Preview theme colors108235
Node: Per-theme customization settings110080
Node: Get a single color from the palette111426
Node: Use theme colors in code with modus-themes-with-colors113630
Node: Do not extend the region background115963
Node: Add padding to mode line116761
Node: Remap face with local value119319
Node: Font configurations for Org and others121742
Ref: Font configurations for Org and others-Footnote-1124651
Node: Configure bold and italic faces124838
Node: Custom Org todo keyword and priority faces128995
Node: Custom Org emphasis faces132560
Node: Update Org block delimiter fontification137383
Node: Measure color contrast139300
Node: Load theme depending on time of day141998
Node: Backdrop for pdf-tools143008
Node: Toggle themes without reloading them145907
Node: A theme-agnostic hook for theme loading147183
Node: Custom hl-todo colors149605
Node: Add support for solaire-mode151130
Node: Face coverage154041
Node: Supported packages154493
Node: Indirectly covered packages159842
Node: Notes on individual packages161195
Node: Note on calendarel weekday and weekend colors162295
Node: Note on git-gutter in Doom Emacs163443
Node: Note on php-mode multiline comments165787
Node: Note on underlines in compilation buffers166540
Node: Note on inline Latex in Org buffers167377
Node: Note on dimmerel167987
Node: Note on display-fill-column-indicator-mode169472
Node: Note on highlight-parenthesesel170871
Node: Note on mmm-modeel background colors176849
Node: Note for prism179149
Node: Note on company-mode overlay pop-up182317
Ref: Note on company-mode overlay pop-up-Footnote-1183047
Ref: Note on company-mode overlay pop-up-Footnote-2183114
Node: Note on ERC escaped color sequences183169
Ref: Note on ERC escaped color sequences-Footnote-1184597
Node: Note on powerline or spaceline184707
Node: Note on SHR colors185121
Node: Note on SHR fonts185545
Node: Note on Ement colors and fonts186184
Node: Note on pdf-tools link hints187694
Node: Note on the Notmuch logo190154
Node: Note on goto-address-mode faces190692
Node: Frequently Asked Questions191804
Node: Is the contrast ratio about adjacent colors?192435
Node: What does it mean to avoid exaggerations?193942
Node: Why are colors mostly variants of blue magenta cyan?195792
Node: What is the best setup for legibility?200098
Node: Are these color schemes?202743
Node: Port the Modus themes to other platforms?206425
Node: Contributing209197
Node: Sources of the themes209594
Node: Issues you can help with210488
Node: Patches require copyright assignment to the FSF211879
Node: Acknowledgements214099
Node: GNU Free Documentation License218030
Node: Indices243394
Node: Function index243573
Node: Variable index244756
Node: Concept index246655

End Tag Table

View file

@ -1153,7 +1153,22 @@ Named colors can be previewed, such as with the command
For a video tutorial that users of all skill levels can approach,
watch: https://protesilaos.com/codelog/2022-12-17-modus-themes-v4-demo/.
*** Palette override presets
* Advanced customization
:properties:
:custom_id: h:f4651d55-8c07-46aa-b52b-bed1e53463bb
:end:
Unlike the predefined customization options which follow a clear pattern
of allowing the user to quickly specify their preference, the themes
also provide a more flexible, albeit difficult, mechanism to control
things with precision ([[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization Options]]).
This section is of interest only to users who are prepared to maintain
their own local tweaks and who are willing to deal with any possible
incompatibilities between versioned releases of the themes. As such,
they are labeled as "do-it-yourself" or "DIY".
** Palette override presets
:PROPERTIES:
:CUSTOM_ID: h:b0bc811c-227e-42ec-bf67-15e1f41eb7bc
:END:
@ -1214,7 +1229,7 @@ the general idea (extra space for didactic purposes):
,@modus-themes-preset-overrides-intense))
#+end_src
*** Stylistic variants using palette overrides
** Stylistic variants using palette overrides
:PROPERTIES:
:CUSTOM_ID: h:df1199d8-eaba-47db-805d-6b568a577bf3
:END:
@ -1226,7 +1241,7 @@ to take effect. To apply overrides at startup simply define them
before the call that loads the theme. Remember that we also provide
presets that are easier to apply ([[#h:b0bc811c-227e-42ec-bf67-15e1f41eb7bc][Palette override presets]]).
**** Make the mode line borderless
*** Make the mode line borderless
:PROPERTIES:
:CUSTOM_ID: h:80ddba52-e188-411f-8cc0-480ebd75befe
:END:
@ -1263,7 +1278,7 @@ set their color to that of the underlying background.
(border-mode-line-inactive bg-mode-line-inactive)))
#+end_src
**** Make the active mode line colorful
*** Make the active mode line colorful
:PROPERTIES:
:CUSTOM_ID: h:e8d781be-eefc-4a81-ac4e-5ed156190df7
:END:
@ -1307,7 +1322,7 @@ have a blue mode line for ~modus-operandi~ and a red one for
(border-mode-line-active bg-red-subtle)))
#+end_src
**** Make the tab bar more or less colorful
*** Make the tab bar more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:096658d7-a0bd-4a99-b6dc-9b20a20cda37
:END:
@ -1359,7 +1374,7 @@ manual.
(bg-tab-other bg-cyan-subtle)))
#+end_src
**** Make the fringe invisible or another color
*** Make the fringe invisible or another color
:PROPERTIES:
:CUSTOM_ID: h:c312dcac-36b6-4a1f-b1f5-ab1c9abe27b0
:END:
@ -1393,7 +1408,7 @@ or continuation lines.
'((fringe bg-blue-nuanced)))
#+end_src
**** Make links use subtle or no underlines
*** Make links use subtle or no underlines
:PROPERTIES:
:CUSTOM_ID: h:6c1d1dea-5cbf-4d92-b7bb-570a7a23ffe9
:END:
@ -1417,7 +1432,7 @@ that underline mappings can read correctly.
(underline-link-symbolic unspecified)))
#+end_src
**** Make prompts more or less colorful
*** Make prompts more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:bd75b43a-0bf1-45e7-b8b4-20944ca8b7f8
:END:
@ -1454,7 +1469,7 @@ block we show how to add or remove color from prompts.
(bg-prompt bg-yellow-subtle))) ; try to replace "subtle" with "intense"
#+end_src
**** Make completion matches more or less colorful
*** Make completion matches more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:d959f789-0517-4636-8780-18123f936f91
:END:
@ -1541,7 +1556,7 @@ colors to two:
The user can mix and match to their liking.
**** Make comments yellow and strings green
*** Make comments yellow and strings green
:PROPERTIES:
:CUSTOM_ID: h:26f53daa-0065-48dc-88ab-6a718d16cd95
:END:
@ -1584,7 +1599,7 @@ reproduce the effect, but also how to tweak it to one's liking.
(string yellow-cooler)))
#+end_src
**** Make code syntax use the old alt-syntax style
*** Make code syntax use the old alt-syntax style
:PROPERTIES:
:CUSTOM_ID: h:c8767172-bf11-4c96-81dc-e736c464fc9c
:END:
@ -1669,7 +1684,7 @@ The user can always mix and match styles to their liking.
[[#h:943063da-7b27-4ba4-9afe-f8fe77652fd1][Make use of alternative styles for code syntax]].
**** Make use of alternative styles for code syntax
*** Make use of alternative styles for code syntax
:PROPERTIES:
:CUSTOM_ID: h:943063da-7b27-4ba4-9afe-f8fe77652fd1
:END:
@ -1760,7 +1775,7 @@ theme palette.
(variable cyan-warmer)))
#+end_src
**** Make matching parenthesis more or less intense
*** Make matching parenthesis more or less intense
:PROPERTIES:
:CUSTOM_ID: h:259cf8f5-48ec-4b13-8a69-5d6387094468
:END:
@ -1790,7 +1805,7 @@ to enable underlines for those highlights.
(underline-paren-match fg-main)))
#+end_src
**** Make box buttons more or less gray
*** Make box buttons more or less gray
:PROPERTIES:
:CUSTOM_ID: h:4f6b6ca3-f5bb-4830-8312-baa232305360
:END:
@ -1818,7 +1833,7 @@ inactive ones.
(fg-button-inactive "gray50")))
#+end_src
**** Make TODO and DONE more or less intense
*** Make TODO and DONE more or less intense
:PROPERTIES:
:CUSTOM_ID: h:b57bb50b-a863-4ea8-bb38-6de2275fa868
:END:
@ -1858,7 +1873,7 @@ to subdue them.
'((prose-done fg-dim)))
#+end_src
**** Make headings more or less colorful
*** Make headings more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:11297984-85ea-4678-abe9-a73aeab4676a
:END:
@ -1915,7 +1930,7 @@ match styles at will.
(overline-heading-1 border)))
#+end_src
**** Make Org agenda more or less colorful
*** Make Org agenda more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:a5af0452-a50f-481d-bf60-d8143f98105f
:END:
@ -1980,7 +1995,7 @@ A third example that makes the agenda more blue:
(date-weekend fg-dim)))
#+end_src
**** Make inline code in prose use alternative styles
*** Make inline code in prose use alternative styles
:PROPERTIES:
:CUSTOM_ID: h:bb5b396f-5532-4d52-ab13-149ca24854f1
:END:
@ -2039,7 +2054,7 @@ do not show every possible permutation.
(prose-verbatim red-warmer)))
#+end_src
**** Make mail citations and headers more or less colorful
*** Make mail citations and headers more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:7da7a4ad-5d3a-4f11-9796-5a1abed0f0c4
:END:
@ -2108,7 +2123,7 @@ We thus have the following:
(mail-other green)))
#+end_src
**** Make the region preserve text colors, plus other styles
*** Make the region preserve text colors, plus other styles
:PROPERTIES:
:CUSTOM_ID: h:c8605d37-66e1-42aa-986e-d7514c3af6fe
:END:
@ -2148,7 +2163,7 @@ with an appropriate foreground value.
(fg-region fg-main)))
#+end_src
**** Make mouse highlights more or less colorful
*** Make mouse highlights more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:b5cab69d-d7cb-451c-8ff9-1f545ceb6caf
:END:
@ -2177,7 +2192,7 @@ mapping that covers mouse hover effects and related highlights:
'((bg-hover bg-green-subtle)))
#+end_src
**** Make language underlines less colorful
*** Make language underlines less colorful
:PROPERTIES:
:CUSTOM_ID: h:03dbd5af-6bae-475e-85a2-cec189f69598
:END:
@ -2210,7 +2225,7 @@ by code linters and prose spell checkers.
(underline-note green-intense)))
#+end_src
**** Make line numbers use alternative styles
*** Make line numbers use alternative styles
:PROPERTIES:
:CUSTOM_ID: h:b6466f51-cb58-4007-9ebe-53a27af655c7
:END:
@ -2252,7 +2267,7 @@ this section we show how to affect the ~display-line-numbers-mode~.
(bg-line-number-active bg-cyan-intense)))
#+end_src
**** Make diffs use only a foreground
*** Make diffs use only a foreground
:PROPERTIES:
:CUSTOM_ID: h:b3761482-bcbf-4990-a41e-4866fb9dad15
:END:
@ -2316,7 +2331,7 @@ just using the "common" overrides.
(fg-removed-intense yellow-intense)))
#+end_src
**** Make deuteranopia diffs red and blue instead of yellow and blue
*** Make deuteranopia diffs red and blue instead of yellow and blue
:PROPERTIES:
:CUSTOM_ID: h:16389ea1-4cb6-4b18-9409-384324113541
:END:
@ -2367,21 +2382,6 @@ respectively. This is achieved by overriding the "changed" and
(fg-removed-intense "#ff9095")))
#+end_src
* Advanced customization
:properties:
:custom_id: h:f4651d55-8c07-46aa-b52b-bed1e53463bb
:end:
Unlike the predefined customization options which follow a clear pattern
of allowing the user to quickly specify their preference, the themes
also provide a more flexible, albeit difficult, mechanism to control
things with precision ([[#h:bf1c82f2-46c7-4eb2-ad00-dd11fdd8b53f][Customization Options]]).
This section is of interest only to users who are prepared to maintain
their own local tweaks and who are willing to deal with any possible
incompatibilities between versioned releases of the themes. As such,
they are labeled as "do-it-yourself" or "DIY".
** More accurate colors in terminal emulators
:PROPERTIES:
:CUSTOM_ID: h:fbb5e254-afd6-4313-bb05-93b3b4f67358