Beginner's question. I am helping with documentation (written under 
Sphinx) for a popular open source project. The current docs are scanty, and 
the developers haven't time or inclination to look at this.

The current docs have .rst files which all get put into a single table of 
contents. The
docs need a load of detailed pages, which I'd like to put in an appendix, 
because
otherwise they'd frighten off new users.

So currently there is, in index.rst:
Table of Contents:
------------------

.. toctree::
   :maxdepth: 2

   introduction
   topic1
    etc...

I want separate .rst files for each appendix, and I want the toc to list eg
Table of Contents

Introduction
Topic 1
etc
...
Appendix
    appendix 1 - some topic
    appemdix 2 - another topic

My interest is in writing the docs - not in learning Sphinx I'm afraid. 
Would anyone be
kind enough to tell me what to do to implement this? Thank you 

-- 
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 view this discussion on the web visit 
https://groups.google.com/d/msgid/sphinx-users/1fd63034-447d-40bb-ac6f-8d7019d84147n%40googlegroups.com.

Reply via email to