I'd like to add the following to my documentation:
tutorial
sect a
sect b
where the "tutorial" page contains some introduction, and "sect a" and
"sect b" then contain sub sections.
Unfortunately, I can't quite get this to build right with sphinx. I
tried two things:
1) My outer document's toctree included "tutorial/index", which contains
the introduction, as well as a toctree directive for "sect a" and "sect
b". When the toctree directive appears first, i.e. before the
"introduction" section, the generated toctree would be
tutorial
sect a
sect b
introduction
2) My outer document's toctree included "tutorial/contents", where the
"tutorial/contents.rst" file merely contains a toctree:
.. toctree::
introduction <index>
sect a
sect b
That generates the right toctree, but the "tutorial" link in the toctree
would be to an empty page with nothing but the contents links in it.
Is there a way to do what I want ? It seems that 1) above gets me
"almost there". If there was a way to either append the toctree
directive to the end of the file (without it being a toctree that's the
child of the "introduction" section), or some means to express that the
toctree should be appended to the page's own toctree, instead of prepended.
Any ideas ?
Thanks a lot,
Stefan
--
...ich hab' noch einen Koffer in Berlin...
--
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com.
To unsubscribe from this group, send email to
sphinx-dev+unsubscr...@googlegroups.com.
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en.
