There are quite a few solutions because notebooks are so flexible. A past approach I used was to a single github repo <https://github.com/deathbeds/deathbeds.github.io/> that had the structure of a python project. This approach makes notebooks publishable on Github <https://github.com/deathbeds/deathbeds.github.io/>, nbviewer <https://nbviewer.jupyter.org/github/deathbeds/deathbeds.github.io/tree/master/deathbeds/> (we can post slides here too!), binder, and readthedocs <https://readthedocs.com/> using the nbsphinx extension <https://nbsphinx.readthedocs.io/en/0.4.2/>. This publishing project tested code in the blog posts and exported a python module with importnb <https://github.com/deathbeds/importnb/>.
Clearly all of that is too complicated, and builds took a while. As we accrued too many notebooks in the project this monolithic idea fell over. I've recently landed on the fact that gists <https://gist.github.com> are the easiest way to share and publish notebooks. Authors can drag and drop notebooks into a gist which means NO GIT! Adding an environment or requirements file allows notebooks to work on binder <https://mybinder.org>, usable on cola <https://colab.research.google.com>b, viewed with nbviewer <https://nbviewer.jupyter.org>, and provide a commenting system. Later, gists can be combined as submodules in a repository that manages only the structure of contents, and not the actual contents. For example a notebook <https://gist.github.com/tonyfast/1b6fc686eaa336f36bb8e04837f54ee3>(s) in a gist, has a binder <https://mybinder.org/v2/gist/tonyfast/1b6fc686eaa336f36bb8e04837f54ee3/master> and may be viewed on nbviewer <https://nbviewer.jupyter.org/gist/tonyfast/1b6fc686eaa336f36bb8e04837f54ee3/datashape-typing-system.ipynb>. Other presentation formats can be added when integrated with a repository and continuous integration. -- You received this message because you are subscribed to the Google Groups "Project Jupyter" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. To post to this group, send email to [email protected]. To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/5772c01d-af06-419f-b7df-a87d73f4e5b4%40googlegroups.com. For more options, visit https://groups.google.com/d/optout.
