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.,
Include content in your hub¶
To include content in your hub (e.g., scripts, notebooks, etc) we recommend using
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.
https://<your-hub>.pilot.2i2c.cloudas 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
nbgitpullerlink. 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.