I have a Sphinx master document which includes child documents as follows:
.. toctree::
:maxdepth: 2
:numbered:
doc1
doc2
doc3
doc4
doc5
doc6
I would like to divide the TOC into parts or subsections, so that it
renders along the lines of:
Part 1: Title of Part 1
<doc1 TOC>
<doc2 TOC>
Part 2: Title of Part 2
<doc3 TOC>
<doc4 TOC>
Part 3: Title of Part 3
<doc5 TOC>
<doc6 TOC>
My current approach is to create pseudo-child documents, that list the
actual documents in their TOC, for example, "part1.rst" would have:
.. toctree::
:maxdepth: 2
:numbered:
doc1
doc2
and then in the master document:
.. toctree::
:maxdepth: 3
:numbered:
part1
part2
part3
The problem with this is that when clicking the link for "part1", you are
taken to a page with no real content ("part1.rst").
Is there any other approach?
Alternatively, is there a way to suppress the entry for "part1.rst" from
generating a page link?
--
You received this message because you are subscribed to the Google Groups
"sphinx-users" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to [email protected].
To post to this group, send email to [email protected].
Visit this group at http://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.