I've inherited a simple Sphinx site with a kind of head scratcher problem.
The users want the toctree to only appear in the sidebar, not on the
homepage AND they want the home button to always take them to that homepage
So, I pointed master_doc to homepage in conf.py On the homepage, I tried
this:
.. toctree::
:maxdepth: 2
Home <homepage>
foo
bar
Local HTML content goes here
But this causes grumbling about recursive references to homepage and messes
up the sidebar.
So, I factored out the toctree stuff into contents.rst, leaving only the
local HTML content in homepage.rst. Then I pointed master_doc to index.rst
which has the following in it:
.. include:: ./contents.rst
.. include:: ./homepage.rst
That solved the recursion problem but has one small irritating issue. The
first time you load the site or use the Home button, you're logically in
the "index" document. If you press the Next button, it takes you to
homepage - which index has already loaded. You have to press the Next
button a second time to actually get to the foo document ... which is
irritating.
tl;dr Want a way to use RTD to have the home button land on a homepage
that does not have a toc tree on it but otherwise works normally.
Ideas? (New to Sphinx, so this may be a stupid question ....)
--
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 https://groups.google.com/group/sphinx-users.
For more options, visit https://groups.google.com/d/optout.
