sphinx-doc/sphinx

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

Open

#11.269 aberto em 29 de mar. de 2023

Ver no GitHub
 (17 comments) (0 reactions) (0 assignees)Python (1.985 forks)batch import
builder:latexhelp wanted

Métricas do repositório

Stars
 (5.625 stars)
Métricas de merge de PR
 (Mesclagem média 10d 11h) (11 fundiu PRs em 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.

Guia do colaborador

Direção de pesquisa
Inspecione o arquivo de modelo LaTeX que define a cor de fundo do bloco de código e teste diferentes valores de cinza com xelatex para melhorar o contraste dos tokens não realçados.
Pilha de tecnologia
python
Domain
documentation
Tipo Issue
Bug
DifficultyDificuldade de implementação estimada para um novo contribuidor, de 1 para alterações muito pequenas a 5 para trabalho de nível especializado.
2
Tempo estimadoUm intervalo de tempo aproximado para um colaborador experiente investigar, implementar, testar e preparar um pull request.
1-3 horas
Status da atividadeQuão disponível o issue aparece agora: novo, ativo, obsoleto, bloqueado ou aguardando entrada do mantenedor.
Ativo
ClarityCom que clareza o issue explica a mudança esperada, os critérios de aceitação e a próxima etapa.
Claro
Prerequisites
PythonGitLaTeX
Simpatia para novatosUma pontuação de 1 a 100 que estima o quão acessível este issue é para colaboradores iniciantes.
70