RE: [sphinx-dev] Using if statements in conf.py

2011-12-06 Thread Alastair Dent
, Dec 5, 2011 at 5:47 AM, Alastair Dent alastair.d...@imgtec.com wrote: Thanks, that helps. I really don't know anything about Python - my background is with languages like Fortran and Pascal. How do I pass an argument to conf.py? If I were doing this in Pascal I'd declare it as a global

[sphinx-dev] two tocs in index.rst = two in sidebar

2011-12-06 Thread Alastair Dent
I have two tocs in my index.rst, each contained by an ifconfig statement. The body of the index.rst generates correctly, with the correct toc showing according to the parameters for ifconfig. However, the sidebar (which contains a mini-toc based on index.rst) does not generate correctly.

RE: [sphinx-dev] Using if statements in conf.py

2011-12-05 Thread Alastair Dent
Sent: 02 December 2011 22:29 To: sphinx-dev@googlegroups.com Subject: Re: [sphinx-dev] Using if statements in conf.py On Fri, Dec 2, 2011 at 11:27 AM, Alastair Dent alastair.d...@imgtec.com wrote: Can I do something like the following in conf.py: You can but you'll have to use Python syntax (conf.py

[sphinx-dev] Using if statements in conf.py

2011-12-02 Thread Alastair Dent
Can I do something like the following in conf.py: if ifconf_product='mini' then exclude_patterns = ['interface/*.rst','dialogs/*.rst'] elseif ifconf_product='main' then exclude_patterns = ['mini-indexes.rst] endif I need to exclude specific files for some builds

RE: [sphinx-dev] exclude_patterns not working

2011-07-20 Thread Alastair Dent
and not used to produce html output. On 07/20/2011 04:28 PM, Alastair Dent wrote: Python 2.6 Sphinx-1.0.7-py2.6.egg I'm using the following in conf.py exclude_patterns = ['interface/peripheralRegion.rst', 'hdEditor/'] All files in hdEditor and the 'interface/peripheralRegion.rst' file

RE: [sphinx-dev] exclude_patterns not working

2011-07-20 Thread Alastair Dent
out :) but anyway, it might still be helpful in general if you specified whether or not .html is actually being generated for them, or if it's only the sources that get copied. good luck On 07/20/2011 04:54 PM, Alastair Dent wrote: They are linked by reference. Do you think that could

RE: [sphinx-dev] exclude_patterns not working

2011-07-20 Thread Alastair Dent
and not used to produce html output. On 07/20/2011 04:28 PM, Alastair Dent wrote: Python 2.6 Sphinx-1.0.7-py2.6.egg I'm using the following in conf.py exclude_patterns = ['interface/peripheralRegion.rst', 'hdEditor/'] All files in hdEditor and the 'interface/peripheralRegion.rst' file are included

RE: [sphinx-dev] Where is the Sphinx-Wiki???

2010-10-05 Thread Alastair Dent
I think you've misunderstood the main usage of Sphinx. It is used for producing documentation from commented source code, where the comments are written in rst format. I'd be very interested in a project that used a wiki as a source. -Original Message- From:

RE: [sphinx-dev] Putting the search box on the top bar

2010-09-28 Thread Alastair Dent
Find the layout.html file for the theme you are using. Look for 'Search' and you should find some lines like: {%- block sidebarsearch %} {%- include searchbox.html %} {%- endblock %} Now to decide where to put it in the header. The template I'm using has a navigation

RE: [sphinx-dev] Putting the search box on the top bar

2010-09-28 Thread Alastair Dent
September 2010 13:55 To: sphinx-dev@googlegroups.com Subject: Re: [sphinx-dev] Putting the search box on the top bar On Tue, Sep 28, 2010 at 8:35 PM, Alastair Dent alastair.d...@imgtec.com wrote: Find the layout.html file for the theme you are using. Look for 'Search' and you should find some

[sphinx-dev] accessing global variables like 'toc'

2010-09-27 Thread Alastair Dent
In some html files I'd like to place a local toc. The variable 'toc' would seem to do the trick, but how do I insert it? Should I define a block in the layout.html? -- You received this message because you are subscribed to the Google Groups sphinx-dev group. To post to this group, send email

RE: [sphinx-dev] Re: secondary windows or hidden sections in html output

2010-09-17 Thread Alastair Dent
] On Behalf Of Max Battcher Sent: 16 September 2010 21:33 To: sphinx-dev@googlegroups.com Subject: Re: [sphinx-dev] Re: secondary windows or hidden sections in html output On 9/16/2010 4:15, Alastair Dent wrote: Just re-read your email, and I'm not sure how this would work. In html, I'd have two divs

RE: [sphinx-dev] Re: secondary windows or hidden sections in html output

2010-09-15 Thread Alastair Dent
. -Original Message- From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] On Behalf Of Guenter Milde Sent: 15 September 2010 08:00 To: sphinx-dev@googlegroups.com Subject: [sphinx-dev] Re: secondary windows or hidden sections in html output On 2010-09-14, Alastair Dent wrote

RE: [sphinx-dev] Re: secondary windows or hidden sections in html output

2010-09-15 Thread Alastair Dent
I'll try that tomorrow, thanks. -Original Message- From: sphinx-dev@googlegroups.com on behalf of Max Battcher Sent: Wed 15/09/2010 19:03 To: sphinx-dev@googlegroups.com Subject: Re: [sphinx-dev] Re: secondary windows or hidden sections in html output On 09/15/2010 08:42 AM, Alastair

[sphinx-dev] secondary windows or hidden sections in html output

2010-09-14 Thread Alastair Dent
I'm used to working with raw html and adding sections of info or graphics that are only displayed when the user clicks a link or button. Sometimes it's text that is expanded inline, sometimes a large version of a graphic. Is there a way of doing this with rst and Sphinx, or do I need to write an

RE: [sphinx-dev] PDF docs from HTML

2010-09-13 Thread Alastair Dent
Take a look at http://www.princexml.com/. We use it for converting html to pdf and find the results fantastic. -Original Message- From: sphinx-dev@googlegroups.com [mailto:sphinx-...@googlegroups.com] On Behalf Of Georg Brandl Sent: 23 August 2010 15:08 To: sphinx-dev@googlegroups.com

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

2010-08-12 Thread Alastair Dent
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 alastair.d...@imgtec.com wrote: I was a bit woolly in my description, and on checking, I'm wrong as well. AFAIK, the sidebar

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-11 Thread Alastair Dent
is that? And how would I start? On Aug 9, 11:14 am, Alastair Dent alastair.d...@imgtec.com 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

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

2010-08-09 Thread Alastair Dent
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,

[sphinx-dev] sort order with Glob

2010-08-06 Thread Alastair Dent
Is it possible to tell glob to sort by document title rather than document name? -- 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] Using :glob:

2010-07-07 Thread Alastair Dent
I'd really like to mix using :glob: with manual entries in a toctree. Is this possible? It seems that the normal syntax is something like this: .. toctree:: :maxdepth: 2 :glob: dialoghelp/* I want to put some manual entries in before the entries inserted by

[sphinx-dev] 'unknown directive'

2010-07-01 Thread Alastair Dent
I have an rst file with the following line: .. cfunction:: DAConf [options] [command [DA-id]] Building this results in the error message ERROR/3 Unknown directive type cfunction Why? -- You received this message because you are subscribed to the Google Groups sphinx-dev group.

[sphinx-dev] KeyError; 'test' with sphinx v1.0b2

2010-06-28 Thread Alastair Dent
I was building successfully using default setup. altered the html_theme to point to a custom theme and got the following error (build completed successfully, as far as I can tell). Exception occurred: File c:\Python26\lib\site-packages\sphinx-1.0b2-py2.6.egg\sphinx \environment.py, line 1031,

[sphinx-dev] Search Function Firefox on Linux (Centos+KDE)

2010-06-25 Thread Alastair Dent
We are testing out using Sphinx for a cross-platform app, and it looks ok on both Windows and Linux, apart from one wrinkle. The search function simply doesn't do anything on Linux. No error messages, just nothing. The same doc set works perfectly on windows xp and 7. I'm running CentOS 5 with KDE