Skip to content

docs(zh): localize English-prose Range cells - #211

Open
XdeaF wants to merge 1 commit into
Comfy-Org:mainfrom
XdeaF:docs/zh-range-prose
Open

XdeaF wants to merge 1 commit into
Comfy-Org:mainfrom
XdeaF:docs/zh-range-prose

Conversation

@XdeaF

@XdeaF XdeaF commented Oct 27, 2026

Copy link
Copy Markdown

What

Localizes the Range column in 10 Chinese node docs where the whole cell was still English prose
(Multiline text, Single image, Any value, ...).

Follow-up to #210, which noted that one subset of Range cells needed "a separate pass" because
their values are English prose rather than mechanical connectives like 0 to 100.

Scope

  • zh.md only
  • Range column only, one line per file
  • en.md, Data Type columns and every other locale untouched
  • 11 files changed, 11 insertions(+), 11 deletions(-)
Node Before After
BasicScheduler 9 options 9 个选项
BriaVideoGreenScreen Video file 视频文件
CheckpointLoaderSimple All model files found in the checkpoints folder checkpoints 文件夹中的全部模型文件
ComfyCloudMageFlowTurboTextToImageNode Free text 自由文本
ComfyNotNode Any value 任意值
CustomCombo Any integer (default: 0) 任意整数(默认:0)
Flux3TextToVideoNode Multiline text 多行文本
HeyGenCreateAvatarNode Single image 单张图像
LtxApi25AudioToVideo Single image 单张图像
MeshToFile3D Single mesh 单个网格
MetaMuseImageEditApi Any text with a minimum length of 1 character 任意文本,至少 1 个字符

Validation

python .github/scripts/check_md_format.py
  15360 files: 0 errors, 125 warnings (all pre-existing en.md fingerprint warnings)

python .github/scripts/check_doc_structure.py
  0 repaired, 0 defect(s) found

python docs-generation/scripts/fix_translation_preamble.py --check-only
  found: 0 files, 0 leaked lines

Note: --changed-only reports 0 files on Windows because check_md_format.py compares
Path.relative_to() output (backslashes) against git diff output (forward slashes). The
full-tree scan was run instead; Linux CI is unaffected.

Terminology choices

  • Multiline text → 多行文本 (matches 17 existing occurrences)
  • Single image → 单张图像 (9 existing occurrences)
  • Any value → 任意值
  • Free text → 自由文本, kept distinct from the existing Any text → 任意文本
  • 9 options → 9 个选项, keeping the count (repo precedent is often 提供多个选项)

Deliberately left alone: boolean cells (True or False) and the mechanical numeric ranges
(0.0 - 1.0 (step: 0.01)). No reviewed Chinese precedent exists for localized booleans, and the
numeric ones look like they belong to the remaining mechanical pass.

Happy to widen this to the rest of the zh prose cells, or to change any wording, before merge.

AI assistance

Drafted with an AI assistant; the diff was reviewed line by line and validated locally with the
three scripts above.

@github-actions

github-actions Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

✅ All contributors have signed the CLA. Thank you! This PR is ready to be merged.
Posted by the CLA Assistant Lite bot.

@coderabbitai

coderabbitai Bot commented Oct 27, 2026 •

Copy link
Copy Markdown

Review in Change Stack →

No actionable comments were generated in the recent review.

Recent review info
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: eafcdd61-a999-469b-a4f9-6d0221de8853
Commits

Reviewing files that changed from the base of the PR and between 8a2b92b and 1579f20.

Files selected for processing: 11
  • comfyui_embedded_docs/docs/BasicScheduler/zh.md
  • comfyui_embedded_docs/docs/BriaVideoGreenScreen/zh.md
  • comfyui_embedded_docs/docs/CheckpointLoaderSimple/zh.md
  • comfyui_embedded_docs/docs/ComfyCloudMageFlowTurboTextToImageNode/zh.md
  • comfyui_embedded_docs/docs/ComfyNotNode/zh.md
  • comfyui_embedded_docs/docs/CustomCombo/zh.md
  • comfyui_embedded_docs/docs/Flux3TextToVideoNode/zh.md
  • comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/zh.md
  • comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh.md
  • comfyui_embedded_docs/docs/MeshToFile3D/zh.md
  • comfyui_embedded_docs/docs/MetaMuseImageEditApi/zh.md

Included review availability: This review used your included allowance. Your plan provides up to 1 included review per hour; 0 remain after this review.

Walkthrough

Eleven Chinese node documentation pages replace English parameter descriptions or an option count with Chinese text. Parameter types, defaults, ranges, and behavior remain unchanged.

Changes: Chinese documentation translations

Layer / File(s) Summary
Translate parameter descriptions
comfyui_embedded_docs/docs/BasicScheduler/zh.md, comfyui_embedded_docs/docs/BriaVideoGreenScreen/zh.md, comfyui_embedded_docs/docs/CheckpointLoaderSimple/zh.md, comfyui_embedded_docs/docs/ComfyCloudMageFlowTurboTextToImageNode/zh.md, comfyui_embedded_docs/docs/ComfyNotNode/zh.md, comfyui_embedded_docs/docs/CustomCombo/zh.md, comfyui_embedded_docs/docs/Flux3TextToVideoNode/zh.md, comfyui_embedded_docs/docs/HeyGenCreateAvatarNode/zh.md, comfyui_embedded_docs/docs/LtxApi25AudioToVideo/zh.md, comfyui_embedded_docs/docs/MeshToFile3D/zh.md, comfyui_embedded_docs/docs/MetaMuseImageEditApi/zh.md
The pages translate parameter descriptions or an option count into Chinese. Stated parameter values and behavior are unchanged.

Suggested reviewers: lin-bot23

Priority: Low

Merge Risk: Minimal · up to 1579f

This documentation-only change has no identified merge-blocking risk.

Pre-merge checks: Passed 2
Check name Status Explanation
Linked Issues check Passed Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check Passed Check skipped because no linked issues were found for this pull request.
Finishing Touches: 💡 1
🛠️ Fix failing CI checks: 💡
  • Commit to this branch
  • Create a new PR
🧪 Generate unit tests (beta)
  • Create a new PR
✨ Simplify code
  • Create a new PR
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Comment @coderabbitai help to get the list of available commands.

@XdeaF

XdeaF commented Oct 27, 2026

Copy link
Copy Markdown
Author

I have read and agree to the Contributor License Agreement

1 similar comment
@XdeaF

XdeaF commented Oct 27, 2026

Copy link
Copy Markdown
Author

I have read and agree to the Contributor License Agreement

comfy-legal added a commit to Comfy-Org/comfy-cla that referenced this pull request Oct 27, 2026
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