Files
TinyTorch/docs/_config.yml
2025-11-28 14:59:51 +01:00

105 lines
2.7 KiB
YAML

# TinyTorch: Build ML Systems from Scratch
# Interactive Jupyter Book Configuration
# Branding: Use stylized "Tiny🔥Torch" for public-facing site branding
# This matches the branding convention for memorable, personality-driven presentation
title: "Tiny🔥Torch"
author: "Prof. Vijay Janapa Reddi (Harvard University)"
copyright: "2025"
# Logo: Updated to use standard logo (replaces white version for better visibility)
logo: _static/logos/logo-tinytorch.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
# Exclude patterns - don't scan these directories/files
exclude_patterns:
- _build
- .venv
- appendices
- "**/.venv/**"
- "**/__pycache__/**"
- "**/.DS_Store"
- "modules/**/*.md"
- "!modules/*_ABOUT.md"
# GitHub repository configuration for GitHub Pages
repository:
url: https://github.com/mlsysbook/TinyTorch
path_to_book: docs
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
# Custom JavaScript
extra_js:
- _static/wip-banner.js
- _static/ml-timeline.js
- _static/hero-carousel.js
- _static/sidebar-link.js
- _static/marimo-badges.js
# Favicon configuration
favicon: "_static/favicon.svg"
# 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"
# Sidebar collapsible sections configuration
html_theme_options:
show_navbar_depth: 1 # Initial expanded depth (1 = top-level only)
collapse_navigation: false # Allow navigation to be collapsible
navigation_depth: 4 # Maximum depth for navigation tree
# 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