The quarto-web repository (https://github.com/quarto-dev/quarto-web) serves two primary functions:
Documentation Website: Hosts the complete documentation for Quarto, the open-source scientific and technical publishing system. This includes guides, tutorials, API references, and examples covering authoring, computations, output formats, publishing, and extensions.
Release Distribution System: Manages the automated download infrastructure for Quarto CLI releases, providing version-agnostic URLs that always point to the latest stable and prerelease versions.
The repository is organized as a Quarto website project configured in _quarto.yml1-690 with content spanning authoring guides, computational examples, publishing workflows, and a comprehensive extension catalog. The site is deployed to both quarto.org (stable) and prerelease.quarto.org (development) via automated CI/CD pipelines.
For information about specific subsystems:
Sources: _quarto.yml1-690 _redirects1-26 index.qmd1-342 docs/download/_prerelease.json1-88 docs/download/_download.json1-88
The quarto-web repository contains ten major interconnected systems:
| System | Purpose | Key Files |
|---|---|---|
| Release and Download | Tracks Quarto CLI releases (stable v1.8.27, prerelease v1.9.23) and provides version-agnostic download URLs | docs/download/_prerelease.json, docs/download/_download.json, _redirects |
| CI/CD Infrastructure | Automates rendering, deployment, and maintenance across production and prerelease environments | .github/workflows/publish.yml, .github/workflows/preview.yml, .github/workflows/update-downloads.yml |
| Website Configuration | Defines site structure, navigation, metadata, and publishing targets | _quarto.yml, docs/guide/guide.yml |
| Homepage and Entry | Landing page with hero banner, multi-language demos, and feature showcase | index.qmd, index.css, theme.scss |
| Extension Ecosystem | Catalog of 343+ community extensions (shortcodes, filters, formats, RevealJS) | _extensions/, YAML listing files |
| Document Authoring | Documentation for markdown syntax, computation engines, execution options, branding | docs/authoring/, docs/computations/ |
| Presentation System | Reveal.js integration documentation and interactive demo | docs/presentations/, demo/index.qmd |
| Dashboard System | Dashboard creation with Python/R/Julia/Observable | docs/dashboards/ |
| Gallery and Showcase | Community examples and use cases | docs/gallery/ |
| Publishing Workflows | Guides for deploying to various hosting platforms | docs/publishing/ |
Sources: _quarto.yml1-690 index.qmd1-342 docs/download/_prerelease.json1-88 docs/download/_download.json1-88 _redirects1-26 docs/publishing/github-pages.qmd1-341
Sources: _quarto.yml1-14 docs/publishing/netlify.qmd1-250 docs/projects/code-execution.qmd (referenced in comments)
The repository maintains two parallel deployment environments with separate branches and domains:
Sources: docs/download/_download.json1-88 docs/download/_prerelease.json1-88 docs/publishing/github-pages.qmd122-173
The _quarto.yml file defines the complete website structure:
Sources: _quarto.yml1-690 _quarto.yml16-103 _quarto.yml676-688 theme.scss1-45 theme-dark.scss1-189
The homepage (index.qmd1-342) uses a custom layout with specific structural components:
Sources: index.qmd1-342 index.css1-298 theme.scss1-45 theme-dark.scss1-189
The repository includes comprehensive documentation for multiple publishing targets:
| Publishing Target | Documentation File | Key Features |
|---|---|---|
| Quarto Pub | docs/publishing/quarto-pub.qmd1-256 | Free hosting, QUARTO_PUB_AUTH_TOKEN, GitHub Actions |
| GitHub Pages | docs/publishing/github-pages.qmd1-341 | gh-pages branch, _redirects, freeze computations |
| Netlify | docs/publishing/netlify.qmd1-250 | NETLIFY_AUTH_TOKEN, build plugin, custom domains |
| Posit Connect | docs/publishing/rstudio-connect.qmd1-341 | CONNECT_SERVER, CONNECT_API_KEY, Git-backed content |
| Other Services | docs/publishing/other.qmd1-48 | Firebase, Site44, Amazon S3 |
| CI Publishing | docs/publishing/ci.qmd1-195 | Shell commands, freezing, credentials |
Each guide follows a consistent structure:
Sources: docs/publishing/quarto-pub.qmd1-256 docs/publishing/github-pages.qmd1-341 docs/publishing/netlify.qmd1-250 docs/publishing/rstudio-connect.qmd1-341 docs/publishing/other.qmd1-48 docs/publishing/ci.qmd1-195
The release management system is the most critical infrastructure component, automatically tracking two concurrent version streams:
The _redirects file provides 26 URL mapping rules enabling version-agnostic downloads. For example:
/download/latest/quarto-linux-amd64.deb → GitHub release for v1.8.27/download/prerelease/quarto-linux-amd64.deb → GitHub release for v1.9.23This ensures documentation and tooling never need hardcoded version numbers.
Sources: docs/download/_prerelease.json1-88 docs/download/_download.json1-88 _redirects1-26 _quarto.yml6-9
The repository relies on several core technologies:
prod_QUARTO) and prerelease (prerelease_QUARTO)quarto-dev/quarto-actionsSources: _quarto.yml30-38 docs/publishing/github-pages.qmd159-168
Refresh this wiki
This wiki was recently refreshed. Please wait 1 day to refresh again.