From b21bf0288fd93be19938003bb1231d734509614f Mon Sep 17 00:00:00 2001
From: PythonWoods <gianluca.catalano@gmail.com>
Date: Fri, 17 Apr 2026 17:39:34 +0200
Subject: [PATCH] feat: add Read the Docs configuration for RTD mirror
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

- Add .readthedocs.yaml (Ubuntu 24.04, Node 22, npm ci → build → copy)
- No trailingSlash override: preserves filesystem-based link integrity
  validated by Zenzic Sentinel (exit 0, zero path traversals)
- Docusaurus build passes clean for both en + it locales
---
 .readthedocs.yaml | 20 ++++++++++++++++++++
 1 file changed, 20 insertions(+)
 create mode 100644 .readthedocs.yaml

diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644
index 0000000..9e897af
--- /dev/null
+++ b/.readthedocs.yaml
@@ -0,0 +1,20 @@
+# SPDX-FileCopyrightText: 2025 PythonWoods <dev@pythonwoods.dev>
+# SPDX-License-Identifier: Apache-2.0
+
+# Read the Docs configuration for Docusaurus v3
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    nodejs: "22"
+
+  commands:
+    # 1. Installazione deterministica delle dipendenze (root-based)
+    - npm ci
+    # 2. Generazione del sito statico
+    - npm run build
+    # 3. Preparazione directory di output RTD
+    - mkdir --parents $READTHEDOCS_OUTPUT/html/
+    # 4. Trasferimento della build (la cartella è 'build/', non 'docs/build/')
+    - cp --recursive build/* $READTHEDOCS_OUTPUT/html/