From 0cfdc3ccd8d84fec378e66ea90cfad31db711a5c Mon Sep 17 00:00:00 2001
From: Robert Kaussow <mail@thegeeklab.de>
Date: Sun, 23 Mar 2025 20:55:37 +0100
Subject: [PATCH] docs: document how to include custom resources

---
 exampleSite/content/en/usage/customization.md | 16 ++++++++++++++++
 layouts/partials/head/custom.html             | 10 +++++++++-
 2 files changed, 25 insertions(+), 1 deletion(-)
 create mode 100644 exampleSite/content/en/usage/customization.md

diff --git a/exampleSite/content/en/usage/customization.md b/exampleSite/content/en/usage/customization.md
new file mode 100644
index 0000000..bb67c75
--- /dev/null
+++ b/exampleSite/content/en/usage/customization.md
@@ -0,0 +1,16 @@
+---
+title: Customization
+---
+
+{{< toc >}}
+
+## Custom resources
+
+To add custom resources to your site e.g. CSS or JavaScript files, create the `layouts/partials/head/custom.html` in the root dir of your project. Add the source files you want to include in the `static/` folder of your project, for example `static/css/custom.css` and `static/js/custom.js`. To include the files in your site, add the following code to `layouts/partials/head/custom.html`:
+
+```html
+<link rel="stylesheet" type="text/css" href="/css/custom.css" />
+<script type="text/javascript" src="/js/custom.js"></script>
+```
+
+Ensure to use the absolute path to the files.
diff --git a/layouts/partials/head/custom.html b/layouts/partials/head/custom.html
index 44862c7..8e11485 100644
--- a/layouts/partials/head/custom.html
+++ b/layouts/partials/head/custom.html
@@ -1 +1,9 @@
-<!-- You can add custom elements to the page header here. -->
+<!--
+You can add custom elements to the page header here.
+
+Example:
+Ensure to use the absolute path to custom files and place the source files in the `static` folder.
+
+<link rel="stylesheet" type="text/css" href="/custom.css">
+<script type="text/javascript" src="/custom.js"></script>
+-->