branch: externals/modus-themes
commit db5b771c4213dd0f1950c309b1b771eb16c412c3
Author: Protesilaos Stavrou <i...@protesilaos.com>
Commit: Protesilaos Stavrou <i...@protesilaos.com>
Add more sample code in the manual for "user" palette definitions
---
doc/modus-themes.info | 202 ++++++++++++++++++++++++++------------------------
doc/modus-themes.org | 12 +++
2 files changed, 119 insertions(+), 95 deletions(-)
diff --git a/doc/modus-themes.info b/doc/modus-themes.info
index 36ef4df159..695e77c0bb 100644
--- a/doc/modus-themes.info
+++ b/doc/modus-themes.info
@@ -1406,6 +1406,18 @@ the following user options:
'((cursor cherry)
(string plum)))
+
+ ;; Tweaks on a per-theme basis give the user maximum flexibility. For
+ ;; example, they can have the above for `modus-operandi' while they use
+ ;; these for `modus-vivendi':
+ (setq modus-vivendi-palette-user
+ '((apricot "#dfb350")
+ (kiwi "#80d458")))
+
+ (setq modus-vivendi-palette-overrides
+ '((cursor apricot)
+ (string kiwi)))
+
File: modus-themes.info, Node: Preview theme colors, Next: Use colors from
the Modus themes palette, Prev: Customization options, Up: Top
@@ -6390,101 +6402,101 @@ Node: Heading styles41598
Node: UI typeface46028
Node: Palette overrides47001
Node: Option to extend the palette for use with overrides51425
-Node: Preview theme colors53389
-Node: Use colors from the Modus themes palette55202
-Node: Get a single color from the palette with
modus-themes-get-color-value56066
-Node: Use theme colors in code with modus-themes-with-colors58428
-Node: Advanced customization60684
-Node: DIY Palette override presets62343
-Node: DIY Stylistic variants using palette overrides65198
-Node: DIY Make the mode line borderless67252
-Node: DIY Make the active mode line colorful68627
-Node: DIY Make the tab bar more or less colorful70845
-Node: DIY Make the fringe invisible or another color72782
-Node: DIY Make links use subtle or no underlines73983
-Node: DIY Make prompts more or less colorful75101
-Node: DIY Make completion matches more or less colorful76424
-Node: DIY Make comments yellow and strings green79983
-Node: DIY Make code syntax use the old alt-syntax style81692
-Node: DIY Make use of alternative styles for code syntax84815
-Node: DIY Make matching parenthesis more or less intense88277
-Node: DIY Make box buttons more or less gray89649
-Node: DIY Make TODO and DONE more or less intense90662
-Node: DIY Make headings more or less colorful92163
-Node: DIY Make Org block colors more or less colorful94280
-Node: DIY Make Org agenda more or less colorful98654
-Node: DIY Make inline code in prose use alternative styles101829
-Node: DIY Make mail citations and headers more or less colorful104071
-Node: DIY Make the region preserve text colors plus other styles106471
-Node: DIY Make mouse highlights more or less colorful108027
-Node: DIY Make language underlines less colorful109040
-Node: DIY Make line numbers use alternative styles110192
-Node: DIY Make diffs use only a foreground111835
-Node: DIY Make deuteranopia diffs red and blue instead of yellow and
blue114726
-Node: DIY More accurate colors in terminal emulators117206
-Node: DIY Range of color with terminal emulators118518
-Node: DIY Per-theme customization settings121311
-Node: DIY Do not extend the region background122744
-Node: DIY Add padding to the mode line123548
-Node: DIY Remap face with local value126481
-Node: DIY Font configurations for Org and others129029
-Ref: DIY Font configurations for Org and others-Footnote-1132012
-Node: DIY Configure bold and italic faces132199
-Node: DIY Custom Org todo keyword and priority faces136821
-Node: DIY Custom Org emphasis faces140564
-Node: DIY Use colored Org source blocks per language145445
-Node: DIY Measure color contrast150085
-Node: DIY Load theme depending on time of day152805
-Node: DIY Backdrop for pdf-tools153835
-Node: DIY Toggle themes without reloading them157004
-Node: DIY Use more spacious margins or padding in Emacs frames158313
-Node: DIY Custom hl-todo colors162570
-Node: DIY Add support for solaire-mode164387
-Node: DIY Use a hook at the post-load-theme phase167513
-Node: DIY A theme-agnostic hook for theme loading169637
-Node: Face coverage172268
-Node: Supported packages172720
-Node: Indirectly covered packages178451
-Node: Notes on individual packages179820
-Node: Note on calendarel weekday and weekend colors180920
-Node: Note on git-gutter in Doom Emacs182068
-Node: Note on php-mode multiline comments184568
-Node: Note on underlines in compilation buffers185328
-Node: Note on inline Latex in Org buffers186200
-Node: Note on dimmerel186810
-Node: Note on display-fill-column-indicator-mode188295
-Node: Note on highlight-parenthesesel189748
-Node: Note on mmm-modeel background colors195831
-Node: Note for prism198185
-Node: Note on company-mode overlay pop-up201407
-Ref: Note on company-mode overlay pop-up-Footnote-1202137
-Ref: Note on company-mode overlay pop-up-Footnote-2202204
-Node: Note on ERC escaped color sequences202259
-Ref: Note on ERC escaped color sequences-Footnote-1203687
-Node: Note on powerline or spaceline203797
-Node: Note on SHR colors204211
-Node: Note on SHR fonts204635
-Node: Note on Ement colors and fonts205322
-Node: Note on pdf-tools link hints206832
-Node: Note on the Notmuch logo209292
-Node: Note on goto-address-mode faces209830
-Node: Frequently Asked Questions210948
-Node: Is the contrast ratio about adjacent colors?211581
-Node: What does it mean to avoid exaggerations?213090
-Node: Why are colors mostly variants of blue magenta cyan?214942
-Node: What is the best setup for legibility?219276
-Node: Are these color schemes?221923
-Node: Port the Modus themes to other platforms?225607
-Node: Contributing228453
-Node: Sources of the themes228852
-Node: Issues you can help with229748
-Node: Patches require copyright assignment to the FSF231141
-Node: Acknowledgements233363
-Node: GNU Free Documentation License237601
-Node: Indices262965
-Node: Function index263144
-Node: Variable index264442
-Node: Concept index268645
+Node: Preview theme colors53784
+Node: Use colors from the Modus themes palette55597
+Node: Get a single color from the palette with
modus-themes-get-color-value56461
+Node: Use theme colors in code with modus-themes-with-colors58823
+Node: Advanced customization61079
+Node: DIY Palette override presets62738
+Node: DIY Stylistic variants using palette overrides65593
+Node: DIY Make the mode line borderless67647
+Node: DIY Make the active mode line colorful69022
+Node: DIY Make the tab bar more or less colorful71240
+Node: DIY Make the fringe invisible or another color73177
+Node: DIY Make links use subtle or no underlines74378
+Node: DIY Make prompts more or less colorful75496
+Node: DIY Make completion matches more or less colorful76819
+Node: DIY Make comments yellow and strings green80378
+Node: DIY Make code syntax use the old alt-syntax style82087
+Node: DIY Make use of alternative styles for code syntax85210
+Node: DIY Make matching parenthesis more or less intense88672
+Node: DIY Make box buttons more or less gray90044
+Node: DIY Make TODO and DONE more or less intense91057
+Node: DIY Make headings more or less colorful92558
+Node: DIY Make Org block colors more or less colorful94675
+Node: DIY Make Org agenda more or less colorful99049
+Node: DIY Make inline code in prose use alternative styles102224
+Node: DIY Make mail citations and headers more or less colorful104466
+Node: DIY Make the region preserve text colors plus other styles106866
+Node: DIY Make mouse highlights more or less colorful108422
+Node: DIY Make language underlines less colorful109435
+Node: DIY Make line numbers use alternative styles110587
+Node: DIY Make diffs use only a foreground112230
+Node: DIY Make deuteranopia diffs red and blue instead of yellow and
blue115121
+Node: DIY More accurate colors in terminal emulators117601
+Node: DIY Range of color with terminal emulators118913
+Node: DIY Per-theme customization settings121706
+Node: DIY Do not extend the region background123139
+Node: DIY Add padding to the mode line123943
+Node: DIY Remap face with local value126876
+Node: DIY Font configurations for Org and others129424
+Ref: DIY Font configurations for Org and others-Footnote-1132407
+Node: DIY Configure bold and italic faces132594
+Node: DIY Custom Org todo keyword and priority faces137216
+Node: DIY Custom Org emphasis faces140959
+Node: DIY Use colored Org source blocks per language145840
+Node: DIY Measure color contrast150480
+Node: DIY Load theme depending on time of day153200
+Node: DIY Backdrop for pdf-tools154230
+Node: DIY Toggle themes without reloading them157399
+Node: DIY Use more spacious margins or padding in Emacs frames158708
+Node: DIY Custom hl-todo colors162965
+Node: DIY Add support for solaire-mode164782
+Node: DIY Use a hook at the post-load-theme phase167908
+Node: DIY A theme-agnostic hook for theme loading170032
+Node: Face coverage172663
+Node: Supported packages173115
+Node: Indirectly covered packages178846
+Node: Notes on individual packages180215
+Node: Note on calendarel weekday and weekend colors181315
+Node: Note on git-gutter in Doom Emacs182463
+Node: Note on php-mode multiline comments184963
+Node: Note on underlines in compilation buffers185723
+Node: Note on inline Latex in Org buffers186595
+Node: Note on dimmerel187205
+Node: Note on display-fill-column-indicator-mode188690
+Node: Note on highlight-parenthesesel190143
+Node: Note on mmm-modeel background colors196226
+Node: Note for prism198580
+Node: Note on company-mode overlay pop-up201802
+Ref: Note on company-mode overlay pop-up-Footnote-1202532
+Ref: Note on company-mode overlay pop-up-Footnote-2202599
+Node: Note on ERC escaped color sequences202654
+Ref: Note on ERC escaped color sequences-Footnote-1204082
+Node: Note on powerline or spaceline204192
+Node: Note on SHR colors204606
+Node: Note on SHR fonts205030
+Node: Note on Ement colors and fonts205717
+Node: Note on pdf-tools link hints207227
+Node: Note on the Notmuch logo209687
+Node: Note on goto-address-mode faces210225
+Node: Frequently Asked Questions211343
+Node: Is the contrast ratio about adjacent colors?211976
+Node: What does it mean to avoid exaggerations?213485
+Node: Why are colors mostly variants of blue magenta cyan?215337
+Node: What is the best setup for legibility?219671
+Node: Are these color schemes?222318
+Node: Port the Modus themes to other platforms?226002
+Node: Contributing228848
+Node: Sources of the themes229247
+Node: Issues you can help with230143
+Node: Patches require copyright assignment to the FSF231536
+Node: Acknowledgements233758
+Node: GNU Free Documentation License237996
+Node: Indices263360
+Node: Function index263539
+Node: Variable index264837
+Node: Concept index269040
End Tag Table
diff --git a/doc/modus-themes.org b/doc/modus-themes.org
index 78dbf3dc70..1b774807c8 100644
--- a/doc/modus-themes.org
+++ b/doc/modus-themes.org
@@ -1256,6 +1256,18 @@ Examples demonstrating how to use the aforementioned:
(setq modus-operandi-palette-overrides
'((cursor cherry)
(string plum)))
+
+
+;; Tweaks on a per-theme basis give the user maximum flexibility. For
+;; example, they can have the above for `modus-operandi' while they use
+;; these for `modus-vivendi':
+(setq modus-vivendi-palette-user
+ '((apricot "#dfb350")
+ (kiwi "#80d458")))
+
+(setq modus-vivendi-palette-overrides
+ '((cursor apricot)
+ (string kiwi)))
#+end_src
* Preview theme colors
