Windows v3.10.3 .chm file (in python310\doc) page headings are messed up and spread out over several lines. Also the font has changed from the former san serif font to a smaller and harder to read serif font.

[DonnieODonnell]

BPO	47051
Nosy	@pfmoore, @tjguk, @zware, @zooba, @DonnieODonnell

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = None
created_at = <Date 2022-03-17.20:39:27.706>
labels = ['type-bug', '3.10', 'OS-windows', 'docs']
title = 'Windows v3.10.3 .chm file (in python310\\doc) page headings are messed up and spread out over several lines. Also the font has changed from the former san serif font to a smaller and harder to read serif font.'
updated_at = <Date 2022-03-21.23:07:21.078>
user = 'https://github.com/DonnieODonnell'

bugs.python.org fields:

activity = <Date 2022-03-21.23:07:21.078>
actor = 'steve.dower'
assignee = 'docs@python'
closed = False
closed_date = None
closer = None
components = ['Documentation', 'Windows']
creation = <Date 2022-03-17.20:39:27.706>
creator = 'DonnieODonnell'
dependencies = []
files = []
hgrepos = []
issue_num = 47051
keywords = []
message_count = 2.0
messages = ['415688', '415723']
nosy_count = 6.0
nosy_names = ['paul.moore', 'tim.golden', 'docs@python', 'zach.ware', 'steve.dower', 'DonnieODonnell']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue47051'
versions = ['Python 3.10']

[zooba]

I guess for 3.11 we should just switch to loose HTML files and using the default browser, rather than fighting with dead CHM tools.

No idea what may have caused this. Has anyone tried analysing the file for unsupported JavaScript or something? I think that's what caused it last time. Maybe Sphinx got an update and is using unsupported CSS?

[zooba]

Doesn't seem to be any relevant changes in the repo between v3.10.2 and v3.10.3, and the theme hasn't changed. Obviously the HTMLHelp tools haven't changed in a decade or so, and the only difference in the build logs looks like less errors in the later one (apparently index terms didn't get fixed up properly in 3.10.2).

So other than running the build again and hoping (which we'll likely be doing later this week anyway), doesn't seem to be anything that can be fixed here.

[panda-34]

The problem is caused by this change:
in 3.10.2:
<link rel="stylesheet" href="_static/pydoctheme.css" type="text/css" />
in 3.10.3:
<link rel="stylesheet" href="_static/pydoctheme.css?2022.1" type="text/css" />

[zooba]

Well spotted! If someone figures out where that's coming from, we can definitely backport a fix so that the next round of 3.9 and 3.10 updates have working docs (the CHM is already gone for 3.11, so it doesn't matter there).