Build all languages in a single pass. (#58)

Author: freakboy3742

.github/workflows/ci.yml

@@ -24,3 +24,33 @@ 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/checkout@v6.0.2
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        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

.github/workflows/publish.yml

@@ -0,0 +1,57 @@
+name: Publish site
+on:
+  push:
+    branches:
+      - main
+  workflow_dispatch:
+
+# Cancel active CI runs for a PR before starting another run
+concurrency:
+  group: ${{ github.workflow }}-${{ github.ref }}
+  cancel-in-progress: true
+
+defaults:
+  run:
+    shell: bash  # https://github.com/beeware/briefcase/pull/912
+
+env:
+  FORCE_COLOR: "1"
+
+jobs:
+  publish:
+    name: Build and publish site
+    permissions:
+      contents: write
+    runs-on: ubuntu-latest
+    timeout-minutes: 5
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v6.0.2
+        with:
+          fetch-depth: 1
+
+      - name: Set up Python
+        uses: actions/setup-python@v6.2.0
+        with:
+          python-version: "3.X"
+          cache: pip
+          cache-dependency-path: |
+            pyproject.toml
+            .pre-commit-config.yaml
+
+      - name: Update pip
+        run: python -m pip install -U pip
+
+      - name: Install Tox
+        run: python -m pip install --group 'tox-uv'
+
+      - name: Build the site
+        run: python -m tox -e docs-all
+
+      - name: Deploy the built files
+        uses: JamesIves/github-pages-deploy-action@v4.8.0
+        with:
+          folder: _build/html  # The folder the action should deploy.
+          branch: gh-pages  # The branch to which the action should deploy.
+          git-config-name: github-actions[bot]
+          git-config-email: 41898282+github-actions[bot]@users.noreply.github.com

.readthedocs.yaml

@@ -9,16 +9,14 @@ 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:
     post_checkout:
       - git fetch --unshallow
     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/

tox.ini

@@ -5,8 +5,8 @@ envlist = docs-lint,docs-all
 docs_dir = {tox_root}{/}docs{/}en
 
 [testenv:docs{,-lint,-translate,-all,-live,-en,-de,-es,-fr,-it,-pt,-zh-cn,-zh-tw}]
-# 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
@@ -18,8 +18,6 @@ commands:
     translate : update_machine_translations --soft-fail de es fr it pt zh_CN zh_TW
     lint : markdown-checker --dir {[docs]docs_dir} --func check_broken_urls
     lint : pyspelling
-    live : live_serve_en {posargs} --port=8041
-    all : build_md_translations {posargs} en de es fr it pt zh_CN zh_TW
     en : build_md_translations {posargs} en
     de : build_md_translations {posargs} de
     es : build_md_translations {posargs} es
@@ -28,3 +26,6 @@ commands:
     pt : build_md_translations {posargs} pt
     zh-cn : build_md_translations {posargs} zh_CN
     zh-tw : build_md_translations {posargs} zh_TW
+    all : build_md_translations {posargs} en de es fr it pt zh_CN zh_TW
+    serve : python -m http.server -d _build/html 8041
+    live : live_serve_en {posargs} --port=8041