Documentation: Add configuration for Read the Docs

Also, relocate `docs` dependencies to dedicated file.

Author: amotl

.readthedocs.yml

@@ -0,0 +1,22 @@
+# .readthedocs.yml
+# Read the Docs configuration file
+
+# Details
+# - https://docs.readthedocs.io/en/stable/config-file/v2.html
+
+# Required
+version: 2
+
+build:
+  os: "ubuntu-24.04"
+  tools:
+    python: "3.14"
+
+sphinx:
+  configuration: docs/conf.py
+  builder: html
+  fail_on_warning: true
+
+# Optionally build your docs in additional formats such as PDF
+#formats:
+#  - pdf

docs/requirements.txt

@@ -0,0 +1,10 @@
+furo
+myst-parser[linkify]>=0.18,<6
+roman-numerals-py<5
+sphinx<10
+sphinx-autobuild
+sphinx-copybutton
+sphinx-design-elements<1
+sphinx-sitemap<3
+sphinxcontrib-mermaid<3
+sphinxext-opengraph<1

pyproject.toml

@@ -139,18 +139,6 @@ optional-dependencies.develop = [
   "ruff<0.12",
   "validate-pyproject<1",
 ]
-optional-dependencies.docs = [
-  "furo",
-  "myst-parser[linkify]>=0.18,<6",
-  "roman-numerals-py<5",
-  "sphinx<10",
-  "sphinx-autobuild",
-  "sphinx-copybutton",
-  "sphinx-design-elements<1",
-  "sphinx-sitemap<3",
-  "sphinxcontrib-mermaid<3",
-  "sphinxext-opengraph<1",
-]
 optional-dependencies.full = [ "omniload[ibm-db,odbc,oracle]" ]
 optional-dependencies.ibm-db = [
   "ibm-db<4; platform_machine!='aarch64'",
@@ -343,12 +331,15 @@ tasks.check = [
   "test",
 ]
 tasks.docs-autobuild = [
+  { cmd = "uv pip install -r docs/requirements.txt;" },
   { cmd = "sphinx-autobuild --open-browser docs docs/_build" },
 ]
 tasks.docs-html = [
+  { cmd = "uv pip install -r docs/requirements.txt;" },
   { cmd = "sphinx-build -W --keep-going docs docs/_build" },
 ]
 tasks.docs-linkcheck = [
+  { cmd = "uv pip install -r docs/requirements.txt;" },
   { cmd = "sphinx-build -W --keep-going -b linkcheck docs docs/_build" },
 ]
 tasks.docs-lint = { cmd = "vale docs --glob='!**/.vitepress/**'" }