Fix readthedocs builds

Author: xispa

.readthedocs.yaml

@@ -0,0 +1,18 @@
+# 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.13"
+  jobs:
+    post_create_environment:
+      - python -m pip install sphinx_rtd_theme
+
+# Build documentation in the "docs/" directory with Sphinx
+sphinx:
+  configuration: docs/conf.py

docs/conf.py

@@ -37,6 +37,7 @@
 extensions = [
     'sphinx.ext.autodoc',
     'sphinx.ext.viewcode',
+    'sphinx_rtd_theme',
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -53,16 +54,16 @@
 
 # General information about the project.
 project = u'senaite.jsonapi'
-copyright = u'2017-2020, Riding Bytes & Naralabs'
+copyright = u'2017-2025, Riding Bytes & Naralabs'
 
 # The version info for the project you're documenting, acts as replacement for
 # |version| and |release|, also used in various other places throughout the
 # built documents.
 #
 # The short X.Y version.
-version = '1.2.3'
+version = '2.6.0'
 # The full version, including alpha/beta/rc tags.
-release = '1.2.3'
+release = '2.6.0'
 
 # The language for content autogenerated by Sphinx. Refer to documentation
 # for a list of supported languages.
@@ -107,7 +108,7 @@
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-html_theme = 'default'
+html_theme = 'sphinx_rtd_theme'
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
@@ -250,7 +251,8 @@
 #  dir menu entry, description, category)
 texinfo_documents = [
   ('index', 'senaitejsonapi', u'senaite.jsonapi Documentation',
-   u'Riding Bytes & Naralabs', 'senaitejsonapi', 'One line description of project.',
+   u'Riding Bytes & Naralabs', 'senaitejsonapi',
+   'A RESTful JSON API for SENAITE LIMS',
    'Miscellaneous'),
 ]