Official GitHub Actions for installing, rendering, and publishing Quarto documents and projects.
Quarto Actions is a collection of official GitHub Actions for automating the setup, rendering, and publishing of Quarto projects. It solves the problem of manually building and deploying Quarto documents by integrating Quarto's capabilities directly into GitHub's CI/CD workflows. This allows for automated, reproducible generation of websites, books, reports, and presentations from Quarto source files.
Developers, researchers, and technical writers who use Quarto for creating documents and websites and want to automate their build and deployment processes using GitHub Actions.
Developers choose Quarto Actions because they are the officially maintained, versioned actions that guarantee compatibility with Quarto updates. They simplify CI/CD configuration, reduce manual steps, and ensure consistent, automated publishing of Quarto projects directly from GitHub repositories.
This repository provides a collection of official GitHub Actions designed to automate the workflow for Quarto projects. It enables seamless integration of Quarto's document rendering and publishing capabilities into CI/CD pipelines, making it easier to produce and deploy reproducible research, websites, books, and presentations.
The project aims to provide reliable, versioned, and easy-to-use actions that integrate Quarto's powerful publishing toolkit into automated GitHub workflows, promoting reproducibility and automation in document creation.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Developed and maintained by quarto-dev, ensuring compatibility with Quarto updates and reducing integration risks.
Uses semantic versioning and GitHub's release system, allowing automatic updates with major version tags like @v2, as highlighted in the README.
Dedicated actions for setup, render, and publish minimize YAML boilerplate, making CI/CD configuration straightforward.
Includes example workflows and links to real repositories, offering templates for common use cases like deploying to GitHub Pages.
These actions are tightly coupled with GitHub Actions, locking users into the GitHub ecosystem and limiting portability to other CI/CD services.
Major version updates (e.g., v1 to v2) can introduce breaking changes that require manual workflow updates, as admitted in the README's release management section.
Focused on standard Quarto workflows; complex builds with custom dependencies or extensions may need additional manual steps, increasing configuration complexity.