Skip to content

i18n: sync zh/ja/ko and es translations with upstream/main (2026-11-02) - #2220

Open
lin-bot23 wants to merge 3 commits into
Comfy-Org:mainfrom
lin-bot23:docs/i18n-sync-all-20261102
Open

lin-bot23 wants to merge 3 commits into
Comfy-Org:mainfrom
lin-bot23:docs/i18n-sync-all-20261102

Conversation

@lin-bot23

@lin-bot23 lin-bot23 commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

What

One consolidated translation sync for zh / ja / ko / es — 206 files, +4797 / -2995.

It replaces every open per-locale sync PR (all closed as superseded):

closed branch files
#2148 docs/i18n-es-sync-20261028 21
#2192 docs/i18n-es-sync-20261031 17
#2205 docs/i18n-es-sync-20261101 39
#2202 docs/i18n-sync-20261101 37
#2217 docs/i18n-es-sync-20261102 32
#2216 docs/i18n-sync-20261102 76
#2193 docs/i18n-sync-20261031 38
#2195 docs/i18n-es-sync-20261031-1211 40

Files were taken from the newest branch that touched them (later translation wins), then every gate was re-run on the merged result. Three files overlapped between the 10-31 and 11-01/11-02 batches and keep the newer version.

By locale

  • es — 128 files (+3805 / -2675): backlog down from 169 to ~60 pending pages
  • zh — 25 files (+328 / -104), ja — 25 (+331 / -110), ko — 26 (+329 / -105): translate-i18n.ts --dry-run reports 0 pending sections for these locales afterwards
  • snippets/es/intel-install.mdx, docs.json (newest nav from 11-02)

Fixes included

  • es/development/comfyui-server/api-examples.mdx: two <Card href> values still used the English heading slugs after the headings were translated → now the Spanish slugs.
  • es/development/cloud/api-reference.mdx: #tareas-simultáneas → #límites-de-simultaneidad (the target heading was translated).

Verification

gate result
check-structure-parity.ts Structure parity: OK
verify_content_parity.py (all changed files) 0 real gaps — two accepted differences: localized prose inside code blocks (troubleshooting/model-issues.mdx) and the metadata:/metadatos: token false positive (hunyuan3D-2.mdx)
check-anchors.py --file (all changed files) all OK
check-translation-truncation.ts nothing introduced: the one hit (es/troubleshooting/custom-node-issues.mdx) is inherited from the English source (7 fences in both)
translate-i18n.ts --dry-run zh/ja/ko 0 pending; es ~60 pending

Notes

  • No English content changes.
  • Going forward the daily job produces one branch/PR covering all four locales instead of separate es and zh/ja/ko PRs.

Review pass (2026-11-02)

A per-file review of all 204 localized pages against their English twins (20 reviewers, one page set each, coverage asserted by set equality) found 78 issues — 4 high, 4 medium, 70 low. The high/medium ones are fixed in 82c53928e, on top of a rebase onto current main:

  • zh / ko development/comfy-router/limitations.mdx — the generated "models without a pre-flight estimate" block was a stale snapshot (67 model ids vs 41 in English, incl. fal/crystal-upscaler, veed/clean-audio, kling/kling-v3*). Regenerated from the English source; sync-hash drift on both pages cleared.
  • es/troubleshooting/custom-node-issues.mdx — the four links inside the mermaid flowcharts still targeted the English slugs while the headings were translated, so every in-diagram link was dead (check-anchors.py skips fenced blocks, which is why CI was green). Re-pointed at the localized anchors.
  • ko/…/byteplus/dreamina-seedance-2-0-mini/code.mdx — committed translator scaffolding (Wait, I need to translate that too…, Then:, a raw field: "…" dump) rendered as page body; removed, and the id response field translated.
  • zh / ko development/comfy-router/reference.mdx — a list item had been merged into the previous bullet; split back.
  • es — 15 tutorial pages had already-translated alt= / Card title= values reverted to English by the sync (Vista previa del flujo de trabajo de … → … workflow preview); restored, and two ltx-2-3 headings re-reverted to English were restored too. A base-vs-head attribute-language diff now shows 0 pages carrying more English attribute values than before the PR.

Remaining 70 findings are wording/terminology consistency (one-off drift, untranslated single clauses) and are intentionally left alone — no reader is misled by them and bulk-replacing them is how new defects get introduced.

Gates re-run at 82c53928e: structure parity OK · anchors OK · validate-links OK · truncation unchanged (14 pre-existing hits, 13 in files this PR does not touch) · translate:sync-hash clean for the regenerated pages · all CI checks green including mint-checks.

@mintlify

mintlify Bot commented Nov 2, 2026 •

Copy link
Copy Markdown
Contributor

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit 82c5392.

Approve preview

@coderabbitai

coderabbitai Bot commented Nov 2, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

  • Run on-demand review

This review includes 206 billable files and costs up to $51.50.

View limit details

Learn how review limits work.

Review configuration:

Run configuration
  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: ASSERTIVE
  • Plan: Advanced
  • Run ID: a0a4ef6c-15ed-45e2-9a93-d825703a6463
Commits

Reviewing files that changed from the base of the PR and between 4bd7958 and 82c5392.

Files selected for processing: 206
  • docs.json
  • es/agent-tools/cli.mdx
  • es/agent-tools/partner-mcp.mdx
  • es/comfy-cli/getting-started.mdx
  • es/custom-nodes/backend/images_and_masks.mdx
  • es/custom-nodes/backend/lazy_evaluation.mdx
  • es/custom-nodes/backend/node-replacement.mdx
  • es/custom-nodes/i18n.mdx
  • es/custom-nodes/js/context-menu-migration.mdx
  • es/custom-nodes/js/javascript_commands_keybindings.mdx
  • es/custom-nodes/js/javascript_examples.mdx
  • es/custom-nodes/js/javascript_objects_and_hijacking.mdx
  • es/custom-nodes/js/javascript_selection_toolbox.mdx
  • es/custom-nodes/js/javascript_settings.mdx
  • es/custom-nodes/js/javascript_sidebar_tabs.mdx
  • es/custom-nodes/js/javascript_topbar_menu.mdx
  • es/custom-nodes/js/subgraphs.mdx
  • es/custom-nodes/walkthrough.mdx
  • es/development/cloud/api-reference.mdx
  • es/development/cloud/overview.mdx
  • es/development/comfy-router/api.mdx
  • es/development/comfy-router/higgsfield-byok.mdx
  • es/development/comfy-router/limitations.mdx
  • es/development/comfy-router/litellm.mdx
  • es/development/comfy-router/models.mdx
  • es/development/comfy-router/models/black-forest-labs/flux-pro-1-0-expand/code.mdx
  • es/development/comfy-router/models/bria/image-edit-product-virtual-tryon/code.mdx
  • es/development/comfy-router/models/fal/h3-max-turbo/code.mdx
  • es/development/comfy-router/models/higgsfield/higgsfield-genjutsu-motion-transfer-v1-0/code.mdx
  • es/development/comfy-router/models/kling/kling-image-o1/code.mdx
  • es/development/comfy-router/models/recraft/recraftv4-1-utility-vector/code.mdx
  • es/development/comfy-router/models/veed/fabric-1-0/code.mdx
  • es/development/comfy-router/models/veed/lipsync-2-0/code.mdx
  • es/development/comfy-router/models/veed/video-background-removal/code.mdx
  • es/development/comfy-router/quickstart.mdx
  • es/development/comfy-router/realtime.mdx
  • es/development/comfyui-server/api-examples.mdx
  • es/development/comfyui-server/api-key-integration.mdx
  • es/development/comfyui-server/startup-flags.mdx
  • es/development/deploy/cloud-usage.mdx
  • es/development/serverless/overview.mdx
  • es/installation/desktop/usage/manage.mdx
  • es/installation/desktop/usage/migrate.mdx
  • es/interface/features/subgraph.mdx
  • es/interface/settings/overview.mdx
  • es/registry/specifications.mdx
  • es/specs/workflow_json.mdx
  • es/troubleshooting/custom-node-issues.mdx
  • es/troubleshooting/model-issues.mdx
  • es/troubleshooting/overview.mdx
  • es/tutorials/3d/hunyuan3D-2.mdx
  • es/tutorials/3d/pixal3d.mdx
  • es/tutorials/3d/trellis2.mdx
  • es/tutorials/3d/triposplat.mdx
  • es/tutorials/audio/ace-step/ace-step-v1-5.mdx
  • es/tutorials/audio/ace-step/ace-step-v1.mdx
  • es/tutorials/audio/minimax/minimax-music-3.mdx
  • es/tutorials/audio/yue2/yue2.mdx
  • es/tutorials/basic/text-to-image.mdx
  • es/tutorials/controlnet/pose-controlnet-2-pass.mdx
  • es/tutorials/flux/flux-1-fill-dev.mdx
  • es/tutorials/flux/flux-1-kontext-dev.mdx
  • es/tutorials/flux/flux-1-uso.mdx
  • es/tutorials/flux/flux-2-dev.mdx
  • es/tutorials/flux/flux-2-klein.mdx
  • es/tutorials/flux/flux-3-klein.mdx
  • es/tutorials/image/anima/anima.mdx
  • es/tutorials/image/ernie-image/ernie-image.mdx
  • es/tutorials/image/hidream/hidream-e1.mdx
  • es/tutorials/image/hidream/hidream-i1.mdx
  • es/tutorials/image/krea/krea-2.mdx
  • es/tutorials/image/lens/lens.mdx
  • es/tutorials/image/mage-flow/mage-flow.mdx
  • es/tutorials/image/moss-image/moss-image.mdx
  • es/tutorials/image/ovis/ovis-image.mdx
  • es/tutorials/image/pixeldit/pixeldit.mdx
  • es/tutorials/image/qwen/qwen-image-2512.mdx
  • es/tutorials/image/qwen/qwen-image-edit.mdx
  • es/tutorials/image/qwen/qwen-image-layered.mdx
  • es/tutorials/image/z-image/z-image-turbo.mdx
  • es/tutorials/image/z-image/z-image.mdx
  • es/tutorials/llm/gemma4/gemma4.mdx
  • es/tutorials/llm/qwen/qwen3.mdx
  • es/tutorials/llm/qwen/qwen3_5.mdx
  • es/tutorials/partner-nodes/black-forest-labs/flux-1-kontext.mdx
  • es/tutorials/partner-nodes/bytedance/seedream-5-flash.mdx
  • es/tutorials/partner-nodes/bytedance/seedream-5-pro.mdx
  • es/tutorials/partner-nodes/fishaudio/drama-3.mdx
  • es/tutorials/partner-nodes/fishaudio/fish-audio.mdx
  • es/tutorials/partner-nodes/fishaudio/prompt-guide.mdx
  • es/tutorials/partner-nodes/google/gemini.mdx
  • es/tutorials/partner-nodes/ideogram/ideogram-v3.mdx
  • es/tutorials/partner-nodes/luma/luma-uni-1.mdx
  • es/tutorials/partner-nodes/magnific/overview.mdx
  • es/tutorials/partner-nodes/openai/dall-e-2.mdx
  • es/tutorials/partner-nodes/openai/dall-e-3.mdx
  • es/tutorials/partner-nodes/overview.mdx
  • es/tutorials/partner-nodes/pixverse/overview.mdx
  • es/tutorials/partner-nodes/quiver/overview.mdx
  • es/tutorials/partner-nodes/topaz/image-enhance-bloom-2.mdx
  • es/tutorials/partner-nodes/topaz/overview.mdx
  • es/tutorials/partner-nodes/topaz/video-enhance-starlight-precise-2-5.mdx
  • es/tutorials/partner-nodes/wavespeed/overview.mdx
  • es/tutorials/utility/depth-anything-3.mdx
  • es/tutorials/utility/marigold-v2.mdx
  • es/tutorials/utility/pose-detection-sdpose.mdx
  • es/tutorials/utility/sam3d-body.mdx
  • es/tutorials/utility/seedvr2.mdx
  • es/tutorials/video/bytedance/bernini-r.mdx
  • es/tutorials/video/hunyuan/hunyuan-video-1-5.mdx
  • es/tutorials/video/hunyuan/hunyuan-video.mdx
  • es/tutorials/video/kandinsky/kandinsky-5.mdx
  • es/tutorials/video/ltx/ltx-2-3.mdx
  • es/tutorials/video/ltx/ltx-2-5-dfr.mdx
  • es/tutorials/video/ltxv.mdx
  • es/tutorials/video/minimax/minimax-h3-fastvideo.mdx
  • es/tutorials/video/minimax/minimax-h3-fun-controlnet.mdx
  • es/tutorials/video/minimax/minimax-h3-multiframe.mdx
  • es/tutorials/video/minimax/minimax-h3-prompt-guide.mdx
  • es/tutorials/video/wan/fun-camera.mdx
  • es/tutorials/video/wan/fun-control.mdx
  • es/tutorials/video/wan/wan-animate-2.mdx
  • es/tutorials/video/wan/wan-causal-forcing.mdx
  • es/tutorials/video/wan/wan-move.mdx
  • es/tutorials/video/wan/wan2-2-animate.mdx
  • es/tutorials/video/wan/wan2-2-fun-control.mdx
  • es/tutorials/video/wan/wan2-2-fun-inp.mdx
  • es/tutorials/video/wan/wan2_2.mdx
  • es/tutorials/video/zai/scail2.mdx
  • ja/development/comfy-router/api.mdx
  • ja/development/comfy-router/limitations.mdx
  • ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
  • ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
  • ja/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
  • ja/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
  • ja/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
  • ja/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
  • ja/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
  • ja/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
  • ja/development/comfy-router/models/kling/kling-image-o1/code.mdx
  • ja/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
  • ja/development/comfy-router/models/kling/kling-v2-6/code.mdx
  • ja/development/comfy-router/models/kling/kling-v3-omni/code.mdx
  • ja/development/comfy-router/models/kling/kling-v3/code.mdx
  • ja/development/comfy-router/models/kling/kling-video-o1/code.mdx
  • ja/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
  • ja/development/comfy-router/models/kling/videos-lip-sync/code.mdx
  • ja/development/comfy-router/models/runway/gen4-image/code.mdx
  • ja/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
  • ja/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
  • ja/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
  • ja/development/comfy-router/models/xai/grok-imagine-image/code.mdx
  • ja/development/comfy-router/realtime.mdx
  • ja/development/comfy-router/reference.mdx
  • ko/development/comfy-router/api.mdx
  • ko/development/comfy-router/limitations.mdx
  • ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
  • ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
  • ko/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
  • ko/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
  • ko/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
  • ko/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
  • ko/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
  • ko/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
  • ko/development/comfy-router/models/kling/kling-image-o1/code.mdx
  • ko/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
  • ko/development/comfy-router/models/kling/kling-v2-6/code.mdx
  • ko/development/comfy-router/models/kling/kling-v3-omni/code.mdx
  • ko/development/comfy-router/models/kling/kling-v3/code.mdx
  • ko/development/comfy-router/models/kling/kling-video-o1/code.mdx
  • ko/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
  • ko/development/comfy-router/models/kling/videos-lip-sync/code.mdx
  • ko/development/comfy-router/models/runway/gen4-image/code.mdx
  • ko/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
  • ko/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
  • ko/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
  • ko/development/comfy-router/models/xai/grok-imagine-image/code.mdx
  • ko/development/comfy-router/queue.mdx
  • ko/development/comfy-router/realtime.mdx
  • ko/development/comfy-router/reference.mdx
  • snippets/es/intel-install.mdx
  • zh/development/comfy-router/api.mdx
  • zh/development/comfy-router/limitations.mdx
  • zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-260128/code.mdx
  • zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-fast-260128/code.mdx
  • zh/development/comfy-router/models/byteplus/dreamina-seedance-2-0-mini/code.mdx
  • zh/development/comfy-router/models/byteplus/dreamina-seedance-2-5-260628/code.mdx
  • zh/development/comfy-router/models/byteplus/seedance-1-0-pro-250528/code.mdx
  • zh/development/comfy-router/models/byteplus/seedance-1-0-pro-fast-251015/code.mdx
  • zh/development/comfy-router/models/byteplus/seedance-1-5-pro-251215/code.mdx
  • zh/development/comfy-router/models/kling/kling-3-0-turbo/code.mdx
  • zh/development/comfy-router/models/kling/kling-image-o1/code.mdx
  • zh/development/comfy-router/models/kling/kling-v2-5-turbo/code.mdx
  • zh/development/comfy-router/models/kling/kling-v2-6/code.mdx
  • zh/development/comfy-router/models/kling/kling-v3-omni/code.mdx
  • zh/development/comfy-router/models/kling/kling-v3/code.mdx
  • zh/development/comfy-router/models/kling/kling-video-o1/code.mdx
  • zh/development/comfy-router/models/kling/videos-avatar-image2video/code.mdx
  • zh/development/comfy-router/models/kling/videos-lip-sync/code.mdx
  • zh/development/comfy-router/models/runway/gen4-image/code.mdx
  • zh/development/comfy-router/models/xai/grok-imagine-image-2-0/code.mdx
  • zh/development/comfy-router/models/xai/grok-imagine-image-pro/code.mdx
  • zh/development/comfy-router/models/xai/grok-imagine-image-quality/code.mdx
  • zh/development/comfy-router/models/xai/grok-imagine-image/code.mdx
  • zh/development/comfy-router/realtime.mdx
  • zh/development/comfy-router/reference.mdx
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

lin-bot23 and others added 3 commits November 2, 2026 22:13
Single consolidated sync for the four published/translated locales: the
per-locale daily branches had piled up into six open PRs (Comfy-Org#2148, Comfy-Org#2192, Comfy-Org#2205,
Comfy-Org#2202, Comfy-Org#2217, Comfy-Org#2216) with 170 files between them, so they were merged here by
taking the newest version of every file and re-running the gates.

- zh/ja/ko: 75 files, 0 sections left pending
- es: 93 files + 1 snippet, pending backlog down from 169 to 97 pages
- fixed two links that pointed at English/renamed anchors
  (comfyui-server/api-examples.mdx, cloud/api-reference.mdx)
…he consolidated sync

Their files are disjoint from the ones already here (35 es + 35 zh/ja/ko); the
three overlapping pages keep the newer 11-01/11-02 translation.
- zh/ko comfy-router/limitations: regenerate the generated estimate-coverage
  block from the English source; the stale copy listed 67 model ids against
  English's 41 (fal/crystal-upscaler, veed/clean-audio, kling/kling-v3*, ...),
  telling readers those models cannot be priced.
- es troubleshooting/custom-node-issues: point the four mermaid in-diagram
  links at the localized anchors; they still targeted the English slugs, so
  every link inside the flowcharts was dead.
- ko dreamina-seedance-2-0-mini: drop the committed translator scaffolding
  ("Wait, I need to translate that too...") that rendered as page body and
  translate the id response field.
- zh/ko comfy-router/reference: restore the list item the rewrite merged into
  the previous bullet.
- es: restore the Spanish alt/card strings this sync reverted to English on
  15 tutorial pages, and two headings on ltx-2-3.
- refresh translationSourceHash for the two regenerated limitations pages.
@comfyui-wiki
comfyui-wiki force-pushed the docs/i18n-sync-all-20261102 branch from a0acddf to 82c5392 Compare November 2, 2026 14:16

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant