Create an online book with Jupyter Notebooks and Jekyll
Clone or download
Pull request Compare This branch is 19 commits behind jupyter:master.
Latest commit 8d5e61b Jan 10, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci updating circle build to use raw HTML an deploy to jupyter-book.githu… Jan 4, 2019
_bibliography adding citations builder Dec 19, 2018
_build updating interact link instructions Jan 9, 2019
_data updating code collapsing blocks to be more configurable and simpler Jan 9, 2019
_includes sidebar logo link Jan 10, 2019
_layouts adding collapsible code blocks Jan 6, 2019
_sass improve codemirror syntax highlighting Jan 10, 2019
assets updating code collapsing blocks to be more configurable and simpler Jan 9, 2019
content improve codemirror syntax highlighting Jan 10, 2019
scripts Merge pull request jupyter#59 from choldgraf/collapsible_code Jan 9, 2019
.gitignore updating circle build to use raw HTML an deploy to jupyter-book.githu… Jan 4, 2019
CHANGELOG.md adding changelog Jan 6, 2019
Gemfile adding citations builder Dec 19, 2018
Gemfile.lock updating circle build to use raw HTML an deploy to jupyter-book.githu… Jan 4, 2019
Guardfile adding new build system Oct 23, 2018
LICENSE adding new build system Oct 23, 2018
Makefile updating circle build to use raw HTML an deploy to jupyter-book.githu… Jan 4, 2019
README.md first juniper attempt Dec 30, 2018
_config.yml sidebar logo link Jan 10, 2019
build-environment.yml updating install instructions to use conda Nov 30, 2018
build-requirements.txt updating install instructions to use conda Nov 30, 2018
requirements.txt updating requirements for binder Dec 29, 2018

README.md

Jupyter Book

CircleCI

This is a guide and template for hosting your own book 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:

Explore this book

This website is an example of a Jupyter Book. You can explore the chapters of the book by clicking on links in the sidebar to the left. Or, you can move linearly forward and backwards by clicking the left/right arrow on your computer.

Contribute or improve the book

Notice some inefficient CSS? A typo in the text? Want to add a cool feature so that others can enjoy the improvements to Jupyter Books? Don't hesitate to open an issue or a PR on the Jupyter Book template repo. We'd love your help!

Acknowledgements

Jupyter Books was originally created by Sam Lau and Chris Holdgraf with support of the UC Berkeley Data Science Education Program and the Berkeley Institute for Data Science.