Quarto GitHub Actions
Official GitHub Actions for installing, rendering, and publishing Quarto documents and projects.
What is Quarto GitHub Actions?
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.
Overview
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.
Key Features
- Setup Action — Installs the Quarto CLI and necessary dependencies on GitHub Actions runners.
- Render Action — Executes Quarto to render documents, websites, books, or other project outputs.
- Publish Action — Deploys rendered Quarto projects to various hosting platforms or destinations.
- Version Management — Follows semantic versioning and GitHub's release management for actions, ensuring stability and easy updates.
Philosophy
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.
Related Projects
Found a gem we're missing?
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
