# TinyTorch: Build ML Systems from Scratch
# Interactive Jupyter Book Configuration

title: "TinyTorch"
author: "Prof. Vijay Janapa Reddi (Harvard University)"
copyright: "2025"
logo: logo.png

# Book description and metadata
description: >-
  An interactive course for building machine learning systems from the ground up.
  Learn by implementing your own PyTorch-style framework with hands-on coding,
  real datasets, and production-ready practices.

# Execution settings for interactive notebooks  
execute:
  execute_notebooks: "cache"
  allow_errors: true
  timeout: 300

# GitHub repository configuration for GitHub Pages
repository:
  url: https://github.com/mlsysbook/TinyTorch
  path_to_book: book
  branch: main

# HTML output configuration
html:
  use_issues_button: true
  use_repository_button: true
  use_edit_page_button: true
  use_download_button: true
  use_fullscreen_button: true
  
  # Custom styling
  extra_css:
    - _static/custom.css
  
  # Binder integration for executable notebooks
  launch_buttons:
    binderhub_url: "https://mybinder.org"
    colab_url: "https://colab.research.google.com"

# LaTeX/PDF output
latex:
  latex_documents:
    targetname: tinytorch-course.tex

# Bibliography support
bibtex_bibfiles:
  - references.bib

# Sphinx extensions for enhanced functionality  
sphinx:
  extra_extensions:
    - sphinxcontrib.mermaid
  config:
    mermaid_version: "10.6.1"

# Parse configuration for MyST Markdown
parse:
  myst_enable_extensions:
    - "colon_fence"
    - "deflist" 
    - "html_admonition"
    - "html_image"
    - "linkify"
    - "replacements"
    - "smartquotes"
    - "substitution"
    - "tasklist"

# Advanced options
only_build_toc_files: true