Document how to make tabs more or less colorful

This commit is contained in:
Protesilaos Stavrou 2023-01-20 11:26:37 +02:00
parent 7d643b30f4
commit 9e1b5dfce3
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
2 changed files with 240 additions and 134 deletions

View file

@ -126,6 +126,7 @@ Stylistic variants using palette overrides
* Make the mode line borderless::
* Make the active mode line colorful::
* Make the tab bar more or less colorful::
* Make the fringe invisible or another color::
* Make links use subtle or no underlines::
* Make prompts more or less colorful::
@ -1369,6 +1370,7 @@ Palette override presets::).
* Make the mode line borderless::
* Make the active mode line colorful::
* Make the tab bar more or less colorful::
* Make the fringe invisible or another color::
* Make links use subtle or no underlines::
* Make prompts more or less colorful::
@ -1425,7 +1427,7 @@ set their color to that of the underlying background.
(border-mode-line-inactive bg-mode-line-inactive)))

File: modus-themes.info, Node: Make the active mode line colorful, Next: Make the fringe invisible or another color, Prev: Make the mode line borderless, Up: Stylistic variants using palette overrides
File: modus-themes.info, Node: Make the active mode line colorful, Next: Make the tab bar more or less colorful, Prev: Make the mode line borderless, Up: Stylistic variants using palette overrides
4.11.2.2 Make the active mode line colorful
...........................................
@ -1467,9 +1469,60 @@ blue mode line for modus-operandi and a red one for modus-vivendi.
(border-mode-line-active bg-red-subtle)))

File: modus-themes.info, Node: Make the fringe invisible or another color, Next: Make links use subtle or no underlines, Prev: Make the active mode line colorful, Up: Stylistic variants using palette overrides
File: modus-themes.info, Node: Make the tab bar more or less colorful, Next: Make the fringe invisible or another color, Prev: Make the active mode line colorful, Up: Stylistic variants using palette overrides
4.11.2.3 Make the fringe invisible or another color
4.11.2.3 Make the tab bar 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::).
Here we show how to affect the colors of the built-in tab-bar-mode and
tab-line-mode.
For consistent theme-wide results, consider changing the mode line,
fringes, and line numbers. These are shown in other sections of this
manual.
;; 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.
;; Make the `tab-bar-mode' mode subtle while keepings its original
;; gray aesthetic.
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-main)
(bg-tab-current bg-active)
(bg-tab-other bg-dim)))
;; Like the above, but the current tab has a colorful background and
;; the inactive tabs have a slightly more noticeable gray background.
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-main)
(bg-tab-current bg-cyan-intense)
(bg-tab-other bg-inactive)))
;; Make the tabs colorful, using a monochromatic pattern (e.g. shades
;; of cyan).
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-cyan-nuanced)
(bg-tab-current bg-cyan-intense)
(bg-tab-other bg-cyan-subtle)))
;; Like the above, but with a dichromatic pattern (cyan and magenta).
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-cyan-nuanced)
(bg-tab-current bg-magenta-intense)
(bg-tab-other bg-cyan-subtle)))

File: modus-themes.info, Node: Make the fringe invisible or another color, Next: Make links use subtle or no underlines, Prev: Make the tab bar more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.4 Make the fringe invisible or another color
...................................................
This is one of our practical examples to override the semantic colors of
@ -1502,7 +1555,7 @@ or continuation lines.

File: modus-themes.info, Node: Make links use subtle or no underlines, Next: Make prompts more or less colorful, Prev: Make the fringe invisible or another color, Up: Stylistic variants using palette overrides
4.11.2.4 Make links use subtle or no underlines
4.11.2.5 Make links use subtle or no underlines
...............................................
This is one of our practical examples to override the semantic colors of
@ -1525,7 +1578,7 @@ that underline mappings can read correctly.

File: modus-themes.info, Node: Make prompts more or less colorful, Next: Make completion matches more or less colorful, Prev: Make links use subtle or no underlines, Up: Stylistic variants using palette overrides
4.11.2.5 Make prompts more or less colorful
4.11.2.6 Make prompts more or less colorful
...........................................
This section contains practical examples of overriding the palette of
@ -1562,7 +1615,7 @@ prompts.

File: modus-themes.info, Node: Make completion matches more or less colorful, Next: Make comments yellow and strings green, Prev: Make prompts more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.6 Make completion matches more or less colorful
4.11.2.7 Make completion matches more or less colorful
......................................................
This section contains practical examples of overriding the palette of
@ -1646,7 +1699,7 @@ colors to two:

File: modus-themes.info, Node: Make comments yellow and strings green, Next: Make code syntax use the old alt-syntax style, Prev: Make completion matches more or less colorful, Up: Stylistic variants using palette overrides
4.11.2.7 Make comments yellow and strings green
4.11.2.8 Make comments yellow and strings green
...............................................
This is one of our practical examples to override the semantic colors of
@ -1688,7 +1741,7 @@ reproduce the effect, but also how to tweak it to ones liking.

File: modus-themes.info, Node: Make code syntax use the old alt-syntax style, Next: Make use of alternative styles for code syntax, Prev: Make comments yellow and strings green, Up: Stylistic variants using palette overrides
4.11.2.8 Make code syntax use the old alt-syntax style
4.11.2.9 Make code syntax use the old alt-syntax style
......................................................
This is one of our practical examples to override the semantic colors of
@ -1768,8 +1821,8 @@ interesting to experiment with faintly red colored comments:

File: modus-themes.info, Node: Make use of alternative styles for code syntax, Next: Make matching parenthesis more or less intense, Prev: Make code syntax use the old alt-syntax style, Up: Stylistic variants using palette overrides
4.11.2.9 Make use of alternative styles for code syntax
.......................................................
4.11.2.10 Make use of alternative styles for code syntax
........................................................
This is one of our practical examples to override the semantic colors of
the Modus themes (*note Stylistic variants using palette overrides::).
@ -1858,7 +1911,7 @@ palette.

File: modus-themes.info, Node: Make matching parenthesis more or less intense, Next: Make box buttons more or less gray, Prev: Make use of alternative styles for code syntax, Up: Stylistic variants using palette overrides
4.11.2.10 Make matching parenthesis more or less intense
4.11.2.11 Make matching parenthesis more or less intense
........................................................
This is one of our practical examples to override the semantic colors of
@ -1887,7 +1940,7 @@ to enable underlines for those highlights.

File: modus-themes.info, Node: Make box buttons more or less gray, Next: Make TODO and DONE more or less intense, Prev: Make matching parenthesis more or less intense, Up: Stylistic variants using palette overrides
4.11.2.11 Make box buttons more or less gray
4.11.2.12 Make box buttons more or less gray
............................................
This is one of our practical examples to override the semantic colors of
@ -1913,7 +1966,7 @@ gray from the active buttons and amplifies it for the inactive ones.

File: modus-themes.info, Node: Make TODO and DONE more or less intense, Next: Make headings more or less colorful, Prev: Make box buttons more or less gray, Up: Stylistic variants using palette overrides
4.11.2.12 Make TODO and DONE more or less intense
4.11.2.13 Make TODO and DONE more or less intense
.................................................
This is one of our practical examples to override the semantic colors of
@ -1952,7 +2005,7 @@ subdue them.

File: modus-themes.info, Node: Make headings more or less colorful, Next: Make Org agenda more or less colorful, Prev: Make TODO and DONE more or less intense, Up: Stylistic variants using palette overrides
4.11.2.13 Make headings more or less colorful
4.11.2.14 Make headings more or less colorful
.............................................
This is one of our practical examples to override the semantic colors of
@ -2009,7 +2062,7 @@ less intense.

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.11.2.14 Make Org agenda more or less colorful
4.11.2.15 Make Org agenda more or less colorful
...............................................
This is one of our practical examples to override the semantic colors of
@ -2068,7 +2121,7 @@ what we show in the other chapters with practical stylistic variants.

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.11.2.15 Make inline code in prose use alternative styles
4.11.2.16 Make inline code in prose use alternative styles
..........................................................
This is one of our practical examples to override the semantic colors of
@ -2126,7 +2179,7 @@ not show every possible permutation.

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.11.2.16 Make mail citations and headers more or less colorful
4.11.2.17 Make mail citations and headers more or less colorful
...............................................................
This is one of our practical examples to override the semantic colors of
@ -2192,7 +2245,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.11.2.17 Make the region preserve text colors, plus other styles
4.11.2.18 Make the region preserve text colors, plus other styles
.................................................................
This is one of our practical examples to override the semantic colors of
@ -2231,7 +2284,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.11.2.18 Make mouse highlights more or less colorful
4.11.2.19 Make mouse highlights more or less colorful
.....................................................
This is one of our practical examples to override the semantic colors of
@ -2259,7 +2312,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.11.2.19 Make language underlines less colorful
4.11.2.20 Make language underlines less colorful
................................................
This is one of our practical examples to override the semantic colors of
@ -2291,7 +2344,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.11.2.20 Make line numbers use alternative styles
4.11.2.21 Make line numbers use alternative styles
..................................................
This is one of our practical examples to override the semantic colors of
@ -5664,119 +5717,120 @@ B.3 Concept index

Tag Table:
Node: Top874
Node: Overview7849
Node: How do the themes look like10247
Node: Learn about the latest changes10606
Node: Installation10994
Node: Install manually from source11924
Node: Install from the archives12749
Node: Install on GNU/Linux13348
Node: Debian 11 Bullseye13841
Node: GNU Guix14251
Node: Dealing with byte compilation errors14534
Node: Enable and load15692
Node: The require-theme for built-in Emacs themes18546
Node: Sample configuration with and without use-package19666
Node: Differences between loading and enabling22497
Node: Customization options24535
Node: Custom reload theme28283
Node: Disable other themes29191
Node: Bold constructs30399
Node: Italic constructs31236
Node: Mixed fonts32007
Node: Command prompts33003
Node: Completion UIs34808
Node: Org mode blocks37598
Node: Heading styles39478
Node: UI typeface43832
Node: Palette overrides44763
Node: Palette override presets49070
Node: Stylistic variants using palette overrides51567
Node: Make the mode line borderless53226
Node: Make the active mode line colorful54834
Node: Make the fringe invisible or another color56789
Node: Make links use subtle or no underlines58285
Node: Make prompts more or less colorful59288
Node: Make completion matches more or less colorful60958
Node: Make comments yellow and strings green64864
Node: Make code syntax use the old alt-syntax style66773
Node: Make use of alternative styles for code syntax70060
Node: Make matching parenthesis more or less intense73728
Node: Make box buttons more or less gray75170
Node: Make TODO and DONE more or less intense76482
Node: Make headings more or less colorful78191
Node: Make Org agenda more or less colorful80597
Node: Make inline code in prose use alternative styles83335
Node: Make mail citations and headers more or less colorful85882
Node: Make the region preserve text colors plus other styles88583
Node: Make mouse highlights more or less colorful90400
Node: Make language underlines less colorful91713
Node: Make line numbers use alternative styles93165
Node: Advanced customization95067
Node: More accurate colors in terminal emulators96557
Node: Range of color with terminal emulators97798
Node: Preview theme colors100512
Node: Per-theme customization settings102206
Node: Use theme colors in code with modus-themes-with-colors103571
Node: Do not extend the region background105852
Node: Add padding to mode line106650
Node: Remap face with local value109206
Node: Font configurations for Org and others111627
Ref: Font configurations for Org and others-Footnote-1114534
Node: Configure bold and italic faces114721
Node: Custom Org todo keyword and priority faces118878
Node: Custom Org emphasis faces122443
Node: Update Org block delimiter fontification127266
Node: Measure color contrast129183
Node: Load theme depending on time of day131881
Node: Backdrop for pdf-tools132891
Node: Toggle themes without reloading them135790
Node: A theme-agnostic hook for theme loading137066
Node: Custom hl-todo colors139488
Node: Add support for solaire-mode141013
Node: Face coverage143924
Node: Supported packages144376
Node: Indirectly covered packages149708
Node: Notes on individual packages151061
Node: Note on calendarel weekday and weekend colors152161
Node: Note on git-gutter in Doom Emacs153309
Node: Note on php-mode multiline comments155653
Node: Note on underlines in compilation buffers156406
Node: Note on inline Latex in Org buffers157243
Node: Note on dimmerel157853
Node: Note on display-fill-column-indicator-mode159338
Node: Note on highlight-parenthesesel160737
Node: Note on mmm-modeel background colors166715
Node: Note for prism169015
Node: Note on company-mode overlay pop-up172183
Ref: Note on company-mode overlay pop-up-Footnote-1172913
Ref: Note on company-mode overlay pop-up-Footnote-2172980
Node: Note on ERC escaped color sequences173035
Ref: Note on ERC escaped color sequences-Footnote-1174463
Node: Note on powerline or spaceline174573
Node: Note on SHR colors174987
Node: Note on SHR fonts175411
Node: Note on Ement colors and fonts176050
Node: Note on pdf-tools link hints177560
Node: Note on the Notmuch logo180020
Node: Note on goto-address-mode faces180558
Node: Frequently Asked Questions181670
Node: Is the contrast ratio about adjacent colors?182301
Node: What does it mean to avoid exaggerations?183808
Node: Why are colors mostly variants of blue magenta cyan?185658
Node: What is the best setup for legibility?189964
Node: Are these color schemes?192609
Node: Port the Modus themes to other platforms?196291
Node: Contributing199063
Node: Sources of the themes199460
Node: Issues you can help with200354
Node: Patches require copyright assignment to the FSF201745
Node: Acknowledgements203965
Node: GNU Free Documentation License207833
Node: Indices233197
Node: Function index233376
Node: Variable index234408
Node: Concept index236307
Node: Overview7892
Node: How do the themes look like10290
Node: Learn about the latest changes10649
Node: Installation11037
Node: Install manually from source11967
Node: Install from the archives12792
Node: Install on GNU/Linux13391
Node: Debian 11 Bullseye13884
Node: GNU Guix14294
Node: Dealing with byte compilation errors14577
Node: Enable and load15735
Node: The require-theme for built-in Emacs themes18589
Node: Sample configuration with and without use-package19709
Node: Differences between loading and enabling22540
Node: Customization options24578
Node: Custom reload theme28326
Node: Disable other themes29234
Node: Bold constructs30442
Node: Italic constructs31279
Node: Mixed fonts32050
Node: Command prompts33046
Node: Completion UIs34851
Node: Org mode blocks37641
Node: Heading styles39521
Node: UI typeface43875
Node: Palette overrides44806
Node: Palette override presets49113
Node: Stylistic variants using palette overrides51610
Node: Make the mode line borderless53312
Node: Make the active mode line colorful54920
Node: Make the tab bar more or less colorful56871
Node: Make the fringe invisible or another color59108
Node: Make links use subtle or no underlines60608
Node: Make prompts more or less colorful61611
Node: Make completion matches more or less colorful63281
Node: Make comments yellow and strings green67187
Node: Make code syntax use the old alt-syntax style69096
Node: Make use of alternative styles for code syntax72383
Node: Make matching parenthesis more or less intense76053
Node: Make box buttons more or less gray77495
Node: Make TODO and DONE more or less intense78807
Node: Make headings more or less colorful80516
Node: Make Org agenda more or less colorful82922
Node: Make inline code in prose use alternative styles85660
Node: Make mail citations and headers more or less colorful88207
Node: Make the region preserve text colors plus other styles90908
Node: Make mouse highlights more or less colorful92725
Node: Make language underlines less colorful94038
Node: Make line numbers use alternative styles95490
Node: Advanced customization97392
Node: More accurate colors in terminal emulators98882
Node: Range of color with terminal emulators100123
Node: Preview theme colors102837
Node: Per-theme customization settings104531
Node: Use theme colors in code with modus-themes-with-colors105896
Node: Do not extend the region background108177
Node: Add padding to mode line108975
Node: Remap face with local value111531
Node: Font configurations for Org and others113952
Ref: Font configurations for Org and others-Footnote-1116859
Node: Configure bold and italic faces117046
Node: Custom Org todo keyword and priority faces121203
Node: Custom Org emphasis faces124768
Node: Update Org block delimiter fontification129591
Node: Measure color contrast131508
Node: Load theme depending on time of day134206
Node: Backdrop for pdf-tools135216
Node: Toggle themes without reloading them138115
Node: A theme-agnostic hook for theme loading139391
Node: Custom hl-todo colors141813
Node: Add support for solaire-mode143338
Node: Face coverage146249
Node: Supported packages146701
Node: Indirectly covered packages152033
Node: Notes on individual packages153386
Node: Note on calendarel weekday and weekend colors154486
Node: Note on git-gutter in Doom Emacs155634
Node: Note on php-mode multiline comments157978
Node: Note on underlines in compilation buffers158731
Node: Note on inline Latex in Org buffers159568
Node: Note on dimmerel160178
Node: Note on display-fill-column-indicator-mode161663
Node: Note on highlight-parenthesesel163062
Node: Note on mmm-modeel background colors169040
Node: Note for prism171340
Node: Note on company-mode overlay pop-up174508
Ref: Note on company-mode overlay pop-up-Footnote-1175238
Ref: Note on company-mode overlay pop-up-Footnote-2175305
Node: Note on ERC escaped color sequences175360
Ref: Note on ERC escaped color sequences-Footnote-1176788
Node: Note on powerline or spaceline176898
Node: Note on SHR colors177312
Node: Note on SHR fonts177736
Node: Note on Ement colors and fonts178375
Node: Note on pdf-tools link hints179885
Node: Note on the Notmuch logo182345
Node: Note on goto-address-mode faces182883
Node: Frequently Asked Questions183995
Node: Is the contrast ratio about adjacent colors?184626
Node: What does it mean to avoid exaggerations?186133
Node: Why are colors mostly variants of blue magenta cyan?187983
Node: What is the best setup for legibility?192289
Node: Are these color schemes?194934
Node: Port the Modus themes to other platforms?198616
Node: Contributing201388
Node: Sources of the themes201785
Node: Issues you can help with202679
Node: Patches require copyright assignment to the FSF204070
Node: Acknowledgements206290
Node: GNU Free Documentation License210158
Node: Indices235522
Node: Function index235701
Node: Variable index236733
Node: Concept index238632

End Tag Table

View file

@ -1308,6 +1308,58 @@ have a blue mode line for ~modus-operandi~ and a red one for
(border-mode-line-active bg-red-subtle)))
#+end_src
**** Make the tab bar more or less colorful
:PROPERTIES:
:CUSTOM_ID: h:096658d7-a0bd-4a99-b6dc-9b20a20cda37
: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]]).
Here we show how to affect the colors of the built-in ~tab-bar-mode~
and ~tab-line-mode~.
For consistent theme-wide results, consider changing the mode line,
fringes, and line numbers. These are shown in other sections of this
manual.
#+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.
;; Make the `tab-bar-mode' mode subtle while keepings its original
;; gray aesthetic.
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-main)
(bg-tab-current bg-active)
(bg-tab-other bg-dim)))
;; Like the above, but the current tab has a colorful background and
;; the inactive tabs have a slightly more noticeable gray background.
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-main)
(bg-tab-current bg-cyan-intense)
(bg-tab-other bg-inactive)))
;; Make the tabs colorful, using a monochromatic pattern (e.g. shades
;; of cyan).
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-cyan-nuanced)
(bg-tab-current bg-cyan-intense)
(bg-tab-other bg-cyan-subtle)))
;; Like the above, but with a dichromatic pattern (cyan and magenta).
(setq modus-themes-common-palette-overrides
'((bg-tab-bar bg-cyan-nuanced)
(bg-tab-current bg-magenta-intense)
(bg-tab-other bg-cyan-subtle)))
#+end_src
**** Make the fringe invisible or another color
:PROPERTIES:
:CUSTOM_ID: h:c312dcac-36b6-4a1f-b1f5-ab1c9abe27b0