Infra: override RTD build commands (#2728)

Author: hugovk

.github/workflows/render.yml

@@ -24,7 +24,7 @@ jobs:
           python -m pip install --upgrade pip
 
       - name: 🔧 Render PEPs
-        run: make pages -j$(nproc)
+        run: make pages JOBS=$(nproc)
 
         # remove the .doctrees folder when building for deployment as it takes two thirds of disk space
       - name: 🔥 Clean up files

Makefile

@@ -3,7 +3,8 @@
 PYTHON=python3
 VENVDIR=.venv
 JOBS=8
-RENDER_COMMAND=$(VENVDIR)/bin/python3 build.py -j $(JOBS)
+OUTPUT_DIR=build
+RENDER_COMMAND=$(VENVDIR)/bin/python3 build.py -j $(JOBS) -o $(OUTPUT_DIR)
 
 render: venv
 	$(RENDER_COMMAND)

build.py

@@ -36,6 +36,12 @@ def create_parser():
     parser.add_argument("-j", "--jobs", type=int, default=1,
                         help="How many parallel jobs to run (if supported). "
                              "Integer, default 1.")
+    parser.add_argument(
+        "-o",
+        "--output-dir",
+        default="build",  # synchronise with render.yaml -> deploy step
+        help="Output directory, relative to root. Default 'build'.",
+    )
 
     return parser.parse_args()
 
@@ -57,7 +63,7 @@ def create_index_file(html_root: Path, builder: str) -> None:
 
     root_directory = Path(".").absolute()
     source_directory = root_directory
-    build_directory = root_directory / "build"  # synchronise with deploy-gh-pages.yaml -> deploy step
+    build_directory = root_directory / args.output_dir
     doctree_directory = build_directory / ".doctrees"
 
     # builder configuration

readthedocs.yaml

@@ -1,13 +1,12 @@
 version: 2
 
 build:
-  os: ubuntu-20.04
+  os: ubuntu-22.04
   tools:
-    python: "3.9"
+    python: "3.10"
 
-python:
-  install:
-    - requirements: requirements.txt
+  commands:
+    - make pages JOBS=$(nproc) OUTPUT_DIR=_readthedocs/html
 
 sphinx:
   builder: dirhtml