pytest icon indicating copy to clipboard operation
pytest copied to clipboard

[docs rendering] Too much italics on RTD

Open webknjaz opened this issue 3 years ago • 5 comments

Comparing https://docs.pytest.org/en/4.6.x/ and https://docs.pytest.org/en/6.2.x/ I see that the latter almost exclusively uses italic font style. I haven't been able to check what caused such a change, though. So just documenting this for now.

webknjaz avatar Aug 03 '22 15:08 webknjaz

Hi @webknjaz,

What do you mean? This is what I see:

image

image

nicoddemus avatar Aug 03 '22 15:08 nicoddemus

Weird, this is not how it's rendered on my laptop (Gentoo Linux, Firefox). I don't have this issue on the phone too. I wonder if there's some fallback font config that only becomes active under certain envs (which is a common practice but the fallback is weird).

webknjaz avatar Aug 03 '22 16:08 webknjaz

For some reason, I'm seeing this: pytest-rtd-italic-10183

And it looks like it's Garamond that is coming from https://docs.pytest.org/en/latest/_static/pocoo.css.

It might be that you've got some working override and I don't. @nicoddemus you should be able to see which font got used and where it have from using DevTools in your browser, in a "Rendering" subtab.

webknjaz avatar Aug 03 '22 21:08 webknjaz

Here it is using Georgia:

image

nicoddemus avatar Aug 03 '22 22:08 nicoddemus

So it seems like my browser picks Garamond if it's available. Not sure when it appeared on my laptop, probably with one of the updates... @nicoddemus have you tried installing that font so it's available for you too? Still, I don't understand why it's different for different docs versions — I haven't noticed anything changing theme-wise. In this repo or in the docs deps tree. The old version seems to be using the same CSS file — maybe it has some additional overrides that got dropped somewhere?

webknjaz avatar Aug 05 '22 22:08 webknjaz

This is no longer happening to me (I probably fixed the font on this laptop or something) so it's probably not worth keeping it open in the pile.

webknjaz avatar Feb 26 '24 21:02 webknjaz