sphinx-doc/sphinx

LaTeX: background gray in PDF code-blocks has a lesser contrast for ``xelatex`` with non-highlighted tokens

Open

#11,269 opened on Mar 29, 2023

View on GitHub
 (17 comments) (0 reactions) (0 assignees)Python (1,985 forks)batch import
builder:latexhelp wanted

Repository metrics

Stars
 (5,625 stars)
PR merge metrics
 (Avg merge 10d 11h) (11 merged PRs in 30d)

Description

Describe the bug

Example with 'xelatex' for latex_engine: Capture d’écran 2023-03-29 à 09 47 59

Same with default 'pdflatex': Capture d’écran 2023-03-29 à 09 47 30

The choice of default background gray was done with testing with pdflatex. If testing with xelatex, it could have been chosen possibly even lighter.

But this issue is mainly applying to the few non highlighted tokens.

It is a font issue, the one used for xelatex/lualatex is thinner than the one used for pdflatex. It may also be compounded with a PDF viewer anti-aliasing effect, for these thin glyphs on colored background.

How to Reproduce

Any project with code-blocks

Environment Information

Sphinx 6.1.3

Sphinx extensions

No response

Additional context

LaTeX installation from TeXLive 2023.

Contributor guide

Research direction
Inspect the LaTeX template file that defines code block background color and test different gray values with xelatex to improve contrast for non highlighted tokens.
Tech stack
python
Domain
documentation
Issue type
Bug
DifficultyEstimated implementation difficulty for a new contributor, from 1 for very small changes to 5 for expert-level work.
2
Estimated timeA rough time range for an experienced contributor to investigate, implement, test, and prepare a pull request.
1-3 hours
Activity statusHow available the issue appears right now: fresh, active, stale, blocked, or waiting on maintainer input.
Active
ClarityHow clearly the issue explains the expected change, acceptance criteria, and next step.
Clear
Prerequisites
PythonGitLaTeX
Newbie friendlinessA 1-100 score estimating how approachable this issue is for first-time contributors.
70