publishing a jupyter nb

[Alexander Garcia Castro]

Hi. I want to publish jupyter nbs. I dont want to have restrcited access or to proviede editing. I get an nb and I publish it like in a pre print or like in a journal. how can I do this? jupiter hub is not the answer because it is restricted in access and I want it as simple as click and get the nb. with out the user needing to be registered anywhere. 

[William Stein]

Hi,

(1) Get an account on GitHub, create a public repository there, and
upload the ipynb file there. When you click on the ipynb file, it
will be rendered by GitHub (using nbconvert). There are tons of
examples of this here:
https://github.com/jupyter/jupyter/wiki/A-gallery-of-interesting-Jupyter-Notebooks

(2) If (1) isn't quite sufficient... use https://nbviewer.jupyter.org/
in conjunction with some hosting (e.g., github as above).

(3) There's many other possibilities as well, if (1) or (2) isn't
sufficient for your use case. I'm working on one at
https://share.cocalc.com, but it's not as mature as other options yet.

William

On Tue, Jul 9, 2019 at 3:32 PM Alexander Garcia Castro
<alexg...@gmail.com> wrote:
>
> Hi. I want to publish jupyter nbs. I dont want to have restrcited access or to proviede editing. I get an nb and I publish it like in a pre print or like in a journal. how can I do this? jupiter hub is not the answer because it is restricted in access and I want it as simple as click and get the nb. with out the user needing to be registered anywhere.
>

> --
> 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+u...@googlegroups.com.
> To post to this group, send email to jup...@googlegroups.com.
> To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/fad698b0-f668-487b-8d78-b1392ccf77e4%40googlegroups.com.
> For more options, visit https://groups.google.com/d/optout.



--
William (http://wstein.org)

[Tim Head]

Hey,

there is a new project called Voila for which there is a tool called Voila gallery with a nice blog post https://blog.jupyter.org/a-gallery-of-voil%C3%A0-examples-a2ce7ef99130 you can add your notebook to the gallery here (I think): https://github.com/voila-gallery/gallery

Related to that an example of how to deploy your own notebook on Heroku: https://github.com/martinRenou/voila_heroku

T

To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/CACLE5GAWkdpDbXUVbo6RqdAyPMOezDk_HzG38p1uRWha3cLvpQ%40mail.gmail.com.

[Sascha Spors]

Hi,

I also use github for my notebooks. For instance for Open Educational Resources

https://github.com/spatialaudio/signals-and-systems-lecture

https://github.com/spatialaudio/digital-signal-processing-lecture

In order to (more or less) officially publish the notebooks I use the DOI service provided by zenodo.org. If you register the repositorty in zenodo and create a release in github a DOI is automatically generated.

greetings,

Sascha

To view this discussion on the web visit https://groups.google.com/d/msgid/jupyter/CACLE5GAWkdpDbXUVbo6RqdAyPMOezDk_HzG38p1uRWha3cLvpQ%40mail.gmail.com.

[Tony Fast]

There are quite a few solutions because notebooks are so flexible.

A past approach I used was to a single github repo that had the structure of a python project.  This approach makes notebooks publishable on Github, nbviewer (we can post slides here too!), binder, and readthedocs using the nbsphinx extension.  This publishing project tested code in the blog posts and exported a python module with 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 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, usable on colab, viewed with nbviewer, 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(s) in a gist, has a binder and may be viewed on nbviewer.  Other presentation formats can be added when integrated with a repository and continuous integration.