astrosyverthe/rcsc18

The website for the 2018 Research Computing Summer School

Textbooks with Jupyter and Jekyll

This repository / website is a template for hosting your own textbook using Jupyter Notebooks and Jekyll.

Here are some highlights:

• All course content is written in markdown and Jupyter Notebooks, stored in notebooks/
• This site comes packaged with helper scripts to convert these into Jekyll pages (in scripts/)
• Pages can have Binder or JupyterHub links automatically added for interactivity.
• The website itself is based on Jekyll, and is highly extensible and can be freely-hosted on GitHub.

This repository comes with some sample textbook files from the Data 8 course for Data Science at UC Berkeley. You can update these materials and all site content with your own, and have a Jupyter-based textbook ready to go shortly!

Here are a few links of interest:

• A demo of the hosted textbook
• A short guide to deploying your own textbook
• The markdown version of the guide in this repo