[issue13282] the table of contents in epub file is too long
New submission from wrobell <wrobell@pld-linux.org>: the table of contents in python documentation epub file is very very long. it takes several long minutes to jump from first page to a part containing language reference toc. imho it would be great if first page of epub file contained pointers to tutorial, lang ref, mod ref without detailed table of contents as it is at docs.python.org. ---------- assignee: docs@python components: Documentation messages: 146548 nosy: docs@python, wrobell priority: normal severity: normal status: open title: the table of contents in epub file is too long versions: Python 2.7, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13282> _______________________________________
Éric Araujo <merwok@netwok.org> added the comment: Thanks for the report. I do not know if this something that we can fix in the CPython repository by editing some template or config file or if it requires a patch to Sphinx first. Georg? ---------- nosy: +eric.araujo, georg.brandl _______________________________________ Python tracker <report@bugs.python.org> <http://bugs.python.org/issue13282> _______________________________________
Change by Cheryl Sabella <cheryl.sabella@gmail.com>: ---------- nosy: +ezio.melotti, mdk, willingc type: -> enhancement versions: +Python 3.7, Python 3.8 -Python 2.7, Python 3.2 _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13282> _______________________________________
Change by Ben Creasy <ben@bencreasy.com>: ---------- nosy: +jcrben _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13282> _______________________________________
Ben Creasy <ben@bencreasy.com> added the comment: Not sure if this is filed elsewhere, but the contents on the page at https://docs.python.org/3/contents.html could really use a collapse button, and could start automatically collapsed. The first half of the page is "What's new" for the past few Python versions and the Changelog. I looked around for an issue in the upstream tracker and didn't see one https://github.com/sphinx-doc/sphinx/issues - I don't know much about Sphinx but it seems like it should be possible with a bit of Javascript and CSS. ---------- _______________________________________ Python tracker <report@bugs.python.org> <https://bugs.python.org/issue13282> _______________________________________
participants (4)
-
Ben Creasy -
Cheryl Sabella
-
wrobell
-
Éric Araujo