Add semantic mappings for inline code backgrounds in addition to foregrounds; plus docs

This commit is contained in:
Protesilaos Stavrou 2024-03-17 08:20:29 +02:00
parent 7384dbf264
commit d33c545153
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
10 changed files with 246 additions and 177 deletions

View file

@ -2289,6 +2289,9 @@ contents and for the delimiter lines (the #+begin_ and #+end_
parts). The text of the delimiter lines is a subtle gray foreground
color.
*note Make inline code in prose use alternative styles: DIY Make
inline code in prose use alternative styles.
;; Make code blocks (in Org, for example) use a more colorful style
;; for their delimiter lines as well as their contents. Give this a
;; purple feel. Make the delimiter lines distinct from the contents.
@ -2447,42 +2450,42 @@ 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: DIY Make TODO and DONE
more or less intense.
• *note Make TODO and DONE more or less intense: DIY Make TODO and
DONE more or less intense.
• *note DIY Make Org block colors more or less colorful::.
;; These are all the mappings at their default values for didactic
;; purposes
;; A nuanced accented background, combined with a suitable foreground.
(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)))
'((bg-prose-code bg-green-nuanced)
(fg-prose-code green-cooler)
;; 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)))
(bg-prose-verbatim bg-magenta-nuanced)
(fg-prose-verbatim magenta-warmer)
;; Like the above but with more color variety for the inline code
;; elements
(bg-prose-macro bg-blue-nuanced)
(fg-prose-macro magenta-cooler)))
;; A more noticeable accented background, combined with a suitable foreground.
(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)))
'((bg-prose-code bg-sage)
(fg-prose-code green-faint)
(bg-prose-verbatim bg-ochre)
(fg-prose-verbatim red-faint)
(bg-prose-macro bg-lavender)
(fg-prose-macro blue-faint)))
;; Leave the backgrounds without a color and simply make the foregrounds more intense.
(setq modus-themes-common-palette-overrides
'((bg-prose-code unspecified)
(fg-prose-code green-intense)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-intense)
(bg-prose-macro unspecified)
(fg-prose-macro cyan-intense)))
Reload the theme for changes to take effect.
@ -6326,79 +6329,79 @@ Node: DIY Make box buttons more or less gray87569
Node: DIY Make TODO and DONE more or less intense88582
Node: DIY Make headings more or less colorful90083
Node: DIY Make Org block colors more or less colorful92200
Node: DIY Make Org agenda more or less colorful96460
Node: DIY Make inline code in prose use alternative styles99635
Node: DIY Make mail citations and headers more or less colorful101925
Node: DIY Make the region preserve text colors plus other styles104325
Node: DIY Make mouse highlights more or less colorful105881
Node: DIY Make language underlines less colorful106894
Node: DIY Make line numbers use alternative styles108046
Node: DIY Make diffs use only a foreground109689
Node: DIY Make deuteranopia diffs red and blue instead of yellow and blue112580
Node: DIY More accurate colors in terminal emulators115060
Node: DIY Range of color with terminal emulators116372
Node: DIY Per-theme customization settings119165
Node: DIY Do not extend the region background120598
Node: DIY Add padding to the mode line121402
Node: DIY Remap face with local value124335
Node: DIY Font configurations for Org and others126883
Ref: DIY Font configurations for Org and others-Footnote-1129866
Node: DIY Configure bold and italic faces130053
Node: DIY Custom Org todo keyword and priority faces134675
Node: DIY Custom Org emphasis faces138418
Node: DIY Use colored Org source blocks per language143299
Node: DIY Measure color contrast147939
Node: DIY Load theme depending on time of day150659
Node: DIY Backdrop for pdf-tools151689
Node: DIY Toggle themes without reloading them154858
Node: DIY Use more spacious margins or padding in Emacs frames156167
Node: DIY Custom hl-todo colors160424
Node: DIY Add support for solaire-mode162241
Node: DIY Use a hook at the post-load-theme phase165367
Node: DIY A theme-agnostic hook for theme loading167491
Node: Face coverage170122
Node: Supported packages170574
Node: Indirectly covered packages176284
Node: Notes on individual packages177653
Node: Note on calendarel weekday and weekend colors178753
Node: Note on git-gutter in Doom Emacs179901
Node: Note on php-mode multiline comments182401
Node: Note on underlines in compilation buffers183161
Node: Note on inline Latex in Org buffers184033
Node: Note on dimmerel184643
Node: Note on display-fill-column-indicator-mode186128
Node: Note on highlight-parenthesesel187581
Node: Note on mmm-modeel background colors193664
Node: Note for prism196018
Node: Note on company-mode overlay pop-up199240
Ref: Note on company-mode overlay pop-up-Footnote-1199970
Ref: Note on company-mode overlay pop-up-Footnote-2200037
Node: Note on ERC escaped color sequences200092
Ref: Note on ERC escaped color sequences-Footnote-1201520
Node: Note on powerline or spaceline201630
Node: Note on SHR colors202044
Node: Note on SHR fonts202468
Node: Note on Ement colors and fonts203155
Node: Note on pdf-tools link hints204665
Node: Note on the Notmuch logo207125
Node: Note on goto-address-mode faces207663
Node: Frequently Asked Questions208781
Node: Is the contrast ratio about adjacent colors?209414
Node: What does it mean to avoid exaggerations?210923
Node: Why are colors mostly variants of blue magenta cyan?212775
Node: What is the best setup for legibility?217109
Node: Are these color schemes?219756
Node: Port the Modus themes to other platforms?223440
Node: Contributing226286
Node: Sources of the themes226685
Node: Issues you can help with227581
Node: Patches require copyright assignment to the FSF228974
Node: Acknowledgements231196
Node: GNU Free Documentation License235366
Node: Indices260730
Node: Function index260909
Node: Variable index262207
Node: Concept index264901
Node: DIY Make Org agenda more or less colorful96574
Node: DIY Make inline code in prose use alternative styles99749
Node: DIY Make mail citations and headers more or less colorful101991
Node: DIY Make the region preserve text colors plus other styles104391
Node: DIY Make mouse highlights more or less colorful105947
Node: DIY Make language underlines less colorful106960
Node: DIY Make line numbers use alternative styles108112
Node: DIY Make diffs use only a foreground109755
Node: DIY Make deuteranopia diffs red and blue instead of yellow and blue112646
Node: DIY More accurate colors in terminal emulators115126
Node: DIY Range of color with terminal emulators116438
Node: DIY Per-theme customization settings119231
Node: DIY Do not extend the region background120664
Node: DIY Add padding to the mode line121468
Node: DIY Remap face with local value124401
Node: DIY Font configurations for Org and others126949
Ref: DIY Font configurations for Org and others-Footnote-1129932
Node: DIY Configure bold and italic faces130119
Node: DIY Custom Org todo keyword and priority faces134741
Node: DIY Custom Org emphasis faces138484
Node: DIY Use colored Org source blocks per language143365
Node: DIY Measure color contrast148005
Node: DIY Load theme depending on time of day150725
Node: DIY Backdrop for pdf-tools151755
Node: DIY Toggle themes without reloading them154924
Node: DIY Use more spacious margins or padding in Emacs frames156233
Node: DIY Custom hl-todo colors160490
Node: DIY Add support for solaire-mode162307
Node: DIY Use a hook at the post-load-theme phase165433
Node: DIY A theme-agnostic hook for theme loading167557
Node: Face coverage170188
Node: Supported packages170640
Node: Indirectly covered packages176350
Node: Notes on individual packages177719
Node: Note on calendarel weekday and weekend colors178819
Node: Note on git-gutter in Doom Emacs179967
Node: Note on php-mode multiline comments182467
Node: Note on underlines in compilation buffers183227
Node: Note on inline Latex in Org buffers184099
Node: Note on dimmerel184709
Node: Note on display-fill-column-indicator-mode186194
Node: Note on highlight-parenthesesel187647
Node: Note on mmm-modeel background colors193730
Node: Note for prism196084
Node: Note on company-mode overlay pop-up199306
Ref: Note on company-mode overlay pop-up-Footnote-1200036
Ref: Note on company-mode overlay pop-up-Footnote-2200103
Node: Note on ERC escaped color sequences200158
Ref: Note on ERC escaped color sequences-Footnote-1201586
Node: Note on powerline or spaceline201696
Node: Note on SHR colors202110
Node: Note on SHR fonts202534
Node: Note on Ement colors and fonts203221
Node: Note on pdf-tools link hints204731
Node: Note on the Notmuch logo207191
Node: Note on goto-address-mode faces207729
Node: Frequently Asked Questions208847
Node: Is the contrast ratio about adjacent colors?209480
Node: What does it mean to avoid exaggerations?210989
Node: Why are colors mostly variants of blue magenta cyan?212841
Node: What is the best setup for legibility?217175
Node: Are these color schemes?219822
Node: Port the Modus themes to other platforms?223506
Node: Contributing226352
Node: Sources of the themes226751
Node: Issues you can help with227647
Node: Patches require copyright assignment to the FSF229040
Node: Acknowledgements231262
Node: GNU Free Documentation License235432
Node: Indices260796
Node: Function index260975
Node: Variable index262273
Node: Concept index264967

End Tag Table

View file

@ -2088,6 +2088,8 @@ contents and for the delimiter lines (the =#+begin_= and =#+end_=
parts). The text of the delimiter lines is a subtle gray foreground
color.
[[#h:bb5b396f-5532-4d52-ab13-149ca24854f1][Make inline code in prose use alternative styles]].
#+begin_src emacs-lisp
;; Make code blocks (in Org, for example) use a more colorful style
;; for their delimiter lines as well as their contents. Give this a
@ -2257,42 +2259,42 @@ 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]].
- [[#h:b57bb50b-a863-4ea8-bb38-6de2275fa868][Make TODO and DONE more or less intense]].
- [[#h:f44cc6e3-b0f1-4a5e-8a90-9e48fa557b50][DIY Make Org block colors more or less colorful]].
#+begin_src emacs-lisp
;; These are all the mappings at their default values for didactic
;; purposes
;; A nuanced accented background, combined with a suitable foreground.
(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)))
'((bg-prose-code bg-green-nuanced)
(fg-prose-code green-cooler)
;; 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)))
(bg-prose-verbatim bg-magenta-nuanced)
(fg-prose-verbatim magenta-warmer)
;; Like the above but with more color variety for the inline code
;; elements
(bg-prose-macro bg-blue-nuanced)
(fg-prose-macro magenta-cooler)))
;; A more noticeable accented background, combined with a suitable foreground.
(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)))
'((bg-prose-code bg-sage)
(fg-prose-code green-faint)
(bg-prose-verbatim bg-ochre)
(fg-prose-verbatim red-faint)
(bg-prose-macro bg-lavender)
(fg-prose-macro blue-faint)))
;; Leave the backgrounds without a color and simply make the foregrounds more intense.
(setq modus-themes-common-palette-overrides
'((bg-prose-code unspecified)
(fg-prose-code green-intense)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-intense)
(bg-prose-macro unspecified)
(fg-prose-macro cyan-intense)))
#+end_src
Reload the theme for changes to take effect.
@ -3287,7 +3289,7 @@ the user had no choice over the =language --> color= mapping.
As such, the old user option is no more. Users can use the following
to achieve what they want:
[ All this is done by setting the Org user option ~org-src-block-faces~,
[ All this is done by setting the Org user option ~org-src-block-faces~,
so it is not related to the palette overrides mechanism provided by
the Modus themes. ]

View file

@ -352,16 +352,25 @@ standard)."
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code cyan-cooler)
(bg-prose-code unspecified)
(fg-prose-code cyan-cooler)
(bg-prose-macro unspecified)
(fg-prose-macro magenta-cooler)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done blue)
(prose-macro magenta-cooler)
(prose-todo yellow-warmer)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula yellow-warmer)
(prose-tag magenta-faint)
(prose-todo yellow-warmer)
(prose-verbatim magenta-warmer)
;;;; Rainbow mappings

View file

@ -350,16 +350,25 @@ which corresponds to a minimum contrast in relative luminance of
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code green-cooler)
(bg-prose-code unspecified)
(fg-prose-code green-cooler)
(bg-prose-macro unspecified)
(fg-prose-macro magenta-cooler)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done green)
(prose-macro magenta-cooler)
(prose-todo red)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula magenta-warmer)
(prose-tag magenta-faint)
(prose-todo red)
(prose-verbatim magenta-warmer)
;;;; Rainbow mappings

View file

@ -350,16 +350,25 @@ which corresponds to a minimum contrast in relative luminance of
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code green-cooler)
(bg-prose-code unspecified)
(fg-prose-code green-cooler)
(bg-prose-macro unspecified)
(fg-prose-macro magenta-cooler)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done green)
(prose-macro magenta-cooler)
(prose-todo red)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula magenta-warmer)
(prose-tag magenta-faint)
(prose-todo red)
(prose-verbatim magenta-warmer)
;;;; Rainbow mappings

View file

@ -352,16 +352,25 @@ standard)."
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code cyan)
(bg-prose-code unspecified)
(fg-prose-code cyan)
(bg-prose-macro unspecified)
(fg-prose-macro red-warmer)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done cyan)
(prose-macro red-warmer)
(prose-todo red)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula red-cooler)
(prose-tag fg-alt)
(prose-todo red)
(prose-verbatim magenta-warmer)
(prose-tag magenta-faint)
;;;; Rainbow mappings

View file

@ -770,12 +770,13 @@ represents."
(fg-prompt cyan-faint)
(prose-code olive)
(fg-prose-code olive)
(fg-prose-macro indigo)
(fg-prose-verbatim maroon)
(prose-done green-faint)
(prose-macro indigo)
(prose-tag rust)
(prose-todo red-faint)
(prose-verbatim maroon)
(rainbow-0 fg-main)
(rainbow-1 magenta)
@ -934,7 +935,7 @@ Info node `(modus-themes) Option for palette overrides'.")
(mail-other blue)
(prose-tag fg-dim)
(prose-verbatim blue-cooler))
(fg-prose-verbatim blue-cooler))
"Preset of palette overrides with cooler colors.
This changes parts of the palette to use more blue and
@ -989,7 +990,7 @@ Info node `(modus-themes) Option for palette overrides'.")
(mail-subject blue-warmer)
(mail-other magenta-warmer)
(prose-macro red-cooler)
(fg-prose-macro red-cooler)
(prose-tag fg-dim))
"Preset of palette overrides with warmer colors.
@ -1566,9 +1567,9 @@ FG and BG are the main colors."
`(modus-themes-prominent-note ((,c :background ,bg-prominent-note :foreground ,fg-prominent-note)))
`(modus-themes-prominent-warning ((,c :background ,bg-prominent-warning :foreground ,fg-prominent-warning)))
;;;;; markup
`(modus-themes-prose-code ((,c :inherit modus-themes-fixed-pitch :foreground ,prose-code)))
`(modus-themes-prose-macro ((,c :inherit modus-themes-fixed-pitch :foreground ,prose-macro)))
`(modus-themes-prose-verbatim ((,c :inherit modus-themes-fixed-pitch :foreground ,prose-verbatim)))
`(modus-themes-prose-code ((,c :inherit modus-themes-fixed-pitch :background ,bg-prose-code :foreground ,fg-prose-code)))
`(modus-themes-prose-macro ((,c :inherit modus-themes-fixed-pitch :background ,bg-prose-macro :foreground ,fg-prose-macro)))
`(modus-themes-prose-verbatim ((,c :inherit modus-themes-fixed-pitch :background ,bg-prose-verbatim :foreground ,fg-prose-verbatim)))
;;;;; search
`(modus-themes-search-current ((,c :background ,bg-search-current :foreground ,fg-main)))
`(modus-themes-search-lazy ((,c :background ,bg-search-lazy :foreground ,fg-main)))
@ -2929,12 +2930,12 @@ FG and BG are the main colors."
;;;;; markup-faces (`adoc-mode')
`(markup-attribute-face ((,c :inherit (modus-themes-slant markup-meta-face))))
`(markup-bold-face ((,c :inherit bold)))
`(markup-code-face ((,c :foreground ,prose-code)))
`(markup-code-face ((,c :inherit modus-themes-prose-code)))
`(markup-comment-face ((,c :inherit font-lock-comment-face)))
`(markup-complex-replacement-face ((,c :foreground ,prose-macro)))
`(markup-complex-replacement-face ((,c :inherit modus-themes-prose-macro)))
`(markup-emphasis-face ((,c :inherit markup-italic-face)))
`(markup-error-face ((,c :inherit error)))
`(markup-gen-face ((,c :foreground ,prose-verbatim)))
`(markup-gen-face ((,c :inherit modus-themes-prose-verbatim)))
`(markup-internal-reference-face ((,c :inherit (shadow modus-themes-slant))))
`(markup-italic-face ((,c :inherit italic)))
`(markup-list-face ((,c :background ,bg-inactive)))
@ -2956,7 +2957,7 @@ FG and BG are the main colors."
`(markup-title-3-face ((,c :inherit modus-themes-heading-4)))
`(markup-title-4-face ((,c :inherit modus-themes-heading-5)))
`(markup-title-5-face ((,c :inherit modus-themes-heading-6)))
`(markup-verbatim-face ((,c :inherit modus-themes-fixed-pitch :foreground ,prose-verbatim)))
`(markup-verbatim-face ((,c :inherit modus-themes-prose-verbatim)))
;;;;; mct
`(mct-highlight-candidate ((,c :inherit modus-themes-completion-selected)))
;;;;; messages

View file

@ -352,16 +352,25 @@ standard)."
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code cyan-cooler)
(bg-prose-code unspecified)
(fg-prose-code cyan-cooler)
(bg-prose-macro unspecified)
(fg-prose-macro magenta-cooler)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done blue)
(prose-macro magenta-cooler)
(prose-todo yellow-warmer)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula yellow-cooler)
(prose-table-formula yellow-warmer)
(prose-tag magenta-faint)
(prose-todo yellow-warmer)
(prose-verbatim magenta-warmer)
;;;; Rainbow mappings

View file

@ -350,16 +350,25 @@ which corresponds to a minimum contrast in relative luminance of
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code cyan-cooler)
(bg-prose-code unspecified)
(fg-prose-code green-cooler)
(bg-prose-macro unspecified)
(fg-prose-macro magenta-cooler)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done green)
(prose-macro magenta-cooler)
(prose-todo red)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula magenta-warmer)
(prose-tag magenta-faint)
(prose-todo red)
(prose-verbatim magenta-warmer)
;;;; Rainbow mappings

View file

@ -350,16 +350,25 @@ which corresponds to a minimum contrast in relative luminance of
(fg-prose-block-delimiter fg-dim)
(bg-prose-block-contents bg-dim)
(prose-code cyan-cooler)
(bg-prose-code unspecified)
(fg-prose-code green-cooler)
(bg-prose-macro unspecified)
(fg-prose-macro magenta-cooler)
(bg-prose-verbatim unspecified)
(fg-prose-verbatim magenta-warmer)
(prose-done green)
(prose-macro magenta-cooler)
(prose-todo red)
(prose-metadata fg-dim)
(prose-metadata-value fg-alt)
(prose-table fg-alt)
(prose-table-formula magenta-warmer)
(prose-tag magenta-faint)
(prose-todo red)
(prose-verbatim magenta-warmer)
;;;; Rainbow mappings