Skip to main content
Ctrl+K

Manual

Your First TeachBook!

  • What is a TeachBook?
  • How can you do it?
  • It only takes 10 clicks!
  • You Know the Basics: What Next?

Getting Going!

  • User types
  • Collaboration tool: Git
    • Which git provider to choose
  • Install & authenticate required software
    • Editing text: VS Code
    • Git: GitHub Desktop / Git in VS Code
    • Managing code-related software: Anaconda
    • Combining Git Bash, VS Code and Conda
    • Build your book: JupyterBook
  • Collaborative book-editing
    • Assign task to yourself (milestones, issues)
    • Create your own version (branching, cloning, pulling)
    • Edit (merge conflicts, staging, committing, pushing)
    • Check changes online
    • Reviewing and combine versions (merge/pull request, merging)
  • Organize editing team, collaboration and visibility
  • Versioning and URLs
    • Publish version on separate (fixed) URLs
    • TeachBooks versioning with changelog
    • Publishing your book with a publisher
  • Copyright and Licenses checklist
    • Copyright Considerations
    • Licenses
    • Recommendations

Features

  • Overview
    • TeachBooks Python Package
    • Deploy Book workflow
    • TeachBooks Favourites
    • TeachBook Template
  • Easy Editing Process
    • Write book fully in GitHub interface
    • Share book online for multiple versions
    • Draft-Release Workflow
    • Build pull requests from forks
    • Local Server to view interactive elements locally
    • Sharing content between books in table of contents
      • (Deprecated) Share content between books using submodules
    • Auto-updating packages
    • TeachBooks Versioning
  • Additional functionality
    • Download link replacer
    • Multilingual book
    • Discussions in your book: Utterances
    • H5p interactive elements
      • Examples of H5p Quizzes
    • Interactive plots: plotly
    • Grasple
    • Interactive HTML/JavaScript elements
      • Adding interactive HTML/JavaScript elements
      • Creating basic interactive HTML/JavaScript elements
    • Interactive content: Run Python inside your book
      • Ipywidgets
      • Exercise checking using check-answer button
    • JupyterQuiz
    • Iframes
    • Indexed Definitions
    • PRIME applets
    • Examples with executable code and visuals
    • Sphinx proof
    • NoteBook Execution Patterns
    • Sphinx exercise
    • Interactive graph of book content
  • Book styling
    • Adding accessibility features
    • Image and iframe dark mode colour inverter
    • JupyterBook-Patches
    • TU Delft theme
    • Rich hover over tips
    • APA References
    • Custom named colors
    • Dropdown Toggle
  • TeachBooks Student-view Features
    • Local Annotator Extension
    • Making comments on the website: Hypothesis

Original Jupyter Book v1 and Sphinx Features

  • Overview
    • Anatomy of a TeachBook
    • Figures
    • Equations
    • Videos
    • References
    • Code
    • Code blocks that produce figures
    • Badges, Buttons & Icons
    • Banner or Announcement

Examples

  • Overview
    • Well-Structured Book
    • Live Code (Sphinx Thebe)
    • Programming assignment with checks
    • Combining theory & interactive quizzes
    • Theory, interactive quizzes & live code
    • Coding theory, interactive quizzes & live code
    • Parametric questions

Editing Tools

  • Figure syntax maker
  • Scripts for automating workflow
    • Convert LaTeX to Markdown
    • Move images to separate hosting
    • Snippit
    • Extensionchecker, filedownloader and figreturner
    • Figshrinker

Miscellaneous

  • References
  • Credits and License
  • Changelog
  • Contact
  • Repository
  • Open issue

Index

T

T

  • Truss structures

By TeachBooks Development Team and TeachBooks users, built with TeachBooks, CC BY 4.0

Last updated on November 10, 2025.