shoebot / toybot-scenegraph

Experimental scenegraph renderer for bot languages
0 stars 1 forks source link

Use Jupytext so that notebooks can be versioned easily. #10

Open stuaxo opened 4 years ago

stuaxo commented 4 years ago

See PR for details and TODO: https://github.com/shoebot/toybot-scenegraph/pull/13

https://towardsdatascience.com/diff-your-notebook-as-you-want-jupytext-e5df4db682f7

Notebook json isn't great fun to version, it would be better to store a .py .md using jupytext.

We may want to publish (unversioned) notebooks as part of the build process.

stuaxo commented 4 years ago

During setup, add output formats to ipynb notebook $ jupytext --set-formats ipynb,md --sync "notebooks/Building Toybot.ipynb"

Example to generate ipynb from .md notebook $ jupytext --sync "notebooks/Building Toybot.md"