Re: [sphinx-dev] Decorators

2012-09-05 Thread Jonathan Fine
It may be possible to fix this by wrapping the decorator. I'm reading you problem to mean that you wrote the module, and that you are using third party decorators. Instead of @wibble def fn(): '''Docstring''' perhaps try @wobble(wibble) def fn(): '''Docstring' Here @wibble is the third

[sphinx-dev] JavaScript documentation (and tutorial) using Sphinx

2010-07-07 Thread Jonathan Fine
Hi 'll be giving a tutorial on JavaScript at the EuroPython conference later this month, and to support this I've written some documentation (using Sphinx, of course). You can download the latest (and earlier) versions at http://bitbucket.org/jfine/javascript-for-python-programmers/downloads

Re: [sphinx-dev] inline latex png's don't respect baseline of running text

2010-04-23 Thread Jonathan Fine
Hi Getting inline math formulas aligned on the baseline is not easy, particularly as there is no standard off-the-shelf solution. My mathtran site sometimes manages it quite well - see http://www.mathtran.org/wiki/index.php/Samples - but the technology is not yet rolled out. The basic idea is

Re: [sphinx-dev] Re: inline latex png's don't respect baseline of running text

2010-04-23 Thread Jonathan Fine
What I do in MathTran is place the metadata in the image, and then leave it to the application to do the right thing with it. And if I server the image via http then I put the metadata in the http header. The preview package and MathTran both rely on the depth report provided by dvipng. --