[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[elpa] externals/modus-vivendi-theme e92f6bd 31/73: Internal: indentatio
From: |
Stefan Monnier |
Subject: |
[elpa] externals/modus-vivendi-theme e92f6bd 31/73: Internal: indentation changes in the README |
Date: |
Wed, 26 Aug 2020 09:20:57 -0400 (EDT) |
branch: externals/modus-vivendi-theme
commit e92f6bda20cfc585f947cda2336bc23d3766ac0e
Author: Protesilaos Stavrou <info@protesilaos.com>
Commit: Protesilaos Stavrou <info@protesilaos.com>
Internal: indentation changes in the README
---
README.org | 238 ++++++++++++++++++++++++++++++-------------------------------
1 file changed, 119 insertions(+), 119 deletions(-)
diff --git a/README.org b/README.org
index 30de2fa..71f4800 100644
--- a/README.org
+++ b/README.org
@@ -3,9 +3,9 @@
#+EMAIL: public@protesilaos.com
* Overview
- :PROPERTIES:
- :CUSTOM_ID: h:d42d56a4-9252-4858-ac8e-3306cdd24e19
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:d42d56a4-9252-4858-ac8e-3306cdd24e19
+:END:
This is a set of accessible themes for GNU Emacs. The contrast ratio
between foreground and background values should always be >= 7:1, which
@@ -21,9 +21,9 @@ different than their default austere aesthetic. Make sure to
read the
section on the [[#h:d414ca47-6dce-4905-9f2e-de1465bf23bb][customisation
options]].
** Links with demo content
- :PROPERTIES:
- :CUSTOM_ID: h:3b1b8ad9-f08f-4329-b9ee-d817b610708f
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:3b1b8ad9-f08f-4329-b9ee-d817b610708f
+:END:
Check the
[[https://gitlab.com/protesilaos/modus-themes/wikis/Screenshots][Wiki page with
the screen shots]]. There are lots of scenaria
on display that draw attention to details and important aspects in the
@@ -34,14 +34,14 @@ Also note that I use these themes in
[[https://protesilaos.com/code-casts][my Em
(although older videos contain earlier, "alpha" versions).
* Install and auto-load
- :PROPERTIES:
- :CUSTOM_ID: h:25c3ecd3-8025-414c-9b96-e4d6266c6fe8
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:25c3ecd3-8025-414c-9b96-e4d6266c6fe8
+:END:
** Install the packages
- :PROPERTIES:
- :CUSTOM_ID: h:c3e293e8-8464-4196-aefd-184027116ded
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:c3e293e8-8464-4196-aefd-184027116ded
+:END:
I maintain /Modus Operandi/ (light theme) and /Modus Vivendi/ (dark) as
standalone packages in Emacs-specific archives: GNU ELPA, MELPA, and
@@ -72,9 +72,9 @@ To be clear, that sequence means:
available.
*** With the "use-package" configuration manager
- :PROPERTIES:
- :CUSTOM_ID: h:3ab0ac39-38fb-405b-8a15-771cbd843b6d
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:3ab0ac39-38fb-405b-8a15-771cbd843b6d
+:END:
For a declarative approach with =use-package= and the built-in =package.el=,
you can write something like this (also see
[[#h:d414ca47-6dce-4905-9f2e-de1465bf23bb][the customisation options]]
@@ -87,9 +87,9 @@ for how to expand these package declarations):
#+END_SRC
*** GNU/Linux distro packages
- :PROPERTIES:
- :CUSTOM_ID: h:f696763b-5db1-4717-a90a-964e127d1a73
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:f696763b-5db1-4717-a90a-964e127d1a73
+:END:
The themes are also available from the archives of some GNU/Linux
distributions. These should correspond to a tagged release rather than
@@ -100,9 +100,9 @@ distro's packaging policies.
you may have and/or to update this section.
**** Debian ("Sid" or "Unstable")
- :PROPERTIES:
- :CUSTOM_ID: h:a3d891ff-3dc3-4455-a482-b251e59bb21a
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:a3d891ff-3dc3-4455-a482-b251e59bb21a
+:END:
The two themes are distributed as
[[https://packages.debian.org/sid/elpa-modus-themes][a single package for
Debian]] and its
derivatives. Currently in the unstable suite and should be available in
@@ -118,9 +118,9 @@ Special thanks to package maintainer Dhavan Vaidya and the
rest of the
Debian Emacsen team!
**** GNU Guix
- :PROPERTIES:
- :CUSTOM_ID: h:fea43d19-b307-46d7-81ab-d0e77e9cbede
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:fea43d19-b307-46d7-81ab-d0e77e9cbede
+:END:
Users of either GuixSD (the distro) or just Guix (the package manager)
can get each theme as a standalone package.
@@ -139,9 +139,9 @@ I do not know who the package maintainer is, but I wish to
thank you
regardless!
*** Manual installation method
- :PROPERTIES:
- :CUSTOM_ID: h:0317c29a-3ddb-4a0a-8ffd-16c781733ea2
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:0317c29a-3ddb-4a0a-8ffd-16c781733ea2
+:END:
Download the files in this repository ending in =*-theme.el= and place
them in an appropriate directory, such as =~/.emacs.d/themes/=. To make
@@ -153,9 +153,9 @@ following in your initialisation file:
#+END_SRC
** Load automatically
- :PROPERTIES:
- :CUSTOM_ID: h:ae978e05-526f-4509-a007-44a0925b8bce
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:ae978e05-526f-4509-a007-44a0925b8bce
+:END:
To load the theme from your Emacs initialisation file use the relevant
snippet:
@@ -169,9 +169,9 @@ Make sure to /remove any other theme/ that is being loaded,
otherwise you
might run into unexpected issues (you can also =M-x disable-theme=).
*** Load at a given time or at sunset/sunrise
- :PROPERTIES:
- :CUSTOM_ID: h:4e936e31-e9eb-4b50-8fdd-45d827a03cca
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:4e936e31-e9eb-4b50-8fdd-45d827a03cca
+:END:
This is a neat trick contributed by
[[https://www.reddit.com/r/emacs/comments/gdtqov/weekly_tipstricketc_thread/fq9186h/][b3n
on r/emacs]]. It will select the
appropriate theme based on the time of the day and it will also switch
@@ -215,9 +215,9 @@ does not enable the theme directly: the subsequent
=enable-theme= does
that when needed.
* Customisation options
- :PROPERTIES:
- :CUSTOM_ID: h:d414ca47-6dce-4905-9f2e-de1465bf23bb
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:d414ca47-6dce-4905-9f2e-de1465bf23bb
+:END:
Both of the Modus themes expose variables that allow users to tweak how
certain styles are configured. Check the
[[https://gitlab.com/protesilaos/modus-themes/wikis/Screenshots][Wiki with the
screen shots]] to
@@ -250,9 +250,9 @@ Consult the section below with the
[[#h:0e3b8a62-8d72-4439-be2d-cb12ed98f4cb][co
fully fledged =use-package= declaration.
** Option for "greyscale" or "rainbow" Org blocks
- :PROPERTIES:
- :CUSTOM_ID: h:ca57a3af-6f79-4530-88c0-e35eda9d3bf7
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:ca57a3af-6f79-4530-88c0-e35eda9d3bf7
+:END:
Symbol names:
@@ -286,9 +286,9 @@ major-mode so that the colours are applied properly: =M-x
org-mode= to
refresh the buffer. Or start typing in each code block.
** Option for colourful "rainbow" headings
- :PROPERTIES:
- :CUSTOM_ID: h:1be42afb-bcd2-4425-b956-0ba93eb960c2
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:1be42afb-bcd2-4425-b956-0ba93eb960c2
+:END:
Symbol names:
@@ -312,9 +312,9 @@ bold typography and the nuances between the various heading
levels
provide the elements of differentiation.
** Option for sectioned headings
- :PROPERTIES:
- :CUSTOM_ID: h:c1c9a380-7a05-4c0d-b714-2acac88f10ad
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:c1c9a380-7a05-4c0d-b714-2acac88f10ad
+:END:
Symbol names:
@@ -345,9 +345,9 @@ text, use this:
#+end_src
** Option for scaled headings
- :PROPERTIES:
- :CUSTOM_ID: h:db0275ea-11c2-47c9-82a9-10b65d8df0f8
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:db0275ea-11c2-47c9-82a9-10b65d8df0f8
+:END:
Symbol names:
@@ -399,9 +399,9 @@ control of the themes and I am not aware of any way to make
such
keywords scale accordingly (see [[*Font configurations for Org (and
others)][issue 37]]).
** Option for "subtle" or "intense" fringe visibility
- :PROPERTIES:
- :CUSTOM_ID: h:d989f116-7559-40bc-bf94-ef508d480960
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:d989f116-7559-40bc-bf94-ef508d480960
+:END:
Symbol names:
@@ -423,9 +423,9 @@ meaning that the fringes are not obvious though they still
occupy the
space given to them by =fringe-mode= (8 pixels on either side by default).
** Option for more slanted constructs
- :PROPERTIES:
- :CUSTOM_ID: h:cb327797-b303-47c5-8171-4587a911ccc2
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:cb327797-b303-47c5-8171-4587a911ccc2
+:END:
Symbol names:
@@ -443,9 +443,9 @@ affects documentation strings and code comments.
The default is to not use italics unless it is absolutely necessary.
** Option for more bold constructs
- :PROPERTIES:
- :CUSTOM_ID: h:9a77e814-5eca-488f-9a67-119a95c2d28a
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:9a77e814-5eca-488f-9a67-119a95c2d28a
+:END:
Symbol names:
@@ -473,9 +473,9 @@ it throughout the theme:
#+end_src
** Option for three-dimensional focused mode line
- :PROPERTIES:
- :CUSTOM_ID: h:ce155208-fdd6-4ada-9e0c-54aab7e2aff8
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:ce155208-fdd6-4ada-9e0c-54aab7e2aff8
+:END:
Symbol names:
@@ -497,9 +497,9 @@ around them and with the active one having more intense
colours than any
inactive ones.
** Option for subtle diffs
- :PROPERTIES:
- :CUSTOM_ID: h:e3933a53-cbd9-4e44-958a-1d6d133f0816
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:e3933a53-cbd9-4e44-958a-1d6d133f0816
+:END:
Symbol names:
@@ -524,9 +524,9 @@ which is, nonetheless, more subtle with this option than
with its
default equivalent.
** Option for faint code syntax highlighting
- :PROPERTIES:
- :CUSTOM_ID: h:9f05eef0-9d0d-4305-98a1-c4e49f41e1c8
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:9f05eef0-9d0d-4305-98a1-c4e49f41e1c8
+:END:
Symbol names:
@@ -552,9 +552,9 @@ this list):
+ [[https://github.com/tarsius/paren-face][paren-face]]
** Option for intense line highlight (hl-line-mode)
- :PROPERTIES:
- :CUSTOM_ID: h:e19092a4-7204-40d3-ac35-3644b72de937
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:e19092a4-7204-40d3-ac35-3644b72de937
+:END:
Symbol names:
@@ -590,9 +590,9 @@ well as the =smartparens= package. The default is to use a
subtle warm
colour for the background of those overlays.
** Option for intense standard completions
- :PROPERTIES:
- :CUSTOM_ID: h:5b0b1e66-8287-4f3f-ba14-011c29320a3f
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:5b0b1e66-8287-4f3f-ba14-011c29320a3f
+:END:
Symbol names:
@@ -618,9 +618,9 @@ The default is to only use foreground colour values for the
various
matching characters or items of standard completion tools.
** Option for variable-pitch fonts in headings
- :PROPERTIES:
- :CUSTOM_ID: h:33023fa6-6482-45d4-9b5e-3c73c945718f
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:33023fa6-6482-45d4-9b5e-3c73c945718f
+:END:
Symbol names:
@@ -643,9 +643,9 @@ the main text, while letting inline code and some other
space-sensitive
constructs use a monospaced font).
** Complete example configuration for the above
- :PROPERTIES:
- :CUSTOM_ID: h:0e3b8a62-8d72-4439-be2d-cb12ed98f4cb
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:0e3b8a62-8d72-4439-be2d-cb12ed98f4cb
+:END:
This is a complete =use-package= declaration with Modus Operandi as an
example. You can modify it to your preferences. Here we enable all
@@ -690,9 +690,9 @@ do not try to interpret the values of the variables, as I
always test
different combinations and scenaria).
** Full access to the palette for further tweaks (advanced)
- :PROPERTIES:
- :CUSTOM_ID: h:b7282635-4fe9-415a-abdf-962b736ff5b6
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:b7282635-4fe9-415a-abdf-962b736ff5b6
+:END:
Unlike the previous options which follow a straightforward pattern of
allowing the user to quickly select their preference, the themes also
@@ -700,9 +700,9 @@ provide a more powerful, albeit difficult, mechanism of
controlling
things with precision.
*** Option 1 to redefine colour values
- :PROPERTIES:
- :CUSTOM_ID: h:149e23b6-ada1-480f-95cd-c56fb40999b5
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:149e23b6-ada1-480f-95cd-c56fb40999b5
+:END:
The variables are:
@@ -775,9 +775,9 @@ the following (courtesy of the
[[https://github.com/seagle0128/.emacs.d/blob/mas
#+end_src
*** Option 2 to apply colour variables to faces
- :PROPERTIES:
- :CUSTOM_ID: h:9754abfd-c890-4af3-91a8-1a2cb2b5be44
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:9754abfd-c890-4af3-91a8-1a2cb2b5be44
+:END:
The macro symbols are:
@@ -806,23 +806,23 @@ Len's sample package declaration (with comments by me):
(if (member 'modus-vivendi custom-enabled-themes)
;; this macro allows us to access the colour palette
(modus-vivendi-theme-with-color-variables
- (custom-theme-set-faces
- 'modus-vivendi
- `(magit-branch-current
- ((;; use a box property if the current display terminal
- ;; supports it and also apply a background
- ((supports :box t))
- (:foreground ,blue-alt-other :background ,bg-alt :box t))
- (t
- ;; use an underline if instead of a box for other
- ;; terminals
- (:foreground ,blue-alt-other :background ,bg-alt :underline t))))
- `(magit-branch-remote-head
- ((((supports :box t))
- (:foreground ,magenta-alt-other :background ,bg-alt :box t))
- (t
- (:foreground ,magenta-alt-other :background ,bg-alt :underline
t))))
- ))))
+ (custom-theme-set-faces
+ 'modus-vivendi
+ `(magit-branch-current
+ ((;; use a box property if the current display terminal
+ ;; supports it and also apply a background
+ ((supports :box t))
+ (:foreground ,blue-alt-other :background ,bg-alt :box t))
+ (t
+ ;; use an underline if instead of a box for other
+ ;; terminals
+ (:foreground ,blue-alt-other :background ,bg-alt :underline
t))))
+ `(magit-branch-remote-head
+ ((((supports :box t))
+ (:foreground ,magenta-alt-other :background ,bg-alt :box t))
+ (t
+ (:foreground ,magenta-alt-other :background ,bg-alt :underline
t))))
+ ))))
;; invoke the above function when appropriate in order to override the
;; styles of the desired faces
(add-hook 'after-load-theme-hook 'customize-modus-vivendi)
@@ -852,9 +852,9 @@ If something is not clear or not working as intended,
please let me
know.
*** Further considerations
- :PROPERTIES:
- :CUSTOM_ID: h:4acda0f1-564e-48ff-8998-ebf7618377dd
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:4acda0f1-564e-48ff-8998-ebf7618377dd
+:END:
Please understand that these customisation methods are meant for
advanced users or those who are prepared to do their own research. If
@@ -883,9 +883,9 @@ methods documented in my
[[https://protesilaos.com/codelog/2020-05-10-modus-oper
(2020-05-10).
** Font configurations for Org (and others)
- :PROPERTIES:
- :CUSTOM_ID: h:ea30ff0e-3bb6-4801-baf1-d49169d94cd5
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:ea30ff0e-3bb6-4801-baf1-d49169d94cd5
+:END:
The themes are designed to cope well with mixed font settings.
Currently this applies to =org-mode= (courtesy of
[[https://gitlab.com/protesilaos/modus-themes/-/issues/40][Ben in issue 40]])
and
@@ -932,9 +932,9 @@ check these:
+
[[https://protesilaos.com/codelog/2020-07-17-emacs-mixed-fonts-org/][Configuring
mixed fonts for Org mode and others]] (2020-07-17)
** Note on settings for rendering of HTML buffers
- :PROPERTIES:
- :CUSTOM_ID: h:61875051-b284-40f0-a74d-1574f41b3d42
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:61875051-b284-40f0-a74d-1574f41b3d42
+:END:
The rendering mechanism that enables viewing of HTML content in Emacs
may need some explicit specification depending on your preferences. This
@@ -942,18 +942,18 @@ is demonstrated in
[[https://gitlab.com/protesilaos/modus-themes/-/issues/60][is
in mu4e.
* Face coverage
- :PROPERTIES:
- :CUSTOM_ID: h:944a3bdf-f545-40a0-a26c-b2cec8b2b316
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:944a3bdf-f545-40a0-a26c-b2cec8b2b316
+:END:
This list will always be updated to reflect the current state of the
project. The idea is to offer an overview of the /known status/ of all
affected face groups.
** Full support
- :PROPERTIES:
- :CUSTOM_ID: h:5ea98392-1376-43a4-8080-2d42a5b690ef
- :END:
+:PROPERTIES:
+:CUSTOM_ID: h:5ea98392-1376-43a4-8080-2d42a5b690ef
+:END:
The items with an appended asterisk =*= tend to have lots of extensions, so
the "full support" may not be 100% true…
- [elpa] externals/modus-vivendi-theme dbfffe9 27/73: Add explicit support for git-rebase (Magit), (continued)
- [elpa] externals/modus-vivendi-theme dbfffe9 27/73: Add explicit support for git-rebase (Magit), Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 03a1e5d 20/73: Update sample package declaration, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 35391ae 21/73: Add support for built-in 'file-name-shadow' face, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 042bac1 22/73: Add support for PKGBUILD-MODE, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme dc8c584 07/73: Further tweaks to Magit Blame (extend a5e1325ca), Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 1bd6fd6 12/73: Use accented background for notmuch message folds, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 0e9be20 13/73: Add support for org-table-sticky-header, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme cf0a1f2 17/73: Add support for Emacs 27 line number ticks, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 05844a1 18/73: Let 'hl-todo' keywords use optional slant, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme ac475d8 28/73: Add support for SEMANTIC, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme e92f6bd 31/73: Internal: indentation changes in the README,
Stefan Monnier <=
- [elpa] externals/modus-vivendi-theme 7ec9258 33/73: Internal: minor doc correction, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 0ff98fd 34/73: New CUSTOM OPTION for completion UIs (major entry), Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 781189c 38/73: Review powerline faces, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme ed2b435 39/73: Review generic completion faces, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 66470fe 41/73: Review mu4e-draft-face, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme ae0e8c2 45/73: Refine powerline faces (extend commit 781189c59), Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 26a2118 47/73: Add support for 'doom-modeline-debug-visual' face, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme b87714e 42/73: Add external projects (ports) section to README, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 58d35d7 43/73: Internal: indentation fixes in README, Stefan Monnier, 2020/08/26
- [elpa] externals/modus-vivendi-theme 673191c 58/73: Merge branch 'master' into 'master', Stefan Monnier, 2020/08/26