Fix: Add RTD docs build configuration file 42/72742/1
authorMatthew Watkins <mwatkins@linuxfoundation.org>
Wed, 13 Mar 2024 14:49:55 +0000 (14:49 +0000)
committerMatthew Watkins <mwatkins@linuxfoundation.org>
Wed, 13 Mar 2024 14:49:55 +0000 (14:49 +0000)
Also, exclude node_modules directory from linting tools

Issue: RELENG-5212
Change-Id: I73d2880bac202da76e411f636bdde3cbef1c974b
Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>
.gitignore
.readthedocs.yaml [new file with mode: 0644]

index 1b37311..933b98b 100644 (file)
@@ -5,3 +5,4 @@ docs/_build/
 cloud-env.json
 *.pyc
 *.retry
+node_modules/
diff --git a/.readthedocs.yaml b/.readthedocs.yaml
new file mode 100644 (file)
index 0000000..136a922
--- /dev/null
@@ -0,0 +1,27 @@
+# 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-22.04
+  tools:
+    python: "3.10"
+
+# 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
+  - epub
+
+# 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:
+    - requirements: docs/requirements.txt