From 89329af57b5a53b35144c2147a63a77a79adffd3 Mon Sep 17 00:00:00 2001 From: Christophe Dervieux Date: Fri, 10 Oct 2025 12:29:21 +0200 Subject: [PATCH 1/2] Document `plausible-analytics` new config --- docs/websites/website-tools.qmd | 47 +++++++++++++++++++++++++++++++++ 1 file changed, 47 insertions(+) diff --git a/docs/websites/website-tools.qmd b/docs/websites/website-tools.qmd index c2fcaa2bee..1c68710f68 100644 --- a/docs/websites/website-tools.qmd +++ b/docs/websites/website-tools.qmd @@ -211,6 +211,53 @@ image: false --- ``` +## Plausible Analytics + +[Plausible Analytics](https://plausible.io/) is a lightweight, open-source, and privacy-friendly alternative to Google Analytics. Plausible is designed with privacy as a core principle: it doesn't use cookies, is GDPR compliant by default, and all data is processed anonymously. + +To add Plausible Analytics to your Quarto website: + +1. Sign up at [plausible.io](https://plausible.io/) and add your website to your account. +2. In your Plausible dashboard, navigate to your site's settings. +3. Go to the "Site Installation" section and click "Review Installation" to get your unique tracking snippet. +4. Copy the complete script snippet provided by Plausible from your dashboard. +5. Add it to your `_quarto.yml` configuration file under the `plausible-analytics` key: + +For example, it could look like this, where `pa-XXXXXX.js` would be your own custom script provided by Plausible: + +``` yaml +website: + plausible-analytics: | + + +``` + +The script will automatically be included in the `` of every page on your website. **Important:** Make sure to copy and paste the complete snippet exactly as provided by Plausible - the example above shows the typical structure, but your actual snippet will have a unique tracking code instead of `XXXXXX`. + +::: {.callout-tip} +The snippet from your Plausible dashboard may include multiple `