docs: Add readthedocs configuration file, update dependencies

Abijeet · Abijeet · commit bbf65767b37d · 2025-12-03T22:49:47.000+05:30
See: https://docs.readthedocs.com/platform/stable/config-file/index.html Bug: https://phabricator.wikimedia.org/T407180
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
@@ -0,0 +1,26 @@
+# Read the Docs configuration file for Sphinx projects
+# 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
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3.12"
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py
+
+# Optionally build your docs in additional formats such as PDF and ePub
+# formats:
+#   - pdf
+#   - epub
+
+# Optional but recommended, declare the Python requirements required
+# to build your documentation
+# See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
+python:
+  install:
+    - requirements: docs/requirements.txt
diff --git a/docs/conf.py b/docs/conf.py
@@ -20,7 +20,7 @@
 # -- Project information -----------------------------------------------------
 
 project = u'LanguageData'
-copyright = u'2020, Wikimedia Foundation'
+copyright = u'2025, Wikimedia Foundation'
 author = u'Wikimedia Foundation'
 
 # The short X.Y version
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -1,4 +1,4 @@
-Sphinx==1.8.4
-sphinx-rtd-theme==0.4.2
-sphinxcontrib-phpdomain==0.6.3
+Sphinx>=7.0
+sphinx-rtd-theme>=1.2
+sphinxcontrib-phpdomain>=0.8.0
 doxyphp2sphinx>=1.0.1
