From ac3bf6155f8addc62f9a9c48f07eef8c3a6f71b2 Mon Sep 17 00:00:00 2001 From: CAM Gerlach Date: Wed, 3 Aug 2022 14:23:20 -0500 Subject: gh-91207: Fix CSS bug in Windows CHM help file and add deprecation message (GH-95607) --- Doc/conf.py | 7 +++++++ .../Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst | 3 +++ 2 files changed, 10 insertions(+) create mode 100644 Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst diff --git a/Doc/conf.py b/Doc/conf.py index bf0af6a..0a436d7 100644 --- a/Doc/conf.py +++ b/Doc/conf.py @@ -79,6 +79,13 @@ html_theme_options = { 'root_include_title': False # We use the version switcher instead. } +# Override stylesheet fingerprinting for Windows CHM htmlhelp to fix GH-91207 +# https://github.com/python/cpython/issues/91207 +if any('htmlhelp' in arg for arg in sys.argv): + html_style = 'pydoctheme.css' + print("\nWARNING: Windows CHM Help is no longer supported.") + print("It may be removed in the future\n") + # Short title used e.g. for HTML tags. html_short_title = '%s Documentation' % release diff --git a/Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst b/Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst new file mode 100644 index 0000000..8c7391f --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2022-08-03-13-35-08.gh-issue-91207.eJ4pPf.rst @@ -0,0 +1,3 @@ +Fix stylesheet not working in Windows CHM htmlhelp docs +and add warning that they are deprecated. +Contributed by C.A.M. Gerlach. -- cgit v0.12