The docs compile to html only. Thanks On Tuesday, 15 December 2020 at 07:53:03 UTC David King wrote:
> 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/aab913a7-cd4c-46d1-ab40-82f4cb270bddn%40googlegroups.com.
