This is a short overview of the major components and steps in building a Jupyter Book. See the other pages in this guide for more in-depth information.
Install Jupyter Book#
You can install Jupyter Book via
pip install -U jupyter-book
conda install -c conda-forge jupyter-book
This will install everything you need to build a Jupyter Book locally.
The Jupyter Book command-line interface#
Jupyter Book uses a command-line interface to perform a variety of actions. For example, building and cleaning books. You can run the following command to see what options are at your control:
Usage: jupyter-book [OPTIONS] COMMAND [ARGS]...
Build and manage books with Jupyter.
--version Show the version and exit.
-h, --help Show this message and exit.
build Convert your book's or page's content to HTML or a PDF.
clean Empty the _build directory except jupyter_cache.
config Inspect your _config.yml file.
create Create a Jupyter Book template that you can customize.
myst Manipulate MyST markdown files.
toc Command-line for sphinx-external-toc.
For more complete information about the CLI, see Command-line interface reference.
The book building process#
Building a Jupyter Book broadly consists of these steps:
Create your book’s content. You structure your book with a collection of folders, files, and configuration. See Anatomy of a Jupyter Book.
Build your book. Using Jupyter Book’s command-line interface you can convert your pages into either an HTML or a PDF book. See Build your book.
Publish your book online. Once your book is built, you can share it with others. Most common is to build HTML, and host it as a public website. See Publish your book online.
We will use the word “book” to describe the outputs generated by this tutorial, but you can also use Jupyter Book to build articles. See Structure of an Article for more information.
Now that we’ve got a short overview, let’s get started building your first book.