[IPython-dev] notebooks embedded in sphinx
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
> 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.
> IPython-dev mailing list
> IPython-dev at scipy.org
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...
More information about the IPython-dev