nbss-upload
Upload notebooks (Jupyter, Rmd, etc) to a NotebookSharing.space instance.
Installation
nbss-upload
is available on PyPI, and can be installed with pip
.
pip install nbss-upload
Usage
Simply call it with the path to the notebook you want to upload.
$ nbss-upload test.ipynb
https://notebooksharing.space/view/04ab7ab45c2f08628eba9cb8fe5fb9a63f5961d5dfce622b9e26974ddc138916
This will upload the notebook and return the URL you can use to share it with others.
By default, only users who you share the URL with can access the notebook - it will not be visible to search engines. Annotations will also be turned off by default to help fight abuse.
You can enable annotations via hypothes.is
by passing --enable-annotations
or -a
.
The notebook can be made discoverable to search engines by passing --enable-discvery
or -d
.
All notebook formats supported by notebooksharing.space - .ipynb
, .rmd
, .html
are supported.
Uploading from inside a Jupyter Notebook
You can add a cell to your Jupyter Notebook that calls nbss-upload
, and each
time you execute the cell (after saving your notebook), it will be uploaded and the
URL printed.
!nbss-upload <name-of-notebook>