From 47f19fda7cb06c5944ea44d2ec0ad2413e4b9607 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Micka=C3=ABl=20Canouil?=
 <8896044+mcanouil@users.noreply.github.com>
Date: Fri, 26 Apr 2024 18:49:29 +0200
Subject: [PATCH] docs: add a CNAME example for site resources

---
 docs/websites/website-tools.qmd | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/docs/websites/website-tools.qmd b/docs/websites/website-tools.qmd
index 1a9ce296e0..d5d96f3b40 100644
--- a/docs/websites/website-tools.qmd
+++ b/docs/websites/website-tools.qmd
@@ -357,6 +357,16 @@ Images are the most commonly used type of resource file. If you have global imag
 ![](/images/logo.png)
 ```
 
+When publishing to a web host (*e.g.*, [GitHub Pages](docs/publishing/github-pages.qmd)), you can define a custom domain using a `CNAME` record and add it to your site.
+In this case, you can include the `CNAME` file in the resources list in your `_quarto.yml` configuration file:
+
+```yaml
+project:
+  type: website
+  resources:
+    - CNAME
+```
+
 ## Dark Mode
 
 Quarto websites can support both a light and dark mode. For example, you may use the `flatly` and `darkly` themes (which are designed to be used in tandem as dark and light appearances) as: