[IPython-dev] Using sphinx to evaluate notebook cells?

Anthony Scopatz scopatz at gmail.com
Tue Oct 29 15:19:35 EDT 2013

Thanks for the improvement suggestions Matthias.  Including the ipython.css
is a good idea and would hopefully allow us to remove that replace hacks
that are in their now.  More suggestions are definitely appreciated.

Thanks for bring this up again Nathan.

Be Well
Anthony

On Tue, Oct 29, 2013 at 12:47 PM, Matthias Bussonnier <
bussonniermatthias at gmail.com> wrote:

> Gave to see, but once you use basic, you should be able to "just" include
> mathjax and Ipython.css in all the pages.
>
> You can even pass custom templates to the html exporter.
>
> Will have a look and open PRs when more time.
>
> Envoyé de mon iPhone
>
> Le 29 oct. 2013 à 18:17, Nathan Goldbaum <nathan12343 at gmail.com> a écrit :
>
> Hi Matthias,
>
> Thanks for the suggestion.  I did try the ‘basic’ HTML template but found
> that it gave, well, basic results.  I guess I want *part* of the notebook
> CSS but not all of it so the notebook cells appear like notebook cells in
> the document. Likely there’s a better way to do that.
>
> -Nathan
>
> On October 29, 2013 at 4:05:35 AM, Matthias Bussonnier (
> bussonniermatthias at gmail.com <//bussonniermatthias at gmail.com>) wrote:
>
>  Will comment more later:
>
> Yes interested, a lot. Don't use HTML full, use 'basic' it will give you
> only the inner body.
>
> We have 2 CSS one of which should not conflict. Feedback welcomed.
>
> Envoyé de mon iPhone
>
> Le 29 oct. 2013 à 11:16, Nathan Goldbaum <nathan12343 at gmail.com> a écrit :
>
>  Quick update on this.  I managed to create the notebook extension I was
> asking about in my initial message to the list. I did end up using runipy,
> as Matthias suggested.
>
> Much of hard work for the extension was originally done by Anthony
> Scopatz, who wrote a similar notebook sphinx plugin for pyne (
> http://pynesim.org/) based on evaluated notebooks.
>
> Using Anthony's extension, I generalized it to evaluate and embed the
> notebook in our docs. As a proof-of-concept, I transferred the yt bootcamp,
> which we had displayed in the past using static nbviewer links, to use the
> new notebook directive.
>
> The result is here: http://ngoldbaum.net/docs_build/bootcamp/index.html
>
> If you're interested in the details of how this works, the code for the
> plugin is here<https://bitbucket.org/ngoldbaum/yt-doc/src/tip/extensions/notebook_sphinxext.py>.
> One issue is that I had to monkeypatch the CSS I got back from nbconvert to
> avoid mangling our docs theme.
>
> I've also created a similar notebook-cell extension that transforms
> inline .rst code snippets into evaluated notebook cells in the docs build.
>
> For now these extensions are part of the yt documentation, but if there's
> interest I'll happily package up the extensions and do a standalone release
> for them.
>
> -Nathan
>
> On October 23, 2013 at 1:13:08 AM, Matthias Bussonnier (
> bussonniermatthias at gmail.com) wrote:
>
> Hi
>
> I'm not aware of such a plugin. Definitively interested as we want our doc
> as notebook in IPython too.
>
> Have a look at runipy (Google is your friend, and is on pypi iirc). It
> runs notebook headless and generate static HTML from that. Having a
> nbconvert preprocessor that run notebook would also be great!
> (Sorry no direct link, from my phone)
>
> M
>
> Envoyé de mon iPhone
>
> Le 23 oct. 2013 à 02:41, Nathan Goldbaum nathan12343 at gmail.com a écrit :
>
> Hi all,
>
> Myself and some of the other yt devs are thinking about ways to improve
> cookbook section of our documentation by replacing the scripts we currently
> host with notebooks.
>
> Since some of our cookbook recipes store plots, we'd like to track these
> notebooks in version control in an unevaluated state, mainly to avoid
> versioning images. We have a CI server that already builds our cookbook
> recipes for our dev docs, so something that integrates with sphinx seems to
> be the way to go. I think I could write a sphinx plugin that does the job,
> but it would need to use whatever machinery IPython uses when notebook
> cells get evaluated.
>
> Does anyone know if such a plugin is available somewhere? If not, does
> anyone know where I should look in the IPython codebase for when I try to
> write it myself?
>
>
> -Nathan
> ------------------------------
>
> IPython-dev mailing list IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
>
> ------------------------------
>
> IPython-dev mailing list IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
>
>
> _______________________________________________
> IPython-dev mailing list
> IPython-dev at scipy.org
> http://mail.scipy.org/mailman/listinfo/ipython-dev
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://mail.python.org/pipermail/ipython-dev/attachments/20131029/2d78e73e/attachment.html>