quarto_github_action_versioned

Notedocblock 
quarto_github_action_versioned(; kwargs...)

Generate a GitHub Actions workflow for building and deploying versioned documentation.

This workflow supports:

  • /dev/ documentation on push to main/master branch
  • /vX.Y.Z/ documentation on release tags
  • /stable/ published copy of the latest release
  • Automatic versions.json manifest updates
  • Old version cleanup (configurable retention)

Arguments

  • quarto_version::String: Quarto version to use (default: “pre-release”)
  • julia_version::String: Julia version to use (default: “1”)
  • output_dir::String: Output directory from Quarto (default: “site”)
  • dev_branch::String: Branch for dev docs (default: “main”)
  • keep_versions::Int: Number of old versions to keep (default: 5)

Example

quarto_github_action_versioned()
# Creates .github/workflows/docs.yml with versioned deployment

quarto_github_action_versioned(keep_versions=10, dev_branch="develop")

URL Structure

The workflow deploys to:

  • /stable/ - Published copy of the latest release tag
  • /dev/ - Development branch documentation
  • /vX.Y.Z/ - Specific version documentation (from tags)
  • versions.json - Manifest of all available versions