[issue9056] Adding additional level of bookmarks and section numbers in python pdf documents.

New submission from pengyu.ut pengyu.ut@gmail.com:
Current pdf version of python documents don't have bookmarks for sussubsection. For example, there is no bookmark for the following section in python_2.6.5_reference.pdf. Also the bookmarks don't have section numbers in them. I suggest to include the section numbers. Could these features be added in future release of python document.
3.4.1 Basic customization
---------- assignee: docs@python components: Documentation messages: 108334 nosy: docs@python, pengyu.ut priority: normal severity: normal status: open title: Adding additional level of bookmarks and section numbers in python pdf documents. versions: Python 2.6
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9056 _______________________________________

Senthil Kumaran orsenthil@gmail.com added the comment:
You mean "Table of Contents"? The index at the end serves as a bookmark, right? Also, Table of Contents might add up couple of more pages to traverse.
---------- nosy: +orsenthil
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9056 _______________________________________

pengyu.ut pengyu.ut@gmail.com added the comment:
On Tue, Jun 22, 2010 at 6:25 AM, Senthil Kumaran report@bugs.python.org wrote:
Senthil Kumaran orsenthil@gmail.com added the comment:
You mean "Table of Contents"? The index at the end serves as a bookmark, right? Also, Table of Contents might add up couple of more pages to traverse.
I don't need subsubsections to be in the table of content. But I think it is making sense to add them in the bookmarks, as the bookmarks can be folded even if there are many bookmarks for subsubsections. I'm not refereeing to index.
----------
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9056 _______________________________________

On Mon, Jun 21, 2010 at 11:00 PM, pengyu.ut report@bugs.python.org wrote:
Current pdf version of python documents don't have bookmarks for sussubsection. For example, there is no bookmark for the following section in python_2.6.5_reference.pdf.
This would be nice to have.
Also the bookmarks don't have section numbers in them. I suggest to include the section numbers.
Hmm. I'm not a huge fan of section numbers, but so long as we use them, there's some rationale to include them in the PDF bookmarks. So I guess that's up to whoever creates the patch.
-Fred

Sandro Tosi sandro.tosi@gmail.com added the comment:
The number of items in the bookmark is controlled by
\setcounter{tocdepth}{1}
in sphinxmanual.cls, that's included in every latex file (the source of the PDF documentation). The cls file is coming directly from sphinx, so Georg: what is the purpose of limiting the bookmarks depth to 1? can we consider (somehow) to special-case if for python?
---------- nosy: +georg.brandl, sandro.tosi versions: +Python 3.3 -Python 2.6
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9056 _______________________________________

Changes by Ezio Melotti ezio.melotti@gmail.com:
---------- nosy: +ezio.melotti
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9056 _______________________________________

Changes by Ezio Melotti ezio.melotti@gmail.com:
---------- stage: -> needs patch type: -> enhancement
_______________________________________ Python tracker report@bugs.python.org http://bugs.python.org/issue9056 _______________________________________

Change by Cheryl Sabella cheryl.sabella@gmail.com:
---------- keywords: +patch pull_requests: +9026 stage: needs patch -> patch review
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9056 _______________________________________

Change by Cheryl Sabella cheryl.sabella@gmail.com:
---------- nosy: +cheryl.sabella, mdk versions: +Python 3.8 -Python 3.3
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9056 _______________________________________

Julien Palard julien+python@palard.fr added the comment:
Merged Cheryl's patch (thanks Cheryl!).
pengyu.ut if you want to test it you'll be able to see generated PDF in a maximum of 24h from now on [1].
Don't hesitate to ask if you need them for 3.8 we can backport it.
[1]: https://docs.python.org/dev/
---------- resolution: -> fixed stage: patch review -> resolved status: open -> closed
_______________________________________ Python tracker report@bugs.python.org https://bugs.python.org/issue9056 _______________________________________
participants (7)
-
Cheryl Sabella
-
Ezio Melotti
-
Fred Drake
-
Julien Palard
-
pengyu.ut
-
Sandro Tosi
-
Senthil Kumaran