[Doc-SIG] sphinx bug
g.brandl at gmx.net
Sun Mar 23 22:13:55 CET 2008
Ondrej Certik schrieb:
>> > Anyway, the project is great. We moved the docs in ipython to it and
>> > we are going to move sympy docs as well.
>> That's great news! If you need anything, let me know.
> Now I am figuring out how to use templates so that the search box is
> available on all pages.
Try the latest trunk -- I'd forgotten to reenable the search box after
fixing the JS code.
>> > We found a bug though. If python-pygments isn't installed, sphinx
>> > doesn't say anything, "make latex" hapilly generate a latex file, but
>> > this latex file fails to compile:
>> > ! Undefined control sequence.
>> > <argument> In \lb
>> > 1\rb : from ipython1.kernel import client
>> > l.1205 ...rb: from ipython1.kernel import client
>> > That's because the latex file is missing some definitions, like \lb,
>> > that only get included when python-pygments is installed.
>> > Do you think the file sphinx/highlighting.py line 30 could be fixed to
>> > emit a large warning message, that the latex output will be broken
>> > (possibly with an explanation of the problem)? That way one can easily
>> > spot it and fix it.
>> It's even easier to fix the markup so that it will work regardless of
>> Pygments installed or not.
> You mean in rst? I think we are using just regular ::
> some code
Sorry, I meant the generated LaTeX markup.
Thus spake the Lord: Thou shalt indent with four spaces. No more, no less.
Four shall be the number of spaces thou shalt indent, and the number of thy
indenting shall be four. Eight shalt thou not indent, nor either indent thou
two, excepting that thou then proceed to four. Tabs are right out.
More information about the Doc-SIG