Repository files navigation

This repository storesGithub Actions useful for building and publishingQuarto documents.

1. quarto-dev/quarto-actions/setup - Install Quarto
2. quarto-dev/quarto-actions/render - Render project
3. quarto-dev/quarto-actions/publish - Publish project

We recommend usingv2 for your actions, and our examples all usev2.

InExamples, you will find a YAML workflow file to serve as a template to be reused as a base for your project. We are also sharing some links to real example Github repositories using Quarto with Github Actions for rendering and deploying documents and projects. If you want to add your repository in the list, we welcome a PR.

This repository usesGitHub's recommended release management for actions:

• GitHub releases with tags are used for updates on the actions.
• Semantic versioning is used, with major, minor and possibly patch release.
• Major versions (such asv1) will always point to the last minor or patch release for this major version. (whenv1.0.2 is out,v1 will point to this update, too). This means usingquarto-dev/quarto-actions/setup@v2 in your workflow file will automatically get the updated versions. Usingquarto-dev/quarto-actions/setup@v1.0.2 will pin a specific release.
• Major version changes (v1 tov2) will often come with breaking changes, and workflows might require manual updates.