diff --git a/doc/modus-themes.info b/doc/modus-themes.info index 38080fe..f3de238 100644 --- 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 diff --git a/doc/modus-themes.org b/doc/modus-themes.org index 8d597a0..cc1b40b 100644 --- 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