Fix warnings in Sphinx build

Author: jpvanhal

.readthedocs.yaml

@@ -0,0 +1,16 @@
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3"
+
+sphinx:
+  configuration: docs/conf.py
+  fail_on_warning: true
+
+python:
+  install:
+    - method: pip
+      path: .
+    - requirements: docs/requirements.txt

docs/conf.py

@@ -126,7 +126,7 @@
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+# html_static_path = ["_static"]
 
 # If not '', a 'Last updated on:' timestamp is inserted at every page bottom,
 # using the given strftime format.
@@ -263,4 +263,4 @@
 
 
 # Example configuration for intersphinx: refer to the Python standard library.
-intersphinx_mapping = {"http://docs.python.org/": None}
+intersphinx_mapping = {"python": ("http://docs.python.org/", None)}

docs/index.rst

@@ -67,7 +67,7 @@ Same applies to IntegerField:
 
 
 SelectField & SelectMultipleField
------------
+---------------------------------
 
 WTForms-Components provides enhanced versions of WTForms SelectFields. Both WTForms-Components
 SelectField and SelectMultipleField support the following enhancements:
@@ -211,7 +211,7 @@ In the following example we define a start_time and a start_date field, which do
 Email validator
 ---------------
 
-Validates an email address. This validator is based on `Django's email validator`_ and is stricter than the standard email validator included in WTForms.
+Validates an email address. This validator is based on Django's email validator and is stricter than the standard email validator included in WTForms.
 
 Example:
 ::

tox.ini

@@ -19,4 +19,4 @@ deps =
 [testenv:docs]
 basepython = py312
 deps = -r docs/requirements.txt
-commands = sphinx-build docs docs/_build
+commands = sphinx-build docs docs/_build --fail-on-warning