Re: Another project using Sphinx

2008-11-14 Thread Roger Binns
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 Mark Eichin wrote: > On Fri, Nov 14, 2008 at 2:17 PM, Glenn Hutchings <[EMAIL PROTECTED]> wrote: >> Cheers for a great tool that actually makes programmers *want* to >> write documentation! > > Yeah - I've noticed the effect, but don't understand it

One more project using Sphinx: apsw

2008-11-14 Thread Roger Binns
-BEGIN PGP SIGNED MESSAGE- Hash: SHA1 http://apsw.googlecode.com/svn/publish/index.html I previously used hand edited HTML. The HTML was nice in that it was a single standalone file (styles etc incorporated within). Some observations and experience: I gave up trying to use PDF. Even

Re: Another project using Sphinx

2008-11-14 Thread Mark Eichin
On Fri, Nov 14, 2008 at 2:17 PM, Glenn Hutchings <[EMAIL PROTECTED]> wrote: > > Hey Mr Brandl, here's another project using Sphinx/Pygments for docs > (alas poor LyX, I knew it well). You might want to point at it in the > EXAMPLES file: > > IFM: http://fluffybunny.memebot.com/ifm-docs/index.html

Re: Math extension (png rendering)

2008-11-14 Thread Roberto Alsina
On Friday 14 November 2008 17:35:38 Sebastian Wiesner wrote: > Friday 14 November 2008 18:16:17 Fredrik Johansson > > > On Fri, Nov 14, 2008 at 5:44 PM, Sebastian Wiesner > > > > <[EMAIL PROTECTED]> wrote: > > > Friday 14 November 2008 17:17:26 Fredrik Johansson > > > > > >> 1. Inline equations ne

Re: Math extension (png rendering)

2008-11-14 Thread Fredrik Johansson
On Fri, Nov 14, 2008 at 8:35 PM, Sebastian Wiesner <[EMAIL PROTECTED]> wrote: > Image a formula containing only lowercase letters (e.g. "a + c"). Centering > such an image would center the lowercase "a" on the line, which is certainly > not, what you want. Even more problematic are formulas like

Re: Math extension (png rendering)

2008-11-14 Thread Sebastian Wiesner
Friday 14 November 2008 18:16:17 Fredrik Johansson > On Fri, Nov 14, 2008 at 5:44 PM, Sebastian Wiesner > > <[EMAIL PROTECTED]> wrote: > > Friday 14 November 2008 17:17:26 Fredrik Johansson > > > >> 1. Inline equations need proper vertical alignment. > > > > Proper vertical alignment is supported b

Another project using Sphinx

2008-11-14 Thread Glenn Hutchings
Hey Mr Brandl, here's another project using Sphinx/Pygments for docs (alas poor LyX, I knew it well). You might want to point at it in the EXAMPLES file: IFM: http://fluffybunny.memebot.com/ifm-docs/index.html Cheers for a great tool that actually makes programmers *want* to write documentation

Re: Math extension (png rendering)

2008-11-14 Thread Fredrik Johansson
On Fri, Nov 14, 2008 at 5:44 PM, Sebastian Wiesner <[EMAIL PROTECTED]> wrote: > Friday 14 November 2008 17:17:26 Fredrik Johansson >> 1. Inline equations need proper vertical alignment. > > Proper vertical alignment is supported by Sphinx, but depends on the latex- > preview package. Since this p

Re: Math extension (png rendering)

2008-11-14 Thread Sebastian Wiesner
Friday 14 November 2008 17:17:26 Fredrik Johansson > 1. Inline equations need proper vertical alignment. Proper vertical alignment is supported by Sphinx, but depends on the latex- preview package. Since this package is not available everywhere, Sphinx does not use it by default. But if you're

PDF via reportlab: a first shot at code

2008-11-14 Thread Roberto Alsina
I posted it in the issue: http://www.bitbucket.org/birkenfeld/sphinx/issue/27 It's really broken code, I just started hacking without shame! It does work in the sense that it takes a project and produces a PDF. It doesn't produce a NICE pdf, or even a decent PDF. There is no way to pass it opt

Re: Math extension (png rendering)

2008-11-14 Thread Fredrik Johansson
On Fri, Nov 14, 2008 at 5:17 PM, Fredrik Johansson <[EMAIL PROTECTED]> wrote: > 1. Inline equations need proper vertical alignment. The Sphinx documentation claims that this requires preview-latex. However, shouldn't it be sufficient to set style="vertical-align: middle" for all inline formulas?

Math extension (png rendering)

2008-11-14 Thread Fredrik Johansson
Hi, I just installed sphinx-0.5 (dev) to try out the math support, and I'm very happy with it! Latex surely beats ASCII-art math. I've started converting the mpmath docs to use it; you can see it in some of the docstrings on this page: http://mpmath.googlecode.com/svn/trunk/doc/build/functions.ht

Multilingual websites

2008-11-14 Thread Luc Saffre
Dear Sphinx developers, I'm trying to create a multilingual website using Sphinx, and I post my thoughts here in the hope to get feedback from you. 1. Introduction A multilinghual website is a website where the visitor can choose among several languages. Examples: - Sites with automatic lang

Multilingual websites

2008-11-14 Thread Luc Saffre
Dear Sphinx developers, I'm trying to create a multilingual website using Sphinx, and I post my thoughts here in the hope to get feedback from you. 1. Introduction A multilinghual website is a website where the visitor can choose among several languages. Examples: - Sites with automatic lang