Add documentation for path

cderv · cderv · commit abaa570ea897 · 2025-10-13T17:50:32.000+02:00
diff --git a/docs/websites/website-tools.qmd b/docs/websites/website-tools.qmd
@@ -223,9 +223,13 @@ To add Plausible Analytics to your Quarto website:
 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:
+5. Add it to your `_quarto.yml` configuration file.
 
-For example, it could look like this, where `pa-XXXXXX.js` would be your own custom script provided by Plausible:
+You can provide the Plausible snippet in two ways:
+
+**Option 1: Inline snippet**
+
+Paste the snippet directly in your `_quarto.yml` configuration file under the `plausible-analytics` key. Use the `|` character after the key to preserve line breaks in the snippet:
 
 ``` yaml
 website:
@@ -237,10 +241,20 @@ website:
     </script>
 ```
 
+**Option 2: File path**
+
+Save the snippet to a file (e.g., `_plausible_snippet.html`) and provide the path:
+
+``` yaml
+website:
+  plausible-analytics:
+    path: _plausible_snippet.html
+```
+
 The script will automatically be included in the `<head>` 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 `<script>` tags and initialization code. Copy the entire snippet as-is - don't modify or simplify it.
+The snippet from your Plausible dashboard may include multiple `<script>` tags and initialization code. Copy the entire snippet as-is - don't modify or simplify it. Using the file path option can be useful if you want to keep the snippet separate from your configuration or if you need to update it frequently.
 :::
 
 #### Optional Enhanced Measurements
