[sphinx-dev] Re: modifications to the toctree() template function
you're right, basic theme uses globaltoc.html template. but the code in there just calls the toctree() template function. which I also do. my question goes beyond that. my system doesn't seem to know any localtoc() function. where can i see which functions are available in the template, and how to use them? thanks for your insight :) a. On 11 Aug., 15:40, "Alastair Dent" wrote: > I was a bit woolly in my description, and on checking, I'm wrong as well. > > AFAIK, the sidebar is 'built' by taking info from an html file specified for > your theme. For my setup, that's > C:\Python26\Lib\site-packages\Sphinx-1.0b2-py2.6.egg\sphinx\themes\basic\globaltoc.html > > Can you use the function localtoc instead? > > -Original Message- > From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] On > Behalf Of andreash > Sent: 11 August 2010 11:45 > To: sphinx-dev > Subject: [sphinx-dev] Re: modifications to the toctree() template function > > I don't understand what you mean. What's the difference between > 'compile time' and 'runtime'? > > The toctree() template function takes parameters, which means that it > is evaluated when the HTML files are built. So it should just be a > matter of extending the Sphinx function which the template toctree() > function calls. But which is that? And how would I start? > > On Aug 9, 11:14 am, "Alastair Dent" wrote: > > As I understand it, the toctree is built at compile time, not runtime. > > So normally it is built, then inserted into the html file. > > > So the sidebars are built, then inserted. So what you are asking for > > would be quite complicated. > > > I use a 'local' toctree in a similar manner to what you are asking, but > > it is only in the first/overview html file for each chunk. > > > -Original Message- > > From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] > > > On Behalf Of andreash > > Sent: 09 August 2010 09:57 > > To: sphinx-dev > > Subject: [sphinx-dev] modifications to the toctree() template function > > > Hi there, > > > I'm using Sphinx 1.0.1 to build some websites. While adapting the > > basic template to my needs, I stumbled upon the need to modify the > > toctree() template function to accomodate several things. > > > Most importantly, I'd like to have toctree() an option to start at the > > level of the current document, and not at the root level. What I mean > > is this: > > > root/ > > doc1/ > > doc2/ > > doc2.1/ > > doc2.2/ > > doc3/ > > > So I'd like to have the option to render a sidebar menu which only > > contains the 'heading' "doc2", and then the members doc2.1 and doc2.2. > > I was thinking about an option toctree(startatcurrent=True) to > > accomodate this ... > > > Also, how do I get the title of and the link to the parent of the > > current document (to accomodate the 'heading' as descibed above)? > > > I've been searching through the Sphinx code for quite some while, but > > couldn'r really figure out which functions/variables are available to > > the templates. What I did find out is that probably the code that I > > want is in environment.py. But how would I go to implement changes? > > > Any help is greatly appreciated! > > > Cheers, A. > > > -- > > You received this message because you are subscribed to the Google > > Groups "sphinx-dev" group. > > To post to this group, send email to sphinx-...@googlegroups.com. > > To unsubscribe from this group, send email to > > sphinx-dev+unsubscr...@googlegroups.com. > > For more options, visit this group > > athttp://groups.google.com/group/sphinx-dev?hl=en. > > -- > You received this message because you are subscribed to the Google Groups > "sphinx-dev" group. > To post to this group, send email to sphinx-...@googlegroups.com. > To unsubscribe from this group, send email to > sphinx-dev+unsubscr...@googlegroups.com. > For more options, visit this group > athttp://groups.google.com/group/sphinx-dev?hl=en. > > -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
RE: [sphinx-dev] Re: modifications to the toctree() template function
I was a bit woolly in my description, and on checking, I'm wrong as well. AFAIK, the sidebar is 'built' by taking info from an html file specified for your theme. For my setup, that's C:\Python26\Lib\site-packages\Sphinx-1.0b2-py2.6.egg\sphinx\themes\basic\globaltoc.html Can you use the function localtoc instead? -Original Message- From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] On Behalf Of andreash Sent: 11 August 2010 11:45 To: sphinx-dev Subject: [sphinx-dev] Re: modifications to the toctree() template function I don't understand what you mean. What's the difference between 'compile time' and 'runtime'? The toctree() template function takes parameters, which means that it is evaluated when the HTML files are built. So it should just be a matter of extending the Sphinx function which the template toctree() function calls. But which is that? And how would I start? On Aug 9, 11:14 am, "Alastair Dent" wrote: > As I understand it, the toctree is built at compile time, not runtime. > So normally it is built, then inserted into the html file. > > So the sidebars are built, then inserted. So what you are asking for > would be quite complicated. > > I use a 'local' toctree in a similar manner to what you are asking, but > it is only in the first/overview html file for each chunk. > > -Original Message- > From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] > > On Behalf Of andreash > Sent: 09 August 2010 09:57 > To: sphinx-dev > Subject: [sphinx-dev] modifications to the toctree() template function > > Hi there, > > I'm using Sphinx 1.0.1 to build some websites. While adapting the > basic template to my needs, I stumbled upon the need to modify the > toctree() template function to accomodate several things. > > Most importantly, I'd like to have toctree() an option to start at the > level of the current document, and not at the root level. What I mean > is this: > > root/ > doc1/ > doc2/ > doc2.1/ > doc2.2/ > doc3/ > > So I'd like to have the option to render a sidebar menu which only > contains the 'heading' "doc2", and then the members doc2.1 and doc2.2. > I was thinking about an option toctree(startatcurrent=True) to > accomodate this ... > > Also, how do I get the title of and the link to the parent of the > current document (to accomodate the 'heading' as descibed above)? > > I've been searching through the Sphinx code for quite some while, but > couldn'r really figure out which functions/variables are available to > the templates. What I did find out is that probably the code that I > want is in environment.py. But how would I go to implement changes? > > Any help is greatly appreciated! > > Cheers, A. > > -- > You received this message because you are subscribed to the Google > Groups "sphinx-dev" group. > To post to this group, send email to sphinx-...@googlegroups.com. > To unsubscribe from this group, send email to > sphinx-dev+unsubscr...@googlegroups.com. > For more options, visit this group > athttp://groups.google.com/group/sphinx-dev?hl=en. > > -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en. -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
[sphinx-dev] Re: modifications to the toctree() template function
I don't understand what you mean. What's the difference between 'compile time' and 'runtime'? The toctree() template function takes parameters, which means that it is evaluated when the HTML files are built. So it should just be a matter of extending the Sphinx function which the template toctree() function calls. But which is that? And how would I start? On Aug 9, 11:14 am, "Alastair Dent" wrote: > As I understand it, the toctree is built at compile time, not runtime. > So normally it is built, then inserted into the html file. > > So the sidebars are built, then inserted. So what you are asking for > would be quite complicated. > > I use a 'local' toctree in a similar manner to what you are asking, but > it is only in the first/overview html file for each chunk. > > -Original Message- > From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] > > On Behalf Of andreash > Sent: 09 August 2010 09:57 > To: sphinx-dev > Subject: [sphinx-dev] modifications to the toctree() template function > > Hi there, > > I'm using Sphinx 1.0.1 to build some websites. While adapting the > basic template to my needs, I stumbled upon the need to modify the > toctree() template function to accomodate several things. > > Most importantly, I'd like to have toctree() an option to start at the > level of the current document, and not at the root level. What I mean > is this: > > root/ > doc1/ > doc2/ > doc2.1/ > doc2.2/ > doc3/ > > So I'd like to have the option to render a sidebar menu which only > contains the 'heading' "doc2", and then the members doc2.1 and doc2.2. > I was thinking about an option toctree(startatcurrent=True) to > accomodate this ... > > Also, how do I get the title of and the link to the parent of the > current document (to accomodate the 'heading' as descibed above)? > > I've been searching through the Sphinx code for quite some while, but > couldn'r really figure out which functions/variables are available to > the templates. What I did find out is that probably the code that I > want is in environment.py. But how would I go to implement changes? > > Any help is greatly appreciated! > > Cheers, A. > > -- > You received this message because you are subscribed to the Google > Groups "sphinx-dev" group. > To post to this group, send email to sphinx-...@googlegroups.com. > To unsubscribe from this group, send email to > sphinx-dev+unsubscr...@googlegroups.com. > For more options, visit this group > athttp://groups.google.com/group/sphinx-dev?hl=en. > > -- You received this message because you are subscribed to the Google Groups "sphinx-dev" group. To post to this group, send email to sphinx-...@googlegroups.com. To unsubscribe from this group, send email to sphinx-dev+unsubscr...@googlegroups.com. For more options, visit this group at http://groups.google.com/group/sphinx-dev?hl=en.
