-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1 Yes, that's all nice, but I wasn't talking about toctree at all :)
Just put :tocdepth: 2 at the top of the file. Nothing else. Example:: :tocdepth: 2 Title of the file ================= Some text. HTH, Georg Am 10.01.2011 20:34, schrieb Eric Gilmore: > Hm, here are some things I'm 100% sure of: > > 1) When I change the value to 1, with the toctree markup in this position in > index.rst, I see the on-page TOC reduced to a depth of 1 but no change at all > in > the depth reflected in the sidebar: > > ************************************************ > ************************************************ > .. _apache-cassandra: > > Apache Cassandra |release| > ========================== > > .. toctree:: > :maxdepth: 1 > > introduction/index > getting_started/index > > ************************************************ > ************************************************ > > By the same token, if I set that to :maxdepth: 3, I can see all three levels > in > the on-page TOC for index.html, but no change in the sidebar. > > 2) If I place the toctree markup at the very, very top of the page -- ahead > of > the heading and the reference -- then there is no TOC markup at all, and the > entries are listed thus on the page: > > introduction/index getting_started/index configuration/index > data_model/index api/index consistency/index map_reduce/index > operations/index troubleshooting/index utilities/index > > 3) If I place the same toctree markup in either position inside one of the > content pages (not index.rst), it (as expected, I think) has no effect at all. > > Given all this, do you see why I reached the conclusion that the toctree > markup > *does* affect the outline on index.html, but *does not* seem to have a > corresponding effect on the sidebar? > > > > > > > > > > On Mon, Jan 10, 2011 at 11:24 AM, Georg Brandl <[email protected] > <mailto:[email protected]>> wrote: > > Are you sure you put ":tocdepth: 2" at the *top* of the *file*? > > Georg > > Am 10.01.2011 17:20, schrieb Eric Gilmore: >> Georg, I tried that, and it only affected the TOC tree in the index page > -- not >> the side bar. > >> *Should* that setting affect the side bar as well, and there is something > wrong >> with my setup? > >> The "stickysidebar" setting does basically solve my problem of long >> parameters >> spilling over. But I'm still curious about controlling the depth of the > side bar. > >> Thanks very much for your attention to my message :) > >> On Sat, Jan 8, 2011 at 3:37 PM, Georg Brandl <[email protected] > <mailto:[email protected]> >> <mailto:[email protected] <mailto:[email protected]>>> wrote: > >> Am 23.12.2010 19:40, schrieb Gilmorez: >>> It is very easy to set the depth of the TOC on an index page, and that >>> is very handy. > >>> So far, in my attempts to figure out how to do the same for the >>> sidebar TOC, I'm finding it difficult. > >>> We are using localtoc, and I would like to limit it to two levels so >>> that long parameter and class names in our documentation do not appear >>> there and spill over into the main frame. > >>> If anyone can point me in the right direction on how to control that, >>> it is much much appreciated. > >> You can do this by putting this at the top of the file: > >> :tocdepth: 2 > > >> cheers, >> Georg > - -- 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] <mailto:[email protected]>. To unsubscribe from this group, send email to [email protected] <mailto:sphinx-dev%[email protected]>. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en. > -- > *Eric Gilmore > * > Consulting Technical Writer > Riptano, Inc. > Ph: 510 684 9786 (cell) > -- > 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. -----BEGIN PGP SIGNATURE----- Version: GnuPG v1.4.11 (GNU/Linux) iEYEARECAAYFAk0rY7UACgkQN9GcIYhpnLAb2gCdFBNBBW6q3VXyS1K6niQyxvVd 2mYAoLD2nkok+2ATOFFeBtOSazFv5cOx =mU6b -----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.
