- English（en）
- 中文（简体）（zh）
- 中文（繁體）（zh-TW）
- Français（fr）
- 한국어（ko）
- Русский（ru）
- Español（es）
- 日本語（ja）
- العربية（ar）
- Deutsch（de）
- עברית（he）
- Italiano（it）
- فارسی（fa）
- Português (BR)（pt-BR）
- Türkçe（tr）
目录结构
在你的自定义节点下创建locales 文件夹，支持多种翻译文件类型：
your_custom_node/
├── __init__.py
├── your_node.py
└── locales/ # 国际化文件夹
├── en/ # 英语翻译（推荐作为基准）
│ ├── main.json # 通用英文翻译内容
│ ├── nodeDefs.json # 英文节点定义翻译
│ ├── settings.json # 可选：设置界面翻译
│ └── commands.json # 可选：命令翻译
├── zh/ # 中文翻译文件
│ ├── nodeDefs.json # 中文节点定义翻译
│ ├── main.json # 通用中文翻译内容
│ ├── settings.json # 中文设置界面翻译
│ └── commands.json # 中文命令翻译
├──...
nodeDefs.json - 节点定义翻译
例如下面是一个i18n-demo节点的Python定义示例：class I18nTextProcessor:
@classmethod
def INPUT_TYPES(cls):
return {
"required": {
"text": ("STRING", {
"multiline": True,
"default": "Hello World!",
"tooltip": "The original text content to be processed"
}),
"operation": (["uppercase", "lowercase", "reverse", "add_prefix"], {
"default": "uppercase",
"tooltip": "The text processing operation to be executed"
}),
"count": ("INT", {
"default": 1,
"min": 1,
"max": 10,
"step": 1,
"tooltip": "The number of times to repeat the operation"
}),
},
"optional": {
"prefix": ("STRING", {
"default": "[I18N] ",
"multiline": False,
"tooltip": "The prefix to add to the text"
}),
}
}
RETURN_TYPES = ("STRING",)
RETURN_NAMES = ("processed_text",)
FUNCTION = "process_text"
CATEGORY = "I18n Demo"
DESCRIPTION = "A simple i18n demo node that demonstrates text processing with internationalization support"
def process_text(self, text, operation, count, prefix=""):
try:
result = text
for _ in range(count):
if operation == "uppercase":
result = result.upper()
elif operation == "lowercase":
result = result.lower()
elif operation == "reverse":
result = result[::-1]
elif operation == "add_prefix":
result = prefix + result
return (result,)
except Exception as e:
print(f"I18nTextProcessor error: {e}")
return (f"Error: {str(e)}",)
{
"I18nTextProcessor": {
"display_name": "国际化文本处理器",
"description": "一个简单的国际化演示节点，展示支持国际化的文本处理功能",
"inputs": {
"text": {
"name": "文本输入",
"tooltip": "待处理的原始文本内容"
},
"operation": {
"name": "操作类型",
"tooltip": "要执行的文本处理操作",
"options": {
"uppercase": "转为大写",
"lowercase": "转为小写",
"reverse": "反转文本",
"add_prefix": "添加前缀"
}
},
"count": {
"name": "重复次数",
"tooltip": "操作重复执行的次数"
},
"prefix": {
"name": "前缀文本",
"tooltip": "要添加到文本前的前缀"
}
},
"outputs": {
"0": {
"name": "处理后文本",
"tooltip": "最终处理后的文本结果"
}
}
}
}
0, 第二个输出为 1, 以此类推。
菜单设置项目
如在 i18n-demo 节点中我们注册了对应的下面两个菜单设置app.registerExtension({
name: "I18nDemo",
settings: [
{
id: "I18nDemo.EnableDebugMode",
category: ["I18nDemo","DebugMode"], // 与 main.json 中的 settingsCategories 键匹配
name: "Enable Debug Mode", // 会被翻译覆盖
tooltip: "Show debug information in console for i18n demo nodes", // 会被翻译覆盖
type: "boolean",
defaultValue: false,
experimental: true,
onChange: (value) => {
console.log("I18n Demo:", value ? "Debug mode enabled" : "Debug mode disabled");
}
},
{
id: "I18nDemo.DefaultTextOperation",
category: ["I18nDemo","DefaultTextOperation"], // 与 main.json 中的 settingsCategories 键匹配
name: "Default Text Operation", // 会被翻译覆盖
tooltip: "Default operation for text processor node", // 会被翻译覆盖
type: "combo",
options: ["uppercase", "lowercase", "reverse", "add_prefix"],
defaultValue: "uppercase",
experimental: true
}
],
})
main.json 中添加
{
"settingsCategories": {
"I18nDemo": "I18n Demo",
"DebugMode": "Debug Mode",
"DefaultTextOperation": "Default Text Operation"
}
}
settings.json 中，比如：
{
"I18nDemo_EnableDebugMode": {
"name": "启用调试模式",
"tooltip": "在控制台显示国际化演示节点的调试信息"
},
"I18nDemo_DefaultTextOperation": {
"name": "默认文本操作",
"tooltip": "文本处理节点的默认操作",
"options": {
"uppercase": "大写",
"lowercase": "小写",
"reverse": "反转",
"add_prefix": "添加前缀"
}
}
}
. 替换为 _如：
"I18nDemo.EnableDebugMode" -> "I18nDemo_EnableDebugMode"