Skip to content

A tutorial for Jupyter Book 2 beginners. Introducing attendees to Jupyter Book, MyST and The Turing Way. By the end of the workshop, attendees will be able to build beautiful and interactive documents

License

Notifications You must be signed in to change notification settings

the-turing-way/Build-a-Jupyter-Book-with-The-Turing-Way

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Presentation Template

Creative Commons License
This work is licensed under a Creative Commons Attribution 4.0 International License.

Presented at JupyterCon 2025

Abstract

The Turing Way is a community-led and open source resource for reproducible, collaborative, and inclusive data science. Co-created by over 500 contributors on GitHub, The Turing Way enables people to collaboratively share their skills and ideas around best practices for machine learning and artificial intelligence.

The Turing Way is built using Jupyter Book 2. Powered by the MyST Document Engine, Jupyter Books are beautiful, interactive documents which promote reproducibility and reusability. They may be compiled from Jupyter Notebooks or Markdown documents, and can be served as websites or exported as static files.

This tutorial is aimed at beginners with Jupyter Book 2. By the end, attendees will have built a working Jupyter Book that they can take away to develop further in their own projects. We will demonstrate powerful features, including executable content, nested tooltips, and cross-book references. The workshop will showcase how communities like The Turing Way use these next-generation capabilities to inspire researchers, educators, and data practitioners to communicate their findings transparently across a global interconnected ecosystem. And to have fun in the process!

Usage

  • Create a repository using this template
  • Clone your new repository including it's submodules (git clone --recurse-submodules <repository>)
  • Configure your repository to source GitHub Pages from GitHub Actions

You can view the presentation,

  1. Locally by opening index.html
  2. In the GitHub pages site of your repository (built from the main branch)

Edit index.html to modify your presentation. Read the reveal.js documentation for syntax and how-to guides.

Use this README to display the abstract, DOI and other supporting information.

About

A tutorial for Jupyter Book 2 beginners. Introducing attendees to Jupyter Book, MyST and The Turing Way. By the end of the workshop, attendees will be able to build beautiful and interactive documents

Resources

License

Stars

Watchers

Forks

Languages