On 2009-10-08, schoenborno wrote:

> Sphinx is a great doc tool, but I find it really strange how it
> presents TOC in sidebar. It is pretty much the norm to have some form
> of page hierarchy type TOC in a sidebar (or topbar) always visible at
> left/right or top of site, to help navigate a site. Yet Sphinx doesn't
> seem to support this in any easy way. Instead it just presents the TOC
> of the current page only, so the context of the page in the hierarchy
> is lost to the user. 

While the sidebar shows just the sub-toc, the topbar shows the upper part of
the hierarchy (or can easily be configured to do so).
See the top-bar in http://pylit.berlios.de/examples/pylit.py.html as an
example.

That said, it might indeed be desirable to have this info united in the
sidebar.

> A thread from May 2008 asked a similar (identical?) question but the
> answer was that it was not possible without some refactoring. I'd like
> to know if that has changed in the most recent stable (0.6) of Sphinx.
> It's even more surprising since the information is clearly available
> since ..toctree: does it on doc page.

Günter


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