Update to version 2.0.0

This commit is contained in:
Protesilaos Stavrou 2021-12-24 12:35:56 +02:00
parent a924ccf810
commit 8485dba0b1
No known key found for this signature in database
GPG key ID: 99BD6459CD5CA3EA
6 changed files with 485 additions and 132 deletions

View file

@ -15,6 +15,385 @@ For further details, please consult these additional resources:
+ Manual :: <https://protesilaos.com/emacs/modus-themes>
+ Screenshots :: <https://protesilaos.com/emacs/modus-themes-pictures>
* 2.0.0
#+begin_src text
Modus themes version 2.0.0
By Protesilaos Stavrou <info@protesilaos.com> on 2021-12-24
This entry covers the changes made to the project since the publication
of version 1.7.0 on 2021-11-18. There have been more than 90 commits in
the meantime. This is a major upgrade with some backward-incompatible
changes, even though most work was done behind the scenes (i.e. not in
git commits but local testing) to guarantee the relevance of all
user-facing styles, code practices, et cetera.
All modifications of colour combinations mentioned herein are made 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 for relative colour
luminance). Edits also account for colour-coding that is optimised for
the needs of users with red-green colour deficiency (deuteranopia).
To access the URL of the manual visit this web page:
<https://protesilaos.com/emacs/modus-themes>. Or read it in the Emacs
Info reader by evaluating this form:
(info "(modus-themes) Top")
The 'modus-operandi' and 'modus-vivendi' themes are built into Emacs-28
(next stable release) or later, and are available on GNU ELPA as well as
other archives. Emacs-28 ships version 1.6.0, while the current
'master' branch (i.e. Emacs-29) and, by extension, GNU ELPA include the
latest tagged release.
A fully fledged org-mode file with the annotated task list for Modus
themes version 2.0.0 is supplied as complementary material to the
present entry. It should be annexed below this text on the announcement
page: <https://protesilaos.com/codelog/2021-12-24-modus-themes-2-0-0/>.
Customisation options
=====================
There are some breaking changes that were necessary to improve the code
base and make things easier as well as more efficient for end users.
Please read carefully and apologies in advance for whatever
inconvenience.
,* The 'modus-themes-variable-pitch-headings' no longer has any effect.
Instead, users can specify a 'variable-pitch' property to the list
they pass to the 'modus-themes-headings' or 'modus-themes-org-agenda'
(examples below).
,* All 'modus-themes-scale-*' options are removed. Scaling of headings
is now handled directly by the user options 'modus-themes-headings'
and 'modus-themes-org-agenda' (code samples below).
,* The 'modus-themes-headings' option now accepts a floating point (see
function 'floatp') that represents the multiplier relative to the base
font size. This can be used to scale headings accordingly. Since
this option can target individual heading levels (for 1 through 8),
users can now implement their desired scale with greater precision.
Whereas before it was limited to the first four levels, admittedly for
no good reason.
The newly introduced 'variable-pitch' property can also be applied on
a per-level basis (making it easy to combine with existing properties,
such as a custom weight, for maximum control). Example:
;; This is an alist: read the manual or its doc string.
(setq modus-themes-headings
'((1 . (variable-pitch light 1.6))
(2 . (overline semibold 1.4))
(3 . (monochrome overline 1.2))
(4 . (overline 1.1))
(t . (rainbow 1.05))))
,* The 'modus-themes-org-agenda' follows the same design as the
'modus-themes-headings' where appropriate. Headings that can be
scaled accept a floating point, while those that may be rendered in a
proportionately spaced font accept the 'variable-pitch' property. In
addition, a custom font weight is also supported in the relevant
places (just as with 'modus-themes-headings'). Overall, the interface
can now be tailored to the user's preferences with greater precision.
;; This is an alist: read the manual or its doc string.
(setq modus-themes-org-agenda
'((header-block . (variable-pitch light 1.6))
(header-date . (bold-today grayscale underline-today 1.2))
(event . (accented varied))
(scheduled . uniform)
(habit . traffic-light)))
,* The 'modus-themes-scale-small' that was used in the Org agenda
interface has been removed. No replacement is provided, as the
downsizing had the undesired effect of breaking the otherwise neat
alignment of elements on the grid.
,* The 'modus-themes-mode-line-padding' option has been removed.
Instead, users can specify a natural number (positive integer)
directly in the list of properties passed to the
'modus-themes-mode-line' variable. This has no effect when the
'moody' property is also set, because the Moody library applies its
own padding. For example:
(setq modus-themes-mode-line '(borderless accented 4))
Though not related to changes on our end, users of Emacs 29 must now
set 'x-use-underline-position-properties' to nil for padding to work
properly (due to other adjustments upstream). This relates to Emacs
bug#52324 we had reported:
<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=52324>.
,* All deuteranopia styles are consolidated in a single toggle:
'modus-themes-deuteranopia'. The 'modus-themes-success-deuteranopia'
is thus rendered obsolete and superseded, while the individual
deuteranopia-friendly styles for diffs ('modus-themes-diffs') and the
Org agenda's habit graph ('modus-themes-org-agenda') are altogether
removed. As opposed to top-level forms, there is no clean way to
notify the user of the deprecation of individual values of a user
option.
,* The "foreground only" style has been altogether removed from the user
option 'modus-themes-diffs'. It never was up to the aesthetic
standard of the themes even though the colours met the minimum 7:1
contrast ratio. There is a new section in the manual which documents
how to implement such a style with user-level configurations. Short
version:
(defun my-modus-themes-custom-faces ()
(modus-themes-with-colors
(custom-set-faces
`(modus-themes-diff-added ((,class :background unspecified :foreground ,green))) ; OR ,blue for deuteranopia
`(modus-themes-diff-changed ((,class :background unspecified :foreground ,yellow)))
`(modus-themes-diff-removed ((,class :background unspecified :foreground ,red)))
`(modus-themes-diff-refine-added ((,class :background ,bg-diff-added :foreground ,fg-diff-added)))
;; `(modus-themes-diff-refine-added ((,class :background ,bg-diff-added-deuteran :foreground ,fg-diff-added-deuteran)))
`(modus-themes-diff-refine-changed ((,class :background ,bg-diff-changed :foreground ,fg-diff-changed)))
`(modus-themes-diff-refine-removed ((,class :background ,bg-diff-removed :foreground ,fg-diff-removed)))
`(modus-themes-diff-focus-added ((,class :background ,bg-dim :foreground ,green))) ; OR ,blue for deuteranopia
`(modus-themes-diff-focus-changed ((,class :background ,bg-dim :foreground ,yellow)))
`(modus-themes-diff-focus-removed ((,class :background ,bg-dim :foreground ,red)))
`(modus-themes-diff-heading ((,class :background ,bg-alt :foreground ,fg-main)))
`(diff-indicator-added ((,class :foreground ,green))) ; OR ,blue for deuteranopia
`(diff-indicator-changed ((,class :foreground ,yellow)))
`(diff-indicator-removed ((,class :foreground ,red)))
`(magit-diff-added ((,class :background unspecified :foreground ,green-faint)))
`(magit-diff-changed ((,class :background unspecified :foreground ,yellow-faint)))
`(magit-diff-removed ((,class :background unspecified :foreground ,red-faint)))
`(magit-diff-context-highlight ((,class :background ,bg-dim :foreground ,fg-dim))))))
;; This is so that the changes persist when switching between
;; modus-operandi and modus-vivendi
(add-hook 'modus-themes-after-load-theme-hook #'my-modus-themes-custom-faces)
Removed support for packages
============================
The following are no longer supported by the themes. The reasons vary
in each case, though they boil down to (i) the package being obsoleted,
or (ii) the package's faces inheriting from base faces that we already
support (e.g. font-lock). Each case was carefully considered as part of
the comprehensive review of all packages supported by the themes, though
chances are that some mistake was made regardless. If you believe a
package should not have been removed, please report as much.
,* ag
,* apt-sources-list
,* apt-sources-list
,* buffer-expose
,* counsel-org-capture-string
,* define-word
,* diredc
,* disk-usage
,* easy-kill
,* flyspell-correct
,* git-gutter{,fringe}+
,* git-lens
,* git-walktree
,* highlight-blocks
,* highlight-defined
,* highlight-escape-sequences
,* highlight-symbol
,* highlight-tail
,* hyperlist-mode
,* isl (isearch-light)
,* minibuffer-line
,* mu4e-conversation
,* no-emoji
,* objed
,* parrot
,* phi-search
,* pkgbuild-mode
,* rainbow-identifiers
,* sallet
,* spell-fu
,* spray
,* swoop
,* vdiff
,* volatile-highlights
Changes to supported faces or face groups
=========================================
,* Eliminated any possible exaggerations in wgrep faces. Those no longer
use coloured backgrounds. Instead they have colour-coded foreground
colours as well as a bold weight (they ultimately inherit from the
'bold' face, which is a "hidden" customisation option, as explained in
the manual).
,* Forced Org block delimiters to not extend their background by default
(though check 'modus-themes-org-blocks'). That was the intended
design all along, but now it needs to be made explicit. See, for
example, bug#52587 for Emacs:
<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=52587>
,* Revised the 'org-sexp-date' face so that it no longer looks like
'org-date'. Dates are clickable buttons: they work like links, so
they have an underline by default and are subject to the
'modus-themes-links' user option. Whereas the 'org-sexp-date' is not
applied to interactive elements and must thus be visually distinct.
This face is used for diary-style entries in Org files. For example:
%%(diary-anniversary 2000 12 25) NAME %d%s birthday
,* Rewrote several Auctex/Tex faces to inherit from base faces where
relevant (e.g. 'bold', 'success') as well as from font-lock faces. In
the latter case, the end-result makes Auctex/Tex subject to the
'modus-themes-syntax' option. These refinements promote theme-wide
consistency without detracting from the established styles.
,* Improved Git (Magit) commit faces for warnings or errors. This
concerns two cases:
1. The summary line exceeds the recommended limit of 50 characters.
This now uses a yellow foreground colour which contrasts well with
the summary line's new blue hue (blue and yellow are complementary
for our purposes, meaning that they have good contrast in hueness).
2. The second line (the one right below the summary) has text that
should not be there. This one is coloured in a shade of red, which
again contrasts well with blue.
Thanks to Damien Cassou for noticing in issue 261 that the previous
style of applying tinted backgrounds did not work well when
'hl-line-mode' was enabled ('hl-line-mode' overrides backgrounds and
so the warnings/errors where not always obvious):
<https://gitlab.com/protesilaos/modus-themes/-/issues/261>.
,* Added support for the new 'magit-branch-warning' face that we helped
upstream define: <https://github.com/magit/magit/issues/4550>. It
disambiguates warnings in Magit status buffers from the generic and
often inappropriate for such a context 'font-lock-warning-face'.
,* Simplified all the Apropos faces. They no longer look like buttons or
links as that makes the presentation of 'M-x apropos' very busy.
Instead, they now only have a foreground colour.
,* Updated support for org-roam faces by removing old entries and
covering new ones.
,* Replaced old company-mode faces with their new aliases:
- company-scrollbar-bg => company-tooltip-scrollbar-thumb
- company-scrollbar-fg => company-tooltip-scrollbar-track
,* Made 'org-column-title' inherit from 'fixed-pitch' when the user
option 'modus-themes-mixed-fonts' is non-nil. This is needed to line
up columns correctly. Thanks to Björn Lindström for the contribution
in merge request 52:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/52>.
,* Forced the 'org-colview' faces to use the same height, even when
headings are scaled (see 'modus-themes-headings'). This ensures that
the columns are aligned properly and text fits on the same row.
Thanks to Björn Lindström for the contribution in merge request 53:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/53>.
,* Refrained from applying a bold weight to the Org date selection
indicator in the calendar. The use of bold has the potential to create
problems with the alignment of dates for certain typefaces that do not
have a proper bold variant. Also, there is no need for added emphasis
given that we already use a prominent background colour.
,* Made 'M-x org-table-header-line-mode' or the third-party package
'org-table-sticky-header' use colours that fit better with those of
tables.
,* Removed explicit styling of the 'magit-branch-current' face because
its definition checks if the ':box' attribute can be set and if not, it
uses ':inverse-video'. Useful for terminal emulators.
,* Expanded support for the 'mode-line-active' face for Emacs29. The
face upstream basically adds proportionately spaced fonts (the
'variable-pitch' face) to the mode line. The themes can already use
that if the user option 'modus-themes-variable-pitch-ui' is non-nil.
Thanks to Manuel Uberti for the feedback in issue 257:
<https://gitlab.com/protesilaos/modus-themes/-/issues/257>.
,* Implemented some stylistic refinements for ERC and Rcirc to ensure
theme-wide consistency (e.g. timestamps are a shade of cyan).
,* Tweaked adoc-mode faces for stylistic theme-wide consistency.
,* Refashioned all the git faces of Treemacs so that they are more
consistent with other such contexts or uses. The new styles also
conform with the 'modus-themes-deuteranopia' option.
Miscellaneous
=============
,* Ended the wanton use of internal functions in places that did not
require them. Instead, the themes define faces that evaluate such
functions once and pass their results to the relevant entries. Cases
include:
- Symlink and/or broken link faces in contexts such as Dired,
Eshell, Helm, Trashed.
- Tabbed interfaces (tab-bar, tab-line, centaur-tabs).
- Verbatim markup or that of inline code in Org, Markdown, Asciidoc,
etc.
- The optional use of 'variable-pitch' for User Interface elements
(see 'modus-themes-variable-pitch-ui').
,* Refined the dedicated diff background colours of modus-vivendi that
are used when the user option 'modus-themes-deuteranopia' is non-nil.
The changes improve the distinction between all red and yellow
constructs in contexts where they appear together (e.g. smerge-mode).
Basically, yellows will look more bright, while reds appear as
brown. The corresponding blues are toned down a bit to be consistent
with the other colours. Consequently, the standard shades of green
for added lines (when 'modus-themes-deuteranopia' is nil) are
recalibrated to combine well with all other values.
,* Made several faces return an 'unspecified' value instead of nil for
their unused attributes under certain circumstances. This is to guard
against third-party code that unconditionally expects a non-nil value.
,* Omitted {over,under}line attributes from the mode line when the
'padded' property is added to the 'modus-themes-mode-line' user
option. Those are not necessary in that context. Thanks to Illia
Ostapyshyn for the contribution in merge request 54:
<https://gitlab.com/protesilaos/modus-themes/-/merge_requests/54>
,* Rewrote several internal functions in the interest of consistency and
clarity.
,* Deleted two user options that were long obsolete: (i)
'modus-themes-org-habit' has been superseded by
'modus-themes-org-agenda' since version 1.5.0 of the themes and (ii)
'modus-themes-intense-hl-line' has been replaced by
'modus-themes-hl-line' since version 1.3.0.
,* Removed parentheses from headings in the manual as they are invalid
characters for some version of Texinfo. See Emacs bug#52126:
<https://debbugs.gnu.org/cgi/bugreport.cgi?bug=52126>.
,* Updated all doc strings so that quoted lists yield valid syntax in
Help buffers; syntax that can be directly evaluated (otherwise Emacs
prettifies straight quotes as curly ones, which break the code).
Thanks to Christian Tietze for bringing this issue to my attention:
<https://gitlab.com/protesilaos/modus-themes/-/issues/248#note_753169268>.
,* Rewrote all sections of the manual to document the current state of
the project as pertains to valid user options, explicitly supported
face groups, and so on.
#+end_src
* 1.7.0
#+begin_src text

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.7.0, released on 2021-11-18. Any reference to a newer feature which
2.0.0, released on 2021-12-24. 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 2.0.0-dev.
Current development target is 2.1.0-dev.
* Menu:
@ -680,12 +680,7 @@ File: modus-themes.info, Node: Deuteranopia style, Next: Bold constructs, Pre
4.2 Option for red-green color deficiency or deuteranopia
=========================================================
[ Changed as part of 2.0.0-dev. Supersedes and consolidates the
now-deprecated modus-themes-success-deuteranopia as well as individual
styles for red-green color deficiency in modus-themes-diffs and
modus-themes-org-agenda .]
Brief: When non-nil use red/blue color-coding instead of red/green,
Brief: When non-nil use red/blue color-coding instead of red/green,
where appropriate.
Symbol: modus-themes-deuteranopia (boolean type)
@ -988,9 +983,7 @@ File: modus-themes.info, Node: Mode line, Next: Tab style, Prev: Command prom
4.9 Option for mode line presentation
=====================================
[ Changed as part of 2.0.0-dev ]
Brief: Control the style of the mode lines.
Brief: Control the style of the mode lines.
Symbol: modus-themes-mode-line (choice type, list of properties)
@ -1466,9 +1459,7 @@ File: modus-themes.info, Node: Diffs, Next: Org mode blocks, Prev: Active reg
4.20 Option for diff buffer looks
=================================
[ Changed as part of 2.0.0-dev ]
Brief: Set the overall style of diffs.
Brief: Set the overall style of diffs.
Symbol: modus-themes-diffs (choice type)
@ -1498,7 +1489,7 @@ optimizing for such a use-case.
*note Option for red-green color deficiency or deuteranopia:
Deuteranopia style.
In versions before 2.0.0-dev there was an option for foreground-only
In versions before 2.0.0 there was an option for foreground-only
diffs. This is no longer supported at the theme level because there are
cases where the perceived contrast and overall contextuality were not
good enough although the applied colors were technically above the 7:1
@ -1556,9 +1547,7 @@ File: modus-themes.info, Node: Org agenda, Next: Heading styles, Prev: Org mo
4.22 Option for Org agenda constructs
=====================================
[ Changed as part of 2.0.0-dev ]
Brief: Control the style of the Org agenda. Multiple parameters are
Brief: Control the style of the Org agenda. Multiple parameters are
available, each with its own options.
Symbol: modus-themes-org-agenda (alist type, multiple styles)
@ -1743,9 +1732,7 @@ File: modus-themes.info, Node: Heading styles, Next: UI typeface, Prev: Org a
4.23 Option for the headings overall style
===========================================
[ Changed as part of 2.0.0-dev ]
Brief: Control the style of headings. This can be particularised for
Brief: Control the style of headings. This can be particularised for
each level of heading (e.g. Org has eight levels).
Symbol: modus-themes-headings (alist type, multiple properties)
@ -3212,8 +3199,8 @@ themes' palette::):
(add-hook 'modus-themes-after-load-theme-hook #'my-modus-themes-custom-faces)
This used to be an optional style of modus-themes-diffs, but has
been removed since 2.0.0-dev to ensure that the accessibility standard
and aesthetic quality of the themes is not compromised.
been removed since version 2.0.0 to ensure that the accessibility
standard and aesthetic quality of the themes is not compromised.

File: modus-themes.info, Node: Face coverage, Next: Notes on individual packages, Prev: Advanced customization, Up: Top
@ -5339,88 +5326,88 @@ Node: Differences between loading and enabling17815
Node: Customization Options19770
Node: Custom reload theme26055
Node: Deuteranopia style26845
Node: Bold constructs28525
Node: Italic constructs29359
Node: Syntax styles30126
Node: Mixed fonts32258
Node: Link styles33522
Node: Command prompts36000
Node: Mode line37821
Node: Tab style42349
Node: Completion UIs43012
Node: Mail citations44963
Node: Fringes45912
Node: Language checkers46652
Node: Line highlighting49094
Node: Line numbers50691
Node: Intense markup51767
Node: Matching parentheses52500
Node: Active region53885
Node: Diffs55298
Node: Org mode blocks56939
Node: Org agenda58866
Node: Heading styles67405
Node: UI typeface71867
Node: Advanced customization72766
Node: Per-theme customization settings74095
Node: Case-by-case face specs using the themes' palette75400
Node: Face specs at scale using the themes' palette79766
Node: Remap face with local value84433
Node: Cycle through arbitrary colors86858
Node: Override colors93286
Node: Override color saturation98095
Node: Font configurations for Org and others103780
Ref: Font configurations for Org and others-Footnote-1106598
Node: Configure bold and italic faces106785
Node: Custom Org user faces110910
Node: Update Org block delimiter fontification114535
Node: Measure color contrast116448
Node: Load theme depending on time of day119171
Node: Backdrop for pdf-tools120164
Node: Decrease mode line height122859
Node: A theme-agnostic hook for theme loading126984
Node: Diffs with only the foreground129375
Node: Face coverage132439
Node: Supported packages132891
Node: Indirectly covered packages139256
Node: Notes on individual packages140244
Node: Note on avy hints141284
Node: Note on calendarel weekday and weekend colors142452
Node: Note on underlines in compilation buffers143635
Node: Note on inline Latex in Org buffers144447
Node: Note on dimmerel145057
Node: Note on display-fill-column-indicator-mode146542
Node: Note on highlight-parenthesesel148105
Node: Note on mmm-modeel background colors154094
Node: Note for prism156409
Node: Note for god-mode159563
Node: Note on company-mode overlay pop-up161167
Ref: Note on company-mode overlay pop-up-Footnote-1161857
Ref: Note on company-mode overlay pop-up-Footnote-2161924
Node: Note on ERC escaped color sequences161979
Ref: Note on ERC escaped color sequences-Footnote-1163407
Node: Note on powerline or spaceline163517
Node: Note on SHR colors163931
Node: Note on EWW and Elfeed fonts164354
Node: Note on Helm grep165019
Node: Note on vc-annotate-background-mode166494
Node: Note on pdf-tools link hints167379
Node: Frequently Asked Questions169811
Node: Is the contrast ratio about adjacent colors?170367
Node: What does it mean to avoid exaggerations?171874
Node: Why are colors mostly variants of blue magenta cyan?173703
Node: What is the best setup for legibility?178016
Node: Contributing180628
Node: Sources of the themes181025
Node: Issues you can help with181661
Node: Patches require copyright assignment to the FSF182861
Node: Acknowledgements185156
Node: Meta187971
Node: GNU Free Documentation License190135
Node: Indices215487
Node: Function index215666
Node: Variable index216873
Node: Concept index219014
Node: Bold constructs28276
Node: Italic constructs29110
Node: Syntax styles29877
Node: Mixed fonts32009
Node: Link styles33273
Node: Command prompts35751
Node: Mode line37572
Node: Tab style42063
Node: Completion UIs42726
Node: Mail citations44677
Node: Fringes45626
Node: Language checkers46366
Node: Line highlighting48808
Node: Line numbers50405
Node: Intense markup51481
Node: Matching parentheses52214
Node: Active region53599
Node: Diffs55012
Node: Org mode blocks56618
Node: Org agenda58545
Node: Heading styles67047
Node: UI typeface71472
Node: Advanced customization72371
Node: Per-theme customization settings73700
Node: Case-by-case face specs using the themes' palette75005
Node: Face specs at scale using the themes' palette79371
Node: Remap face with local value84038
Node: Cycle through arbitrary colors86463
Node: Override colors92891
Node: Override color saturation97700
Node: Font configurations for Org and others103385
Ref: Font configurations for Org and others-Footnote-1106203
Node: Configure bold and italic faces106390
Node: Custom Org user faces110515
Node: Update Org block delimiter fontification114140
Node: Measure color contrast116053
Node: Load theme depending on time of day118776
Node: Backdrop for pdf-tools119769
Node: Decrease mode line height122464
Node: A theme-agnostic hook for theme loading126589
Node: Diffs with only the foreground128980
Node: Face coverage132054
Node: Supported packages132506
Node: Indirectly covered packages138871
Node: Notes on individual packages139859
Node: Note on avy hints140899
Node: Note on calendarel weekday and weekend colors142067
Node: Note on underlines in compilation buffers143250
Node: Note on inline Latex in Org buffers144062
Node: Note on dimmerel144672
Node: Note on display-fill-column-indicator-mode146157
Node: Note on highlight-parenthesesel147720
Node: Note on mmm-modeel background colors153709
Node: Note for prism156024
Node: Note for god-mode159178
Node: Note on company-mode overlay pop-up160782
Ref: Note on company-mode overlay pop-up-Footnote-1161472
Ref: Note on company-mode overlay pop-up-Footnote-2161539
Node: Note on ERC escaped color sequences161594
Ref: Note on ERC escaped color sequences-Footnote-1163022
Node: Note on powerline or spaceline163132
Node: Note on SHR colors163546
Node: Note on EWW and Elfeed fonts163969
Node: Note on Helm grep164634
Node: Note on vc-annotate-background-mode166109
Node: Note on pdf-tools link hints166994
Node: Frequently Asked Questions169426
Node: Is the contrast ratio about adjacent colors?169982
Node: What does it mean to avoid exaggerations?171489
Node: Why are colors mostly variants of blue magenta cyan?173318
Node: What is the best setup for legibility?177631
Node: Contributing180243
Node: Sources of the themes180640
Node: Issues you can help with181276
Node: Patches require copyright assignment to the FSF182476
Node: Acknowledgements184771
Node: Meta187586
Node: GNU Free Documentation License189750
Node: Indices215102
Node: Function index215281
Node: Variable index216488
Node: Concept index218629

End Tag Table

View file

@ -5,9 +5,9 @@
#+options: ':t toc:nil author:t email:t num:t
#+startup: content
#+macro: stable-version 1.7.0
#+macro: release-date 2021-11-18
#+macro: development-version 2.0.0-dev
#+macro: stable-version 2.0.0
#+macro: release-date 2021-12-24
#+macro: development-version 2.1.0-dev
#+macro: file @@texinfo:@file{@@$1@@texinfo:}@@
#+macro: space @@texinfo:@: @@
#+macro: kbd @@texinfo:@kbd{@@$1@@texinfo:}@@
@ -523,11 +523,6 @@ to user options to take effect ([[#h:3f3c3728-1b34-437d-9d0c-b110f5b161a9][Enabl
:end:
#+vindex: modus-themes-deuteranopia
[ Changed as part of {{{development-version}}}. Supersedes and consolidates
the now-deprecated ~modus-themes-success-deuteranopia~ as well as
individual styles for red-green color deficiency in ~modus-themes-diffs~
and ~modus-themes-org-agenda~ .]
Brief: When non-nil use red/blue color-coding instead of red/green,
where appropriate.
@ -852,8 +847,6 @@ In user configuration files the form may look like this:
:end:
#+vindex: modus-themes-mode-line
[ Changed as part of {{{development-version}}} ]
Brief: Control the style of the mode lines.
Symbol: ~modus-themes-mode-line~ (=choice= type, list of properties)
@ -1357,8 +1350,6 @@ In user configuration files the form may look like this:
:end:
#+vindex: modus-themes-diffs
[ Changed as part of {{{development-version}}} ]
Brief: Set the overall style of diffs.
Symbol: ~modus-themes-diffs~ (=choice= type)
@ -1388,11 +1379,11 @@ optimizing for such a use-case.
[[#h:3ed03a48-20d8-4ce7-b214-0eb7e4c79abe][Option for red-green color deficiency or deuteranopia]].
In versions before {{{development-version}}} there was an option for
foreground-only diffs. This is no longer supported at the theme level
because there are cases where the perceived contrast and overall
contextuality were not good enough although the applied colors
were technically above the 7:1 contrast threshold.
In versions before =2.0.0= there was an option for foreground-only diffs.
This is no longer supported at the theme level because there are cases
where the perceived contrast and overall contextuality were not good
enough although the applied colors were technically above the 7:1
contrast threshold.
[[#h:e2aed9eb-5e1e-45ec-bbd7-bc4faeab3236][Diffs with only the foreground]].
@ -1447,8 +1438,6 @@ and ~rainbow~. Those will continue to work as they are aliases for
:end:
#+vindex: modus-themes-org-agenda
[ Changed as part of {{{development-version}}} ]
Brief: Control the style of the Org agenda. Multiple parameters are
available, each with its own options.
@ -1646,8 +1635,6 @@ Putting it all together, the alist can look like this:
:end:
#+vindex: modus-themes-headings
[ Changed as part of {{{development-version}}} ]
Brief: Control the style of headings. This can be particularised for
each level of heading (e.g. Org has eight levels).
@ -3171,8 +3158,8 @@ macro ([[#h:51ba3547-b8c8-40d6-ba5a-4586477fd4ae][Face specs at scale using the
#+end_src
This used to be an optional style of ~modus-themes-diffs~, but has been
removed since {{{development-version}}} to ensure that the accessibility
standard and aesthetic quality of the themes is not compromised.
removed since version =2.0.0= to ensure that the accessibility standard
and aesthetic quality of the themes is not compromised.
* Face coverage
:properties:

View file

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

View file

@ -4,8 +4,8 @@
;; Author: Protesilaos Stavrou <info@protesilaos.com>
;; URL: https://gitlab.com/protesilaos/modus-themes
;; Version: 1.7.0
;; Last-Modified: <2021-12-21 11:48:32 +0200>
;; Version: 2.0.0
;; Last-Modified: <2021-12-24 12:35:25 +0200>
;; Package-Requires: ((emacs "27.1"))
;; Keywords: faces, theme, accessibility

View file

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