Brief: Set the overall style of Org code blocks, quotes, and the like.
Symbol: modus-themes-org-blocks
(‘choice’ type)
Possible values:
nil
(default)
gray-background
(value grayscale
exists for backward compatibility)
tinted-background
(value rainbow
exists for backward compatibility)
Nil (the default) means that the block has no background of its own: it uses the one that applies to the rest of the buffer. In this case, the delimiter lines have a gray color for their text, making them look exactly like all other Org properties.
Option gray-background
applies a subtle gray background to the block’s
contents. It also affects the begin and end lines of the block as they
get another shade of gray as their background, which differentiates them
from the contents of the block. All background colors extend to the
edge of the window, giving the area a rectangular, “blocky”
presentation.
Option tinted-background
uses a slightly colored background for the
contents of the block. The exact color will depend on the programming
language and is controlled by the variable org-src-block-faces
(refer to
the theme’s source code for the current association list). For this to
take effect, the Org buffer needs to be restarted with org-mode-restart
.
In this scenario, it may be better to inhibit the extension of the
delimiter lines’ background to the edge of the window because Org does
not provide a mechanism to update their colors depending on the contents
of the block. Disable the extension of such backgrounds by setting
org-fontify-whole-block-delimiter-line
to nil.
Code blocks use their major mode’s colors only when the variable
org-src-fontify-natively
is non-nil
. While quote/verse blocks require
setting org-fontify-quote-and-verse-blocks
to a non-nil
value.
Update Org block delimiter fontification.
Older versions of the themes provided options grayscale
(or greyscale
)
and rainbow
. Those will continue to work as they are aliases for
gray-background
and tinted-background
, respectively.