Source code and documentation for the Quarto documentation website, built with Quarto itself.
quarto-web is the source code and content repository for the official Quarto documentation website, hosted at quarto.org and its prerelease counterpart. It serves as the primary learning resource for the Quarto scientific and technical publishing system and is itself built using Quarto to demonstrate the tool's capabilities. The project uses Quarto's features like frozen computation states and profiles to manage a dual-site system from a single codebase.
Quarto users and contributors who need to understand, use, or contribute to the official Quarto documentation. This includes technical writers, developers, and researchers who want to learn about Quarto's features or update its documentation.
Developers choose this project as a reference implementation for building complex, reproducible documentation sites with Quarto, showcasing best practices like automated reference generation, managed computational environments, and a dual-profile system for managing stable and prerelease documentation from one source.
Quarto website
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Reference tables for Quarto options are auto-generated from the CLI schema using a custom script, ensuring accuracy and reducing manual maintenance, as detailed in the README's reference section.
Uses renv for R and pipenv for Python to ensure reproducible execution of code examples, with clear setup steps and dependency tracking in DESCRIPTION and Pipfile files.
Implements Quarto's freeze feature to avoid running engines during full site renders, enabling consistent builds and faster rendering, as explained in the rendering workflow.
Manages two distinct sites (stable and prerelease) from a single codebase using Quarto's profiles, demonstrated with phase and site profiles for flexible branding and configuration.
Requires installing and managing renv and pipenv with specific commands for R and Python, which can be a barrier for casual contributors, as noted in the detailed environment setup instructions.
Relies on advanced Quarto features like freeze and profiles, making the project less adaptable to other static site generators and limiting its utility as a general documentation example.
The use of pipenv may lead to python version conflicts, as mentioned in the README where pipenv might ask for a newer version if the current one doesn't match Pipfile.lock, complicating local development.