[IPython-dev] notebooks embedded in sphinx

[Jake Vanderplas]

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