diff --git a/docs/websites/website-tools.qmd b/docs/websites/website-tools.qmd index c2fcaa2be..37b2c2cdc 100644 --- a/docs/websites/website-tools.qmd +++ b/docs/websites/website-tools.qmd @@ -211,7 +211,56 @@ image: false --- ``` -## Google Analytics +## Analytics + +### 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 `