[IPython-dev] sphinx documentation for ipython1

Fernando Perez fperez.net at gmail.com
Sun Mar 23 06:49:44 EDT 2008


On Sat, Mar 22, 2008 at 8:41 PM, Ondrej Certik <ondrej at certik.cz> wrote:
> Hi,
>
>  I committed a nice sphinx based documentation to the ipython1-doc
>  branch. You can try it out for example by:
>
>  $ bzr branch http://bazaar.launchpad.net/~ipython/ipython/ipython1-doc
>  $ cd ipython1-doc/docs
>  $ make html
>  $ epiphany _build/html/index.html
>
>  (Use your favourite browser instead of epiphany).

Sweet!  The built-in search (jscript tricks, I presume) is absolutely
phenomenal.  I'm updating the cron job to pull from this so everyone
has access to these docs, we should merge this very soon into the dev
branch.

>  The "make html" will download Sphinx from the net (so you need to have
>  an internet connection) and puts it into the sphinx directory in the
>  current dir. Subsequent invocations of "make html" will reuse it. I
>  suggest you to browse the history of my commits to see what exact
>  changes I had to do in order to make all this work.
>
>  The changes broke the pdf generation - this would have to be fixed,
>  but I suggest to get at least the html documentation right and
>  polished, only then try to fix the pdf generation.
>  Also the Sphinx framework should be able to generate pdf files too.
>
>  Unfortunately it took my almost the whole night to fix all things
>  (it's 4:40am), so I won't be able to help much with ipython on Sunday,
>  as I will have to work on other things. But I'll be available if you
>  need to explain anything regarding my patches.

Thanks so much!  This is great, I hope you can get some rest, and
don't worry for now.  Let me know when you have a minute to look at
the xml2rst business for the other docs, since that would be the
remaining piece missing.

>
>  Enjoy hacking at Gaels,

We certainly are: the hospitality given by him and his parents has
been amazing.  Chalk one to great open source development sponsorship!

Cheers,

f



More information about the IPython-dev mailing list