[elpa] externals/modus-vivendi-theme e92f6bd 31/73: Internal: indentation changes in the README

[Stefan Monnier]

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…