Commit Graph

11 Commits

Author SHA1 Message Date
Vijay Janapa Reddi
e7f9223680 feat(site): convert all 20 ABOUT.md files to MyST notebooks with computed values
Replace hardcoded numerical values across all module ABOUT.md files with
Python-computed values using myst_nb glue() references. Each file is now a
MyST Markdown Notebook that executes inline code cells to compute memory
sizes, FLOPs, compression ratios, and other quantitative values.

Key changes:
- Add file_format: mystnb frontmatter and code-cell blocks to all 20 files
- All arithmetic (memory calculations, speedups, ratios) now computed inline
- Fix multiple arithmetic errors discovered during conversion
- Enable execute_notebooks: "cache" in PDF config for glue resolution
- Fix jupyter-book version constraint in Makefile
2026-02-17 18:11:31 -05:00
Vijay Janapa Reddi
2b27429892 fix(site): PDF build improvements and community section
- Add npx pre-flight check for Mermaid CLI in PDF build
- Configure mermaid_cmd to use npx (no global install needed)
- Add Unicode box-drawing fallbacks for LaTeX
- Add Community section to PDF table of contents
2026-02-17 13:53:18 -05:00
Vijay Janapa Reddi
24070e2c7c fix: sync PDF build between Makefile and CI workflow
- Add missing --toc _toc_pdf.yml flag to CI workflow
- Simplify Makefile pdf target to match CI workflow structure
- Remove redundant subsection heading in preface
- Remove bold formatting from GPT model in table
2025-12-14 15:50:14 -05:00
Vijay Janapa Reddi
e5b99e43b7 fix(pdf): add --toc flag to use correct PDF table of contents 2025-12-14 11:04:18 -05:00
Vijay Janapa Reddi
7af42694fb refactor: consolidate ABOUT.md files using symlinks
- Replace site/modules/*_ABOUT.md files with symlinks to src/*/ABOUT.md
- src/ is now the single source of truth for module documentation
- Sync cleaned-up versions (emoji removal) from site/ back to src/
- Remove sync target from Makefile since symlinks handle everything
- Jupyter Book works with symlinks, no build changes needed
2025-12-12 16:43:16 -05:00
Vijay Janapa Reddi
401d7faa18 Adds Tito mascot to the welcome page
Enhances the welcome page with the Tito mascot to improve visual appeal and branding.

Removes outdated author and copyright information from the configuration file.

Simplifies the prerequisites section in the preface, focusing on explaining concepts rather than requiring prior knowledge.
2025-12-11 15:10:58 -08:00
Vijay Janapa Reddi
980c6b2225 feat(tinytorch): add PDF downloads with 'From Tensors to Systems' subtitle
- Add download links for Guide and Paper PDFs to top navigation bar
- Create manual GitHub Actions workflow for PDF builds (tinytorch-build-pdfs.yml)
- Update title page with 'From Tensors to Systems' in companion box
- Add make targets: paper, downloads
- Include built PDFs in _static/downloads/ for website deployment
2025-12-07 14:21:37 -08:00
Vijay Janapa Reddi
3cbe46e21c build(pdf): add XeLaTeX PDF build target to Makefile
- Add 'make pdf' target for PDF generation via XeLaTeX
- Include dependency checks for jupyter-book and xelatex
- Run latex_postprocessor.py for emoji cleanup
- Copy logo assets to build directory
- Add restore-emoji target for interrupted builds
2025-12-07 13:39:24 -08:00
Vijay Janapa Reddi
6ed685534d refactor(site): enhance PDF build with XeLaTeX and TinyTorch branding
- Switch from LuaLaTeX to XeLaTeX for better font handling and Unicode support
- Add comprehensive TinyTorch brand colors matching the logo
- Implement syntax-highlighted code blocks with flame accent
- Enhance title page with professional logo placement
- Add clean headers/footers with branded styling
- Reorganize TOC structure with semantic parts and captions
- Improve chapter titles for better pedagogical clarity
- Update build process to use latexmk for robust compilation
2025-12-07 10:09:03 -08:00
Vijay Janapa Reddi
deb2ced61d refactor(site): consolidate build scripts into Makefile
Simplified build system by removing redundant scripts:
- Removed build.sh (functionality moved to Makefile)
- Removed build_pdf.sh (consolidated into Makefile)
- Removed build_pdf_simple.sh (consolidated into Makefile)

Enhanced Makefile with better organization and PDF build support
Updated README with clearer build instructions
Improved _config_pdf.yml with better PDF generation settings
2025-12-07 06:07:46 -08:00
Vijay Janapa Reddi
c602f97364 feat: integrate TinyTorch into MLSysBook repository
TinyTorch educational deep learning framework now lives at tinytorch/

Structure:
- tinytorch/src/         - Source modules (single source of truth)
- tinytorch/tito/        - CLI tool
- tinytorch/tests/       - Test suite
- tinytorch/site/        - Jupyter Book website
- tinytorch/milestones/  - Historical ML implementations
- tinytorch/datasets/    - Educational datasets (tinydigits, tinytalks)
- tinytorch/assignments/ - NBGrader assignments
- tinytorch/instructor/  - Teaching materials

Workflows (with tinytorch- prefix):
- tinytorch-ci.yml           - CI/CD pipeline
- tinytorch-publish-dev.yml  - Dev site deployment
- tinytorch-publish-live.yml - Live site deployment
- tinytorch-build-pdf.yml    - PDF generation
- tinytorch-release-check.yml - Release validation

Repository Variables added:
- TINYTORCH_ROOT  = tinytorch
- TINYTORCH_SRC   = tinytorch/src
- TINYTORCH_SITE  = tinytorch/site
- TINYTORCH_TESTS = tinytorch/tests

All workflows use \${{ vars.TINYTORCH_* }} for path configuration.

Note: tinytorch/site/_static/favicon.svg kept as SVG (valid for favicons)
2025-12-05 19:23:18 -08:00