diff --git a/.github/workflows/build_jb.yml b/.github/workflows/build_jb.yml
index db9eab8..eb4eb5e 100644
--- a/.github/workflows/build_jb.yml
+++ b/.github/workflows/build_jb.yml
@@ -22,4 +22,4 @@ jobs:
           pip install jupyter-book
 
       - name: Build documentation (only on macos-latest)
-        run: jupyter-book build practicals_jn_book --all
+        run: jupyter-book build practicals_jn_book --all -W
diff --git a/.gitignore b/.gitignore
index c23fdba..5847739 100644
--- a/.gitignore
+++ b/.gitignore
@@ -177,4 +177,5 @@ cython_debug/
 .DS_Store
 
 # jupyter-book
-practicals_jn_book/_build/*
+practicals_jn_book/_build
+practicals_jn_book/conf.py
diff --git a/readthedocs.yaml b/readthedocs.yaml
new file mode 100644
index 0000000..dfbebb9
--- /dev/null
+++ b/readthedocs.yaml
@@ -0,0 +1,18 @@
+version: 2
+
+# Set the version of Python and other tools you might need
+build:
+  os: macos-latest
+  tools:
+    python: "3.12"
+  jobs:
+    pre_build:
+      - "jupyter-book config sphinx practicals_jn_book/"
+
+python:
+   install:
+   - requirements: practicals_jn_book/requirements.txt
+
+formats:
+  - pdf
+  - epub