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.
311 commits 2 branches 60 tags 36 MiB
Emacs Lisp 100%
Go to file
Protesilaos Stavrou b3f7c3a067
Rewrite and streamline parts of the documentation 
+ Reorganise the "enable and load" section.

+ Add manual installation instructions.

+ Add section on "Per-theme customization settings (DIY)".

+ Add section on "A theme-agnostic hook for theme loading (DIY)".  This
  addresses issue 131, by incorporating feedback from Daniel Mendler,
  Nicolas De Jaeghere, Gustavo Barros:
  <https://gitlab.com/protesilaos/modus-themes/-/issues/131>.

+ Recompile Info file.
2021-02-23 13:41:29 +02:00
doc Rewrite and streamline parts of the documentation 2021-02-23 13:41:29 +02:00
.gitignore Add all doc files from main repo 2020-11-18 08:08:45 +02:00
CHANGELOG.org Update to version 1.1.0 2021-01-24 13:55:23 +02:00
COPYING Add all doc files from main repo 2020-11-18 08:08:45 +02:00
modus-operandi-theme.el Restore mistakenly removed section from the manual 2021-01-25 07:52:16 +02:00
modus-themes.el Add support for selectrum-prescient 2021-02-22 21:16:03 +02:00
modus-vivendi-theme.el Restore mistakenly removed section from the manual 2021-01-25 07:52:16 +02:00
README.md Warn about potential issues with custom theme path 2021-02-02 20:14:20 +02: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)

  ;; 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: