Add ko localization, sync docs.json, and update node docs by OneVth · Pull Request #1109 · Comfy-Org/docs

OneVth · 2026-06-06T21:10:45Z

Summary

This PR adds full Korean (ko) localization of the ComfyUI documentation: 1,126 pages plus 42 snippet files. Translations were produced from the English source using qwen-mt-turbo with a deterministic post-processing pass.

What's included

Content

ko/ — 1,126 translated pages
snippets/ko/ — 42 translated snippets

Infrastructure

docs.json — Korean language group added to navigation.languages (en / zh / ja / ko)
.github/scripts/check-ko.ts — Korean translation quality checker (Hangul ratio + leaked-English detection), mirroring check-ja.ts
.github/workflows/ko-sync-check.yml — PR-time sync check, mirroring the existing ja-sync-check.yml / zh-cn-sync-check.yml
.github/scripts/translation-config.json — ko registered in the languages list
.github/workflows/translation-sync.yml — ko/ and snippets/ko/ added to the git-add step so the automated sync commits Korean changes
giscus-comments.js — Korean branch for the comment widget notices

Auto-sync enrollment

Korean is wired into both existing translation mechanisms:

PR-time check — ko-sync-check.yml warns when an English page changes without a matching Korean update, the same way ja-sync-check.yml and zh-cn-sync-check.yml already do.
Post-merge sync — registering ko in translation-config.json and adding ko/ / snippets/ko/ to the git-add step in translation-sync.yml enrolls Korean in the automated translate-sync pipeline, so it stays in sync as English docs evolve.

If you'd prefer to land the content first and review the auto-sync enrollment separately, the translation-config.json and translation-sync.yml changes are isolated to two commits and can be split out.

Test plan

docs.json is valid JSON; every Korean page path maps 1:1 to a file on disk (no missing pages)
mint dev — 0 parse errors across ko/ and snippets/ko/
Language switcher shows Korean; ko/ pages render, including the JSX-heavy ko/index.mdx
mint broken-links — 0 broken links (Korean internal links resolve with the /ko/ prefix)
check-ko.ts — 0 failures
giscus comment notices display in Korean on /ko/ pages

… detection)

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

번역 후처리에서 누락된 description frontmatter 따옴표를 복원합니다. ko/ 및 snippets/ko/ 전체 MDX 파일 697건을 일괄 수선. 특히 ko/custom-nodes/js/subgraphs.mdx는 ': ' 포함으로 YAML 파싱 실패 상태였음. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

07a 빌드 검증에서 발견된 21건의 파싱 에러를 EN 원본 대조 기반으로 복원. 번역 내용은 그대로 유지하고 구조만 복원. 타입1: 닫힘 태그 누락 6건 (</Note>, </Warning>) - ko/account/delete-account.mdx - ko/custom-nodes/workflow_templates.mdx - ko/installation/system_requirements.mdx - ko/support/payment/accepted-payment-methods.mdx - ko/tutorials/basic/upscale.mdx - snippets/ko/install/desktop-resource-warning.mdx 타입2: JSX 내부 닫힘 태그 누락 7건 - ko/agent-tools/index.mdx (</Card>) - ko/cloud/import-models.mdx (</Accordion>) - ko/development/core-concepts/models.mdx (</Accordion>) - ko/get_started/cloud.mdx (</Card>) - ko/interface/settings/comfy.mdx (</Tab>) - ko/interface/settings/overview.mdx (</Card>) - snippets/ko/install/desktop-venv.mdx (</Tab>) 타입3: < 엔티티 → 리터럴 < 복원 17건 (4파일) - ko/built-in-nodes/AdjustBrightness.mdx - ko/built-in-nodes/AdjustContrast.mdx - ko/built-in-nodes/ElevenLabsTextToSpeech.mdx - ko/tutorials/partner-nodes/pricing.mdx 타입4: 플레이스홀더 백틱 감싸기 2건 - ko/manager/configuration.mdx - ko/development/core-concepts/custom-nodes.mdx 타입5: <Update> 미닫힘 + 속성명 오류 3건 - ko/changelog/index.mdx Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Resolves modify/delete conflict by keeping main's removal of translation-sync.yml.

…ing. Drop check-ko.ts and ko-sync-check.yml; Korean is covered by check-i18n-sync.mjs and translate-i18n.ts via translation-config.json.

built-in-nodes is maintained by embedded-docs and skipped by the i18n pipeline; point ko nav and internal links to English built-in-nodes pages instead.

Add hashes for 44 ko files that had translations but no metadata; leave 63 stale hashes unchanged so batch translate still picks up EN updates.

Restore missing closing brace and fence lost during initial Korean translation.

…n path rules. Move translation scripts into a dedicated folder, add truncation scan/repair and shared i18n-config, fix language path handling for new locales, and reorganize contributing READMEs into readme/.

…ions. Fix chunked path localization and checkpoint each translated <Update> block to disk so ja/zh/ko changelog runs can resume without losing progress.

…ation. Add sync-docs-json and nav-label-translate modules, centralize translate log paths, and run nav sync at end of translate.

Sync page paths and translated group/tab titles with the English navigation structure.

Batch translation sync for Korean content, ja/zh built-in node pages, and related locale updates.

Gitignore the new log directory and document .txt/json log filenames in EN and locale readmes.

Default npm run translate now processes pages then snippets in one run; add --pages-only to skip snippets and keep --snippets for snippets-only.

…eference. Skip API calls for already-localized tab/group titles and include the existing map in batch prompts for consistent new labels.

Repair truncated startup-flags and ernie-image accordions, clean ja shortcuts frontmatter, and add ko desktop migrate/update snippets plus ja/zh generate snippet translations.

Normalize docs.json paths via i18n sync (case-correct EN entries, prune missing ko nav), raise Mintlify dev heap and skip OpenAPI locally, and fix ko/snippet Step nesting plus giscus ja/ko exclusions.

Exclude dependency and local tooling paths so pnpm dev no longer floods the terminal with MDX parsing errors from package changelogs.

comfyui-wiki · 2026-06-08T14:45:37Z

Thank you, @OneVth

Add missing ko/built-in-nodes/overview page and nav entry, and exclude readme/ from Mintlify link checks since those files are GitHub-only.

OneVth · 2026-06-09T02:18:56Z

Thanks for adapting it to the new i18n tooling and merging it in! Glad the Korean docs are live now. Happy to help keep them polished going forward.

OneVth and others added 25 commits June 7, 2026 01:48

feat(ko): add Korean documentation translations (00A-00B)

771b9a4

feat(ko): register Korean language in docs.json navigation

1740d8c

feat(ko): add check-ko.ts quality checker (Hangul rate + English-leak…

fe17238

… detection)

feat(ko): register ko in translation-config for auto-sync

59d66d9

fix(ko): include ko/ in translation-sync git add (pairs with config)

858f48f

ci(ko): add ko-sync-check workflow (EN↔ko, no cross-lang)

6b8bf5b

feat(ko): add Korean branch to giscus comment widget

23dbc44

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

Merge origin/main into pr/1109, preferring main on conflicts.

61e5549

Resolves modify/delete conflict by keeping main's removal of translation-sync.yml.

Remove redundant ko-specific CI scripts in favor of unified i18n tool…

ae6acb6

…ing. Drop check-ko.ts and ko-sync-check.yml; Korean is covered by check-i18n-sync.mjs and translate-i18n.ts via translation-config.json.

Remove Korean built-in-nodes translations.

c1ff365

built-in-nodes is maintained by embedded-docs and skipped by the i18n pipeline; point ko nav and internal links to English built-in-nodes pages instead.

Seed translationSourceHash on synced Korean translations only.

9b17e3c

Add hashes for 44 ko files that had translations but no metadata; leave 63 stale hashes unchanged so batch translate still picks up EN updates.

Fix truncated JavaScript code block in ko comms_routes.mdx.

6a33186

Restore missing closing brace and fence lost during initial Korean translation.

Consolidate i18n tooling under .github/scripts/i18n with config-drive…

c2995ef

…n path rules. Move translation scripts into a dedicated folder, add truncation scan/repair and shared i18n-config, fix language path handling for new locales, and reorganize contributing READMEs into readme/.

Write changelog translation blocks incrementally to survive interrupt…

6690036

…ions. Fix chunked path localization and checkpoint each translated <Update> block to disk so ja/zh/ko changelog runs can resume without losing progress.

Sync docs.json navigation after translate with batch nav label transl…

fbdd25a

…ation. Add sync-docs-json and nav-label-translate modules, centralize translate log paths, and run nav sync at end of translate.

Update docs.json navigation for ko, ja, and zh locale sidebars.

4652259

Sync page paths and translated group/tab titles with the English navigation structure.

Update ko, ja, zh, and built-in-nodes MDX translations.

be62a24

Batch translation sync for Korean content, ja/zh built-in node pages, and related locale updates.

Move translate run logs to .github/i18n-logs and update README paths.

0cbb834

Gitignore the new log directory and document .txt/json log filenames in EN and locale readmes.

Run snippet translation in the default translate command.

7d8311a

Default npm run translate now processes pages then snippets in one run; add --pages-only to skip snippets and keep --snippets for snippets-only.

Preserve existing docs.json nav labels and pass them as translation r…

0b2538f

…eference. Skip API calls for already-localized tab/group titles and include the existing map in batch prompts for consistent new labels.

Fix ko MDX parse errors and add missing ko desktop snippets.

5876121

Repair truncated startup-flags and ernie-image accordions, clean ja shortcuts frontmatter, and add ko desktop migrate/update snippets plus ja/zh generate snippet translations.

Fix nav casing, local preview memory, and ko Steps MDX warnings.

022bf65

Normalize docs.json paths via i18n sync (case-correct EN entries, prune missing ko nav), raise Mintlify dev heap and skip OpenAPI locally, and fix ko/snippet Step nesting plus giscus ja/ko exclusions.

Add .mintignore to stop Mintlify from parsing node_modules markdown.

2c747f6

Exclude dependency and local tooling paths so pnpm dev no longer floods the terminal with MDX parsing errors from package changelogs.

comfyui-wiki changed the title ~~Add Korean (ko) localization~~ Add ko localization, sync docs.json, and update node docs Jun 8, 2026

Fix mint broken-links CI for ko overview and readme paths.

6e95da8

Add missing ko/built-in-nodes/overview page and nav entry, and exclude readme/ from Mintlify link checks since those files are GitHub-only.

comfyui-wiki merged commit 1b460cf into Comfy-Org:main Jun 8, 2026
6 checks passed

OneVth deleted the ko-i18n branch June 9, 2026 04:00

OneVth mentioned this pull request Jun 11, 2026

fix(ko): point snippet imports to ko versions #1136

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add ko localization, sync docs.json, and update node docs#1109

Add ko localization, sync docs.json, and update node docs#1109
comfyui-wiki merged 26 commits into
Comfy-Org:mainfrom
OneVth:ko-i18n

OneVth commented Jun 6, 2026

Uh oh!

comfyui-wiki commented Jun 8, 2026 •

edited

Loading

Uh oh!

Uh oh!

OneVth commented Jun 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

Conversation

OneVth commented Jun 6, 2026

Summary

What's included

Auto-sync enrollment

Test plan

Uh oh!

comfyui-wiki commented Jun 8, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

OneVth commented Jun 9, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

comfyui-wiki commented Jun 8, 2026 •

edited

Loading