emacs/protesilaos.modus-themes
1
0
Fork 0
mirror of https://github.com/protesilaos/modus-themes.git synced 2026-09-10 07:16:30 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

Document how to change region with overrides (also see 32dc7f9)

Browse source 
The 'modus-themes-region' option is deprecated, so we know follow this
approach with the overrides.
This commit is contained in:
Protesilaos Stavrou 2022-12-30 19:05:20 +02:00
parent 32dc7f9bc1
commit 687a7941e3
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
2 changed files with 213 additions and 192 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

367
doc/modus-themes.info
View file

@ -110,7 +110,6 @@ Customization options
* Mixed fonts:: Toggle mixing of font families
* Command prompts:: Control the style of command prompts
* Completion UIs:: Choose among several styles for completion UIs
* Active region:: Choose between various styles for the active region
* Org mode blocks:: Choose among plain, gray, or tinted backgrounds
* Heading styles:: Choose among several styles, also per heading level
* UI typeface:: Toggle the use of variable-pitch across the User Interface
@ -138,6 +137,7 @@ Stylistic variants using palette overrides
* Make headings more or less colorful::
* Make Org agenda more or less colorful::
* Make mail citations and headers more or less colorful::
* Make the region preserve text colors, plus other styles: Make the region preserve text colors plus other styles.
Advanced customization
@ -466,8 +466,7 @@ Customization options.). Reload a theme for new changes to take effect.
;; Add all your customizations prior to loading the themes.
(setq modus-themes-italic-constructs t
modus-themes-bold-constructs nil
modus-themes-region '(bg-only no-extend))
modus-themes-bold-constructs nil)
;; Load the theme of your choice.
(load-theme 'modus-operandi)
@ -484,8 +483,7 @@ Customization options.). Reload a theme for new changes to take effect.
;; Add all your customizations prior to loading the themes
(setq modus-themes-italic-constructs t
modus-themes-bold-constructs nil
modus-themes-region '(bg-only no-extend))
modus-themes-bold-constructs nil)
;; Load the theme of your choice.
(load-theme 'modus-operandi :no-confim)
@ -516,8 +514,7 @@ package configurations in their setup. We use this as an example:
:init
;; Add all your customizations prior to loading the themes
(setq modus-themes-italic-constructs t
modus-themes-bold-constructs nil
modus-themes-region '(bg-only no-extend))
modus-themes-bold-constructs nil)
:config
;; Load the theme of your choice.
(load-theme 'modus-operandi)
@ -531,8 +528,7 @@ package configurations in their setup. We use this as an example:
:init
;; Add all your customizations prior to loading the themes
(setq modus-themes-italic-constructs t
modus-themes-bold-constructs nil
modus-themes-region '(bg-only no-extend))
modus-themes-bold-constructs nil)
:config
;; Load the theme of your choice.
(load-theme 'modus-operandi :no-confim)
@ -543,8 +539,7 @@ package configurations in their setup. We use this as an example:
;;; For the built-in themes which cannot use `require':
;; Add all your customizations prior to loading the themes
(setq modus-themes-italic-constructs t
modus-themes-bold-constructs nil
modus-themes-region '(bg-only no-extend))
modus-themes-bold-constructs nil)
;; Load the theme of your choice:
(load-theme 'modus-operandi) ;; OR (load-theme 'modus-vivendi)
@ -558,8 +553,7 @@ package configurations in their setup. We use this as an example:
;; Add all your customizations prior to loading the themes
(setq modus-themes-italic-constructs t
modus-themes-bold-constructs nil
modus-themes-region '(bg-only no-extend))
modus-themes-bold-constructs nil)
;; Load the theme of your choice:
(load-theme 'modus-operandi :no-confim) ;; OR (load-theme 'modus-vivendi :no-confim)
@ -665,11 +659,6 @@ active, it must be reloaded for changes to take effect.
'((matches . (extrabold))
(selection . (semibold italic text-also)))
;; Options for `modus-themes-region' are either nil (the default),
;; or a list of properties that may include any of those symbols:
;; `no-extend', `bg-only'.
modus-themes-region '(bg-only no-extend)
modus-themes-org-blocks 'gray-background ; {nil,'gray-background,'tinted-background}
;; The `modus-themes-headings' is an alist: read the manual's
@ -695,7 +684,6 @@ active, it must be reloaded for changes to take effect.
* Mixed fonts:: Toggle mixing of font families
* Command prompts:: Control the style of command prompts
* Completion UIs:: Choose among several styles for completion UIs
* Active region:: Choose between various styles for the active region
* Org mode blocks:: Choose among plain, gray, or tinted backgrounds
* Heading styles:: Choose among several styles, also per heading level
* UI typeface:: Toggle the use of variable-pitch across the User Interface
@ -873,7 +861,7 @@ in these examples:
*note Make prompts more or less colorful::.

File: modus-themes.info, Node: Completion UIs, Next: Active region, Prev: Command prompts, Up: Customization options
File: modus-themes.info, Node: Completion UIs, Next: Org mode blocks, Prev: Command prompts, Up: Customization options
4.6 Option for completion framework aesthetics
==============================================
@ -943,51 +931,9 @@ across all keys that are not explicitly referenced. For example, this:
*note Make completion matches more or less colorful::.

File: modus-themes.info, Node: Active region, Next: Org mode blocks, Prev: Completion UIs, Up: Customization options
File: modus-themes.info, Node: Org mode blocks, Next: Heading styles, Prev: Completion UIs, Up: Customization options
4.7 Option for active region
============================
[ Simplified as part of 4.0.0-dev. It no longer accepts an ‘accented’
symbol. Changes to colors can be implemented via the overrides. ]
Brief: Control the style of the region.
Symbol: ‘modus-themes-region’ (‘choice’ type, list of properties)
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
symbols:
• ‘no-extend’
• ‘bg-only’
The default (a ‘nil’ value or an empty list) is a prominent gray
background that overrides all foreground colors in the area it
encompasses. Its reach extends to the edge of the window.
The ‘no-extend’ property limits the region to the end of the line, so
that it does not reach the edge of the window.
The ‘bg-only’ property makes the region’s background color more
subtle to allow the underlying text to retain its foreground colors.
Combinations of any of those properties are expressed as a list, like
in these examples:
(no-extend)
(bg-only no-extend)
The order in which the properties are set is not significant.
In user configuration files the form may look like this:
(setq modus-themes-region '(bg-only no-extend))

File: modus-themes.info, Node: Org mode blocks, Next: Heading styles, Prev: Active region, Up: Customization options
4.8 Option for org-mode block styles
4.7 Option for org-mode block styles
====================================
Brief: Set the overall style of Org code blocks, quotes, and the like.
@ -1031,7 +977,7 @@ non-nil. While quote/verse blocks require setting

File: modus-themes.info, Node: Heading styles, Next: UI typeface, Prev: Org mode blocks, Up: Customization options
4.9 Option for the headings’ overall style
4.8 Option for the headings’ overall style
==========================================
[ Refactored with breaking changes as part of 4.0.0-dev. Removed the
@ -1147,8 +1093,8 @@ done in older versions of the themes).

File: modus-themes.info, Node: UI typeface, Next: Palette overrides, Prev: Heading styles, Up: Customization options
4.10 Option for variable-pitch font in UI elements
==================================================
4.9 Option for variable-pitch font in UI elements
=================================================
Brief: Toggle the use of proportionately spaced (‘variable-pitch’) fonts
in the User Interface.
@ -1176,7 +1122,7 @@ items.

File: modus-themes.info, Node: Palette overrides, Prev: UI typeface, Up: Customization options
4.11 Option for palette overrides
4.10 Option for palette overrides
=================================
This section describes palette overrides in detail. For a simpler
@ -1297,7 +1243,7 @@ watch:

File: modus-themes.info, Node: Palette override presets, Next: Stylistic variants using palette overrides, Up: Palette overrides
4.11.1 Palette override presets
4.10.1 Palette override presets
-------------------------------
This section shows how to refashion the themes by opting in to the
@ -1351,7 +1297,7 @@ the general idea (extra space for didactic purposes):

File: modus-themes.info, Node: Stylistic variants using palette overrides, Prev: Palette override presets, Up: Palette overrides
4.11.2 Stylistic variants using palette overrides
4.10.2 Stylistic variants using palette overrides
-------------------------------------------------
This section contains practical examples of overriding the palette of
@ -1379,11 +1325,12 @@ Palette override presets::).
* Make headings more or less colorful::
* Make Org agenda more or less colorful::
* Make mail citations and headers more or less colorful::
* Make the region preserve text colors, plus other styles: Make the region preserve text colors plus other styles.

File: modus-themes.info, Node: Make the mode line borderless, Next: Make the fringe invisible or another color, Up: Stylistic variants using palette overrides
4.11.2.1 Make the mode line borderless
4.10.2.1 Make the mode line borderless
......................................
This is one of our practical examples to override the semantic colors of
@ -1408,7 +1355,7 @@ set their color to that of the underlying background.

File: modus-themes.info, Node: Make the fringe invisible or another color, Next: Make the active mode line colorful, Prev: Make the mode line borderless, Up: Stylistic variants using palette overrides
4.11.2.2 Make the fringe invisible or another color
4.10.2.2 Make the fringe invisible or another color
...................................................
This is one of our practical examples to override the semantic colors of
@ -1441,7 +1388,7 @@ or continuation lines.

File: modus-themes.info, Node: Make the active mode line colorful, Next: Make links use subtle or no underlines, Prev: Make the fringe invisible or another color, Up: Stylistic variants using palette overrides
4.11.2.3 Make the active mode line colorful
4.10.2.3 Make the active mode line colorful
...........................................
This is one of our practical examples to override the semantic colors of
@ -1481,7 +1428,7 @@ blue mode line for ‘modus-operandi’ and a red one for ‘modus-vivendi’.

File: modus-themes.info, Node: Make links use subtle or no underlines, Next: Make prompts more or less colorful, Prev: Make the active mode line colorful, Up: Stylistic variants using palette overrides
4.11.2.4 Make links use subtle or no underlines
4.10.2.4 Make links use subtle or no underlines
...............................................
This is one of our practical examples to override the semantic colors of
@ -1504,7 +1451,7 @@ 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.5 Make prompts more or less colorful
4.10.2.5 Make prompts more or less colorful
...........................................
This section contains practical examples of overriding the palette of
@ -1541,7 +1488,7 @@ 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.6 Make completion matches more or less colorful
4.10.2.6 Make completion matches more or less colorful
......................................................
This section contains practical examples of overriding the palette of
@ -1624,7 +1571,7 @@ 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.7 Make comments yellow and strings green
4.10.2.7 Make comments yellow and strings green
...............................................
This is one of our practical examples to override the semantic colors of
@ -1666,7 +1613,7 @@ 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.8 Make code syntax use the old alt-syntax style
4.10.2.8 Make code syntax use the old alt-syntax style
......................................................
This is one of our practical examples to override the semantic colors of
@ -1746,7 +1693,7 @@ 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.9 Make use of alternative styles for code syntax
4.10.2.9 Make use of alternative styles for code syntax
.......................................................
This is one of our practical examples to override the semantic colors of
@ -1836,7 +1783,7 @@ 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.10 Make matching parenthesis more or less intense
4.10.2.10 Make matching parenthesis more or less intense
........................................................
This is one of our practical examples to override the semantic colors of
@ -1865,7 +1812,7 @@ 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.11 Make box buttons more or less gray
4.10.2.11 Make box buttons more or less gray
............................................
This is one of our practical examples to override the semantic colors of
@ -1891,7 +1838,7 @@ 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.12 Make TODO and DONE more or less intense
4.10.2.12 Make TODO and DONE more or less intense
.................................................
This is one of our practical examples to override the semantic colors of
@ -1928,7 +1875,7 @@ 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.13 Make headings more or less colorful
4.10.2.13 Make headings more or less colorful
.............................................
This is one of our practical examples to override the semantic colors of
@ -1985,7 +1932,7 @@ less intense.

File: modus-themes.info, Node: Make Org agenda more or less colorful, Next: Make mail citations and headers more or less colorful, Prev: Make headings more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.14 Make Org agenda more or less colorful
4.10.2.14 Make Org agenda more or less colorful
...............................................
This is one of our practical examples to override the semantic colors of
@ -2042,9 +1989,9 @@ what we show in the other chapters with practical stylistic variants.
(date-weekend fg-dim)))

File: modus-themes.info, Node: Make mail citations and headers more or less colorful, Prev: Make Org agenda more or less colorful, Up: Stylistic variants using palette overrides
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 Org agenda more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.15 Make mail citations and headers more or less colorful
4.10.2.15 Make mail citations and headers more or less colorful
...............................................................
This is one of our practical examples to override the semantic colors of
@ -2107,6 +2054,43 @@ a message:
(mail-subject red-cooler)
(mail-other green)))

File: modus-themes.info, Node: Make the region preserve text colors plus other styles, Prev: Make mail citations and headers more or less colorful, Up: Stylistic variants using palette overrides
4.10.2.16 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::).
Here we show how to make the region respect the underlying text colors
or how to make the background more/less intense while combining it with
an appropriate foreground value.
;; These overrides are common to all Modus themes. We also provide
;; theme-specific options, such as `modus-operandi-palette-overrides'.
;;
;; In general, the theme-specific overrides are better for overriding
;; color values, such as redefining what `blue-faint' looks like. The
;; common overrides are best used for changes to semantic color
;; mappings, as we show below.
;; A background with no specific foreground (use foreground of
;; underlying text)
(setq modus-themes-common-palette-overrides
'((bg-region bg-ochre) ; try to replace `bg-ochre' with `bg-lavender', `bg-sage'
(fg-region unspecified)))
;; Subtle gray with a prominent blue foreground
(setq modus-themes-common-palette-overrides
'((bg-region bg-dim)
(fg-region blue-cooler)))
;; Intense magenta background combined with the main foreground
(setq modus-themes-common-palette-overrides
'((bg-region bg-magenta-intense)
(fg-region fg-main)))

File: modus-themes.info, Node: Advanced customization, Next: Face coverage, Prev: Customization options, Up: Top
@ -5286,7 +5270,6 @@ B.2 Variable index
* modus-themes-preset-overrides-intense: Palette override presets.
(line 24)
* modus-themes-prompts: Command prompts. (line 6)
* modus-themes-region: Active region. (line 6)
* modus-themes-variable-pitch-ui: UI typeface. (line 6)
* modus-vivendi-deuteranopia-palette-overrides: Palette overrides.
(line 38)
@ -5364,111 +5347,111 @@ B.3 Concept index

Tag Table:
Node: Top874
Node: Overview7463
Node: How do the themes look like9861
Node: Learn about the latest changes10220
Node: Installation10608
Node: Install manually from source11538
Node: Install from the archives12363
Node: Install on GNU/Linux12962
Node: Debian 11 Bullseye13455
Node: GNU Guix13865
Node: Dealing with byte compilation errors14148
Node: Enable and load15306
Node: Sample configuration with and without use-package17996
Node: Differences between loading and enabling20794
Node: Customization options22840
Node: Custom reload theme26778
Node: Bold constructs27776
Node: Italic constructs28612
Node: Mixed fonts29383
Node: Command prompts30379
Node: Completion UIs32331
Node: Active region35329
Node: Org mode blocks36754
Node: Heading styles38633
Node: UI typeface43215
Node: Palette overrides44146
Node: Palette override presets48578
Node: Stylistic variants using palette overrides51075
Node: Make the mode line borderless52430
Node: Make the fringe invisible or another color53564
Node: Make the active mode line colorful55051
Node: Make links use subtle or no underlines56969
Node: Make prompts more or less colorful57964
Node: Make completion matches more or less colorful59634
Node: Make comments yellow and strings green63441
Node: Make code syntax use the old alt-syntax style65350
Node: Make use of alternative styles for code syntax68637
Node: Make matching parenthesis more or less intense72305
Node: Make box buttons more or less gray73747
Node: Make TODO and DONE more or less intense75059
Node: Make headings more or less colorful76706
Node: Make Org agenda more or less colorful79112
Node: Make mail citations and headers more or less colorful81855
Node: Advanced customization84482
Node: More accurate colors in terminal emulators85911
Node: Range of color with terminal emulators87152
Node: Preview theme colors89866
Node: Per-theme customization settings91603
Node: Use the theme colors in custom code (modus-themes-with-colors)92976
Node: Remap face with local value94810
Node: Font configurations for Org and others97277
Ref: Font configurations for Org and others-Footnote-1100184
Node: Configure bold and italic faces100371
Node: Custom Org todo keyword and priority faces104534
Node: Custom Org emphasis faces108097
Node: Update Org block delimiter fontification112920
Node: Measure color contrast114837
Node: Load theme depending on time of day117535
Node: Backdrop for pdf-tools118543
Node: Toggle themes without reloading them121406
Node: A theme-agnostic hook for theme loading122682
Node: Custom hl-todo colors125104
Node: Add support for solaire-mode126629
Node: Face coverage129548
Node: Supported packages130000
Node: Indirectly covered packages135393
Node: Notes on individual packages136746
Node: Note on calendarel weekday and weekend colors137846
Node: Note on git-gutter in Doom Emacs138994
Node: Note on php-mode multiline comments141346
Node: Note on underlines in compilation buffers142099
Node: Note on inline Latex in Org buffers142936
Node: Note on dimmerel143546
Node: Note on display-fill-column-indicator-mode145031
Node: Note on highlight-parenthesesel146438
Node: Note on mmm-modeel background colors152416
Node: Note for prism154724
Node: Note on company-mode overlay pop-up157900
Ref: Note on company-mode overlay pop-up-Footnote-1158630
Ref: Note on company-mode overlay pop-up-Footnote-2158697
Node: Note on ERC escaped color sequences158752
Ref: Note on ERC escaped color sequences-Footnote-1160180
Node: Note on powerline or spaceline160290
Node: Note on SHR colors160704
Node: Note on SHR fonts161128
Node: Note on Ement colors and fonts161767
Node: Note on pdf-tools link hints163277
Node: Note on the Notmuch logo165737
Node: Note on goto-address-mode faces166275
Node: Frequently Asked Questions167387
Node: Is the contrast ratio about adjacent colors?168018
Node: What does it mean to avoid exaggerations?169525
Node: Why are colors mostly variants of blue magenta cyan?171375
Node: What is the best setup for legibility?175681
Node: Are these color schemes?178326
Node: Port the Modus themes to other platforms?182008
Node: Contributing184780
Node: Sources of the themes185177
Node: Issues you can help with186071
Node: Patches require copyright assignment to the FSF187462
Node: Acknowledgements189682
Node: GNU Free Documentation License193455
Node: Indices218819
Node: Function index218998
Node: Variable index220038
Node: Concept index221937
Node: Overview7493
Node: How do the themes look like9891
Node: Learn about the latest changes10250
Node: Installation10638
Node: Install manually from source11568
Node: Install from the archives12393
Node: Install on GNU/Linux12992
Node: Debian 11 Bullseye13485
Node: GNU Guix13895
Node: Dealing with byte compilation errors14178
Node: Enable and load15336
Node: Sample configuration with and without use-package17922
Node: Differences between loading and enabling20508
Node: Customization options22554
Node: Custom reload theme26161
Node: Bold constructs27159
Node: Italic constructs27995
Node: Mixed fonts28766
Node: Command prompts29762
Node: Completion UIs31714
Node: Org mode blocks34714
Node: Heading styles36594
Node: UI typeface41176
Node: Palette overrides42105
Node: Palette override presets46537
Node: Stylistic variants using palette overrides49034
Node: Make the mode line borderless50504
Node: Make the fringe invisible or another color51638
Node: Make the active mode line colorful53125
Node: Make links use subtle or no underlines55043
Node: Make prompts more or less colorful56038
Node: Make completion matches more or less colorful57708
Node: Make comments yellow and strings green61515
Node: Make code syntax use the old alt-syntax style63424
Node: Make use of alternative styles for code syntax66711
Node: Make matching parenthesis more or less intense70379
Node: Make box buttons more or less gray71821
Node: Make TODO and DONE more or less intense73133
Node: Make headings more or less colorful74780
Node: Make Org agenda more or less colorful77186
Node: Make mail citations and headers more or less colorful79929
Node: Make the region preserve text colors plus other styles82619
Node: Advanced customization84335
Node: More accurate colors in terminal emulators85764
Node: Range of color with terminal emulators87005
Node: Preview theme colors89719
Node: Per-theme customization settings91456
Node: Use the theme colors in custom code (modus-themes-with-colors)92829
Node: Remap face with local value94663
Node: Font configurations for Org and others97130
Ref: Font configurations for Org and others-Footnote-1100037
Node: Configure bold and italic faces100224
Node: Custom Org todo keyword and priority faces104387
Node: Custom Org emphasis faces107950
Node: Update Org block delimiter fontification112773
Node: Measure color contrast114690
Node: Load theme depending on time of day117388
Node: Backdrop for pdf-tools118396
Node: Toggle themes without reloading them121259
Node: A theme-agnostic hook for theme loading122535
Node: Custom hl-todo colors124957
Node: Add support for solaire-mode126482
Node: Face coverage129401
Node: Supported packages129853
Node: Indirectly covered packages135246
Node: Notes on individual packages136599
Node: Note on calendarel weekday and weekend colors137699
Node: Note on git-gutter in Doom Emacs138847
Node: Note on php-mode multiline comments141199
Node: Note on underlines in compilation buffers141952
Node: Note on inline Latex in Org buffers142789
Node: Note on dimmerel143399
Node: Note on display-fill-column-indicator-mode144884
Node: Note on highlight-parenthesesel146291
Node: Note on mmm-modeel background colors152269
Node: Note for prism154577
Node: Note on company-mode overlay pop-up157753
Ref: Note on company-mode overlay pop-up-Footnote-1158483
Ref: Note on company-mode overlay pop-up-Footnote-2158550
Node: Note on ERC escaped color sequences158605
Ref: Note on ERC escaped color sequences-Footnote-1160033
Node: Note on powerline or spaceline160143
Node: Note on SHR colors160557
Node: Note on SHR fonts160981
Node: Note on Ement colors and fonts161620
Node: Note on pdf-tools link hints163130
Node: Note on the Notmuch logo165590
Node: Note on goto-address-mode faces166128
Node: Frequently Asked Questions167240
Node: Is the contrast ratio about adjacent colors?167871
Node: What does it mean to avoid exaggerations?169378
Node: Why are colors mostly variants of blue magenta cyan?171228
Node: What is the best setup for legibility?175534
Node: Are these color schemes?178179
Node: Port the Modus themes to other platforms?181861
Node: Contributing184633
Node: Sources of the themes185030
Node: Issues you can help with185924
Node: Patches require copyright assignment to the FSF187315
Node: Acknowledgements189535
Node: GNU Free Documentation License193308
Node: Indices218672
Node: Function index218851
Node: Variable index219891
Node: Concept index221717

End Tag Table

38
doc/modus-themes.org
View file

@ -1936,6 +1936,44 @@ We thus have the following:
(mail-other green)))
#+end_src
**** Make the region preserve text colors, plus other styles
:PROPERTIES:
:CUSTOM_ID: h:c8605d37-66e1-42aa-986e-d7514c3af6fe
:END:
This is one of our practical examples to override the semantic colors
of the Modus themes ([[#h:df1199d8-eaba-47db-805d-6b568a577bf3][Stylistic variants using palette overrides]]).
Here we show how to make the region respect the underlying text colors
or how to make the background more/less intense while combining it
with an appropriate foreground value.
#+begin_src emacs-lisp
;; These overrides are common to all Modus themes. We also provide
;; theme-specific options, such as `modus-operandi-palette-overrides'.
;;
;; In general, the theme-specific overrides are better for overriding
;; color values, such as redefining what `blue-faint' looks like. The
;; common overrides are best used for changes to semantic color
;; mappings, as we show below.
;; A background with no specific foreground (use foreground of
;; underlying text)
(setq modus-themes-common-palette-overrides
'((bg-region bg-ochre) ; try to replace `bg-ochre' with `bg-lavender', `bg-sage'
(fg-region unspecified)))
;; Subtle gray with a prominent blue foreground
(setq modus-themes-common-palette-overrides
'((bg-region bg-dim)
(fg-region blue-cooler)))
;; Intense magenta background combined with the main foreground
(setq modus-themes-common-palette-overrides
'((bg-region bg-magenta-intense)
(fg-region fg-main)))
#+end_src
* Advanced customization
:properties:
:custom_id: h:f4651d55-8c07-46aa-b52b-bed1e53463bb