2.3 KiB
Start your book using GitHub template
This page shows you how as an example how to create your own Jupyter Book. It including making an edit to a predefined book and hosting that book online. It doesn't elaborate on the collaborative functionalities of Git.
To get started making your Jupyter Book with our functionalities, fork our template book https://github.com/TeachBooks/template :
Fill in a repository name, this name will be used in the future url of your book:
Set up the build of your website using GitHub pages by selecting under Settings - Pages - Build and deployment - Source - GitHub Actions:
Enable the predefined workflow to publish your book under Actions - I understand my workflows, go ahead an enable them:
Edit a file under Code - book - A file of your choice - Edit in place, in the example below book/intro.md is edited:
Make your edit and Commit changes to main branch:
Wait a few minutes for the website to be deployed, if you're curious, have a look at the progress under Actions - All wokflows:
When the workflow has finished, visit your build book at https://<username>.github.io/<repository_name> (case sensitive). For our example it is: https://dummystudent-Tom.github.io/My_own_book :
It is possible to have multiple versions of a book published at once, by creating another Git branch (e.g. draft or dev).
For each branch, the respective book is published at https://<username>.github.io/<bookname>/<branchname>.
Technical note: for convenience, just .../<bookname>/ redirects to .../<bookname>/book/, which is itself an alias (a symlink) for
.../<bookname>/main/.
To learn more about how we do this, please see the GitHub Actions documentation and our deployment pipeline configuration file .github/workflows/deploy-book-ghpages.yml here.