Georg Brandl wrote: > Jose Guzman schrieb: > >> I know this is a very simple question, but I could not find the way to >> do it. Until now, I managed to create the documentation of my software >> with Sphinx by just simply typing sphinx -quikstart to create the >> corresponding Makefile. However, now I have several directories with >> different documentation files, and I would really like to put all >> together in a way similar as the python documentation site (a tutorial, >> a How-to, etc.. in the initial page). Is there any source or website >> that explain that ?. Apparently this should be a very easy/standard task >> of the Sphinx documentation manager... but I could not find it. >> >> Thank you very much in advance for your help. >> > > In theory it should work if you just create a new Sphinx project, > put all existing projects in subdirectories, and include them into > a new TOC file. > > Python's main page is not generated from reST, but a custom HTML page. > > Georg >
thank you very much Georg for your answer. Sorry I could not explain it very well, but I think you misunderstood my question. Actually what I wanted to do, is to have one main documentation project with access to 3 or 4 small documentation pieces inside that (everyone in subdirectories under the main project directory). This is similar to the python DOCUMENTATION page, you can see it here : http://docs.python.org/. Sage has exactly the same appearance: http://sagemath.org/doc/ A and very similar way is used in the sphinx home page, where you can find links to contents, and other things, but I would like to add "contents", "manual", "small guide to python"..etc.. I tried to create a main project with sphinx-quickstart, and after that I edited the index.rst of the main project which looks like that: Stimfit Manual ============== Contents: .. toctree:: :maxdepth: 2 /manual/source/ /guide/source/ /python/source/ However this does not work. Is there any explanation on how to do it? (references in the documentation are very welcome!). Thank you very much for your time and help! Jose. --~--~---------~--~----~------------~-------~--~----~ You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to [email protected] To unsubscribe from this group, send email to [email protected] For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en -~----------~----~----~----~------~----~------~--~---
