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 jupyter+unsubscr...@googlegroups.com. To post to this group, send email to jupyter@googlegroups.com. 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.