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
  • 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
  • Choose URLs and tools
  • Copyright and Licenses checklist
    • Copyright Considerations
    • Licenses
    • Recommendations

Features

  • Overview
  • Original Jupyter Book and Sphinx Features
    • Anatomy of a Jupyter Book
    • Figures
    • Equations
    • Videos
    • References
    • Code
    • Code blocks that produce figures
    • Badges, Buttons & Icons
    • Banner or Announcement
  • Easy Editing Process
    • TeachBooks template
    • Pre- and postprocessing book
    • Releasing book online
    • Local Server to view interactive elements locally
    • Sharing content between books
    • Auto-updating packages
  • Additional functionality
    • Download link replacer
    • Multilingual book
    • Discussions in your book: Utterances
    • Interactive content: Elements not including Python
      • Grasple
      • Adding interactive h5p elements
      • 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
  • Book styling
    • Image Inverter
    • JupyterBook-Patches
    • TU Delft theme
    • Rich hover over tips
    • APA References
    • Custom named colors
  • TeachBooks Student-view Features
    • Local Annotator Extension
    • Making comments on the website: Hypothesis

Examples

  • TeachBooks Examples
  • Well-Structured Book
  • Types of H5p Quizzes
  • Live Code (Sphinx Thebe)
  • Programming assignment
  • 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
    • Snippit
    • Extensionchecker, filedownloader and figreturner
    • Figshrinker

Miscallaneous

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

Index

T

T

  • Truss structures

By TeachBooks Team, built with TeachBooks and Jupyter Book, CC BY 4.0

Last updated on January 17, 2025.