From 24e920ffb61f529b5e71332604f54cfc6a72e55e Mon Sep 17 00:00:00 2001 From: alexvoss Date: Sat, 18 Jul 2026 08:52:44 +0200 Subject: [PATCH] fix: add warning about file path restrictions Signed-off-by: alexvoss --- docs/setup/extensions/macros.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/setup/extensions/macros.md b/docs/setup/extensions/macros.md index 89707c1..22cb764 100644 --- a/docs/setup/extensions/macros.md +++ b/docs/setup/extensions/macros.md @@ -30,6 +30,15 @@ The Macros extension, included with Zensical, enables [Jinja2] templating in Mar [mkdocstrings]: https://mkdocstrings.github.io +!!! warning "Keep files in project folder" + + Zensical watches files to able to re-build the project when they change. + This includes Python files containing macros and YAML files included + with `include_yml`. Since Zensical's security policy does not allow paths + outside the project folder, make sure that any files used are located + inside it. This includes modules installed in virtual environments, + which must also be created within the project folder. + The following additional configuration options are supported: #### `module_name`