Notebooks in Sphinx?
Converting the notebooks to ReST with nbconvert, then using sphinx on the .rst files gives a pretty decent effect, except that the title levels are off a little. I need to look into hosting for the notebooks, maybe on MS Azure. In the meantime, I prefer the HTML made by Sphinx to the HTML made by nbconvert directly. It has index and cross refs and the code blocks scroll horizontally which is crucial for wide Joy traces. And Garamond. God bless Garamond. For the Sphinx docs I'm going to edit the notebook ReST files by hand, diverging from the originals.
This commit is contained in:
@@ -6,7 +6,7 @@
|
||||
<head>
|
||||
<meta http-equiv="X-UA-Compatible" content="IE=Edge" />
|
||||
<meta http-equiv="Content-Type" content="text/html; charset=utf-8" />
|
||||
<title>Joy Interpreter — Thun 0.1.0 documentation</title>
|
||||
<title>Joy Interpreter — Thun 0.1.1 documentation</title>
|
||||
<link rel="stylesheet" href="_static/alabaster.css" type="text/css" />
|
||||
<link rel="stylesheet" href="_static/pygments.css" type="text/css" />
|
||||
<script type="text/javascript" src="_static/documentation_options.js"></script>
|
||||
@@ -17,7 +17,7 @@
|
||||
<link rel="index" title="Index" href="genindex.html" />
|
||||
<link rel="search" title="Search" href="search.html" />
|
||||
<link rel="next" title="Stack or Quote or Sequence or List…" href="stack.html" />
|
||||
<link rel="prev" title="Thun 0.1.0 Documentation" href="index.html" />
|
||||
<link rel="prev" title="Thun 0.1.1 Documentation" href="index.html" />
|
||||
|
||||
<link rel="stylesheet" href="_static/custom.css" type="text/css" />
|
||||
|
||||
@@ -96,7 +96,7 @@ executed.</p>
|
||||
<h3>Related Topics</h3>
|
||||
<ul>
|
||||
<li><a href="index.html">Documentation overview</a><ul>
|
||||
<li>Previous: <a href="index.html" title="previous chapter">Thun 0.1.0 Documentation</a></li>
|
||||
<li>Previous: <a href="index.html" title="previous chapter">Thun 0.1.1 Documentation</a></li>
|
||||
<li>Next: <a href="stack.html" title="next chapter">Stack or Quote or Sequence or List…</a></li>
|
||||
</ul></li>
|
||||
</ul>
|
||||
|
||||
Reference in New Issue
Block a user