Document how to override prose colours

2026-09-10 07:16:30 -04:00 · 2023-01-01 07:56:00 +02:00 · 2023-01-01 07:56:00 +02:00 · 70c6ae4386
parent a43682effd
commit 70c6ae4386
2 changed files with 242 additions and 116 deletions
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@ -136,6 +136,7 @@ Stylistic variants using palette overrides
 * Make TODO and DONE more or less intense::
 * Make headings more or less colorful::
 * Make Org agenda more or less colorful::
+* Make inline code in prose use alternative styles::
 * 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.
 * Make mouse highlights more or less colorful::
@ -1327,6 +1328,7 @@ Palette override presets::).
 * Make TODO and DONE more or less intense::
 * Make headings more or less colorful::
 * Make Org agenda more or less colorful::
+* Make inline code in prose use alternative styles::
 * 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.
 * Make mouse highlights more or less colorful::
@ -1859,6 +1861,8 @@ subdue them.

   *note Make headings more or less colorful::.

+   *note Make inline code in prose use alternative styles::.
+
     ;; These overrides are common to all Modus themes.  We also provide
     ;; theme-specific options, such as `modus-operandi-palette-overrides'.
     ;;
@ -1940,7 +1944,7 @@ less intense.
             (overline-heading-1 border)))


-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
+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.10.2.14 Make Org agenda more or less colorful
 ...............................................
@ -1999,9 +2003,68 @@ 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,  Next: Make the region preserve text colors plus other styles,  Prev: Make Org agenda more or less colorful,  Up: Stylistic variants using palette overrides
+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.10.2.15 Make mail citations and headers more or less colorful
+4.10.2.15 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::).
+In the following code block we show how to affect constructs such as
+Org’s verbatim, code, and macro entries.  We also provide mappings for
+tables, property drawers, tags, and code block delimiters, though we do
+not show every possible permutation.
+
+   *note Make TODO and DONE more or less intense::.
+
+     ;; 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.
+
+
+     ;; These are all the mappings at their default values for didactic
+     ;; purposes
+     (setq modus-themes-common-palette-overrides
+           '((prose-block fg-dim)
+             (prose-code green-cooler)
+             (prose-done green)
+             (prose-macro magenta-cooler)
+             (prose-metadata fg-dim)
+             (prose-metadata-value fg-alt)
+             (prose-table fg-alt)
+             (prose-tag magenta-faint)
+             (prose-todo red)
+             (prose-verbatim magenta-warmer)))
+
+     ;; Make code block delimiters use a shade of red, tone down
+     ;; =verbatim=, ~code~, and {{{macro}}}, and amplify the style of
+     ;; property drawers
+     (setq modus-themes-common-palette-overrides
+           '((prose-block red-faint)
+             (prose-code fg-dim)
+             (prose-macro magenta-faint)
+             (prose-metadata cyan)
+             (prose-metadata-value green-warmer)
+             (prose-verbatim fg-dim)))
+
+     ;; Like the above but with more color variety for the inline code
+     ;; elements
+     (setq modus-themes-common-palette-overrides
+           '((prose-block red-faint)
+             (prose-code blue-cooler)
+             (prose-macro yellow-warmer)
+             (prose-metadata cyan)
+             (prose-metadata-value green-warmer)
+             (prose-verbatim red-warmer)))
+
+
+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.10.2.16 Make mail citations and headers more or less colorful
 ...............................................................

 This is one of our practical examples to override the semantic colors of
@ -2067,7 +2130,7 @@ 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.10.2.16 Make the region preserve text colors, plus other styles
+4.10.2.17 Make the region preserve text colors, plus other styles
 .................................................................

 This is one of our practical examples to override the semantic colors of
@ -2104,7 +2167,7 @@ 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.10.2.17 Make mouse highlights more or less colorful
+4.10.2.18 Make mouse highlights more or less colorful
 .....................................................

 This is one of our practical examples to override the semantic colors of
@ -2132,7 +2195,7 @@ 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.10.2.18 Make language underlines less colorful
+4.10.2.19 Make language underlines less colorful
 ................................................

 This is one of our practical examples to override the semantic colors of
@ -2164,7 +2227,7 @@ code linters and prose spell checkers.

 File: modus-themes.info,  Node: Make line numbers use alternative styles,  Prev: Make language underlines less colorful,  Up: Stylistic variants using palette overrides

-4.10.2.19 Make line numbers use alternative styles
+4.10.2.20 Make line numbers use alternative styles
 ..................................................

 This is one of our practical examples to override the semantic colors of
@ -5507,115 +5570,116 @@ B.3 Concept index

 Tag Table:
 Node: Top874
-Node: Overview7650
-Node: How do the themes look like10048
-Node: Learn about the latest changes10407
-Node: Installation10795
-Node: Install manually from source11725
-Node: Install from the archives12550
-Node: Install on GNU/Linux13149
-Node: Debian 11 Bullseye13642
-Node: GNU Guix14052
-Node: Dealing with byte compilation errors14335
-Node: Enable and load15493
-Node: Sample configuration with and without use-package18079
-Node: Differences between loading and enabling20665
-Node: Customization options22703
-Node: Custom reload theme26310
-Node: Bold constructs27308
-Node: Italic constructs28144
-Node: Mixed fonts28915
-Node: Command prompts29911
-Node: Completion UIs31863
-Node: Org mode blocks34863
-Node: Heading styles36743
-Node: UI typeface41325
-Node: Palette overrides42254
-Node: Palette override presets46686
-Node: Stylistic variants using palette overrides49183
-Node: Make the mode line borderless50789
-Node: Make the active mode line colorful51953
-Node: Make the fringe invisible or another color53900
-Node: Make links use subtle or no underlines55396
-Node: Make prompts more or less colorful56399
-Node: Make completion matches more or less colorful58069
-Node: Make comments yellow and strings green61876
-Node: Make code syntax use the old alt-syntax style63785
-Node: Make use of alternative styles for code syntax67072
-Node: Make matching parenthesis more or less intense70740
-Node: Make box buttons more or less gray72182
-Node: Make TODO and DONE more or less intense73494
-Node: Make headings more or less colorful75141
-Node: Make Org agenda more or less colorful77547
-Node: Make mail citations and headers more or less colorful80290
-Node: Make the region preserve text colors plus other styles82980
-Node: Make mouse highlights more or less colorful84748
-Node: Make language underlines less colorful86061
-Node: Make line numbers use alternative styles87513
-Node: Advanced customization89415
-Node: More accurate colors in terminal emulators90865
-Node: Range of color with terminal emulators92106
-Node: Preview theme colors94820
-Node: Per-theme customization settings96557
-Node: Use theme colors in code with modus-themes-with-colors97922
-Node: Add padding to mode line99729
-Node: Remap face with local value102304
-Node: Font configurations for Org and others104725
-Ref: Font configurations for Org and others-Footnote-1107632
-Node: Configure bold and italic faces107819
-Node: Custom Org todo keyword and priority faces111974
-Node: Custom Org emphasis faces115539
-Node: Update Org block delimiter fontification120362
-Node: Measure color contrast122279
-Node: Load theme depending on time of day124977
-Node: Backdrop for pdf-tools125985
-Node: Toggle themes without reloading them128848
-Node: A theme-agnostic hook for theme loading130124
-Node: Custom hl-todo colors132546
-Node: Add support for solaire-mode134071
-Node: Face coverage136982
-Node: Supported packages137434
-Node: Indirectly covered packages142827
-Node: Notes on individual packages144180
-Node: Note on calendarel weekday and weekend colors145280
-Node: Note on git-gutter in Doom Emacs146428
-Node: Note on php-mode multiline comments148772
-Node: Note on underlines in compilation buffers149525
-Node: Note on inline Latex in Org buffers150362
-Node: Note on dimmerel150972
-Node: Note on display-fill-column-indicator-mode152457
-Node: Note on highlight-parenthesesel153856
-Node: Note on mmm-modeel background colors159834
-Node: Note for prism162134
-Node: Note on company-mode overlay pop-up165302
-Ref: Note on company-mode overlay pop-up-Footnote-1166032
-Ref: Note on company-mode overlay pop-up-Footnote-2166099
-Node: Note on ERC escaped color sequences166154
-Ref: Note on ERC escaped color sequences-Footnote-1167582
-Node: Note on powerline or spaceline167692
-Node: Note on SHR colors168106
-Node: Note on SHR fonts168530
-Node: Note on Ement colors and fonts169169
-Node: Note on pdf-tools link hints170679
-Node: Note on the Notmuch logo173139
-Node: Note on goto-address-mode faces173677
-Node: Frequently Asked Questions174789
-Node: Is the contrast ratio about adjacent colors?175420
-Node: What does it mean to avoid exaggerations?176927
-Node: Why are colors mostly variants of blue magenta cyan?178777
-Node: What is the best setup for legibility?183083
-Node: Are these color schemes?185728
-Node: Port the Modus themes to other platforms?189410
-Node: Contributing192182
-Node: Sources of the themes192579
-Node: Issues you can help with193473
-Node: Patches require copyright assignment to the FSF194864
-Node: Acknowledgements197084
-Node: GNU Free Documentation License200857
-Node: Indices226221
-Node: Function index226400
-Node: Variable index227432
-Node: Concept index229258
+Node: Overview7703
+Node: How do the themes look like10101
+Node: Learn about the latest changes10460
+Node: Installation10848
+Node: Install manually from source11778
+Node: Install from the archives12603
+Node: Install on GNU/Linux13202
+Node: Debian 11 Bullseye13695
+Node: GNU Guix14105
+Node: Dealing with byte compilation errors14388
+Node: Enable and load15546
+Node: Sample configuration with and without use-package18132
+Node: Differences between loading and enabling20718
+Node: Customization options22756
+Node: Custom reload theme26363
+Node: Bold constructs27361
+Node: Italic constructs28197
+Node: Mixed fonts28968
+Node: Command prompts29964
+Node: Completion UIs31916
+Node: Org mode blocks34916
+Node: Heading styles36796
+Node: UI typeface41378
+Node: Palette overrides42307
+Node: Palette override presets46739
+Node: Stylistic variants using palette overrides49236
+Node: Make the mode line borderless50895
+Node: Make the active mode line colorful52059
+Node: Make the fringe invisible or another color54006
+Node: Make links use subtle or no underlines55502
+Node: Make prompts more or less colorful56505
+Node: Make completion matches more or less colorful58175
+Node: Make comments yellow and strings green61982
+Node: Make code syntax use the old alt-syntax style63891
+Node: Make use of alternative styles for code syntax67178
+Node: Make matching parenthesis more or less intense70846
+Node: Make box buttons more or less gray72288
+Node: Make TODO and DONE more or less intense73600
+Node: Make headings more or less colorful75309
+Node: Make Org agenda more or less colorful77715
+Node: Make inline code in prose use alternative styles80453
+Node: Make mail citations and headers more or less colorful83018
+Node: Make the region preserve text colors plus other styles85719
+Node: Make mouse highlights more or less colorful87487
+Node: Make language underlines less colorful88800
+Node: Make line numbers use alternative styles90252
+Node: Advanced customization92154
+Node: More accurate colors in terminal emulators93604
+Node: Range of color with terminal emulators94845
+Node: Preview theme colors97559
+Node: Per-theme customization settings99296
+Node: Use theme colors in code with modus-themes-with-colors100661
+Node: Add padding to mode line102468
+Node: Remap face with local value105043
+Node: Font configurations for Org and others107464
+Ref: Font configurations for Org and others-Footnote-1110371
+Node: Configure bold and italic faces110558
+Node: Custom Org todo keyword and priority faces114713
+Node: Custom Org emphasis faces118278
+Node: Update Org block delimiter fontification123101
+Node: Measure color contrast125018
+Node: Load theme depending on time of day127716
+Node: Backdrop for pdf-tools128724
+Node: Toggle themes without reloading them131587
+Node: A theme-agnostic hook for theme loading132863
+Node: Custom hl-todo colors135285
+Node: Add support for solaire-mode136810
+Node: Face coverage139721
+Node: Supported packages140173
+Node: Indirectly covered packages145566
+Node: Notes on individual packages146919
+Node: Note on calendarel weekday and weekend colors148019
+Node: Note on git-gutter in Doom Emacs149167
+Node: Note on php-mode multiline comments151511
+Node: Note on underlines in compilation buffers152264
+Node: Note on inline Latex in Org buffers153101
+Node: Note on dimmerel153711
+Node: Note on display-fill-column-indicator-mode155196
+Node: Note on highlight-parenthesesel156595
+Node: Note on mmm-modeel background colors162573
+Node: Note for prism164873
+Node: Note on company-mode overlay pop-up168041
+Ref: Note on company-mode overlay pop-up-Footnote-1168771
+Ref: Note on company-mode overlay pop-up-Footnote-2168838
+Node: Note on ERC escaped color sequences168893
+Ref: Note on ERC escaped color sequences-Footnote-1170321
+Node: Note on powerline or spaceline170431
+Node: Note on SHR colors170845
+Node: Note on SHR fonts171269
+Node: Note on Ement colors and fonts171908
+Node: Note on pdf-tools link hints173418
+Node: Note on the Notmuch logo175878
+Node: Note on goto-address-mode faces176416
+Node: Frequently Asked Questions177528
+Node: Is the contrast ratio about adjacent colors?178159
+Node: What does it mean to avoid exaggerations?179666
+Node: Why are colors mostly variants of blue magenta cyan?181516
+Node: What is the best setup for legibility?185822
+Node: Are these color schemes?188467
+Node: Port the Modus themes to other platforms?192149
+Node: Contributing194921
+Node: Sources of the themes195318
+Node: Issues you can help with196212
+Node: Patches require copyright assignment to the FSF197603
+Node: Acknowledgements199823
+Node: GNU Free Documentation License203596
+Node: Indices228960
+Node: Function index229139
+Node: Variable index230171
+Node: Concept index231997

 End Tag Table

--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@ -1724,6 +1724,8 @@ to subdue them.

 [[#h:11297984-85ea-4678-abe9-a73aeab4676a][Make headings more or less colorful]].

+[[#h:bb5b396f-5532-4d52-ab13-149ca24854f1][Make inline code in prose use alternative styles]].
+
 #+begin_src emacs-lisp
 ;; These overrides are common to all Modus themes.  We also provide
 ;; theme-specific options, such as `modus-operandi-palette-overrides'.
@ -1871,6 +1873,66 @@ A third example that makes the agenda more blue:
        (date-weekend fg-dim)))
 #+end_src

+**** Make inline code in prose use alternative styles
+:PROPERTIES:
+:CUSTOM_ID: h:bb5b396f-5532-4d52-ab13-149ca24854f1
+: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]]).  In
+the following code block we show how to affect constructs such as
+Org's verbatim, code, and macro entries.  We also provide mappings for
+tables, property drawers, tags, and code block delimiters, though we
+do not show every possible permutation.
+
+[[#h:b57bb50b-a863-4ea8-bb38-6de2275fa868][Make TODO and DONE more or less intense]].
+
+#+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.
+
+
+;; These are all the mappings at their default values for didactic
+;; purposes
+(setq modus-themes-common-palette-overrides
+      '((prose-block fg-dim)
+        (prose-code green-cooler)
+        (prose-done green)
+        (prose-macro magenta-cooler)
+        (prose-metadata fg-dim)
+        (prose-metadata-value fg-alt)
+        (prose-table fg-alt)
+        (prose-tag magenta-faint)
+        (prose-todo red)
+        (prose-verbatim magenta-warmer)))
+
+;; Make code block delimiters use a shade of red, tone down
+;; =verbatim=, ~code~, and {{{macro}}}, and amplify the style of
+;; property drawers
+(setq modus-themes-common-palette-overrides
+      '((prose-block red-faint)
+        (prose-code fg-dim)
+        (prose-macro magenta-faint)
+        (prose-metadata cyan)
+        (prose-metadata-value green-warmer)
+        (prose-verbatim fg-dim)))
+
+;; Like the above but with more color variety for the inline code
+;; elements
+(setq modus-themes-common-palette-overrides
+      '((prose-block red-faint)
+        (prose-code blue-cooler)
+        (prose-macro yellow-warmer)
+        (prose-metadata cyan)
+        (prose-metadata-value green-warmer)
+        (prose-verbatim red-warmer)))
+#+end_src
+
 **** Make mail citations and headers more or less colorful
 :PROPERTIES:
 :CUSTOM_ID: h:7da7a4ad-5d3a-4f11-9796-5a1abed0f0c4