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
My favorite emacs theme.
449 commits 2 branches 60 tags 36 MiB
Emacs Lisp 100%
Go to file
Protesilaos Stavrou 18768051f8
Fix license formatting in HTML export
2021-04-08 22:50:06 +03:00
doc Fix license formatting in HTML export 2021-04-08 22:50:06 +03:00
.gitignore Stop building the modus-themes.texi 2021-03-06 12:56:40 +02:00
CHANGELOG.org Add CHANGELOG entry on version 1.2.0 2021-03-04 15:07:02 +02:00
COPYING Add all doc files from main repo 2020-11-18 08:08:45 +02:00
modus-operandi-theme.el Refine code of commit 6f26cc8 ('require-theme') 2021-03-12 22:29:59 +02:00
modus-themes.el Refine eww faces 2021-04-07 13:07:22 +03:00
modus-vivendi-theme.el Refine code of commit 6f26cc8 ('require-theme') 2021-03-12 22:29:59 +02:00
README.md Update README with notice about old packages 2021-03-30 12:49:08 +03:00

README.md

Modus themes (Modus Operandi and Modus Vivendi)

A pair of highly accessible themes that conform with the WCAG AAA standard for colour contrast between background and foreground combinations (a minimum contrast of 7:1---the highest standard of its kind).

The themes are built into GNU Emacs 28 (development target). They are also distributed in several packages formats.

  • modus-operandi is light
  • modus-vivendi is dark

Quick setup for the latest version

(use-package modus-themes
  :ensure
  :init
  ;; Add all your customizations prior to loading the themes
  (setq modus-themes-slanted-constructs t
        modus-themes-bold-constructs nil
        modus-themes-region 'no-extend)

  ;; Load the theme files before enabling a theme
  (modus-themes-load-themes)
  :config
  ;; Load the theme of your choice:
  (modus-themes-load-operandi) ;; OR (modus-themes-load-vivendi)
  :bind ("<f5>" . modus-themes-toggle))

Note: make sure that you do not customise custom-theme-load-path or custom-theme-directory after the themes' package declaration. That will lead to failures in loading the files. If you must change those variables, do it before the package declaration.

Further information

Read the Info manual HTML version for how to install, load, enable, and customise the themes. If you are using the latest version of the themes, you already have the manual installed: evaluate (info "(modus-themes) Top") to start reading it.

The themes cover a broad range of packages and are highly customisable.

For some demo content, check:

NOTE about old packages

Users coming from version 0.13.0 or earlier, are advised to read the announcement on the emacs-devel mailing list: https://lists.gnu.org/archive/html/emacs-devel/2021-03/msg00300.html. Or read issue 174: https://gitlab.com/protesilaos/modus-themes/-/issues/174.

The web page of the change log is also available: https://protesilaos.com/modus-themes-changelog/.

An Info manual should be distributed with the modus-themes package. Evaluate this form to access it directly:

(info "(modus-themes) Top")

Or visit it at: https://protesilaos.com/modus-themes.