Skip to content

提议:为全部节点文档添加英文翻译(中文文档保持不变)| Proposal: English translations for all node docs (Chinese docs untouched) #21

Description

@Delcado19

你好 cavinHuang 👋

非常感谢你做的这个文档项目 —— 它对 ComfyUI 社区帮助很大。我们 fork 了仓库(Delcado19/comfyui-nodes-docs),做了一些工作,想先来征求你的意见,看看你是否有兴趣。

我们做了什么

  • 把全部约 3553 个节点文档翻译成了英文,生成并行的 *_en.md 文件。中文原文完全没有改动。
  • 语言切换跟随 ComfyUI 现有的 Comfy.Locale 设置:zh* → 中文原文,其它语言 → 英文;找不到译文时自动回退到中文(零回归,对现有中文用户没有任何影响)。
  • 代码上只改了两个文件(server/request.pyweb/comfyui/creatDocsElement.js),其余都是新增的 *_en.md
  • 附带了翻译脚本,方便以后给新增文档补英文。

坦诚说明

  • 英文目前是机器翻译的初版,质量可用但欢迎社区进一步润色。
  • 我们不是中文母语者,本 issue 的中文部分借助了 AI 辅助,若措辞有不妥之处,敬请谅解 🙏

分支在这里:https://github.com/Delcado19/comfyui-nodes-docs/tree/feat/english-locale-docs

想请教你
你是否欢迎我们提一个 PR?还是更希望我们以 fork 的形式单独维护英文版?两种方式我们都很乐意配合。

(另外有一个可选的小改动:把文档里内嵌的源码替换成指向对应仓库的链接,让文档更轻、不易过时 —— 这部分完全独立,如果你更喜欢保留内嵌源码,我们可以去掉。)


Hi cavinHuang 👋

Thanks a lot for this docs project — it's a big help to the ComfyUI community. We've forked the repo (Delcado19/comfyui-nodes-docs) and done some work we'd like to run by you first.

What we did

  • Translated all ~3553 node docs into English as parallel *_en.md files. The Chinese sources are completely untouched.
  • Language follows ComfyUI's existing Comfy.Locale setting: zh* → Chinese source, any other locale → English, with a fallback to Chinese when no translation exists (zero regression — Chinese users see no change).
  • Only two code files changed (server/request.py, web/comfyui/creatDocsElement.js); everything else is additive *_en.md.
  • Includes the translation tooling so future docs can be translated by anyone.

Full transparency

  • The English is a machine-translated first pass — usable, but the community is welcome to refine it.
  • We are not native Chinese speakers; the Chinese above was AI-assisted, so please forgive any awkward wording 🙏

Branch: https://github.com/Delcado19/comfyui-nodes-docs/tree/feat/english-locale-docs

Our question
Would you welcome a PR? Or would you prefer we maintain the English edition as a separate fork? We're happy either way.

(There's also an optional smaller change: replacing the embedded source code in docs with links to each node's repo, to keep docs lean and current. It's fully separable — if you'd rather keep the embedded source, we can drop it.)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions