Add documentation on mail citation+header overrides

I don't know about you, but I just found my new favourite: (setq modus-themes-common-palette-overrides '((mail-cite-0 fg-dim) (mail-cite-1 fg-alt) (mail-cite-2 fg-dim) (mail-cite-3 fg-alt) (mail-part yellow-cooler) (mail-recipient green-cooler) (mail-subject red-cooler) (mail-other green)))
2026-09-10 07:16:30 -04:00 · 2022-12-30 17:42:32 +02:00 · 2022-12-30 17:42:32 +02:00 · 1bf2713e1d
parent ae6cc7ed14
commit 1bf2713e1d
2 changed files with 243 additions and 105 deletions
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@ -137,6 +137,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 mail citations and headers more or less colorful::

 Advanced customization

@ -1377,6 +1378,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 mail citations and headers more or less colorful::


 File: modus-themes.info,  Node: Make the mode line borderless,  Next: Make the fringe invisible or another color,  Up: Stylistic variants using palette overrides
@ -1981,7 +1983,7 @@ less intense.
             (overline-heading-1 border)))


-File: modus-themes.info,  Node: Make Org agenda 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 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
 ...............................................
@ -2039,6 +2041,72 @@ what we show in the other chapters with practical stylistic variants.
             (date-weekday fg-main)
             (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
+
+4.11.2.15 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::).
+In this section we show how to change the coloration of email message
+headers and citations.  Before we show the code, this is the anatomy of
+a message:
+
+     From: Protesilaos <info@protesilaos.com>
+     To: Modus-Themes Development <~protesilaos/modus-themes@lists.sr.ht>
+     Subject: Test subject
+     --- Headers above this line; message and citations below ---
+     This is some sample text
+
+     > > Older quote
+     > Newer quote
+
+   We thus have the following:
+
+     ;; 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.
+
+
+     ;; Reduce the intensity of mail citations and headers
+     (setq modus-themes-common-palette-overrides
+           '((mail-cite-0 cyan-faint)
+             (mail-cite-1 yellow-faint)
+             (mail-cite-2 green-faint)
+             (mail-cite-3 red-faint)
+             (mail-part olive)
+             (mail-recipient indigo)
+             (mail-subject maroon)
+             (mail-other slate)))
+
+     ;; Make mail citations more intense; adjust the headers accordingly
+     (setq modus-themes-common-palette-overrides
+           '((mail-cite-0 blue)
+             (mail-cite-1 yellow)
+             (mail-cite-2 green)
+             (mail-cite-3 magenta)
+             (mail-part magenta-cooler)
+             (mail-recipient cyan)
+             (mail-subject red-warmer)
+             (mail-other cyan-cooler)))
+
+     ;; Make all citations faint and neutral; make most headers green but
+     ;; use red for the subject lie so that it stands out
+     (setq modus-themes-common-palette-overrides
+           '((mail-cite-0 fg-dim)
+             (mail-cite-1 fg-alt)
+             (mail-cite-2 fg-dim)
+             (mail-cite-3 fg-alt)
+             (mail-part yellow-cooler)
+             (mail-recipient green-cooler)
+             (mail-subject red-cooler)
+             (mail-other green)))
+

 File: modus-themes.info,  Node: Advanced customization,  Next: Face coverage,  Prev: Customization options,  Up: Top

@ -5296,110 +5364,111 @@ B.3 Concept index

 Tag Table:
 Node: Top874
-Node: Overview7405
-Node: How do the themes look like9803
-Node: Learn about the latest changes10162
-Node: Installation10550
-Node: Install manually from source11480
-Node: Install from the archives12305
-Node: Install on GNU/Linux12904
-Node: Debian 11 Bullseye13397
-Node: GNU Guix13807
-Node: Dealing with byte compilation errors14090
-Node: Enable and load15248
-Node: Sample configuration with and without use-package17938
-Node: Differences between loading and enabling20736
-Node: Customization options22782
-Node: Custom reload theme26720
-Node: Bold constructs27718
-Node: Italic constructs28554
-Node: Mixed fonts29325
-Node: Command prompts30321
-Node: Completion UIs32273
-Node: Active region35271
-Node: Org mode blocks36696
-Node: Heading styles38575
-Node: UI typeface43157
-Node: Palette overrides44088
-Node: Palette override presets48520
-Node: Stylistic variants using palette overrides51017
-Node: Make the mode line borderless52314
-Node: Make the fringe invisible or another color53448
-Node: Make the active mode line colorful54935
-Node: Make links use subtle or no underlines56853
-Node: Make prompts more or less colorful57848
-Node: Make completion matches more or less colorful59518
-Node: Make comments yellow and strings green63325
-Node: Make code syntax use the old alt-syntax style65234
-Node: Make use of alternative styles for code syntax68521
-Node: Make matching parenthesis more or less intense72189
-Node: Make box buttons more or less gray73631
-Node: Make TODO and DONE more or less intense74943
-Node: Make headings more or less colorful76590
-Node: Make Org agenda more or less colorful78996
-Node: Advanced customization81677
-Node: More accurate colors in terminal emulators83106
-Node: Range of color with terminal emulators84347
-Node: Preview theme colors87061
-Node: Per-theme customization settings88798
-Node: Use the theme colors in custom code (modus-themes-with-colors)90171
-Node: Remap face with local value92005
-Node: Font configurations for Org and others94472
-Ref: Font configurations for Org and others-Footnote-197379
-Node: Configure bold and italic faces97566
-Node: Custom Org todo keyword and priority faces101729
-Node: Custom Org emphasis faces105292
-Node: Update Org block delimiter fontification110115
-Node: Measure color contrast112032
-Node: Load theme depending on time of day114730
-Node: Backdrop for pdf-tools115738
-Node: Toggle themes without reloading them118601
-Node: A theme-agnostic hook for theme loading119877
-Node: Custom hl-todo colors122299
-Node: Add support for solaire-mode123824
-Node: Face coverage126743
-Node: Supported packages127195
-Node: Indirectly covered packages132588
-Node: Notes on individual packages133941
-Node: Note on calendarel weekday and weekend colors135041
-Node: Note on git-gutter in Doom Emacs136189
-Node: Note on php-mode multiline comments138541
-Node: Note on underlines in compilation buffers139294
-Node: Note on inline Latex in Org buffers140131
-Node: Note on dimmerel140741
-Node: Note on display-fill-column-indicator-mode142226
-Node: Note on highlight-parenthesesel143633
-Node: Note on mmm-modeel background colors149611
-Node: Note for prism151919
-Node: Note on company-mode overlay pop-up155095
-Ref: Note on company-mode overlay pop-up-Footnote-1155825
-Ref: Note on company-mode overlay pop-up-Footnote-2155892
-Node: Note on ERC escaped color sequences155947
-Ref: Note on ERC escaped color sequences-Footnote-1157375
-Node: Note on powerline or spaceline157485
-Node: Note on SHR colors157899
-Node: Note on SHR fonts158323
-Node: Note on Ement colors and fonts158962
-Node: Note on pdf-tools link hints160472
-Node: Note on the Notmuch logo162932
-Node: Note on goto-address-mode faces163470
-Node: Frequently Asked Questions164582
-Node: Is the contrast ratio about adjacent colors?165213
-Node: What does it mean to avoid exaggerations?166720
-Node: Why are colors mostly variants of blue magenta cyan?168570
-Node: What is the best setup for legibility?172876
-Node: Are these color schemes?175521
-Node: Port the Modus themes to other platforms?179203
-Node: Contributing181975
-Node: Sources of the themes182372
-Node: Issues you can help with183266
-Node: Patches require copyright assignment to the FSF184657
-Node: Acknowledgements186877
-Node: GNU Free Documentation License190650
-Node: Indices216014
-Node: Function index216193
-Node: Variable index217233
-Node: Concept index219132
+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

 End Tag Table

--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@ -1926,6 +1926,75 @@ A third example that makes the agenda more blue:
        (date-weekend fg-dim)))
 #+end_src

+**** Make mail citations and headers more or less colorful
+:PROPERTIES:
+:CUSTOM_ID: h:7da7a4ad-5d3a-4f11-9796-5a1abed0f0c4
+: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
+this section we show how to change the coloration of email message
+headers and citations.  Before we show the code, this is the anatomy
+of a message:
+
+#+begin_example message
+From: Protesilaos <info@protesilaos.com>
+To: Modus-Themes Development <~protesilaos/modus-themes@lists.sr.ht>
+Subject: Test subject
+--- Headers above this line; message and citations below ---
+This is some sample text
+
+> > Older quote
+> Newer quote
+#+end_example
+
+We thus have the following:
+
+#+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.
+
+
+;; Reduce the intensity of mail citations and headers
+(setq modus-themes-common-palette-overrides
+      '((mail-cite-0 cyan-faint)
+        (mail-cite-1 yellow-faint)
+        (mail-cite-2 green-faint)
+        (mail-cite-3 red-faint)
+        (mail-part olive)
+        (mail-recipient indigo)
+        (mail-subject maroon)
+        (mail-other slate)))
+
+;; Make mail citations more intense; adjust the headers accordingly
+(setq modus-themes-common-palette-overrides
+      '((mail-cite-0 blue)
+        (mail-cite-1 yellow)
+        (mail-cite-2 green)
+        (mail-cite-3 magenta)
+        (mail-part magenta-cooler)
+        (mail-recipient cyan)
+        (mail-subject red-warmer)
+        (mail-other cyan-cooler)))
+
+;; Make all citations faint and neutral; make most headers green but
+;; use red for the subject lie so that it stands out
+(setq modus-themes-common-palette-overrides
+      '((mail-cite-0 fg-dim)
+        (mail-cite-1 fg-alt)
+        (mail-cite-2 fg-dim)
+        (mail-cite-3 fg-alt)
+        (mail-part yellow-cooler)
+        (mail-recipient green-cooler)
+        (mail-subject red-cooler)
+        (mail-other green)))
+#+end_src
+
 * Advanced customization
 :properties:
 :custom_id: h:f4651d55-8c07-46aa-b52b-bed1e53463bb