On Wednesday, 8 August 2012 00:26:37 UTC-4, TP wrote:
>
> On Tue, Aug 7, 2012 at 7:34 AM, Viktor Haag 
> <[email protected] <javascript:>> wrote: 
> > This of course only helps people that are using a theme that supports 
> > html_sidebars. My docs use ..contents:: to put in floating page-only 
> TOCs, 
> > and I like that. Having a way to also provide a "table of contents" page 
> > that would be the globaltoc would be useful, too. 
>
> Huh? That's exactly what the toctree directive is for. Right? 


Oh, yes. You're correct. I use a toctree, but keep it hidden as I use it 
solely for specifying what files to include and in what order.

I guess I'd like to have one directive that controls inventory and a 
separate one that can be used anywhere to provide presentation. There was 
something about the way that the toctree did the latter that I wasn't 
entirely keen on, but I suspect that wasn't necessarily a deficiency of 
toctree but in my not yet wanting to spend the time and effort on styling 
the output to my liking (plus, I wasn't quite able to get a setup working 
where I had the toctree on a Table Of Contents-specific page that was 
separate from my master document).

More fiddling with this is schedule for the future months when I want to 
re-visit how I structured my current doc set and do some serious work on 
the templating I'm using for styling the output -- I know I have several 
hacks in my current build process that I'd prefer not to be using.

--
V.

-- 
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To view this discussion on the web visit 
https://groups.google.com/d/msg/sphinx-dev/-/_D9_6Orz2rwJ.
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