Skip to content

v0.12.0

Choose a tag to compare

@rich-iannone rich-iannone released this 28 May 15:34
· 99 commits to main since this release

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 pypi configuration option to control package links: set to True for auto-detection, False to 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's requires-python for GitHub Pages deployment workflows. (#178)
  • Pre-render and post-render validation added for versioned sites, catching missing .qmd files and failed HTML output early (#181). (#188)

Documentation

  • Added guidance on the site_url setting for proper link resolution in deployed sites. (#182)

Full Changelog: v0.11.0...v0.12.0