cs249r_book/book/quarto/_extensions

MLSysBook Extensions

This directory contains Quarto extensions used by the MLSysBook project.

⚠️ CRITICAL WARNING - READ BEFORE MAKING CHANGES

Some extensions in this directory are HEAVILY CUSTOMIZED and should NEVER be reinstalled using quarto add.

🔍 Quick Safety Check

Before installing or updating any extension, ALWAYS check for:

1. .CUSTOM_LOCK files in extension directories
2. Version numbers ending in -mlsysbook-custom
3. Warnings in extension _extension.yml files

📋 Extension Inventory

Extension	Status	Safe to Update?
`margin-video`	🚫 **100% Custom**	Never (MLSysBook only)
`mlsysbook-ext/pseudocode`	🚫 **Customized** (casing, ▷ comments, EPUB)	Never
`ute/custom-numbered-blocks`	🚫 **Heavy Customization**	Never
`nmfs-opensci/titlepage`	🚫 **Customized**	Never
`pandoc-ext/diagram`	✅ Standard	Yes
`quarto-ext/lightbox`	✅ Standard	Yes

🚨 Emergency Recovery

If you accidentally overwrote a custom extension:

# Check what changed
git status

# Restore from git if needed
git checkout HEAD -- book/_extensions/EXTENSION_NAME/

# Run protection check
python tools/scripts/check_custom_extensions.py

📚 Full Documentation

For complete details, see: CUSTOM_EXTENSIONS.md

---

When in doubt, DON'T reinstall - ask the team first!