Brief: Control the style of links to web pages, files, buffers…
Symbol: modus-themes-links
(‘choice’ type, list of properties)
Possible values are expressed as a list of properties (default is nil
or
an empty list). The list can include any of the following symbols:
neutral-underline
no-underline
faint
no-color
bold
italic
background
The default (a nil
value or an empty list) is a prominent text color,
typically blue, with an underline of the same color.
For the style of the underline, a neutral-underline
property turns the
color of the line into a subtle gray, while the no-underline
property
removes the line altogether. If both of those are set, the latter takes
precedence.
For text coloration, a faint
property desaturates the color of the text
and the underline, unless the underline is affected by the
aforementioned properties. While a no-color
property removes the color
from the text. If both of those are set, the latter takes precedence.
A bold
property applies a heavy typographic weight to the text of the
link.
An italic
property adds a slant to the link’s text (italic or oblique
forms, depending on the typeface).
A background
property applies a subtle tinted background color.
In case both no-underline
and no-color
are set, then a subtle gray
background is applied to all links. This can still be combined with the
bold
and italic
properties.
Combinations of any of those properties are expressed as a list, like in these examples:
(faint) (no-underline faint) (no-color no-underline bold) (italic bold background no-color no-underline)
The order in which the properties are set is not significant.
In user configuration files the form may look like this:
(setq modus-themes-links '(neutral-underline background))
The placement of the underline, meaning its proximity to the text, is
controlled by x-use-underline-position-properties
,
x-underline-at-descent-line
, underline-minimum-offset
. Please refer to
their documentation strings.