Add translations setup by m-aciek · Pull Request #20 · m-aciek/python-docs-offline

m-aciek · 2026-04-15T20:41:31Z

Packages needed for Japanese PDF: python/docsbuild-scripts#149 (comment)

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/a72a4fa7-534f-4313-8fff-989a4f4eec5e Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…ce in prepare Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/22650f24-fed8-48df-870d-6d2777a9e279 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/3ab50848-fa91-4a70-a81c-8eac790c6904 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…pace parse error Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/26f2978c-3a6a-46a2-a47d-9748069226ea Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…latex_engine override Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/1fd2e033-293a-45c6-93d8-06b89a3f10a8 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…nslation files Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/83105c4e-e0e6-47ff-8974-744ccb96b270 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…n Sphinx version Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/207833af-6022-4aed-bf78-59b3741731d5 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/f0fb8aea-7cf2-4fdf-99b7-d83d3745c980 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/307e8acc-650b-42e6-a2e9-e39842abeade Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/3e456ad8-89a6-444b-b3d2-38913d2e7c37 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/2611dcc8-d8af-4048-8b27-a106eff342f0 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…ja luaotfload packages Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/1260f0b8-d528-44d5-a046-1241a8aec3fe Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 057be18d98

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…how it works Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/e2ac249b-d85c-4bb8-a859-73da4bbb285b Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…ix=False) Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/f702db87-f295-4b02-8155-318f2ac25d0b Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

m-aciek · 2026-04-20T23:42:48Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: fd5dfb615e

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

…rwrites Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/dec1a8ed-0cc9-42c4-bc71-e4d02fa3b64a Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…ies" This reverts commit 551b615.

m-aciek · 2026-04-21T20:30:13Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 551b615946

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

… language Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/cd79b93b-6d1a-4eff-a490-a298f00eb5a4 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

…inor> Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/45f4f268-2d71-465b-ab7b-04153e4758b8 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

m-aciek · 2026-04-22T17:57:19Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: e5d68dc403

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-04-22T18:02:17Z

+          artifacts = Path("artifacts")
+          site = Path("_site")
+          name_re = re.compile(
+              r"^python-(\d+\.\d+)[\d.]*(?:-(?!docs|pdf)([a-zA-Z][a-zA-Z0-9_-]*))?-(?:docs|pdf)"


Parse language tag correctly for translated PDF artifacts

The artifact regex here allows hyphens inside the language capture, so translated PDF names like python-3.14.0-fr-docs-pdf-a4.zip are parsed with language fr-docs (the capture greedily consumes -docs and leaves -pdf for the suffix). That sends translated PDFs to _site/fr-docs/<version>/ instead of _site/fr/<version>/, so PDF downloads are missing from the expected language directory.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-04-22T18:02:17Z

+          artifacts = Path("artifacts")
+          site = Path("_site")
+          name_re = re.compile(
+              r"^python-(\d+\.\d+)[\d.]*(?:-(?!docs|pdf)([a-zA-Z][a-zA-Z0-9_-]*))?-(?:docs|pdf)"


Accept prerelease dist versions when routing artifacts

This pattern only allows [\d.]* after <major.minor>, so filenames that include prerelease suffixes (for example python-3.16.0a0-docs-html.zip) do not match and are skipped. Because the matrix includes non-EOL/non-planned branches, prerelease branches can still be built, and their artifacts will never be copied into _site when the dist version contains a, b, or rc markers.

Useful? React with 👍 / 👎.

We don't expect prerelease suffixes, 3.11+ returns major.minor always.

chatgpt-codex-connector · 2026-04-22T18:02:17Z

+              if not link.exists() and not link.is_symlink():
+                  link.symlink_to(Path("en") / version_dir.name)


Replace existing bare-version paths during compatibility setup

The compatibility symlink is only created when a bare version path does not already exist. On migration runs, _site/<major_minor> already exists from the previous layout, so this condition skips it while new artifacts are now written to _site/en/<major_minor>. As a result, old URLs like /3.14/ keep serving stale content instead of tracking the newly published English artifacts.

Useful? React with 👍 / 👎.

…tifact regex Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/7cf2716e-7fd0-4fec-8e64-ee88acb4f0a2 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

m-aciek · 2026-04-30T23:11:47Z

@codex review

chatgpt-codex-connector

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 1810ec4717

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

Open a pull request for review
Mark a draft as ready
Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

chatgpt-codex-connector · 2026-04-30T23:20:01Z

+          artifacts = Path("artifacts")
+          site = Path("_site")
+          name_re = re.compile(
+              r"^python-(\d+\.\d+)[\d.]*(?:-(?!docs|pdf)([a-zA-Z][a-zA-Z0-9_]*))?-(?:docs|pdf)"


Accept prerelease versions when parsing artifact filenames

This regex only permits digits and dots after X.Y, so filenames like python-3.15.0a1-docs-html.zip (the normal format for docs built from main/prerelease branches) fail to match and are silently skipped in the copy loop. Because get-versions includes non-planned/non-end-of-life releases, prerelease branches are part of the matrix, so their artifacts will not be published at all.

Useful? React with 👍 / 👎.

chatgpt-codex-connector · 2026-04-30T23:20:01Z

+              if not link.exists() and not link.is_symlink():
+                  link.symlink_to(Path("en") / version_dir.name)


Replace existing bare version dirs with compatibility symlinks

The compatibility step only creates _site/<major.minor> -> en/<major.minor> links when the bare path does not already exist. On existing deployments, _site/<major.minor> is already a real directory from the previous layout, so no symlink is created and those legacy URLs keep serving stale artifacts while new builds are written only under _site/en/<major.minor>.

Useful? React with 👍 / 👎.

Copilot AI and others added 3 commits April 15, 2026 15:26

Add translation matrix and config-driven sphinxopts to docs builds

26518ab

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/a72a4fa7-534f-4313-8fff-989a4f4eec5e Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Use actions/checkout for language repo; resolve translation branch on…

adf6305

…ce in prepare Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/22650f24-fed8-48df-870d-6d2777a9e279 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Deploy to <language>/<version>/ layout; filenames without language tag

dc1f59f

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/3ab50848-fa91-4a70-a81c-8eac790c6904 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot started work on behalf of m-aciek April 15, 2026 21:17 View session

fix: split -D sphinx opts into separate list items to avoid leading-s…

92e7e00

…pace parse error Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/26f2978c-3a6a-46a2-a47d-9748069226ea Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 15, 2026 21:21

Copilot started work on behalf of m-aciek April 16, 2026 14:27 View session

fix: shlex.split config_sphinxopts entries to avoid leading-space in …

d164d25

…latex_engine override Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/1fd2e033-293a-45c6-93d8-06b89a3f10a8 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 16, 2026 14:32

Copilot started work on behalf of m-aciek April 16, 2026 15:32 View session

fix: correct locale_dirs from ../locale to locale so Sphinx finds tra…

5158007

…nslation files Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/83105c4e-e0e6-47ff-8974-744ccb96b270 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 16, 2026 15:35

Copilot started work on behalf of m-aciek April 16, 2026 16:42 View session

Copilot finished work on behalf of m-aciek April 16, 2026 17:42

fix: exclude locale RST files and gate translation_progress_classes o…

66c2ba4

…n Sphinx version Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/207833af-6022-4aed-bf78-59b3741731d5 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot started work on behalf of m-aciek April 16, 2026 20:03 View session

fix: include default exclude_patterns when overriding for locale

18325c7

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/f0fb8aea-7cf2-4fdf-99b7-d83d3745c980 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 16, 2026 20:06

Copilot started work on behalf of m-aciek April 16, 2026 21:13 View session

fix: override SPHINXERRORHANDLING to avoid treating warnings as errors

126f22c

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/307e8acc-650b-42e6-a2e9-e39842abeade Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 16, 2026 21:37

Copilot started work on behalf of m-aciek April 17, 2026 08:53 View session

feat: install language-specific texlive packages for PDF builds

b12c4c2

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/3e456ad8-89a6-444b-b3d2-38913d2e7c37 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 17, 2026 08:57

Copilot started work on behalf of m-aciek April 17, 2026 09:50 View session

feat: dump LaTeX log tails on failure after make dist-pdf

0dd66e4

Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/2611dcc8-d8af-4048-8b27-a106eff342f0 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 17, 2026 10:32

Copilot started work on behalf of m-aciek April 17, 2026 13:39 View session

fix: normalize language tag for texlive matching and publishing; add …

cdad0b0

…ja luaotfload packages Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/1260f0b8-d528-44d5-a046-1241a8aec3fe Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 17, 2026 13:43

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread .github/workflows/build.yaml Outdated

docs: update README with project description, formats, versions, and …

5b3a4d1

…how it works Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/e2ac249b-d85c-4bb8-a859-73da4bbb285b Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 20, 2026 23:30

Copilot started work on behalf of m-aciek April 20, 2026 23:37 View session

fix: preserve backslashes in sphinxopts by using shlex.split(opt, pos…

fd5dfb6

…ix=False) Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/f702db87-f295-4b02-8155-318f2ac25d0b Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 20, 2026 23:40

chatgpt-codex-connector Bot reviewed Apr 20, 2026

View reviewed changes

Comment thread .github/workflows/schedule.yaml

Copilot started work on behalf of m-aciek April 20, 2026 23:53 View session

Copilot finished work on behalf of m-aciek April 21, 2026 01:39

Copilot AI and others added 3 commits April 21, 2026 01:43

fix: organize deploy output by language to prevent cross-language ove…

4255ea6

…rwrites Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/dec1a8ed-0cc9-42c4-bc71-e4d02fa3b64a Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

fix: add textlive-fonts-extra to Japanese PDF build dependencies

551b615

Revert "fix: add textlive-fonts-extra to Japanese PDF build dependenc…

d110b0b

…ies" This reverts commit 551b615.

chatgpt-codex-connector Bot reviewed Apr 21, 2026

View reviewed changes

Comment thread .github/workflows/schedule.yaml Outdated

Comment thread .github/workflows/schedule.yaml Outdated

Copilot started work on behalf of m-aciek April 22, 2026 13:39 View session

fix: match epub filenames and prevent docs/pdf from being captured as…

a9e096c

… language Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/cd79b93b-6d1a-4eff-a490-a298f00eb5a4 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 22, 2026 13:51

Copilot started work on behalf of m-aciek April 22, 2026 14:11 View session

feat: add backward-compat symlinks _site/<major_minor> -> en/<major_m…

e5d68dc

…inor> Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/45f4f268-2d71-465b-ab7b-04153e4758b8 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 22, 2026 14:18

chatgpt-codex-connector Bot reviewed Apr 22, 2026

View reviewed changes

Copilot started work on behalf of m-aciek April 30, 2026 22:47 View session

fix: remove hyphen from language capture to fix fr-docs parsing in ar…

1810ec4

…tifact regex Agent-Logs-Url: https://github.com/m-aciek/python-docs-offline/sessions/7cf2716e-7fd0-4fec-8e64-ee88acb4f0a2 Co-authored-by: m-aciek <9288014+m-aciek@users.noreply.github.com>

Copilot finished work on behalf of m-aciek April 30, 2026 22:50

chatgpt-codex-connector Bot reviewed Apr 30, 2026

View reviewed changes

m-aciek merged commit 3cde519 into main Apr 30, 2026
199 of 472 checks passed

m-aciek deleted the copilot/add-translations-setup branch April 30, 2026 23:22

		if not link.exists() and not link.is_symlink():
		link.symlink_to(Path("en") / version_dir.name)

Conversation

m-aciek commented Apr 15, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

m-aciek commented Apr 20, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

m-aciek commented Apr 21, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

Uh oh!

Uh oh!

m-aciek commented Apr 22, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Apr 22, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Apr 22, 2026

Choose a reason for hiding this comment

Uh oh!

m-aciek Apr 30, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Apr 22, 2026

Choose a reason for hiding this comment

Uh oh!

m-aciek commented Apr 30, 2026

Uh oh!

chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

💡 Codex Review

Uh oh!

chatgpt-codex-connector Bot Apr 30, 2026

Choose a reason for hiding this comment

Uh oh!

chatgpt-codex-connector Bot Apr 30, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

m-aciek commented Apr 15, 2026 •

edited

Loading