v0.12.0
Great Docs v0.12.0 introduces Termshow, a fully integrated terminal recording and playback system for embedding interactive terminal demos directly in your documentation. Beyond this major addition, this release provides build reliability improvements (including automatic retry on transient errors and versioned-site validation) along with flexible PyPI link configuration and smarter Python version detection for CI workflows.
New Features
- Termshow — Record, edit, and render interactive terminal sessions as SVG-based players embedded in documentation pages. Includes CLI commands for recording (
termshow record), editing via a web-based editor (termshow edit), and rendering to SVG frames, with support for chapters, annotations, and visual highlight overlays. (#183, #185, #186, #187, #189, #191, #192, #193) - PyPI URL config key — New
pypiconfiguration option to control package links: set toTruefor auto-detection,Falseto disable, or pass a custom URL string for private registries (#179). (#180)
Bug Fixes
- Build performance improved with per-build caches for package introspection, avoiding redundant work across rendering phases (#172). (#174)
- Quarto renders now automatically retry on transient filesystem errors instead of failing silently. (#176)
- Version expression comparison now correctly handles complex expressions with operators (
>=,<) and comma-separated tags. (#175) - API objects are now categorized in a single batch call, producing accurate type badges in
_object_types.json. (#177) - Python version is now auto-detected from
pyproject.toml'srequires-pythonfor GitHub Pages deployment workflows. (#178) - Pre-render and post-render validation added for versioned sites, catching missing
.qmdfiles and failed HTML output early (#181). (#188)
Documentation
- Added guidance on the
site_urlsetting for proper link resolution in deployed sites. (#182)
Full Changelog: v0.11.0...v0.12.0