https://github.com/python/cpython/commit/5eb4ab5a91d5ded26ab6c2e58667bfb2f5ade249 commit: 5eb4ab5a91d5ded26ab6c2e58667bfb2f5ade249 branch: main author: Danishk2445 <[email protected]> committer: hugovk <[email protected]> date: 2026-09-26T21:51:22+03:00 summary:
gh-57491: Reduce the EPUB table of contents depth to 2 (#158105) files: A Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst M Doc/conf.py diff --git a/Doc/conf.py b/Doc/conf.py index 0fb8b5cd800cfb0..8791aba435f49ea 100644 --- a/Doc/conf.py +++ b/Doc/conf.py @@ -469,6 +469,10 @@ # https://github.com/sphinx-doc/sphinx/issues/12359 epub_use_index = False +# The default depth of 3 lists over a thousand entries, which makes the +# table of contents hard to navigate in e-book readers +epub_tocdepth = 2 + # translation tag # --------------- diff --git a/Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst b/Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst new file mode 100644 index 000000000000000..c7c8057776bec4a --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2026-09-24-10-10-15.gh-issue-57491.UA-2uN.rst @@ -0,0 +1,3 @@ +Reduce the depth of the table of contents in the EPUB documentation from +three levels to two, making it much shorter and easier to navigate in e-book +readers. _______________________________________________ Python-checkins mailing list -- [email protected] To unsubscribe send an email to [email protected] https://mail.python.org/mailman3//lists/python-checkins.python.org Member address: [email protected]
