OSDN Git Service

Notebooks in Sphinx?
authorSimon Forman <sforman@hushmail.com>
Thu, 26 Apr 2018 14:00:36 +0000 (07:00 -0700)
committerSimon Forman <sforman@hushmail.com>
Thu, 26 Apr 2018 14:00:36 +0000 (07:00 -0700)
commit327548d7154607a3ee1d2295cb695b3dd27c1109
tree19723ede28843d7461698977b0f8f73e5cf77797
parentaac5a42cabce59818e54da1bf855750624b8cb43
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.
38 files changed:
docs/sphinx_docs/_build/html/_modules/index.html
docs/sphinx_docs/_build/html/_modules/joy/joy.html
docs/sphinx_docs/_build/html/_modules/joy/library.html
docs/sphinx_docs/_build/html/_modules/joy/parser.html
docs/sphinx_docs/_build/html/_modules/joy/utils/pretty_print.html
docs/sphinx_docs/_build/html/_modules/joy/utils/stack.html
docs/sphinx_docs/_build/html/_sources/index.rst.txt
docs/sphinx_docs/_build/html/_static/documentation_options.js
docs/sphinx_docs/_build/html/genindex.html
docs/sphinx_docs/_build/html/index.html
docs/sphinx_docs/_build/html/joy.html
docs/sphinx_docs/_build/html/lib.html
docs/sphinx_docs/_build/html/library.html
docs/sphinx_docs/_build/html/objects.inv
docs/sphinx_docs/_build/html/parser.html
docs/sphinx_docs/_build/html/pretty.html
docs/sphinx_docs/_build/html/py-modindex.html
docs/sphinx_docs/_build/html/search.html
docs/sphinx_docs/_build/html/searchindex.js
docs/sphinx_docs/_build/html/stack.html
docs/sphinx_docs/notebooks/0. This Implementation of Joy in Python.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/1. Basic Use of Joy in a Notebook.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/2. Library Examples.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/3. Developing a Program.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/4. Replacing Functions in the Dictionary.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Advent of Code 2017 December 1st.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Advent of Code 2017 December 2nd.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Advent of Code 2017 December 3rd.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Advent of Code 2017 December 4th.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Advent of Code 2017 December 5th.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Advent of Code 2017 December 6th.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Generator Programs.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Hylo-, Ana-, Cata-, and Para-morphisms - Recursion Combinators.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Newton-Raphson.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Quadratic.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Trees.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/Zipper.rst [new file with mode: 0644]
docs/sphinx_docs/notebooks/index.rst [new file with mode: 0644]