Publishing Online Books using Jupyter Book and GitHub Pages

Dr. Soumen Atta, Ph.D.
6 min readApr 1, 2021
Publishing Online Books using Jupyter Book and GitHub Pages

In this beginner-friendly tutorial, we will learn how to publish online books using Jupyter Book and GitHub Pages. In this tutorial, everything will be discussed in detail. Although you don’t need any pre-requisites as such to follow this tutorial, it is better if you have previous knowledge of markdown syntax and Git commands.

At the end of this tutorial, you will be ready to publish your online book hosted by GitHub. One of the significant benefits of using Jupyter Book and GitHub Pages is that you can easily update the book’s contents at any time. You can also make use of the version control feature of Git. A demo book created using the method discussed in this tutorial is available at this link.

Here, I am assuming that Python 3, Jupyter Notebook, and Git are installed on your system. This tutorial consists of three major parts. In the beginning, we will see how to create the contents of the book. Then we will learn how to create a book from these contents using Jupyter Book. In the end, we will discuss the (free) hosting of this book using GitHub Pages.

--

--

Dr. Soumen Atta, Ph.D.

I am a Postdoctoral Researcher at the Faculty of IT, University of Jyväskylä, Finland. You can find more about me on my homepage: https://www.soumenatta.com/