emacs/protesilaos.modus-themes
1
0
Fork 0
mirror of https://github.com/protesilaos/modus-themes.git synced 2026-09-10 07:16:30 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

Update to version 1.5.0

Browse source
This commit is contained in:
Protesilaos Stavrou 2021-07-15 14:12:27 +03:00
parent e46618d937
commit b6fb7cda01
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
6 changed files with 560 additions and 258 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

438
CHANGELOG.org
View file

@ -15,6 +15,444 @@ For further details, please consult these additional resources:
+ Manual :: <https://protesilaos.com/modus-themes>
+ Screenshots :: <https://protesilaos.com/modus-themes-pictures>
* 1.5.0
#+begin_src text
Modus themes version 1.5.0
By Protesilaos Stavrou <info@protesilaos.com> on 2021-07-15
This entry outlines the set of changes made to the project since the
release of version 1.4.0 on 2021-05-25. There have been over 130
commits since then.
Every colour-related modification referenced herein is always
implemented in accordance with the primary accessibility objective of
the themes for a minimum contrast ratio of 7:1 between background and
foreground values in their given combination (the WCAG AAA standard).
Such edits also account for colour-coding that is optimised for the
needs of users with red-green colour deficiency (deuteranopia or
variants).
Here is the URL of the manual: <https://protesilaos.com/modus-themes>.
Or read it from Emacs by evaluating this form:
(info "(modus-themes) Top")
The themes are built into Emacs version 28 (current development target),
and are available on GNU ELPA as well as other archives.
Customisation options
=====================
Overview of new style of sets of properties
-------------------------------------------
Several variables now accept a list of symbols as a value. Those
represent properties, which can be combined with each other to realise
the possible styles. The idea was to simplify their specification in
order to make them easier to both maintain and extend. Thanks to Philip
Kaludercic for introducing this concept in issue 210:
<https://gitlab.com/protesilaos/modus-themes/-/issues/210>.
The variables are:
+ 'modus-themes-prompts' by Philip Kaludercic in merge request 43:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/43>
+ 'modus-themes-mode-line' by Philip Kaludercic in merge request 40:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/40>.
+ 'modus-themes-lang-checkers' by Philip Kaludercic in merge request 46:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/46>
+ 'modus-themes-org-agenda'
+ 'modus-themes-links'
+ 'modus-themes-headings'
+ 'modus-themes-hl-line'
+ 'modus-themes-paren-match'
+ 'modus-themes-region'
+ 'modus-themes-syntax'
Take 'modus-themes-syntax' as an example. Up until version 1.4.0, it
would only accept a symbol, signifying a predefined style. So we had
the possible value 'faint' and another 'faint-yellow-comments'. To make
a third variant of the "faint" aesthetic, such as by combining it with
the "alt syntax" and/or "green strings", we would need to write new
presets in the form of 'faint-green-strings', 'faint-alt-syntax',
'faint-alt-syntax-green-strings', 'faint-green-strings-yellow-comments',
'faint-alt-syntax-green-strings-yellow-comments'. That would have been
inefficient, hence why it was not done.
With the new approach of defining a list of properties, those
combinations are all possible. Such as:
(setq modus-themes-syntax '(faint alt-syntax))
(setq modus-themes-syntax '(yellow-comments alt-syntax green-strings))
The order in which the properties are set is not significant.
The doc string of each of the aforementioned variables, or the
corresponding entry in the manual, provides guidance on how to configure
things. The old forms will continue to work for the time being, though
they are considered deprecated and will stop being supported at a future
date.
Changes in stylistic variants for variables with sets of properties
-------------------------------------------------------------------
+ The meaning of the "alt syntax" style in 'modus-themes-syntax' has
been redefined. In the past, it used to have green-coloured strings
and doc strings. Those are now red. Some other changes have been
implemented to make the overall looks more consistent. Users who
liked the old style can retain it by passing this list of properties:
(alt-syntax green-strings)
New styles for the "faint" aesthetic are possible, here shown as lists
of properties:
(faint green-strings)
(faint alt-syntax)
(faint alt-syntax green-strings)
To each of those the 'yellow-comments' property can be added as well.
Consult the doc string or the manual for the technicalities and code
samples.
+ The 'modus-themes-hl-line' no longer has styles that include only an
underline. Those proved to be problematic under certain circumstances
and were thus removed.
Minor changes have been implemented to make the following combination
of properties more consistent, by colourising the underline:
(accented intense underline)
+ The 'modus-themes-paren-match' now has styles that include an
'underline' property. Those extend the old options, such as:
(bold intense underline)
+ The 'modus-themes-headings' have an improved set of styles for the "no
text color" aesthetic. Those involve the 'monochrome' property, which
can now yield results that include a background (whereas before it was
just colourless text for the headings, optionally without a bold
weight). As this is an alist, here is an example (always check the
docs for fully fledged code samples):
(setq modus-themes-headings
'((1 . (background overline))
(2 . (overline background rainbow))
(t . (monochrome no-bold background))))
To allow a heading level N to retain its original style, a 't' value
can be passed. In the previous version of the themes, it was possible
to use 'nil' for the same purpose, though that is no longer valid. In
those cases, the fallback value of the alist will be used instead,
such as what is noted above:
(t . (monochrome no-bold background))
+ The 'modus-themes-links' provide several new possible styles, due to
an expanded set of properties that includes, among others, 'bold',
'italic', and 'background'. The documentation covers the details.
+ The 'modus-themes-lang-checkers' can now attain a style that uses a
prominently coloured background in addition to what was available
before as a subtle background and the other variants.
New variables
-------------
+ The 'modus-themes-org-agenda' provides the means to refashion the
entirety of the Org agenda buffer. The value it accepts is an alist,
with some keys expecting a symbol and others a list of properties.
The minutia are covered in its doc string. A possible configuration
can look like this:
(setq modus-themes-org-agenda
'((header-block . (variable-pitch scale-title))
(header-date . (grayscale workaholic bold-today))
(scheduled . uniform)
(habit . traffic-light)))
'modus-themes-org-agenda' supersedes the old variable that was specific
to the Org habit graph: 'modus-themes-org-habit'. There now is a
'habit' key which accepts the same values as before, plus a new style
that is optimised for users with red-green colour deficiency:
'traffic-light-deuteranopia'. Please consult the doc string of
'modus-themes-org-agenda' or the relevant entry to the manual.
Thanks to Gustavo Barros for contributing to the creation of this
variable as well as to all other changes in the relevant faces that
were done in the interest of usability. A full report about
'modus-themes-org-agenda' with screen shots is available here:
<https://protesilaos.com/codelog/2021-06-02-modus-themes-org-agenda/>.
A patch has been sent to upstream Org, with its review pending, which
improves upon some of the areas we had identified:
<https://lists.gnu.org/archive/html/emacs-orgmode/2021-06/msg00092.html>.
+ The 'modus-themes-inhibit-reload' controls a new behaviour of
automatically reloading the active theme when an option is set via the
Custom interfaces or with 'customize-set-variable'. To opt-in to this
feature, set the variable to a 'nil' value.
Thanks to Philip Kaludercic for implementing this in merge request 40:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/40>.
In the development phase of this option, a bug was identified
pertaining to recursion, as reported by Gustavo Barros in issue 213:
<https://gitlab.com/protesilaos/modus-themes/-/issues/213>. Changes
have been made to remove that possibility, as found in merge request
45: <https://gitlab.com/protesilaos/modus-themes/-/merge_requests/45>.
A thread was started on the emacs-devel mailing list to inquire upon
the technicalities of this option, but it did not gain any traction:
<https://lists.gnu.org/archive/html/emacs-devel/2021-06/msg00828.html>.
As such, we have decided to take our chances by pressing on with this
feature. Users who are interested in it are encouraged to give it a
try and report any possible complications. Issue 213 remains open.
+ The 'modus-themes-italic-constructs' is the new name of the variable
'modus-themes-slanted-constructs'. The term "slant" was considered
too vague or technical and some users could have missed the meaning of
this option.
+ The 'modus-themes-scale-5' is renamed to 'modus-themes-scale-title' to
better convey its utility.
Changes to the manual
=====================
+ Rewrote or introduced the documentation for all the customisation
options mentioned above. Also updated relevant code samples, such as
in the manual's introduction to the customisation options. Evaluate
this form for an annotated code overview:
(info "(modus-themes) Customization Options")
+ Rephrased a reference to "gamma ray values" as "gamma values". Thanks
to Anders Johansson for the contribution in merge request 42:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/42>.
+ Removed the Org macro that would insert the build date in the manual's
introduction. This was required to make the file reproducible,
otherwise it would keep changing each time a new version of Emacs was
built. Refer to Emacs bug#48661 by Glenn Morris:
<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=48661>.
+ Included note on tweaking the key hints that the Avy package produces.
This is in response to issue 215 by Rudolf Adamkovič:
<https://gitlab.com/protesilaos/modus-themes/-/issues/215>. Thanks to
Nicolas De Jaeghere for providing the text.
+ Wrote a note on how to control the underlines that are generated in
compilation-mode buffers and related. It is about configuring the
variable 'compilation-message-face'.
+ Documented how to configure the colours that are applied to the names
of the days in the 'M-x calendar' interface. The relevant variable is
'calendar-weekend-days'.
+ Elaborated on a "do it yourself" (DIY) guide on how to benefit from
the hidden feature of the themes about how they handle the bold weight
and the italic slant. In short, we do not hardcode values and thus
make it easy for users to specify the particularities of what it means
for a face to have a 'bold' or 'italic' attribute.
Faces and face groups
=====================
New entries
-----------
Newly supported packages:
+ 'ledger-mode'. Thanks to Pengji Zhang for the feedback in issue 202:
<https://gitlab.com/protesilaos/modus-themes/-/issues/202>.
+ 'gotest'. Thanks to Jerry Zhang for the feedback in issue 226:
<https://gitlab.com/protesilaos/modus-themes/-/issues/226>.
+ 'css-mode'
New faces for already supported groups:
+ 'shr-h1', 'shr-h2', 'shr-h3', 'shr-h4', 'shr-h5', 'shr-h6' of the
shr.el library (simple HTML renderer, as experienced in, for example,
EWW). Those are available for Emacs28, with a patch by me:
<http://debbugs.gnu.org/cgi/bugreport.cgi?bug=49433>
+ 'apropos-button' as a generic face that fontifies faces in apropos
buffers. Available for Emacs28, with a patch by me:
<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=49162>.
+ 'selectrum-mouse-highlight'. This makes the mouse hover effect for
selectrum look the same as in most other contexts. Thanks to okamsn
for the feedback in issue 203:
<https://gitlab.com/protesilaos/modus-themes/-/issues/203>.
Review of existing entries
--------------------------
+ Added an ':extend' property to 'next-error' face. This face is used
for pulse effects. It is good to have them extend to the edge of the
window, so that they are easier to spot. Thanks to Gustavo Barros for
the feedback in issue 200, which is about pulse.el:
<https://gitlab.com/protesilaos/modus-themes/-/issues/200>.
+ Tweaked the various Apropos faces. The idea was to remove the colour
from the pseudo headings so that we would not get an exaggerated
result of too much variety in the buffer (e.g. that of 'M-x apropos').
The individual buttons retain their style as links, meaning that they
are governed by the variable 'modus-themes-links'.
+ Revised 'whitespace-line' face to make it look like a warning, as it
ought to be. Thanks to Pengji Zhang for the feedback in issue 204:
<https://gitlab.com/protesilaos/modus-themes/-/issues/204>.
+ Reworked the colour-coding of the Hydra and Transient packages. These
are meant to tone down some excesses with the standard red and to
adapt other colours to it. Thanks to Gustavo Barros for providing
suggestions and helping me tweak those in issue 206:
<https://gitlab.com/protesilaos/modus-themes/-/issues/206>.
+ Recoloured 'transient-argument' to improve its uniqueness in its
context and to better comply with the expectation of hydra-style
colour coding, as noted right above.
+ Made the 'org-agenda-done' face conform with the customisation option
'modus-themes-success-deuteranopia'. This means that it will be
coloured in blue instead of green when the option is set to a non-nil
value.
+ Grayed out the foreground of the Org block delimiter lines on the
premise that any extra colouration was not needed, given the presence
of a gray background and the overall markup of the block.
+ Toned down the colouration of the 'org-code' face, so that it is
consistent with 'org-verbatim' as well as the colours used in opening
and closing lines of blocks. Thanks to Gustavo Barros for suggesting
this change in issue 206, though it went through a couple of reviews:
<https://gitlab.com/protesilaos/modus-themes/-/issues/206>.
+ Simplified the inheritance of the 'fixed-pitch' face, which is used
for internal purposes to ensure alignment of elements in buffers that
must cope with mixed font configurations, such as an org-mode file
with 'M-x variable-pitch-font' enabled.
[ Recall that the option 'modus-themes-no-mixed-fonts' can disable
this feature. Also note that the 'mixed-fonts' package, or
equivalent, is not needed while using the Modus themes (though there
is nothing wrong with having them together). ]
+ Reduced the overall intensity of 'org-mode-line-clock-overrun'.
Thanks to Gustavo Barros for the feedback in issue 208:
<https://gitlab.com/protesilaos/modus-themes/-/issues/208>.
+ Simplified or otherwise tweaked several Org agenda faces to render
possible the new 'modus-themes-org-agenda' variable, as documented
above. Thanks to Gustavo Barros for the feedback in issue 208:
<https://gitlab.com/protesilaos/modus-themes/-/issues/208>.
+ Increased ever so slightly the foreground colour of the 'highlight'
face. This can help improve the perception of highlights, such as
upon hovering over a link with the mouse. Thanks to Rudolf Adamkovič
for reporting the potential problem in issue 216:
<https://gitlab.com/protesilaos/modus-themes/-/issues/216>.
+ Prevented the override of the 'diff-context' face when users assign a
'bg-only' value to the 'modus-themes-diffs' variable. This makes it
consistent with the intent of this style, which is to work with a
non-nil value for 'diff-font-lock-syntax' (basically to allow the
usual colour highlights of the underlying code syntax in diff
buffers).
+ Ensured consistency of all prompt-related faces by introducing a new
face, 'modus-themes-prompt', that is inherited by all others (all
prompt styles are controlled by the variable 'modus-themes-prompts').
This was originally implemented with the 'comint-highlight-prompt'
face, though that could potentially lead to undefined faces if the
comint library was not loaded. Whereas the 'modus-themes-prompt'
guarantees that we pass a known face at all times. Thanks to Philip
Kaludercic for bringing this potential bug to my attention in a
comment to merge request 43:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/43#note_615224855>.
+ Removed the background colour from the 'widget-inactive' face. It
would create problems in some cases, such as in Custom buffers for
multiple choice options.
+ Refined 'calendar-weekend-header' and 'calendar-weekday-header' to
emulate the design of physical calendars and remain truthful to the
expectations set by the default configuration of the calendar.el
library. Weekends now use a faint red, while weekdays are rendered in
the same subtle gray they had before. The underlying principle is to
make weekends convey a subtle warning to the effect that "this is not
a day for work" (notwithstanding precarious economic realities). As
noted above, there is an entry in the manual on how to make all days
look the same, be it gray or faint red. Evaluate this form:
(info "(modus-themes) Note on calendarel weekday and weekend colors")
Request for feedback on a potential version 2.0.0 of the Modus themes
=====================================================================
While we maintain a cautious stance towards preserving the default
styles, there are some cases where we might be forced to introduce
backward-incompatible changes.
Three such cases that can benefit from user feedback are:
+ Issue 196 on 'modus-themes-no-mixed-fonts'
<https://gitlab.com/protesilaos/modus-themes/-/issues/196>.
+ Issue 198 on 'modus-themes-hl-line'
<https://gitlab.com/protesilaos/modus-themes/-/issues/198>
[ Note that 'modus-themes-hl-line now accepts a list of properties as
described in the opening sections of this entry. ]
+ Issue 218 on 'modus-themes-diffs'
<https://gitlab.com/protesilaos/modus-themes/-/issues/218>.
Miscellaneous
=============
+ Recalibrated the value of the colour 'bg-hl-line-intense' in the
palette 'modus-themes-vivendi-colors'. The change should be
practically indecipherable, though it slightly improves things in
certain contexts.
+ Refined the intensity of the three main yellow colours in
'modus-themes-vivendi-colors'.
+ Introduced a new 'modus-themes-faces' group so that those are
decoupled from the customisation options in the various Custom
buffers. Thanks to Philip Kaludercic for the patch in merge request
39: <https://gitlab.com/protesilaos/modus-themes/-/merge_requests/39>.
+ Updated the manual's "Acknowledgements" section to include all new
users who contributed to the project.
Thanks again to everyone involved!
#+end_src
* 1.4.0
#+begin_src text

299
doc/modus-themes.info
View file

@ -43,11 +43,11 @@ customization options for the ‘modus-operandi’ and ‘modus-vivendi’
themes, and provides every other piece of information pertinent to them.
The documentation furnished herein corresponds to stable version
1.4.0, released on 2021-05-25. Any reference to a newer feature which
1.5.0, released on 2021-07-15. 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 1.5.0-dev.
Current development target is 1.6.0-dev.
* Menu:
@ -110,7 +110,6 @@ Customization Options
* Diffs:: Choose among intense, desaturated, or text-only diffs
* Org mode blocks:: Choose among plain, gray, or tinted backgrounds
* Org agenda:: Control each element in the presentation of the agenda
* Org agenda habits:: Choose among standard, simplified, or traffic light styles
* Heading styles:: Choose among several styles, also per heading level
* Scaled headings:: Toggle scaling of headings
* UI typeface:: Toggle the use of variable-pitch across the User Interface
@ -621,7 +620,6 @@ of this manual.
* Diffs:: Choose among intense, desaturated, or text-only diffs
* Org mode blocks:: Choose among plain, gray, or tinted backgrounds
* Org agenda:: Control each element in the presentation of the agenda
* Org agenda habits:: Choose among standard, simplified, or traffic light styles
* Heading styles:: Choose among several styles, also per heading level
* Scaled headings:: Toggle scaling of headings
* UI typeface:: Toggle the use of variable-pitch across the User Interface
@ -633,9 +631,7 @@ File: modus-themes.info, Node: Custom reload theme, Next: Success' color-code,
4.1 Option for inhibiting theme reload
======================================
[ Part of 1.5.0-dev ]
Symbol: ‘modus-themes-inhibit-reload’
Symbol: ‘modus-themes-inhibit-reload’
Possible values:
@ -734,9 +730,7 @@ File: modus-themes.info, Node: Syntax styles, Next: No mixed fonts, Prev: Ita
4.5 Option for syntax highlighting
==================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-syntax’
Symbol: ‘modus-themes-syntax’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -822,9 +816,7 @@ File: modus-themes.info, Node: Link styles, Next: Command prompts, Prev: No m
4.7 Option for links
====================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-links’
Symbol: ‘modus-themes-links’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -891,9 +883,7 @@ File: modus-themes.info, Node: Command prompts, Next: Mode line, Prev: Link s
4.8 Option for command prompt styles
====================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-prompts’
Symbol: ‘modus-themes-prompts’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -944,9 +934,7 @@ File: modus-themes.info, Node: Mode line, Next: Completion UIs, Prev: Command
4.9 Option for mode line presentation
=====================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-mode-line’
Symbol: ‘modus-themes-mode-line’
Possible values, which can be expressed as a list of combinations of
box effect, color, and border visibility:
@ -1118,9 +1106,7 @@ File: modus-themes.info, Node: Language checkers, Next: Line highlighting, Pr
4.13 Option for language checkers
=================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-lang-checkers’
Symbol: ‘modus-themes-lang-checkers’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -1176,9 +1162,7 @@ File: modus-themes.info, Node: Line highlighting, Next: Line numbers, Prev: L
4.14 Option for line highlighting (hl-line-mode)
================================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-hl-line’
Symbol: ‘modus-themes-hl-line’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -1252,9 +1236,7 @@ File: modus-themes.info, Node: Matching parentheses, Next: Active region, Pre
4.16 Option for parenthesis matching (show-paren-mode)
======================================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-paren-match’
Symbol: ‘modus-themes-paren-match’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -1298,9 +1280,7 @@ File: modus-themes.info, Node: Active region, Next: Diffs, Prev: Matching par
4.17 Option for active region
=============================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-region’
Symbol: ‘modus-themes-region’
Possible values are expressed as a list of properties (default is
‘nil’ or an empty list). The list can include any of the following
@ -1425,15 +1405,12 @@ delimiter fontification (DIY).
aliases for ‘gray-background’ and ‘tinted-background’, respectively.

File: modus-themes.info, Node: Org agenda, Next: Org agenda habits, Prev: Org mode blocks, Up: Customization Options
File: modus-themes.info, Node: Org agenda, Next: Heading styles, Prev: Org mode blocks, Up: Customization Options
4.20 Option for Org agenda constructs
=====================================
[ Part of 1.5.0-dev. Supersedes ‘modus-themes-org-habit’ (*note Option
for org-habit graph styles: Org agenda habits.). ]
Symbol: ‘modus-themes-org-agenda’
Symbol: ‘modus-themes-org-agenda’
This is an alist that accepts a ‘(key . value)’ combination. Some
values are specified as a list. Here is a sample, followed by a
@ -1556,56 +1533,12 @@ are passed as a symbol. Those are:
(habit . traffic-light)))

File: modus-themes.info, Node: Org agenda habits, Next: Heading styles, Prev: Org agenda, Up: Customization Options
File: modus-themes.info, Node: Heading styles, Next: Scaled headings, Prev: Org agenda, Up: Customization Options
4.21 Option for org-habit graph styles
======================================
[ Deprecated and superseded by ‘modus-themes-org-agenda’ in 1.5.0-dev
(*note Option for Org agenda constructs: Org agenda.). ]
Symbol: ‘modus-themes-org-habit’
Possible values:
1. ‘nil’ (default)
2. ‘simplified’
3. ‘traffic-light’
The default is meant to conform with the original aesthetic of
‘org-habit’. It employs all four color codes that correspond to the
org-habit states—clear, ready, alert, and overdue—while distinguishing
between their present and future variants. This results in a total of
eight colors in use: red, yellow, green, blue, in tinted and shaded
versions. They cover the full set of information provided by the
‘org-habit’ consistency graph.
Option ‘simplified’ is like the default except that it removes the
dichotomy between current and future variants by applying uniform
color-coded values. It applies a total of four colors: red, yellow,
green, blue. They produce a simplified consistency graph that is more
legible (or less “busy”) than the default. The intent is to shift focus
towards the distinction between the four states of a habit task, rather
than each state’s present/future outlook.
Option ‘traffic-light’ further reduces the available colors to red,
yellow, and green. As in ‘simplified’, present and future variants
appear uniformly, but differently from it, the ’clear’ state is rendered
in a green hue, instead of the original blue. This is meant to capture
the use-case where a habit task being “too early” is less important than
it being “too late”. The difference between ready and clear states is
attenuated by painting both of them using shades of green. This option
thus highlights the alert and overdue states.

File: modus-themes.info, Node: Heading styles, Next: Scaled headings, Prev: Org agenda habits, Up: Customization Options
4.22 Option for the headings’ overall style
4.21 Option for the headings’ overall style
===========================================
[ Refactored as part of 1.5.0-dev ]
Symbol: ‘modus-themes-headings’
Symbol: ‘modus-themes-headings’
This is an alist that accepts a ‘(key . list-of-values)’ combination.
The key is either a number, representing the heading’s level or ‘t’,
@ -1685,7 +1618,7 @@ others, such as ‘org-fontify-done-headline’.

File: modus-themes.info, Node: Scaled headings, Next: UI typeface, Prev: Heading styles, Up: Customization Options
4.23 Option for scaled headings
4.22 Option for scaled headings
===============================
Symbol: ‘modus-themes-scale-headings’
@ -1708,7 +1641,7 @@ Info.

File: modus-themes.info, Node: Scaled heading sizes, Up: Scaled headings
4.23.1 Control the scale of headings
4.22.1 Control the scale of headings
------------------------------------
In addition to the toggle for enabling scaled headings, users can also
@ -1772,7 +1705,7 @@ size of the heading, but not of keywords that were added to it, like

File: modus-themes.info, Node: UI typeface, Next: Headings' typeface, Prev: Scaled headings, Up: Customization Options
4.24 Option for variable-pitch font in UI elements
4.23 Option for variable-pitch font in UI elements
==================================================
Symbol: ‘modus-themes-variable-pitch-ui’
@ -1799,7 +1732,7 @@ Org and others (DIY).

File: modus-themes.info, Node: Headings' typeface, Prev: UI typeface, Up: Customization Options
4.25 Option for variable-pitch font in headings
4.24 Option for variable-pitch font in headings
===============================================
Symbol: ‘modus-themes-variable-pitch-headings’
@ -4916,7 +4849,6 @@ B.2 Variable index
* modus-themes-operandi-color-overrides: Override colors (DIY). (line 6)
* modus-themes-org-agenda: Org agenda. (line 6)
* modus-themes-org-blocks: Org mode blocks. (line 6)
* modus-themes-org-habit: Org agenda habits. (line 6)
* modus-themes-paren-match: Matching parentheses. (line 6)
* modus-themes-prompts: Command prompts. (line 6)
* modus-themes-region: Active region. (line 6)
@ -4990,102 +4922,101 @@ B.3 Concept index

Tag Table:
Node: Top860
Node: Overview6930
Node: How do the themes look like8473
Node: Learn about the latest changes8981
Node: Installation9363
Node: Install manually from source9844
Node: Install from the archives10669
Node: Install on GNU/Linux11446
Node: Debian 11 Bullseye11894
Node: GNU Guix12204
Node: Enable and load12487
Node: Sample configuration for use-package15476
Node: Differences between loading and enabling16854
Node: Customization Options18894
Node: Custom reload theme25398
Node: Success' color-code25959
Node: Bold constructs26896
Node: Italic constructs27685
Node: Syntax styles28403
Node: No mixed fonts30476
Node: Link styles31571
Node: Command prompts33982
Node: Mode line35715
Node: Completion UIs39260
Node: Mail citations41131
Node: Fringes41984
Node: Language checkers42646
Node: Line highlighting44707
Node: Line numbers46262
Node: Matching parentheses47340
Node: Active region48672
Node: Diffs50041
Node: Org mode blocks51980
Node: Org agenda53858
Node: Org agenda habits59485
Node: Heading styles61451
Node: Scaled headings64540
Node: Scaled heading sizes65143
Node: UI typeface68399
Node: Headings' typeface69245
Node: Advanced customization (do-it-yourself)69869
Node: Per-theme customization settings (DIY)71274
Node: Case-by-case face specs using the themes' palette (DIY)72620
Node: Face specs at scale using the themes' palette (DIY)77084
Node: Remap face with local value (DIY)81901
Node: Cycle through arbitrary colors (DIY)84426
Node: Override colors (DIY)90992
Node: Override color saturation (DIY)95885
Node: Font configurations for Org and others (DIY)101638
Ref: Font configurations for Org and others (DIY)-Footnote-1104286
Node: Configure bold and italic faces (DIY)104473
Node: Custom Org user faces (DIY)108519
Node: Update Org block delimiter fontification (DIY)112275
Node: Measure color contrast (DIY)114235
Node: Load theme depending on time of day (DIY)117029
Node: Backdrop for pdf-tools (DIY)118069
Node: A theme-agnostic hook for theme loading (DIY)120858
Node: Face coverage123248
Node: Supported packages123717
Node: Indirectly covered packages130520
Node: Notes on individual packages131074
Node: Note on avy hints132063
Node: Note on calendarel weekday and weekend colors133231
Node: Note on underlines in compilation buffers134414
Node: Note on inline Latex in Org buffers135263
Node: Note on dimmerel135873
Node: Note on display-fill-column-indicator-mode137358
Node: Note on mmm-modeel background colors138979
Node: Note for prism141358
Node: Note for god-mode144584
Node: Note on company-mode overlay pop-up146256
Ref: Note on company-mode overlay pop-up-Footnote-1146946
Ref: Note on company-mode overlay pop-up-Footnote-2147013
Node: Note on ERC escaped color sequences147068
Ref: Note on ERC escaped color sequences-Footnote-1148496
Node: Note on powerline or spaceline148606
Node: Note on SHR colors149020
Node: Note on EWW and Elfeed fonts (SHR fonts)149455
Node: Note on Helm grep150200
Node: Note on vc-annotate-background-mode151687
Node: Note on pdf-tools link hints152572
Node: Frequently Asked Questions (FAQ)155004
Node: Is the contrast ratio about adjacent colors?155578
Node: What does it mean to avoid exaggerations?157091
Node: Why are colors mostly variants of blue magenta cyan?158926
Node: What is the best setup for legibility?163273
Node: Contributing165880
Node: Sources of the themes166283
Node: Issues you can help with167021
Node: Patches require copyright assignment to the FSF168221
Node: Acknowledgements170516
Node: Meta173057
Node: GNU Free Documentation License175054
Node: Indices200406
Node: Function index200585
Node: Variable index201822
Node: Concept index204036
Node: Overview6838
Node: How do the themes look like8381
Node: Learn about the latest changes8889
Node: Installation9271
Node: Install manually from source9752
Node: Install from the archives10577
Node: Install on GNU/Linux11354
Node: Debian 11 Bullseye11802
Node: GNU Guix12112
Node: Enable and load12395
Node: Sample configuration for use-package15384
Node: Differences between loading and enabling16762
Node: Customization Options18802
Node: Custom reload theme25214
Node: Success' color-code25749
Node: Bold constructs26686
Node: Italic constructs27475
Node: Syntax styles28193
Node: No mixed fonts30226
Node: Link styles31321
Node: Command prompts33692
Node: Mode line35385
Node: Completion UIs38890
Node: Mail citations40761
Node: Fringes41614
Node: Language checkers42276
Node: Line highlighting44297
Node: Line numbers45812
Node: Matching parentheses46890
Node: Active region48182
Node: Diffs49511
Node: Org mode blocks51450
Node: Org agenda53328
Node: Heading styles58820
Node: Scaled headings61862
Node: Scaled heading sizes62465
Node: UI typeface65721
Node: Headings' typeface66567
Node: Advanced customization (do-it-yourself)67191
Node: Per-theme customization settings (DIY)68596
Node: Case-by-case face specs using the themes' palette (DIY)69942
Node: Face specs at scale using the themes' palette (DIY)74406
Node: Remap face with local value (DIY)79223
Node: Cycle through arbitrary colors (DIY)81748
Node: Override colors (DIY)88314
Node: Override color saturation (DIY)93207
Node: Font configurations for Org and others (DIY)98960
Ref: Font configurations for Org and others (DIY)-Footnote-1101608
Node: Configure bold and italic faces (DIY)101795
Node: Custom Org user faces (DIY)105841
Node: Update Org block delimiter fontification (DIY)109597
Node: Measure color contrast (DIY)111557
Node: Load theme depending on time of day (DIY)114351
Node: Backdrop for pdf-tools (DIY)115391
Node: A theme-agnostic hook for theme loading (DIY)118180
Node: Face coverage120570
Node: Supported packages121039
Node: Indirectly covered packages127842
Node: Notes on individual packages128396
Node: Note on avy hints129385
Node: Note on calendarel weekday and weekend colors130553
Node: Note on underlines in compilation buffers131736
Node: Note on inline Latex in Org buffers132585
Node: Note on dimmerel133195
Node: Note on display-fill-column-indicator-mode134680
Node: Note on mmm-modeel background colors136301
Node: Note for prism138680
Node: Note for god-mode141906
Node: Note on company-mode overlay pop-up143578
Ref: Note on company-mode overlay pop-up-Footnote-1144268
Ref: Note on company-mode overlay pop-up-Footnote-2144335
Node: Note on ERC escaped color sequences144390
Ref: Note on ERC escaped color sequences-Footnote-1145818
Node: Note on powerline or spaceline145928
Node: Note on SHR colors146342
Node: Note on EWW and Elfeed fonts (SHR fonts)146777
Node: Note on Helm grep147522
Node: Note on vc-annotate-background-mode149009
Node: Note on pdf-tools link hints149894
Node: Frequently Asked Questions (FAQ)152326
Node: Is the contrast ratio about adjacent colors?152900
Node: What does it mean to avoid exaggerations?154413
Node: Why are colors mostly variants of blue magenta cyan?156248
Node: What is the best setup for legibility?160595
Node: Contributing163202
Node: Sources of the themes163605
Node: Issues you can help with164343
Node: Patches require copyright assignment to the FSF165543
Node: Acknowledgements167838
Node: Meta170379
Node: GNU Free Documentation License172376
Node: Indices197728
Node: Function index197907
Node: Variable index199144
Node: Concept index201285

End Tag Table

73
doc/modus-themes.org
View file

@ -5,9 +5,9 @@
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
#+macro: stable-version 1.4.0
#+macro: release-date 2021-05-25
#+macro: development-version 1.5.0-dev
#+macro: stable-version 1.5.0
#+macro: release-date 2021-07-15
#+macro: development-version 1.6.0-dev
#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
#+macro: space @@texinfo:@: @@
#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@ -469,8 +469,6 @@ this manual.
:end:
#+vindex: modus-themes-inhibit-reload
[ Part of {{{development-version}}} ]
Symbol: ~modus-themes-inhibit-reload~
Possible values:
@ -576,8 +574,6 @@ Advanced users may also want to configure the exact attributes of the
:end:
#+vindex: modus-themes-syntax
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-syntax~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -670,8 +666,6 @@ are ~org-variable-pitch~ and ~mixed-pitch~.
:end:
#+vindex: modus-themes-links
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-links~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -743,8 +737,6 @@ their documentation strings.
:end:
#+vindex: modus-themes-prompts
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-prompts~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -801,8 +793,6 @@ In user configuration files the form may look like this:
:end:
#+vindex: modus-themes-mode-line
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-mode-line~
Possible values, which can be expressed as a list of combinations of box
@ -984,8 +974,6 @@ names imply.
:end:
#+vindex: modus-themes-lang-checkers
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-lang-checkers~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -1046,8 +1034,6 @@ style, is controlled by the built-in variables ~underline-minimum-offset~,
:end:
#+vindex: modus-themes-hl-line
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-hl-line~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -1129,8 +1115,6 @@ updated to accommodate this aesthetic.
:end:
#+vindex: modus-themes-paren-match
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-paren-match~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -1178,8 +1162,6 @@ This customization variable affects the built-in ~show-paren-mode~ and the
:end:
#+vindex: modus-themes-region
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-region~
Possible values are expressed as a list of properties (default is ~nil~ or
@ -1313,9 +1295,6 @@ and ~rainbow~. Those will continue to work as they are aliases for
:end:
#+vindex: modus-themes-org-agenda
[ Part of {{{development-version}}}. Supersedes ~modus-themes-org-habit~
([[#h:cf261363-d227-4717-ba3a-8171584030a7][Option for org-habit graph styles]]). ]
Symbol: ~modus-themes-org-agenda~
This is an alist that accepts a =(key . value)= combination. Some values
@ -1448,50 +1427,6 @@ Putting it all together, the alist can look like this:
(habit . traffic-light)))
#+end_src
** Option for org-habit graph styles
:properties:
:alt_title: Org agenda habits
:description: Choose among standard, simplified, or traffic light styles
:custom_id: h:cf261363-d227-4717-ba3a-8171584030a7
:end:
#+vindex: modus-themes-org-habit
[ Deprecated and superseded by ~modus-themes-org-agenda~ in
{{{development-version}}} ([[#h:68f481bc-5904-4725-a3e6-d7ecfa7c3dbc][Option for Org agenda constructs]]). ]
Symbol: ~modus-themes-org-habit~
Possible values:
1. ~nil~ (default)
2. ~simplified~
3. ~traffic-light~
The default is meant to conform with the original aesthetic of
=org-habit=. It employs all four color codes that correspond to the
org-habit states---clear, ready, alert, and overdue---while
distinguishing between their present and future variants. This results
in a total of eight colors in use: red, yellow, green, blue, in tinted
and shaded versions. They cover the full set of information provided by
the =org-habit= consistency graph.
Option ~simplified~ is like the default except that it removes the
dichotomy between current and future variants by applying uniform
color-coded values. It applies a total of four colors: red, yellow,
green, blue. They produce a simplified consistency graph that is more
legible (or less "busy") than the default. The intent is to shift focus
towards the distinction between the four states of a habit task, rather
than each state's present/future outlook.
Option ~traffic-light~ further reduces the available colors to red,
yellow, and green. As in ~simplified~, present and future variants appear
uniformly, but differently from it, the 'clear' state is rendered in a
green hue, instead of the original blue. This is meant to capture the
use-case where a habit task being "too early" is less important than it
being "too late". The difference between ready and clear states is
attenuated by painting both of them using shades of green. This option
thus highlights the alert and overdue states.
** Option for the headings' overall style
:properties:
:alt_title: Heading styles
@ -1500,8 +1435,6 @@ thus highlights the alert and overdue states.
:end:
#+vindex: modus-themes-headings
[ Refactored as part of {{{development-version}}} ]
Symbol: ~modus-themes-headings~
This is an alist that accepts a =(key . list-of-values)= combination. The

2
modus-operandi-theme.el
View file

@ -4,7 +4,7 @@
;; Author: Protesilaos Stavrou <info@protesilaos.com>
;; URL: https://gitlab.com/protesilaos/modus-themes
;; Version: 1.4.0
;; Version: 1.5.0
;; Package-Requires: ((emacs "26.1"))
;; Keywords: faces, theme, accessibility

4
modus-themes.el
View file

@ -4,8 +4,8 @@
;; Author: Protesilaos Stavrou <info@protesilaos.com>
;; URL: https://gitlab.com/protesilaos/modus-themes
;; Version: 1.4.0
;; Last-Modified: <2021-07-15 13:18:36 +0300>
;; Version: 1.5.0
;; Last-Modified: <2021-07-15 13:21:55 +0300>
;; Package-Requires: ((emacs "26.1"))
;; Keywords: faces, theme, accessibility

2
modus-vivendi-theme.el
View file

@ -4,7 +4,7 @@
;; Author: Protesilaos Stavrou <info@protesilaos.com>
;; URL: https://gitlab.com/protesilaos/modus-themes
;; Version: 1.4.0
;; Version: 1.5.0
;; Package-Requires: ((emacs "26.1"))
;; Keywords: faces, theme, accessibility