Update modus-themes to version 4.5.0

This commit is contained in:
Protesilaos Stavrou 2024-08-21 10:24:25 +03:00
parent 7532d69bf1
commit db70c2ca92
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
4 changed files with 219 additions and 62 deletions

View file

@ -15,6 +15,163 @@ For further details, please consult these additional resources:
+ Manual :: <https://protesilaos.com/emacs/modus-themes>
+ Screenshots :: <https://protesilaos.com/emacs/modus-themes-pictures>
* 4.5.0 on 2024-08-21
:PROPERTIES:
:CUSTOM_ID: h:1a3e2de7-2244-4160-a29c-40a0ab35cd5f
:END:
The themes are in a stable state. They cover a wide range of packages
and interfaces, while they are highly configurable. The present
version provides further scope for customisation as well as some
quality-of-life refinements.
** Users can now extend the palette of each/all themes
:PROPERTIES:
:CUSTOM_ID: h:9f38b395-9ab0-4b81-a9cd-3e753e6c62b9
:END:
In addition to palette overrides, users can now define extensions for
the palette of each theme or for all themes. The idea is to define new
colours while keeping the existing ones intact. Then, those colours
can be accessed in all the usual ways via (i) the
~modus-themes-with-colors~ macro, (ii) the function
~modus-themes-get-color-value~, and (iii) in the palette override user
options.
I wrote about this on my website: <https://protesilaos.com/codelog/2024-06-25-emacs-modus-themes-user-palette/>.
And, as always, the manual is the up-to-date reference for everything
you need.
The relevant user options are the following:
- ~modus-themes-common-palette-user~
- ~modus-operandi-palette-user~
- ~modus-operandi-tinted-palette-user~
- ~modus-operandi-deuteranopia-palette-user~
- ~modus-operandi-tritanopia-palette-user~
- ~modus-vivendi-palette-user~
- ~modus-vivendi-tinted-palette-user~
- ~modus-vivendi-deuteranopia-palette-user~
- ~modus-vivendi-tritanopia-palette-user~
** More colours to chose from in customisations
:PROPERTIES:
:CUSTOM_ID: h:7b67da30-eb71-4752-8d09-91052faa9277
:END:
A big part of the themes' customisability is the palette overrides
users can implement. The manual covers lots of examples. The short
version is that the user can change how, say, the mode lines look,
what an Org heading looks like, and so on.
We now have a new pair of background and foreground colours, namely,
~bg-clay~ and ~fg-clay~, as well as foreground values to complement
their already existing background counterparts: ~fg-ochre~,
~fg-lavender~, ~fg-sage~.
** "Graph" colours look a bit better in context
:PROPERTIES:
:CUSTOM_ID: h:f7d7a69c-0125-479f-9b35-8b2ba750fa23
:END:
Each theme's palette contains a subset of colour values that are
intended for use in graphs. One well-known package where those are
applied is the ~org-habit~ consistency block.
I tweak a few colours in this subset to make them look better
side-by-side as well as in other combinations. This concerns all the
light themes.
** The indicator for minibuffer recursion has a different style
:PROPERTIES:
:CUSTOM_ID: h:c5079296-74f2-4fe5-8c40-34b11db5a931
:END:
This concerns the number shown next to the minibuffer prompt while in
a recursive minibuffer (per ~minibuffer-depth-indicate-mode~ and
related settings to enable minibuffer recursion). Before, the style
was like a mouse highlight, which could be confusing in certain
situations. Now it is an unambiguous coloured background that still
stands out nicely.
** The ~kmacro-menu~ faces are also supported
:PROPERTIES:
:CUSTOM_ID: h:b8294884-9c8c-45d7-b372-b2fb7fbdb100
:END:
These are the marks we see while using the interface provided by the
built-in command ~kmacro-menu~ (alias ~list-keyboard-macros~).
** The ~vtable~ will respect the user choice for "mixed fonts"
:PROPERTIES:
:CUSTOM_ID: h:5ea1131d-1529-45bf-a86f-4c3778177455
:END:
The ~vtable~ face will be rendered in a monospaced font (technically,
it will inherit ~fixed-pitch~) if the user sets the user option
~modus-themes-mixed-fonts~ to a non-nil value. Users may want to do
this to eventually apply a proportionately spaced font for regular
prose while keeping spacing-sensitive elements like blocks and tables
in a monospaced view.
[ The manual shows how to configure the individual font families via
their respective faces. ]
Thanks to shipmints for bringing this matter to my attention in issue
110: <https://github.com/protesilaos/modus-themes/issues/110>.
** The ~jabber~ package is now supported
:PROPERTIES:
:CUSTOM_ID: h:725123b9-31ed-460b-9411-c2cd9f54502c
:END:
Thanks to Thanos Apollo for the contribution. The change is within
the accepted line limit, meaning that Thanos does not need to assign
copyright to the Free Software Foundation.
** The ~doom-modeline~ no longer uses ~bold-italic~
:PROPERTIES:
:CUSTOM_ID: h:28e9a11b-54b0-4df6-9b96-b2db54a2e43e
:END:
This style was used to highlight some forms of emphasis, but it turns
out that it can clip the outline of icon fonts (per the ~nerd-fonts~
package) under some situations.
** Covered the built-in ~window-tool-bar-mode~
:PROPERTIES:
:CUSTOM_ID: h:92b3a588-4d0d-4afd-bb79-31884836292f
:END:
Thanks to Jared Finder for the contribution. The change is small,
meaning that Jared does not need to assign copyright to the Free
Software Foundation.
** Miscellaneous
:PROPERTIES:
:CUSTOM_ID: h:e3617c15-1909-48f2-9a7d-3243a45fc07b
:END:
- The ~elisp-shorthand-font-lock-face~ is now easier to spot in
context. This is a way for Emacs packages to define so-called
"shorthands" of short prefixes in symbols that are aliases for
longer ones. These shorthands will now use a style that is not found
anywhere else in Elisp code, making them stand out more.
- Added partial support for the built-in ~viper~ package. NOTE though
that this package is applying colors to cursors in a way that themes
cannot override. The issue is especially problematic when switching
themes. If anyone is using Viper and interested to modernise it, let
me know about your work and then I will update the themes
accordingly. Thanks to ZharMeny for asking me to support Viper in
issue 115: <https://github.com/protesilaos/modus-themes/issues/115>.
- Fixed the symbol of an inherited face in ~web-mode~. Thanks to Pavel
Novichkov for the change. It does not require copyright assignment.
- Updated the manual to cover the aforementioned.
* 4.4.0
:PROPERTIES:
:CUSTOM_ID: h:4025f2f4-8524-49d9-9ee5-627361ff9875
@ -275,7 +432,7 @@ while.
:PROPERTIES:
:CUSTOM_ID: h:3c2d3f21-7686-4376-a3ec-82240b283eec
:END:
This is subject to the user option ~olivetty-style~, which can be set
to the value of =fancy= to produce a page-like effect.
@ -287,7 +444,7 @@ to my attention on the now-discontinued mailing list:
:PROPERTIES:
:CUSTOM_ID: h:8c6717d2-0488-4590-8083-52e081adf6f5
:END:
The default value of that face inherits from the ~region~ face. This
is fine in some cases, though not when the user calls
~consult-outline~ in a buffer with hidden text (e.g. Org folded
@ -305,7 +462,7 @@ levels but differ on whether the heading has subheadings or not.
Before, we would colourise those differently, which could be
confusing. Now they look the same, which is fine because the interface
has additional markup to show when subheadings are present.
Thanks to ltmsyvag for pointing this out in issue 95:
<https://github.com/protesilaos/modus-themes/issues/95>.

View file

@ -43,11 +43,11 @@ customization options for the Modus themes, and provides every other
piece of information pertinent to them.
The documentation furnished herein corresponds to stable version
4.4.0, released on 2024-03-17. Any reference to a newer feature which
4.5.0, released on 2024-08-21. Any reference to a newer feature which
does not yet form part of the latest tagged commit, is explicitly marked
as such.
Current development target is 4.5.0-dev.
Current development target is 4.6.0-dev.
• Package name (GNU ELPA): modus-themes
• Official manual: <https://protesilaos.com/emacs/modus-themes>
@ -4237,7 +4237,7 @@ have lots of extensions, so the “full support” may not be 100% true…
• isearch, occur, etc.
• ivy*
• ivy-posframe
• jabber [ Part of 4.5.0-dev ]
• jabber
• japanese-holidays
• jira (org-jira)
• jit-spell
@ -4247,7 +4247,7 @@ have lots of extensions, so the “full support” may not be 100% true…
• julia
• kaocha-runner
• keycast
• kmacro-menu [ Part of 4.5.0-dev ]
• kmacro-menu
• ledger-mode
• leerzeichen
• line numbers (display-line-numbers-mode and global variant)
@ -4257,7 +4257,7 @@ have lots of extensions, so the “full support” may not be 100% true…
• marginalia
• markdown-mode
• markup-faces (adoc-mode)
• mb-depth [ Part of 4.5.0-dev ]
• mb-depth
• mct
• messages
• minimap
@ -4353,10 +4353,10 @@ have lots of extensions, so the “full support” may not be 100% true…
• vertico
• vertico-quick
• vimish-fold
• viper [ Part of 4.5.0-dev ]
• viper
• visible-mark
• visual-regexp
• vtable [ Part of 4.5.0-dev ]
• vtable
• vterm
• vundo
• wcheck-mode
@ -4366,7 +4366,7 @@ have lots of extensions, so the “full support” may not be 100% true…
• which-key
• whitespace-mode
• window-divider-mode
• window-tool-bar [ Part of 4.5.0-dev ]
• window-tool-bar
• writegood-mode
• woman
• xah-elisp-mode
@ -6454,47 +6454,47 @@ Node: DIY Use a hook at the post-load-theme phase168053
Node: DIY A theme-agnostic hook for theme loading170177
Node: Face coverage172808
Node: Supported packages173260
Node: Indirectly covered packages179105
Node: Notes on individual packages180474
Node: Note on calendarel weekday and weekend colors181574
Node: Note on git-gutter in Doom Emacs182722
Node: Note on php-mode multiline comments185222
Node: Note on underlines in compilation buffers185982
Node: Note on inline Latex in Org buffers186854
Node: Note on dimmerel187464
Node: Note on display-fill-column-indicator-mode188949
Node: Note on highlight-parenthesesel190402
Node: Note on mmm-modeel background colors196485
Node: Note for prism198839
Node: Note on company-mode overlay pop-up202061
Ref: Note on company-mode overlay pop-up-Footnote-1202791
Ref: Note on company-mode overlay pop-up-Footnote-2202858
Node: Note on ERC escaped color sequences202913
Ref: Note on ERC escaped color sequences-Footnote-1204341
Node: Note on powerline or spaceline204451
Node: Note on SHR colors204865
Node: Note on SHR fonts205289
Node: Note on Ement colors and fonts205976
Node: Note on pdf-tools link hints207486
Node: Note on the Notmuch logo209946
Node: Note on goto-address-mode faces210484
Node: Frequently Asked Questions211602
Node: Is the contrast ratio about adjacent colors?212235
Node: What does it mean to avoid exaggerations?213744
Node: Why are colors mostly variants of blue magenta cyan?215596
Node: What is the best setup for legibility?219930
Node: Are these color schemes?222577
Node: Port the Modus themes to other platforms?226261
Node: Contributing229107
Node: Sources of the themes229506
Node: Issues you can help with230402
Node: Patches require copyright assignment to the FSF231795
Node: Acknowledgements234017
Node: GNU Free Documentation License238282
Node: Indices263646
Node: Function index263825
Node: Variable index265123
Node: Concept index268474
Node: Indirectly covered packages178973
Node: Notes on individual packages180342
Node: Note on calendarel weekday and weekend colors181442
Node: Note on git-gutter in Doom Emacs182590
Node: Note on php-mode multiline comments185090
Node: Note on underlines in compilation buffers185850
Node: Note on inline Latex in Org buffers186722
Node: Note on dimmerel187332
Node: Note on display-fill-column-indicator-mode188817
Node: Note on highlight-parenthesesel190270
Node: Note on mmm-modeel background colors196353
Node: Note for prism198707
Node: Note on company-mode overlay pop-up201929
Ref: Note on company-mode overlay pop-up-Footnote-1202659
Ref: Note on company-mode overlay pop-up-Footnote-2202726
Node: Note on ERC escaped color sequences202781
Ref: Note on ERC escaped color sequences-Footnote-1204209
Node: Note on powerline or spaceline204319
Node: Note on SHR colors204733
Node: Note on SHR fonts205157
Node: Note on Ement colors and fonts205844
Node: Note on pdf-tools link hints207354
Node: Note on the Notmuch logo209814
Node: Note on goto-address-mode faces210352
Node: Frequently Asked Questions211470
Node: Is the contrast ratio about adjacent colors?212103
Node: What does it mean to avoid exaggerations?213612
Node: Why are colors mostly variants of blue magenta cyan?215464
Node: What is the best setup for legibility?219798
Node: Are these color schemes?222445
Node: Port the Modus themes to other platforms?226129
Node: Contributing228975
Node: Sources of the themes229374
Node: Issues you can help with230270
Node: Patches require copyright assignment to the FSF231663
Node: Acknowledgements233885
Node: GNU Free Documentation License238150
Node: Indices263514
Node: Function index263693
Node: Variable index264991
Node: Concept index268342

End Tag Table

View file

@ -4,9 +4,9 @@
#+language: en
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
#+macro: stable-version 4.4.0
#+macro: release-date 2024-03-17
#+macro: development-version 4.5.0-dev
#+macro: stable-version 4.5.0
#+macro: release-date 2024-08-21
#+macro: development-version 4.6.0-dev
#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
#+macro: space @@texinfo:@: @@
#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@ -4088,7 +4088,7 @@ have lots of extensions, so the "full support" may not be 100% true…
+ isearch, occur, etc.
+ ivy*
+ ivy-posframe
+ jabber [ Part of {{{development-version}}} ]
+ jabber
+ japanese-holidays
+ jira (org-jira)
+ jit-spell
@ -4098,7 +4098,7 @@ have lots of extensions, so the "full support" may not be 100% true…
+ julia
+ kaocha-runner
+ keycast
+ kmacro-menu [ Part of {{{development-version}}} ]
+ kmacro-menu
+ ledger-mode
+ leerzeichen
+ line numbers (~display-line-numbers-mode~ and global variant)
@ -4108,7 +4108,7 @@ have lots of extensions, so the "full support" may not be 100% true…
+ marginalia
+ markdown-mode
+ markup-faces (~adoc-mode~)
+ mb-depth [ Part of {{{development-version}}} ]
+ mb-depth
+ mct
+ messages
+ minimap
@ -4204,10 +4204,10 @@ have lots of extensions, so the "full support" may not be 100% true…
+ vertico
+ vertico-quick
+ vimish-fold
+ viper [ Part of {{{development-version}}} ]
+ viper
+ visible-mark
+ visual-regexp
+ vtable [ Part of {{{development-version}}} ]
+ vtable
+ vterm
+ vundo
+ wcheck-mode
@ -4217,7 +4217,7 @@ have lots of extensions, so the "full support" may not be 100% true…
+ which-key
+ whitespace-mode
+ window-divider-mode
+ window-tool-bar [ Part of {{{development-version}}} ]
+ window-tool-bar
+ writegood-mode
+ woman
+ xah-elisp-mode

View file

@ -5,7 +5,7 @@
;; Author: Protesilaos Stavrou <info@protesilaos.com>
;; Maintainer: Protesilaos Stavrou <info@protesilaos.com>
;; URL: https://github.com/protesilaos/modus-themes
;; Version: 4.4.0
;; Version: 4.5.0
;; Package-Requires: ((emacs "27.1"))
;; Keywords: faces, theme, accessibility