[IPython-dev] notebooks embedded in sphinx

Damián Avila damianavila at gmail.com
Mon Sep 24 23:09:28 EDT 2012

El 24/09/12 22:36, Jake Vanderplas escribió:
> Hi all,
> I've been thinking about the best way to embed notebooks in sphinx
> documentation using nbconvert. I've opened an initial PR at
> http://github.com/ipython/nbconvert/pull/35/
> The current version is a simple sphinx extension based on the raw html
> directive, but results in non-standard html that may not work in some
> browsers (i.e., style tags outside the html header).
> I'm still not sure the best way to progress, but I'd appreciate any
> feedback or ideas.
> Thanks!
>      Jake
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev

Hi Jake,

I have been playing with nbconvert to embed the static html of the 
notebook into a static site generator (nikola).
I have also used the raw:: html directive and the css styling provided 
by the html-header from nbconvert.
I have also modified the template html provided by nikola.
I am testing some other things, but you can see an example here: 
Maybe, as you suggest in the github discussion, you could write a 
template in Sphinx to embed correctly the notebook.



-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20120925/d6591c15/attachment.html>

More information about the IPython-dev mailing list