[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 -- Fred L. Drake, Jr. <fdrake at gmail.com> "A storm broke loose in my mind." --Albert Einstein
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