diff --git a/doc/modus-themes.info b/doc/modus-themes.info index 7c5905e..23d814a 100644 --- 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 + 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 diff --git a/doc/modus-themes.org b/doc/modus-themes.org index 4633f14..c52a76b 100644 --- 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 +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