Update docs build

.readthedocs.yml

@@ -1,17 +1,17 @@
 version: 2
 
 build:
-  image: latest
-
-python:
-  version: 3.7
-  install:
-    - requirements: docs/requirements.txt
-    - method: pip
-      path: .
+  os: "ubuntu-22.04"
+  tools:
+    python: "3.11"
+  jobs:
+    post_install:
+      - pip install poetry
+      - poetry config virtualenvs.create false
+      - poetry install --all-extras --only=main,docs
 
 sphinx:
-  builder: htmldir
   configuration: docs/conf.py
+  builder: dirhtml
 
 formats: all

docs/conf.py

@@ -25,6 +25,10 @@
 
 autodoc_member_order = "bysource"
 
-extlinks = {"issue": ("https://github.com/jodal/pykka/issues/%s", "#")}
+extlinks = {
+    "issue": ("https://github.com/jodal/pykka/issues/%s", "#%s"),
+}
 
-intersphinx_mapping = {"python": ("https://docs.python.org/3", None)}
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+}

pyproject.toml

@@ -34,6 +34,11 @@ pytest-cov = "^3.0.0"
 pytest-mock = "^3.6.1"
 tox = "^3.23.1"
 
+[tool.poetry.group.docs.dependencies]
+sphinx = "^6.2.1"
+sphinx_rtd_theme = "^1.2.1"
+toml = "^0.10.2"
+
 [tool.black]
 target-version = ["py37", "py38", "py39", "py310", "py311"]
 

tox.ini

@@ -12,10 +12,9 @@ commands =
         {posargs}
 
 [testenv:docs]
-changedir = docs
 commands =
-    python -m pip install -r requirements.txt
-    python -m sphinx -b html -d {envtmpdir}/doctrees . {envtmpdir}/html
+    poetry install --all-extras --only=main,docs
+    python -m sphinx -b html -d {envtmpdir}/doctrees docs {envtmpdir}/html
 
 [testenv:flake8]
 commands =