Create content for your Hub

Write public books that connect to a 2i2c Hub

You can create public content that is designed to have connections with your 2i2c Hub. For example, you can create lectures from Jupyter Notebooks, and allow students to grab their own copy of the notebook to interact with on the 2i2c Hub.

To connect your public content with a 2i2c Hub, we recommend using Jupyter Book. This is an open-source project that allows you to share collections of notebooks and markdown files as an online website and book. Check out the Jupyter Book getting started guide for more information about Jupyter Book.

You can tell Jupyter Book to place links directly to your 2i2c Hub on each page that is served from a notebook. To do so, follow the launch buttons for JupyterHubs instructions. Make sure that you configure your jupyterhub_url to point to the URL of your 2i2c Hub (e.g., https://<your-hub>.pilot.2i2c.cloud).

Include content in your hub

To include content in your hub (e.g., scripts, notebooks, etc) we recommend using nbgitpuller.

You can use nbgitpuller to generate a link to a public repository, or a file in that repository. When a user clicks that link, a copy of the link’s target will be automatically placed in the user’s home directory, and they will be directed to that content in the JupyterHub (if they are logged in).

  • Generate an nbgitpuller link by going to nbgitpuller.link. You’ll be asked to provide some information about the content you wish to share, and can copy the link when you are done.

    • Use https://<your-hub>.pilot.2i2c.cloud as your JupyterHub address

    • Fill in the GitHub repository where your content exists (along with an optional file path or branch name)

    • The link will be in the field just above your form.

  • Share this link with your users. Anybody can click an nbgitpuller link. If they have an account on the hub to which it points, then they’ll get a copy of the content that you’ve linked to.

Double-check your hub URL

Make sure that the hub URL you insert into the nbgitpuller form is correct! See Where are hubs accessed? for more information.

Go to nbgitpuller.link

../_images/nbgitpuller-ui.png

The nbgitpuller.link user interface, along with some important fields highlighted.