<div dir="ltr">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.<div>

<br></div><div>Thanks for bring this up again Nathan.</div><div><br></div><div>Be Well</div><div>Anthony</div></div><div class="gmail_extra"><br><br><div class="gmail_quote">On Tue, Oct 29, 2013 at 12:47 PM, Matthias Bussonnier <span dir="ltr"><<a href="mailto:bussonniermatthias@gmail.com" target="_blank">bussonniermatthias@gmail.com</a>></span> wrote:<br>

<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="auto"><div>Gave to see, but once you use basic, you should be able to "just" include mathjax and Ipython.css in all the pages. </div>

<div><br></div><div>You can even pass custom templates to the html exporter.</div><div><br></div><div>Will have a look and open PRs when more time.<br><br>Envoyé de mon iPhone</div><div><br>Le 29 oct. 2013 à 18:17, Nathan Goldbaum <<a href="mailto:nathan12343@gmail.com" target="_blank">nathan12343@gmail.com</a>> a écrit :<br>

<br></div><div><div class="h5"><blockquote type="cite"><div><div style="font-family:Helvetica,Arial;font-size:13px;color:rgba(0,0,0,1.0);margin:0px;line-height:auto">Hi Matthias,</div><div style="font-family:Helvetica,Arial;font-size:13px;color:rgba(0,0,0,1.0);margin:0px;line-height:auto">

<br></div><div style="font-family:Helvetica,Arial;font-size:13px;color:rgba(0,0,0,1.0);margin:0px;line-height:auto">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.</div>

<div style="font-family:Helvetica,Arial;font-size:13px;color:rgba(0,0,0,1.0);margin:0px;line-height:auto"><br></div><div style="font-family:Helvetica,Arial;font-size:13px;color:rgba(0,0,0,1.0);margin:0px;line-height:auto">

-Nathan</div> <div></div> <br><p style="color:#a0a0a8">On October 29, 2013 at 4:05:35 AM, Matthias Bussonnier (<a href="mailto://bussonniermatthias@gmail.com" target="_blank">bussonniermatthias@gmail.com</a>) wrote:</p> <blockquote type="cite">

<span><div dir="auto"><div>







<div>Will comment more later:</div>
<div><br></div>
<div>Yes interested, a lot. Don't use HTML full, use 'basic' it
will give you only the inner body. </div>
<div><br></div>
<div>We have 2 CSS one of which should not conflict. Feedback
welcomed.<br>
<br>
Envoyé de mon iPhone</div>
<div><br>
Le 29 oct. 2013 à 11:16, Nathan Goldbaum <<a href="mailto:nathan12343@gmail.com" target="_blank">nathan12343@gmail.com</a>> a
écrit :<br>
<br></div>
<blockquote type="cite">
<div>
<p>Quick update on this.  I managed to create the
<code>notebook</code> extension I was asking about in my initial
message to the list. I did end up using <code>runipy</code>, as
Matthias suggested.</p>
<p>Much of hard work for the extension was originally done by
Anthony Scopatz, who wrote a similar notebook sphinx plugin for
<code>pyne</code> (<a href="http://pynesim.org/" target="_blank">http://pynesim.org/</a>) based on evaluated
notebooks.</p>
<p>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 <code>notebook</code>
directive.</p>
<p>The result is here: <a href="http://ngoldbaum.net/docs_build/bootcamp/index.html" target="_blank">http://ngoldbaum.net/docs_build/bootcamp/index.html</a></p>
<p>If you're interested in the details of how this works, the code
for the plugin is <a href="https://bitbucket.org/ngoldbaum/yt-doc/src/tip/extensions/notebook_sphinxext.py" target="_blank">
here</a>. One issue is that I had to monkeypatch the CSS I got back
from nbconvert to avoid mangling our docs theme.</p>
<p>I've also created a similar <code>notebook-cell</code> extension
that transforms inline .rst code snippets into evaluated notebook
cells in the docs build.</p>
<p>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.</p>
<p>-Nathan</p>
<p>On October 23, 2013 at 1:13:08 AM, Matthias Bussonnier (<a href="mailto:bussonniermatthias@gmail.com" target="_blank">bussonniermatthias@gmail.com</a>)
wrote:</p>
<p>Hi</p>
<p>I'm not aware of such a plugin. Definitively interested as we
want our doc as notebook in IPython too.</p>
<p>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!</p>
<h2>(Sorry no direct link, from
my phone)</h2>
<p>M</p>
<p>Envoyé de mon iPhone</p>
<blockquote>
<p>Le 23 oct. 2013 à 02:41, Nathan Goldbaum <a href="mailto:nathan12343@gmail.com" target="_blank">nathan12343@gmail.com</a> a écrit
:</p>
<p>Hi all,</p>
<p>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.</p>
<p>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.</p>
<p>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?</p>
<p>Thanks for your help,</p>
<p>-Nathan</p>
<hr>
<p>IPython-dev mailing list <a href="mailto:IPython-dev@scipy.org" target="_blank">IPython-dev@scipy.org</a> <a href="http://mail.scipy.org/mailman/listinfo/ipython-dev" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-dev</a></p>


</blockquote>
<hr>
<p>IPython-dev mailing list <a href="mailto:IPython-dev@scipy.org" target="_blank">IPython-dev@scipy.org</a> <a href="http://mail.scipy.org/mailman/listinfo/ipython-dev" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-dev</a></p>


</div>
</blockquote>


</div></div></span></blockquote></div></blockquote></div></div></div><br>_______________________________________________<br>
IPython-dev mailing list<br>
<a href="mailto:IPython-dev@scipy.org">IPython-dev@scipy.org</a><br>
<a href="http://mail.scipy.org/mailman/listinfo/ipython-dev" target="_blank">http://mail.scipy.org/mailman/listinfo/ipython-dev</a><br>
<br></blockquote></div><br></div>