fix(crowdin): normalize repo locale codes on upload

- replace the raw translation upload script with a Node wrapper that rewrites repo-facing locale aliases before invoking Crowdin
- previously maintainers had to know that the repo stores Chinese translations in i18n/zh while the Crowdin project only accepts the zh-CN language slug
- that mismatch made the documented pnpm upload command fail even when the underlying translation files and Crowdin config were otherwise correct
- the new wrapper strips pnpm's passthrough delimiter, normalizes zh to zh-CN, preserves other language codes as-is, and keeps the documented workflow aligned with the actual CLI behavior

Author: elibosley

README.md

@@ -245,7 +245,7 @@ Help translate Unraid Docs for the global community.
 * Follow the glossary and tone guidance in the [Style Guide](docs/contribute/style-guide.mdx)
 * Use `pnpm crowdin:upload` or `pnpm crowdin:upload:sources` after changing English source docs
 * Use `pnpm crowdin:upload:translations -- --language <lang>` after manually fixing files under `i18n/` so those fixes are pushed back to Crowdin before the next download
-* Use Crowdin project language codes for `<lang>`: `de`, `es`, `fr`, and `zh-CN` for the `i18n/zh` locale
+* The upload wrapper accepts the repo locale codes directly: use `de`, `es`, `fr`, and `zh` for `i18n/zh`; it normalizes `zh` to Crowdin's `zh-CN` project language code automatically
 * Use `pnpm crowdin:download` to pull the latest exported translations after uploads
 * `pnpm crowdin:sync` updates source strings and downloads translations, but it does not replace `crowdin:upload:translations` when you need to preserve manual translation fixes
 

package.json

@@ -22,7 +22,7 @@
     "postinstall": "pnpm rebuild sharp",
     "crowdin:upload": "crowdin upload sources --config crowdin.yml",
     "crowdin:upload:sources": "crowdin upload sources --config crowdin.yml",
-    "crowdin:upload:translations": "crowdin upload translations --config crowdin.yml",
+    "crowdin:upload:translations": "node scripts/crowdin-upload-translations.js",
     "crowdin:sync": "docusaurus write-translations && crowdin upload sources --config crowdin.yml && crowdin download --config crowdin.yml",
     "crowdin:download": "crowdin download --config crowdin.yml",
     "write-translations": "docusaurus write-translations"

scripts/crowdin-upload-translations.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+
+const { spawnSync } = require("node:child_process");
+
+function normalizeLanguageCode(language) {
+  if (!language) {
+    return language;
+  }
+
+  const lowered = language.toLowerCase();
+  if (lowered === "zh" || lowered === "zh-cn") {
+    return "zh-CN";
+  }
+
+  return language;
+}
+
+const rawArgs = process.argv.slice(2);
+const args = [];
+
+for (let index = 0; index < rawArgs.length; index += 1) {
+  const arg = rawArgs[index];
+
+  if (arg === "--") {
+    continue;
+  }
+
+  if (arg === "--language") {
+    args.push(arg, normalizeLanguageCode(rawArgs[index + 1]));
+    index += 1;
+    continue;
+  }
+
+  if (arg.startsWith("--language=")) {
+    const [, language] = arg.split("=", 2);
+    args.push(`--language=${normalizeLanguageCode(language)}`);
+    continue;
+  }
+
+  args.push(arg);
+}
+
+const result = spawnSync(
+  "crowdin",
+  ["upload", "translations", "--config", "crowdin.yml", ...args],
+  {
+    stdio: "inherit",
+    shell: true,
+  }
+);
+
+if (result.error) {
+  throw result.error;
+}
+
+process.exit(result.status ?? 1);