Open erlend-aasland opened 3 months ago
Hugo commented https://github.com/python/cpython/issues/110383#issuecomment-2154713713:
The 4.43:1 contrast ratio of green digits on grey is much better than before, but doesn't quite meet the WCAG AA guidelines of 4.5:1.
https://webaim.org/resources/contrastchecker/?fcolor=247F51&bcolor=F2F2F2
The grey symbols (5.12:1) meets AA and the black text (18.75:1) meets both AA and AAA (7:1).
I'm not sure where these colours are defined.
I responded https://github.com/python/cpython/issues/110383#issuecomment-2155516934:
Me neither, but ISTM the PDFs are generated from
make -C Doc dist
. I'm suspecting it might be the Sphinx LaTeX packagesphinx.sty
.
This may be a Sphinx issue, cc. @AA-Turner.
See also (cc. @picnixz, who's been recently active in our repo):
The problem we had was mostly because of the font families and an extensible glyph support. More precisely, we need^1:
a monospace Unicode font supporting:
- at least Latin Greek and Cyrillic (CJK goes via separate pathways a priori but it would be a plus to have simplified Chinese)
- Unicode code points involved in output of Linux tree command
Ideally:
- does not require
texlive-fonts-extra
for Ubuntu and if it does was already included there with 18.04LTS, is also available via TeXLive,- has been tested with fontspec \setmonofont with Path and no extension specified so that it will work whether font is opentype or TrueType and whether it is system font or in LaTeX installation font tree both with xelatex and lualatex
And it has to look good on gray background.
We can disregard the last 'gray background' condition under the assumption that someone finds a good background for code blocks. It should be possible to configure the exact color used for listings in some latex_preamble
or so but I don't remember exactly how.
Created from #110383.
Regarding the PDF readability issue:
The image attached to that report, is attached here:
I downloaded the docs as PDF, and currently they're rendered like this:
IMO, there is an improvement, but I'm not sure if it's a good enough improvement. Comments?