homepage

This issue tracker has been migrated to GitHub , and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: Adding additional level of bookmarks and section numbers in python pdf documents.
Type: enhancement Stage: resolved
Components: Documentation Versions: Python 3.8
process
Status: closed Resolution: fixed
Dependencies: Superseder:
Assigned To: docs@python Nosy List: cheryl.sabella, docs@python, ezio.melotti, fdrake, georg.brandl, mdk, orsenthil, pengyu.ut, sandro.tosi
Priority: normal Keywords: patch

Created on 2010年06月22日 03:00 by pengyu.ut, last changed 2022年04月11日 14:57 by admin. This issue is now closed.

Pull Requests
URL Status Linked Edit
PR 9629 merged cheryl.sabella, 2018年09月28日 22:17
Messages (6)
msg108334 - (view) Author: (pengyu.ut) Date: 2010年06月22日 03:00
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
msg108370 - (view) Author: Senthil Kumaran (orsenthil) * (Python committer) Date: 2010年06月22日 11:25
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.
msg108374 - (view) Author: (pengyu.ut) Date: 2010年06月22日 13:41
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.
msg108382 - (view) Author: Fred Drake (fdrake) (Python committer) Date: 2010年06月22日 14:17
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
msg132033 - (view) Author: Sandro Tosi (sandro.tosi) * (Python committer) Date: 2011年03月24日 21:27
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?
msg362237 - (view) Author: Julien Palard (mdk) * (Python committer) Date: 2020年02月18日 23:04
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/ 
History
Date User Action Args
2022年04月11日 14:57:02adminsetgithub: 53302
2020年02月18日 23:04:21mdksetstatus: open -> closed
resolution: fixed
messages: + msg362237

stage: patch review -> resolved
2018年11月15日 22:05:13cheryl.sabellasetnosy: + mdk, cheryl.sabella

versions: + Python 3.8, - Python 3.3
2018年09月28日 22:17:04cheryl.sabellasetkeywords: + patch
stage: needs patch -> patch review
pull_requests: + pull_request9026
2012年02月24日 11:07:56ezio.melottisettype: enhancement
stage: needs patch
2011年03月26日 19:12:40ezio.melottisetnosy: + ezio.melotti
2011年03月24日 21:27:30sandro.tosisetnosy: + georg.brandl, sandro.tosi

messages: + msg132033
versions: + Python 3.3, - Python 2.6
2010年06月22日 14:17:18fdrakesetnosy: + fdrake
messages: + msg108382
2010年06月22日 13:41:14pengyu.utsetmessages: + msg108374
2010年06月22日 11:25:36orsenthilsetnosy: + orsenthil
messages: + msg108370
2010年06月22日 03:00:34pengyu.utcreate

AltStyle によって変換されたページ (->オリジナル) /