Skip to content

Commit afaddd3

Browse files
authored
Update LaTeX docs with new admonition colours (#12588)
1 parent 6699a89 commit afaddd3

File tree

1 file changed

+16
-7
lines changed

1 file changed

+16
-7
lines changed

doc/latex.rst

+16-7
Original file line numberDiff line numberDiff line change
@@ -1304,14 +1304,24 @@ forget the underscore separating the prefix from the property names.
13041304
| ``<prefix>_TeXcolor``.
13051305
These are colors.
13061306
1307-
The shadow color defaults in all cases to ``{rgb}{0,0,0}`` i.e. to black.
1307+
Since 6.0.0 the border and background colors of :rst:dir:`code-block`,
1308+
default respectively to ``{RGB}{32,32,32}`` (i.e. ``{HTML}{202020}``), and
1309+
``{RGB}{242,242,242}`` (i.e. ``{gray}{0.95}`` or ``{HTML}{F2F2F2}``).
13081310
1309-
Since 6.0.0 the border color and background color of :rst:dir:`code-block`,
1310-
i.e. ``pre`` prefix, default respectively to ``{RGB}{32,32,32}`` and
1311-
``{gray}{0.95}``. They previously defaulted to black, respectively white.
1311+
At 7.4.0 other directives acquire non-black/white default border and
1312+
background colors. Here they are using ``xcolor`` hexadecimal notation
1313+
(which requires always 6 hexadecimal digits):
13121314
1313-
For all other types, the border color defaults to black and the background
1314-
color to white.
1315+
- ``{HTML}{F7F7F7}`` serves as background color to all.
1316+
- ``{HTML}{86989B}`` is border color of light admonitions (inclusive of
1317+
:rst:dir:`seealso` and :rst:dir:`todo`) as well as of :dudir:`topic` and
1318+
contents_ directives.
1319+
- ``{HTML}{940000}`` is border color or :dudir:`warning`-type admonitions,
1320+
except :dudir:`error` which uses ``{HTML}{B40000}``.
1321+
1322+
The only directives displaying a shadow per default are :dudir:`topic` and
1323+
contents_ (handled identically at LaTeX level) and their shadow color is
1324+
``{HTML}{6C6C6C}``. For all others the default shadow color is black.
13151325
13161326
The ``<prefix>_TeXcolor`` stands for the CSS property "color", i.e. it
13171327
influences the text color of the contents. As for the three other options,
@@ -1330,7 +1340,6 @@ forget the underscore separating the prefix from the property names.
13301340
start of the contents; for admonitions, this happens after the heading which
13311341
reproduces the admonition type.
13321342
1333-
13341343
The next keys, for admonitions only, were all three added at 7.4.0. The
13351344
default colors are the ones applying to the current HTML rendering of Sphinx
13361345
own docs at https://www.sphinx-doc.org.

0 commit comments

Comments
 (0)