Build all languages on RTD in a single pass (#26)

Author: freakboy3742

.github/workflows/ci.yml

@@ -24,3 +24,35 @@ jobs:
     uses: beeware/.github/.github/workflows/pre-commit-run.yml@main
     with:
       pre-commit-source: "--group pre-commit"
+
+  lint:
+    needs: [ pre-commit ]
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout
+        uses: actions/[email protected]
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/[email protected]
+        with:
+          python-version: "3.X"
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            .pre-commit-config.yaml
+
+      - name: Install system dependencies
+        run: |
+          sudo apt-get install aspell aspell-en
+
+      - name: Update pip
+        run: python -m pip install -U pip
+
+      - name: Install Tox
+        run: python -m pip install --group 'tox-uv'
+
+      - name: Perform lint checks
+        run: python -m tox -e docs-lint

.readthedocs.yaml

@@ -9,14 +9,12 @@ version: 2
 build:
   os: ubuntu-24.04
   tools:
-    # Docs are always built on Python 3.12. See also the tox config.
-    python: "3.12"
+    # Docs are always built on Python 3.13. See also the tox config.
+    python: "3.13"
   jobs:
     pre_install:
       - python -m pip install --upgrade pip
       - python -m pip install --group 'tox-uv'
-    pre_build:
-      - python -m tox -e docs-lint
     build:
       html:
-        - python -m tox -e docs-$READTHEDOCS_LANGUAGE -- --output=$READTHEDOCS_OUTPUT/html/
+        - python -m tox -e docs-all -- --output=$READTHEDOCS_OUTPUT/html/

pyproject.toml

@@ -22,6 +22,7 @@ dev = [
 
 docs = [
     "beeware-docs-tools @ git+https://github.com/beeware/beeware-docs-tools",
+    # "beeware-docs-tools @ file://../beeware-docs-tools",
     {include-group = "redirects"},
 ]
 

tox.ini

@@ -5,8 +5,8 @@ envlist = docs-lint,docs-all
 docs_dir = {tox_root}{/}docs{/}en
 
 [testenv:docs{,-translate,-lint,-en,-ar,-cs,-da,-de,-es,-fa,-fr,-it,-ko,-pl,-pt,-tr,-zh-cn,-zh-tw,-all,-serve,-live}]
-# Docs are always built on Python 3.12. See also the RTD config.
-base_python = py312
+# Docs are always built on Python 3.13. See also the RTD config.
+base_python = py313
 skip_install = true
 passenv =
     DEEPL_API_KEY
@@ -34,5 +34,5 @@ commands:
     zh-cn : build_md_translations {posargs} zh_CN
     zh-tw : build_md_translations {posargs} zh_TW
     all : build_md_translations {posargs} en ar cs da de es fa fr it ko pl pt tr zh_CN zh_TW
-    serve : python -m http.server -d _build/html
+    serve : python -m http.server -d _build/html 8042
     live : live_serve_en {posargs} --port=8042