-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

Does anyone have any guidance on how to get Sphinx to play nicely with
ifconfig and toctree?  What I want to write is something like this (but
quite a bit more complicated) where the ifconfig choices are mutually
exclusive (only one will ever be true).

.. ifconfig:: modeA

   .. toctree::

      a
      b
      f
      g

.. ifconfig:: modeB

   .. toctree::

      f
      a
      g


What I found is that HTML generation only includes the content from the
relevant toctree, but the Table Of Contents includes *every* toctree.

I tried making separate files (index-modeA, index-modeB) and select in the
conf.py but then sphinx whines about "WARNING: document isn't included in
any toctree" for the one not being used even though it is in exclude_patterns.

I did see one example where someone split the toctree into multiple
fragments with an ifconfig before each one and tried to replicate it, but
quickly gave up as I actually have 3 different modes, 12 documents (so
far) and the file was becoming lengthy and unintelligible.

Roger
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)

iEYEARECAAYFAk/AeXcACgkQmOOfHg372QRA1QCdEJb5ueGjhWaEBuM018P/qN0O
ryMAnRSWt8BQt677CrnEyAdw64eAnY3w
=A7aN
-----END PGP SIGNATURE-----

-- 
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.

Reply via email to