Build a Jupyter Book
with The Turing Way

Two smiling people, with outstretched arms, stand infront of banner text saying welcome! The text is sorrounded by marks implying lights and fireworks.

Installing Jupyter Book

next.jupyterbook.org/start/install

A QR code linking to the Jupyter Book 2 installation dcumentation.

                        $ pip install "jupyter-book>=2.0.0a0"
                    

                        $ npm install -g "jupyter-book@>=2.0.0-a0"
                    

Jupyter Book

The Jupyter Book logo, formed of text reading jupyter book where the word book is surrounded by braces.
Create documents and knowledge bases that are reusable, reproducible, and interactive.
  • Features for beautiful typesetting, in many domains
  • Builds from MyST Markdown or Jupyter Notebooks

Executable content

  • Jupyter Notebooks
  • code-cell blocks in Markdown
  • Inline statements using eval in Markdown
Screenshot of a Jupyter Notebook session where one cell defines a function for the Fibonacci series

                                        # Title

                                        ```{code-cell} python
                                        hello = "hello"
                                        there = "there"
                                        phrase = f"{hello}, {there}!"
                                        print(phrase)
                                        ```
                                    

                                    # Title

                                    1 + 1 is {eval}`1 + 1`
                                    

Executing

  • At build time
  • Live in a browser

More features!

  • Plugins
  • Cross-book references and embedding
  • Multiple export formats (HTML, pdf, docx, JATS)

Jupyter Book 1

MyST Parser
Sphinx

Jupyter Book 2

mystmd

The Turing Way

Activity

Installation

next.jupyterbook.org/start/install

A QR code linking to the Jupyter Book 2 installation dcumentation.

                        $ pip install "jupyter-book>=2.0.0a0"
                    

                        $ npm install -g "jupyter-book@>=2.0.0-a0"
                    

Jupyter Book Showcase

Highlight 1

Highlight 2

Activity

Initialize a Jupyter Book

freekpols.github.io/JB2_book_template/advanced-start/#initialise-a-project
A QR code linking to …

Activity

Add to your book

Break

☕️

Activity

Add interactivity

Activity

Build a PDF

Reflections

Contributing to Jupyter Books

The Turing Way Community

A group of people work together on a stage labelled our community. Some are tending to plants with symbols representing data and version control. A new community member is being welcomed to the team. Text emphasises working together, sharing knowledge and helping eachother.
Two people hold up a large banner with the word thanks written on it.