IntenseWebs/sphinx
3
0
Fork 0
mirror of https://github.com/sphinx-doc/sphinx.git synced 2025-02-25 18:55:22 -06:00
Code Issues Packages Projects Releases Wiki Activity

Update LaTeX docs with new admonition colours (#12588)

Browse Source
This commit is contained in:
Jean-François B. 2024-07-15 19:28:40 +02:00 committed by GitHub
parent 6699a89d16
commit afaddd3c45
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 16 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

23
doc/latex.rst
View File

@ -1304,14 +1304,24 @@ forget the underscore separating the prefix from the property names.
| ``<prefix>_TeXcolor``.
These are colors.
The shadow color defaults in all cases to ``{rgb}{0,0,0}`` i.e. to black.
Since 6.0.0 the border and background colors of :rst:dir:`code-block`,
default respectively to ``{RGB}{32,32,32}`` (i.e. ``{HTML}{202020}``), and
``{RGB}{242,242,242}`` (i.e. ``{gray}{0.95}`` or ``{HTML}{F2F2F2}``).
Since 6.0.0 the border color and background color of :rst:dir:`code-block`,
i.e. ``pre`` prefix, default respectively to ``{RGB}{32,32,32}`` and
``{gray}{0.95}``. They previously defaulted to black, respectively white.
At 7.4.0 other directives acquire non-black/white default border and
background colors. Here they are using ``xcolor`` hexadecimal notation
(which requires always 6 hexadecimal digits):
For all other types, the border color defaults to black and the background
color to white.
- ``{HTML}{F7F7F7}`` serves as background color to all.
- ``{HTML}{86989B}`` is border color of light admonitions (inclusive of
:rst:dir:`seealso` and :rst:dir:`todo`) as well as of :dudir:`topic` and
contents_ directives.
- ``{HTML}{940000}`` is border color or :dudir:`warning`-type admonitions,
except :dudir:`error` which uses ``{HTML}{B40000}``.
The only directives displaying a shadow per default are :dudir:`topic` and
contents_ (handled identically at LaTeX level) and their shadow color is
``{HTML}{6C6C6C}``. For all others the default shadow color is black.
The ``<prefix>_TeXcolor`` stands for the CSS property "color", i.e. it
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.
start of the contents; for admonitions, this happens after the heading which
reproduces the admonition type.
The next keys, for admonitions only, were all three added at 7.4.0. The
default colors are the ones applying to the current HTML rendering of Sphinx
own docs at https://www.sphinx-doc.org.