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

2011-12-05 Thread Alastair Dent
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 variable and initialise it explicitly at an appropriate point. Python doesn't

[sphinx-dev] Sphinx vs. docutils for textbook

2011-12-05 Thread Bob Plantz
I am converting a textbook I have written in LaTeX to epub. The book (500+ pages) is on assembly language. It has many drawings (vector graphics), a fair amount of math equations (but only simple algebra notation), and many code listings. My goal is to make it available both in epub (for ereaders)

[sphinx-dev] Divide a documentation in parts

2011-12-05 Thread Romain
Helllo ! I wrote a documentation into Restructured text / Sphinx projects in the last days. You can have a look here : https://github.com/alchemy-fr/Phraseanet-Docs I would like to divide my documentation in 3 parts (admin / user / developper) and customise the HTML layout depending in which

[sphinx-dev] conf.py latex_preamble unicode?

2011-12-05 Thread Joseph_Chen
Hello there, I have a problem when filling the latex_preamble variable with unicode strings, something like this: latex_preamble = u'''\usepackage{xeCJK} \setCJKmainfont{標楷體}''' and the I issue the command: make latex output: Configuration error: There is a syntax error in your configuration

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

2011-12-05 Thread Nick Leaton
Why not create two configs? One for the short version, one for the longer version and then make the long, or make the short? On 5 December 2011 10:47, Alastair Dent alastair.d...@imgtec.com wrote: Thanks, that helps. I really don't know anything about Python - my background is with languages

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

2011-12-05 Thread Maxim Yaskevich
12/5/2011 1:47 PM, Alastair Dent ?: 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 variable and initialise it

Re: [sphinx-dev] Splitting HTML output at subsection boundaries

2011-12-05 Thread Tim Golden
On 01/12/2011 13:16, Kevin Dunn wrote: I wrote something a while back to do exactly what you asked for (and a few other things). The code and an example is available at http://ucomment.org. That looks brilliant. I only wish I had a reason to use it :) TJG -- You received this message

[sphinx-dev] How to hide code with sphinx doc

2011-12-05 Thread lafada
Hello, I dont know this is write forum to write or not for this question. But i put same question on StackOverflow http://stackoverflow.com/questions/8151729/how-to-show-and-hide-code-in-sphinx-doc. I want to know that the functionality given in SQLALCHEMY doc to hide the code is inbuilt

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

2011-12-05 Thread Ernesto Posse
My comments are below. On Mon, 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

[sphinx-dev] MathML (was Re: Splitting HTML output at subsection boundaries)

2011-12-05 Thread Guenter Milde
On 2011-12-03, Friedrich Romstedt wrote: Hello Guenter, 3)  Maths as PNGs (if not using JSMath, what is not an option for ebook readers) not properly aligned in inline text mostly. Since version 0.8, Docutils supports math with MathML and HTML+CSS output options in HTML. (I don't know how

[sphinx-dev] HTMLHELP index problem

2011-12-05 Thread BiDi
I have a problem with index generation in HTMLHELP. The index keywords are all single letters for some reason. A look inside the '.hhk' file generated by sphinx shows things like this: /ULLI OBJECT type=text/sitemap param name=Keyword value=r param name=Local

[sphinx-dev] Re: HTMLHELP index problem

2011-12-05 Thread BiDi
Further to this, I went back to sphinx 1.0.7, which was successful last time. With no other changes, the index problem does not occur. So, is there something that I need to change in the configuration to use 1.1.2, or is this perhaps a bug? Thanks -- You received this message because you

Re: [sphinx-dev] Splitting HTML output at subsection boundaries

2011-12-05 Thread Fernando Perez
On Thu, Dec 1, 2011 at 9:04 AM, Friedrich Romstedt friedrichromst...@gmail.com wrote: 2011/12/1 Fernando Perez fperez@gmail.com: On Thu, Dec 1, 2011 at 2:56 AM, Friedrich Romstedt friedrichromst...@gmail.com wrote: 1)  Spanning paragraphs over equations.  Paragraphs are in Docutils a