Initial scaffold for ml translation

Author: mmcky

.github/workflows/rebase-translations.yml

@@ -0,0 +1,65 @@
+# Rebase Translation PRs
+#
+# Install this workflow in the TARGET (translated) repository.
+# When a translation PR is merged, this workflow automatically rebases the
+# other open translation PRs against the updated main branch. It covers both
+# kinds this tool creates: `translation-sync-*` branches from the Action's sync
+# mode, and `resync/*` branches from the CLI's `translate forward --github`.
+#
+# This eliminates merge conflicts caused by multiple upstream PRs
+# modifying the same files. See: https://github.com/QuantEcon/action-translation/issues/63
+#
+# Place this file at: .github/workflows/rebase-translations.yml
+
+name: Rebase Translation PRs
+
+on:
+  pull_request:
+    types: [closed]
+
+jobs:
+  rebase:
+    # Only run when a translation PR is merged. Both prefixes must be listed:
+    # sync mode creates `translation-sync-*`, while the CLI's `translate forward --github`
+    # creates `resync/*`, and a wave of resync PRs goes stale the same way.
+    # Keep this in step with `isTranslationBranch` in the action's src/branch-naming.ts
+    # — this `if` decides whether the job runs, that predicate decides which open PRs
+    # it then rebases, so a prefix matching only one of them is a no-op run.
+    # The head-repo check is belt-and-braces: fork PRs never receive secrets, so
+    # the PAT is not exposed either way — but a merged fork PR whose branch happens
+    # to match a prefix would otherwise start this job with an empty token and fail
+    # red. Same-repo branches matching these prefixes only come from the tooling.
+    if: >
+      github.event.pull_request.merged == true &&
+      github.event.pull_request.head.repo.full_name == github.repository &&
+      (startsWith(github.event.pull_request.head.ref, 'translation-sync-') ||
+       startsWith(github.event.pull_request.head.ref, 'resync/'))
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: write
+      pull-requests: write
+
+    # Prevent concurrent rebases from overlapping
+    concurrency:
+      group: rebase-translations
+      cancel-in-progress: false
+
+    steps:
+      - name: Rebase open translation PRs
+        uses: QuantEcon/action-translation@v0
+        with:
+          mode: rebase
+          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          # Commits pushed with the default GITHUB_TOKEN do not trigger workflows
+          # (GitHub's recursion guard), so rebased/refreshed branches will get their
+          # new commit but NO CI runs on it. If checks must re-run — and with
+          # required checks a run-less head blocks merging — pass a PAT or App
+          # token here instead, as the sync workflows do.
+          github-token: ${{ secrets.GITHUB_TOKEN }}
+          # Uncomment during a drift-recovery wave. `forward` opens one PR per lecture,
+          # so siblings never share a file and none of them are conflict-rebased — but
+          # every merge still leaves their checks stale. This refreshes them against the
+          # new base without re-translating. Off by default: mid-wave it touches every
+          # other open PR on every merge. See action-translation#123.
+          # rebase-stale-siblings: 'true'

.github/workflows/review-translations.yml

@@ -0,0 +1,54 @@
+# Review Translation PRs
+#
+# Install this workflow in the TARGET (translated) repository at:
+#   .github/workflows/review-translations.yml
+#
+# It posts an AI quality review on every translation PR the sync opens.
+# The review's target language is not an input: it is detected from the
+# repository-name suffix (lecture-python-intro.zh-cn -> zh-cn).
+#
+# This file is the single canonical template: `translate setup` scaffolds
+# new target repos from it (substituting source-repo, source-language and
+# docs-folder), and the docs quote the same shape. A drift test
+# (src/cli/__tests__/workflow-templates.test.ts) keeps every copy aligned.
+
+name: Review Translations
+
+on:
+  pull_request:
+    types: [opened, synchronize, labeled, reopened]
+
+jobs:
+  review:
+    # `labeled` in the trigger list matters: the sync applies its labels after
+    # opening the PR, so without it a PR labeled late is never reviewed. The
+    # second clause then ignores `labeled` events for every OTHER label — a
+    # sync applies labels one call at a time, and each would otherwise start
+    # a full (billed) review of the same diff (#96).
+    if: >
+      contains(github.event.pull_request.labels.*.name, 'action-translation') &&
+      (github.event.action != 'labeled' || github.event.label.name == 'action-translation')
+    runs-on: ubuntu-latest
+
+    permissions:
+      contents: read
+      pull-requests: write
+
+    # One review per PR — supersede an in-flight review instead of running both
+    concurrency:
+      group: review-translations-${{ github.event.pull_request.number }}
+      cancel-in-progress: true
+
+    steps:
+      - uses: actions/checkout@v7
+        with:
+          fetch-depth: 2
+
+      - uses: QuantEcon/action-translation@v0
+        with:
+          mode: review
+          source-repo: 'QuantEcon/lecture-python-programming'
+          source-language: 'en'
+          docs-folder: 'lectures'
+          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github-token: ${{ secrets.GITHUB_TOKEN }}

.gitignore

@@ -0,0 +1,10 @@
+# Build outputs
+_build/
+__pycache__/
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Environment
+.env

.translate/config.yml

@@ -0,0 +1,4 @@
+source-language: en
+target-language: ml
+docs-folder: lectures
+tool-version: 0.24.0

README.md

@@ -0,0 +1,5 @@
+# lecture-python-programming.ml
+
+ml translation of [QuantEcon/lecture-python-programming](https://github.com/QuantEcon/lecture-python-programming).
+
+Generated by [`translate setup`](https://github.com/QuantEcon/action-translation).