[IPython-dev] html notebook converter

Fernando Perez fperez.net at gmail.com
Thu Apr 26 01:38:00 EDT 2012

Hi Damian,

On Wed, Apr 25, 2012 at 7:05 PM, Damián Avila <damianavila at gmail.com> wrote:
> I have been reading the notebook converter script posted in github.
> Searching for tools to a better conversion from rst to html, i have
> found a static site generator called Nikola (developed from a guy in my
> country).
> So, I taked some code... I make some changes... and you can see the
> result here: http://damian.staticloud.com

great, thanks for diving into this!  It actually looks very nice,
though I'm curious: why not use sphinx?  While it will be great to
allow people to plug in their own converters, I think that given how
so much of the python world uses sphinx, that would be a good target
to consider.  Additionally, sphinx produces high-quality pdf via
latex, which is another reason why good sphinx support is worthwhile.

When considering this problem, I'd thought that we'd probably offer
out of the box a basic html export using only docutils, and a richer
one using sphinx.  How does that sound to you?

And in any case, though in the end most people really want html/pdf,
having the intermediate rst export available as an explicit target is
always a good idea.  That way, people may decide to only use our
converter for rst and then plug it into the rest of their worfklow.

But in any case, I'm glad to see you looking into this problem and
making good progress!



More information about the IPython-dev mailing list