Hi! We are using Sphinx to document a custom programming language. For that purpose we created a custom domain. I don't know if my question is related with the domain or not.
Our language has various "contexts" that cannot be used simultaneously. Each context can have different types and methods, but most types and methods are present in all contexts. Now we need an index for each context so that people who work with "their" context have a documentation for the context only. And we need a global index, so that it's possible to search for a type or method indepenant of the context. Our project now features a main index.rst, and each context resides in a subdirectory, each containing a separate index.rst. The main index.rst looks like this (only two contexts here for simplicity): Welcome to our documentation! =========================================== Contents: .. toctree:: :maxdepth: 2 context1/index.rst context2/index.rst Global indices and tables ================== * :ref:`genindex` * :ref:`modindex` * :ref:`search` When I generate the documentation there is of course only one (global) index. Inside this index I can see that there are duplicate types denoted by a [1] after the type. My first approach was to use each subdirectory as a separate project. So I added context1/conf.py and context2/conf.py. This works fine, but the result is duplicate documentation. Now I have the entire documentation created by the global project, and "local" documentations for each context in the subdirectory. The same type is documented two or three times with the exact same HTML page. What I want to have instead is, that the global project has it's own global index, but the content is linked to the sub-project's content. Is this possible with simple means? So I need something like that: - create the index from context1/index.rst and context2/index.rst - but link to context1/output/index.html and context2/output/index.html The index of both context is generated, so the only thing I need is to merge these indexes. I hope someone can help me here. Greetings, Torsten PS: I'm quite new to Python, so forgive my ignorance. -- 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/groups/opt_out.
