diff --git a/doc/modus-themes.info b/doc/modus-themes.info index d533afa..c70a675 100644 --- a/doc/modus-themes.info +++ b/doc/modus-themes.info @@ -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: . + +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 one’s 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 @@ theme’s 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 diff --git a/doc/modus-themes.org b/doc/modus-themes.org index 47d3e6c..042382f 100644 --- a/doc/modus-themes.org +++ b/doc/modus-themes.org @@ -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