From af3c5fcbaba0e3cd3e17400f9bd18d878040cd73 Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:11:12 +0800 Subject: [PATCH 1/7] Correct targets for zh builds. --- tox.ini | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/tox.ini b/tox.ini index e7c0d77fca..aee0df47fe 100644 --- a/tox.ini +++ b/tox.ini @@ -4,7 +4,7 @@ envlist = docs-lint,docs-all [docs] docs_dir = {tox_root}{/}docs{/}en -[testenv:docs{,-translate,-lint,-en,-ar,-cs,-da,-de,-es,-fa,-fr,-it,-ja,-ko,-pl,-pt,-ru,-tr,-zh-cn,-zh-tw,-all,-serve,-live}] +[testenv:docs{,-translate,-lint,-en,-ar,-cs,-da,-de,-es,-fa,-fr,-it,-ja,-ko,-pl,-pt,-ru,-tr,-zh_CN,-zh_TW,-all,-serve,-live}] # Docs are always built on Python 3.13. See also the RTD config. base_python = py313 skip_install = true @@ -12,7 +12,7 @@ passenv = DEEPL_API_KEY dependency_groups = docs commands: - !translate-!lint-!en-!ar-!cs-!da-!de-!es-!fa-!fr-!it-!ja-!ko-!pl-!pt-!ru-!tr-!zh-cn-!zh-tw-!all-!serve-!live : build_md_translations {posargs} en + !translate-!lint-!en-!ar-!cs-!da-!de-!es-!fa-!fr-!it-!ja-!ko-!pl-!pt-!ru-!tr-!zh_CN-!zh_TW-!all-!serve-!live : build_md_translations {posargs} en translate : build_pot_translations --exclude=news translate : build_po_translations ar cs da de es fa fr it ja ko pl pt ru tr zh_CN zh_TW translate : update_machine_translations --soft-fail ar cs da de es fa fr it ja ko pl pt ru tr zh_CN zh_TW @@ -33,8 +33,8 @@ commands: pt : build_md_translations {posargs} pt ru : build_md_translations {posargs} ru tr : build_md_translations {posargs} tr - zh-cn : build_md_translations {posargs} zh_CN - zh-tw : build_md_translations {posargs} zh_TW + 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 ja ko pl pt ru tr zh_CN zh_TW serve : python -m http.server -d _build/html 8042 live : live_serve_en {posargs} --port=8042 From edce3053c8bcfd8fe6ba6f9bd631ff35deacfd7c Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:16:45 +0800 Subject: [PATCH 2/7] Update gitignore. --- .gitignore | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/.gitignore b/.gitignore index 9f04371019..2874ce0f01 100644 --- a/.gitignore +++ b/.gitignore @@ -7,7 +7,11 @@ comment.md .tox __pycache__ venv*/ -.envrc # macOS Finder artefacts .DS_Store + +# Local credentials +local/ +.envrc +.weblate From 15bba49de0e0dbe53b222b2657f861b9978f3e69 Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:16:57 +0800 Subject: [PATCH 3/7] Add README for docs-redirect. --- docs-redirect/README.md | 5 +++++ 1 file changed, 5 insertions(+) create mode 100644 docs-redirect/README.md diff --git a/docs-redirect/README.md b/docs-redirect/README.md new file mode 100644 index 0000000000..b656fe8fe7 --- /dev/null +++ b/docs-redirect/README.md @@ -0,0 +1,5 @@ +# docs.beeware.org + +This is a microsite that makes `https://docs.beeware.org` a redirection to `https://beeware.org/docs`. + +It has an [independent ReadTheDocs.org configuration](https://app.readthedocs.org/projects/docsbeewareorg/). From f7f696f1c6c2ce42deeb578e4a01d68f8893707b Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:17:45 +0800 Subject: [PATCH 4/7] Add some basic hosting information. --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 77122a3451..8e25b1ad18 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ This is the homepage for the [BeeWare project](http://beeware.org). -It is a [MkDocs](https://mkdocs.org)-based site. +It is a [MkDocs](https://mkdocs.org)-based site. The site is hosted on GitHub Pages, with PR builds being provided by ReadTheDocs. ## Getting started From 15dcc896a21496c2606725da4d701f4ab5554cd3 Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:19:56 +0800 Subject: [PATCH 5/7] More gitignore cleanups. --- .gitignore | 2 ++ 1 file changed, 2 insertions(+) diff --git a/.gitignore b/.gitignore index 2874ce0f01..eb5d27557d 100644 --- a/.gitignore +++ b/.gitignore @@ -2,9 +2,11 @@ _build comment.md +# IDEs and oather build artefacts .idea .rumdl_cache .tox +.vscode __pycache__ venv*/ From 60159dcea332544937a683bc42a77a4ad6d3430c Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:24:44 +0800 Subject: [PATCH 6/7] Only publish or translate if on the original fork --- .github/workflows/publish.yml | 1 + .github/workflows/translate.yml | 2 +- 2 files changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/workflows/publish.yml b/.github/workflows/publish.yml index 189b92a6aa..389abfabbb 100644 --- a/.github/workflows/publish.yml +++ b/.github/workflows/publish.yml @@ -20,6 +20,7 @@ env: jobs: publish: name: Build and publish site + if: github.repository == 'beeware/beeware.github.io' permissions: contents: write runs-on: ubuntu-latest diff --git a/.github/workflows/translate.yml b/.github/workflows/translate.yml index dc8da23938..121408e36f 100644 --- a/.github/workflows/translate.yml +++ b/.github/workflows/translate.yml @@ -14,7 +14,7 @@ env: jobs: update-translations: name: Update Translations - if: github.actor != 'brutusthebee' + if: github.repository == 'beeware/beeware.github.io' && github.actor != 'brutusthebee' runs-on: ubuntu-latest steps: - name: Checkout From b4f1ed44f385922c02eac4508cc875b82f3e7bd3 Mon Sep 17 00:00:00 2001 From: Russell Keith-Magee Date: Tue, 3 Mar 2026 13:27:41 +0800 Subject: [PATCH 7/7] Add ReadTheDocs to spelling list. --- docs/spelling_wordlist | 1 + 1 file changed, 1 insertion(+) diff --git a/docs/spelling_wordlist b/docs/spelling_wordlist index b8090865df..d8bebae0b5 100644 --- a/docs/spelling_wordlist +++ b/docs/spelling_wordlist @@ -128,6 +128,7 @@ PythonAnywhere Pythonista README READMEs +ReadTheDocs RIAA Rackspace SBOM