Add .readthedocs.yml to the template

copier.yml

@@ -93,13 +93,27 @@ dependencies:
         spaces between them. These dependencies will be included in the pyproject.toml file.
     default: "numpy,scipy"
 
+apt_packages:
+    type: str
+    help: |
+        Enter the required apt packages for this project, separate them with commas and do not leave any
+        spaces between them. The dependencies are installed before each CI/CD workflow and readthedocs
+        build via apt-get on a Linux system.
+    default: "libsndfile1,"
+
 valid_python_versions:
   when: false
   type: yaml
   default: >
     {% set min_index = python_versions.index(minimum_python_version) %}
     {{ python_versions[min_index:] }}
 
+latest_python_version:
+  when: false
+  type: yaml
+  default: >
+    {{ python_versions[-1] }}
+
 pypi_license_classifiers_list:
   when: false
   type: yaml

template/.readthedocs.yml.jinja

@@ -0,0 +1,32 @@
+# .readthedocs.yml
+# 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: {{ latest_python_version }}
+{% if 'libsndfile1' in apt_packages -%}
+  apt_packages:
+    - libsndfile1
+{%- endif %}
+
+# 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
+
+# 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:
+    - method: pip
+      path: ".[docs]"

tests/conftest.py

@@ -11,6 +11,7 @@ def copier_project_defaults():
         "license": "MIT",
         "copyright_statement": "2025, The pyfar developers",
         "project_short_description": "my_project_short_description",
+        "python_versions": "['3.9', '3.10', '3.11', '3.12', '3.13', '3.14']",
         }
 
 @pytest.fixture(scope="session")

tests/test_copier.py

@@ -27,6 +27,7 @@ def test_project_folder(default_project):
     "docs/Makefile",
     "docs/readme.rst",
     "MANIFEST.in",
+    ".readthedocs.yml",
 ])
 def test_generated_file_exists(default_project, file_name):
     assert default_project.project_dir.joinpath(file_name).exists()
@@ -158,3 +159,13 @@ def test_content_docs_multiple_files(default_project, file_name):
     content = default_project.project_dir.joinpath(file_name).read_text()
     desired = "my_project"
     assert desired in content, f"{desired!r} is not in content"
+
+
+@pytest.mark.parametrize("desired", [
+    '- libsndfile1',
+    "python: 3.14",
+])
+def test_content_readthedocs(default_project, desired):
+    content = default_project.project_dir.joinpath(
+                                    ".readthedocs.yml").read_text()
+    assert desired in content