數位公民 tw variant + .alternates workflow linking

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: audreyt

.alternates

@@ -0,0 +1,6 @@
+# Alternate-language pairs (tab-separated).
+# Each line links two translations of the same talk.
+# The workflow sends alternate_filename in both directions on upload.
+2026-03-04-Ciudadanía-Digital.md	2026-03-04-數位公民.md
+2026-03-05-Good-enough-gardeners-must-harness-AI-teams-in-the-Year-of-the-Horse.md	2026-03-05-商周專欄-當你的部屬是一群「會社交」的-AI.md
+2026-03-13-A-Dialogue-on-Civic-AI.md	2026-03-13-仁工智慧對話.md

.github/workflows/upload-markdown-on-change.yml

@@ -62,6 +62,23 @@ jobs:
           event_name = os.environ.get("GITHUB_EVENT_NAME", "")
           ref_name = os.environ.get("GITHUB_REF_NAME", "")
 
+          # Parse .alternates file: bidirectional map of filename → alternate slug
+          alternates = {}
+          alt_path = workspace / ".alternates"
+          if alt_path.exists():
+            for line in alt_path.read_text(encoding="utf-8").splitlines():
+              line = line.strip()
+              if not line or line.startswith("#"):
+                continue
+              parts = line.split("\t")
+              if len(parts) == 2:
+                a, b = parts[0].strip(), parts[1].strip()
+                a_slug = pathlib.Path(a).stem.lower()
+                b_slug = pathlib.Path(b).stem.lower()
+                alternates[a] = b_slug
+                alternates[b] = a_slug
+            print(f"[debug] loaded {len(alternates)} alternate mappings")
+
           MAX_RETRIES = 3
           BASE_DELAY = 2  # seconds
 
@@ -164,6 +181,9 @@ jobs:
               "filename": rel_path,
               "markdown": markdown,
             }
+            if rel_path in alternates:
+              payload["alternate_filename"] = alternates[rel_path]
+              print(f"[debug] alternate for {rel_path}: {alternates[rel_path]}")
             data = json.dumps(payload).encode("utf-8")
             req = urllib.request.Request(
               endpoint,
@@ -209,6 +229,9 @@ jobs:
               "filename": rel_path,
               "markdown": markdown,
             }
+            if rel_path in alternates:
+              payload["alternate_filename"] = alternates[rel_path]
+              print(f"[debug] alternate for {rel_path}: {alternates[rel_path]}")
             data = json.dumps(payload).encode("utf-8")
             req = urllib.request.Request(
               endpoint,