classification
Title: the table of contents in epub file is too long
Type: enhancement Stage:
Components: Documentation Versions: Python 3.8, Python 3.7
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: docs@python Nosy List: docs@python, eric.araujo, ezio.melotti, georg.brandl, jcrben, mdk, willingc, wrobell
Priority: normal Keywords:

Created on 2011-10-28 10:08 by wrobell, last changed 2019-04-11 07:05 by jcrben.

Messages (3)
msg146548 - (view) Author: wrobell (wrobell) Date: 2011-10-28 10:08
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.
msg147477 - (view) Author: Éric Araujo (eric.araujo) * (Python committer) Date: 2011-11-12 11:40
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?
msg339931 - (view) Author: Ben Creasy (jcrben) Date: 2019-04-11 07:05
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.
History
Date User Action Args
2019-04-11 07:05:55jcrbensetmessages: + msg339931
2019-04-11 06:56:45jcrbensetnosy: + jcrben
2019-03-26 11:20:58cheryl.sabellasetnosy: + ezio.melotti, willingc, mdk

type: enhancement
versions: + Python 3.7, Python 3.8, - Python 2.7, Python 3.2
2011-11-12 11:40:36eric.araujosetnosy: + georg.brandl, eric.araujo
messages: + msg147477
2011-10-28 10:08:26wrobellcreate