Update .readthedocs.yaml

Author: Carrington-dev

.readthedocs.yaml

@@ -1,27 +1,46 @@
-# Read the Docs configuration file
+# .readthedocs.yaml
+# Read the Docs configuration file for dj-payfast
 # See https://docs.readthedocs.io/en/stable/config-file/v2.html for details
 
-# Required
 version: 2
 
-# Set the OS, Python version, and other tools you might need
+# Set the OS, Python version and other tools you might need
 build:
-  os: ubuntu-24.04
+  os: ubuntu-22.04
   tools:
-    python: "3.13"
+    python: "3.11"
+  jobs:
+    post_create_environment:
+      # Install poetry or other dependencies if needed
+      - pip install poetry || echo "Poetry installation optional"
+    post_install:
+      # Install any additional requirements
+      - echo "Build environment ready"
 
 # Build documentation in the "docs/" directory with Sphinx
 sphinx:
-   configuration: docs/conf.py
+  configuration: docs/conf.py
+  fail_on_warning: false
 
+# Optionally build your docs in additional formats such as PDF and ePub
 formats:
   - pdf
   - epub
 
-# Optionally, but recommended,
-# declare the Python requirements required to build your documentation
-# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+# Python configuration
 python:
-   install:
-   - requirements: docs/requirements.txt
-        
+  install:
+    - requirements: docs/requirements.txt
+    - requirements: requirements.txt
+    - method: pip
+      path: .
+      extra_requirements:
+        - docs
+
+# Additional settings
+search:
+  ranking:
+    'docs/introduction.rst': 2
+    'docs/index.rst': 3
+  ignore:
+    - '404.html'