Re: [sphinx-dev] Programmatic use of sphinx

2010-08-12 Thread Kevin Horn
On Thu, Aug 12, 2010 at 8:03 AM, Mango wrote: > Hello Sphinx devs! > > First of all thanks for the great tool! I'm from the OpenAlea (python) > project (http://openalea.gforge.inria.fr/wiki/doku.php?id=openalea) > and we have started to move our documentation to sphinx. > > However, we want to pu

[sphinx-dev] Programmatic use of sphinx

2010-08-12 Thread Mango
Hello Sphinx devs! First of all thanks for the great tool! I'm from the OpenAlea (python) project (http://openalea.gforge.inria.fr/wiki/doku.php?id=openalea) and we have started to move our documentation to sphinx. However, we want to push a little further than simply generating html files, we wa

[sphinx-dev] Dynamic file order

2010-08-12 Thread Lllama
Hello all, I'm currently building a collection of scripts for my team to use when writing reports. The plan is that they will create a bunch of rst files and Sphinx will turn them into a shiny PDF, or similar. Each rst file will have a priority associated with it and I was wondering what would be

[sphinx-dev] Programmatic use of sphinx

2010-08-12 Thread Mango
Hello Sphinx devs! First of all thanks for the great tool! I'm from the OpenAlea (python) project (http://openalea.gforge.inria.fr/wiki/doku.php?id=openalea) and we have started to move our documentation to sphinx. However, we want to push a little further than simply generating html files, we wa

RE: [sphinx-dev] Re: modifications to the toctree() template function

2010-08-12 Thread Alastair Dent
I had a thought (wow). In your original question, you wanted a sidebar toc that displayed a list for a sub-grouping of docs. Can you build each sub-group of docs separately, then just combine the files? You would need a 'master' grouping as well, to give you an overall toc/sitemap. So your dir

RE: [sphinx-dev] Re: modifications to the toctree() template function

2010-08-12 Thread Alastair Dent
Sorry, the function isn't called localtoc, it's just 'toc'. Some of the templates produce html with a toc that is just for the current file. Look for localtoc.html. Also mentioned here: http://sphinx.pocoo.org/config.html?highlight=localtoc Like you, I'm finding using some of the functions fru