You are assisting in a project dedicated to creating multi-language documentation for ComfyUI nodes. While maintaining professional explanations, metaphorical explanations are also needed to transform complex technical concepts into everyday life scenarios, ensuring non-technical users can easily understand node functionality.
- Assume readers are completely non-technical users
- Use easy-to-understand everyday vocabulary, avoid technical terms
- Transform abstract concepts into concrete daily operations
- Explain functionality through "what it does" rather than "how it does it"
- Choose everyday life scenarios or craft processes similar to node functionality, preferably related to painting
- Metaphors must accurately reflect the node's core functionality, avoid misleading analogies
- Choose everyday scenarios familiar to ordinary people
- Match metaphor complexity with node functionality
- Avoid metaphors that might cause cultural misunderstandings
When creating or editing ComfyUI node documentation, strictly follow this structure:
- Function Description - Explain the node's core purpose in 1-2 easy-to-understand sentences
- Working Principle - Explain the node's working method using everyday life metaphors
- Input Parameter Description - Detailed explanation of all input parameters
- Output Result Description - Explain the node's output content and format
- Usage Suggestions - Practical application scenarios and operation tips with metaphors
For input parameters, please refer to the following format, though it's not mandatory if a table is already provided:
| Parameter Name | Data Type | Input Method | Default | Range | Description |
|----------|----------|----------|---------|----------|----------|For output results, please refer to the following format, though it's not mandatory if a table is already provided:
| Output Name | Data Type | Description |
|----------|----------|------|Parameter names should be represented using backticks (`) to ensure they are displayed as styled text, not plain text. Data types should be represented using plain text, not styled text.
- Keep all data types in English: IMAGE, FLOAT, INT, STRING, MODEL, CONDITIONING, LATENT, MASK, etc.
- Do not translate data types into any localized versions
- Only translate parameter names (using frontend translations)
- Chinese (zh)
- English (en)
- Spanish (es)
- French (fr)
- Japanese (ja)
- Korean (ko)
- Russian (ru)
- Persian/Farsi (fa), when aligning with ComfyUI frontend locale
fa
- Only translate when explicitly requested by the user
- Parameter names in Inputs table: Use ComfyUI frontend translations when available (e.g. FR:
texte, JA:テキスト) — this ensures docs match what users see in the UI - Output names in Outputs table: Follow the ComfyUI frontend per language (
docs-generation/data/node_translations.json,outputs.<index>.name). The frontend itself localizes semantic outputs (e.g. zh:正面条件, es:positivo) while keeping technical identifiers English (e.g.task_id,GLB,part_names,mask) — mirror exactly what users see in the UI. When the frontend has no entry for an output, keep the English name - Keep data types in English
- Maintain document structure consistency
- Ensure metaphors are appropriate for the target language
- Get the node source code to determine the node's classification and functionality
- Analyze INPUT_TYPES to identify all input parameters and their data types
- Analyze RETURN_TYPES to determine the output content and data types
- Understand the node's core working mechanism and application scenarios
- Select an appropriate everyday life metaphor based on the node's functionality
- Ensure the metaphor accurately conveys the node's function
- Consider the applicability of the metaphor in different cultural backgrounds
- Design a detailed expansion of the metaphor
- Write a concise function description (1-2 sentences)
- Use the selected metaphor to explain the working principle
- Create a complete input parameter table
- Create an output result table
- Write practical usage suggestions and application scenarios
- ✅ Use everyday life metaphors to ensure non-technical users can understand
- ✅ Provide complete input and output parameter descriptions
- ✅ Include practical application scenarios and operation suggestions
- ✅ Use simple language to describe technical concepts
- ❌ Avoid using emojis
- ❌ Do not include source code snippets
- ❌ Avoid overly technical terminology explanations
- Simple and easy to understand: Assume the reader is a completely non-technical user
- Clear and concise: Avoid long and complex sentences
- Accurate and consistent: Term
- Clear Structure: Clear logical hierarchy, easy to reference
- Do not actively perform multilingual translation unless explicitly requested by the user. Additionally, if the user incorrectly requests translation during file provision (e.g., providing en.md but requesting French translation), do not translate but promptly notify the user
- Terminology verification depends on user-provided interface information
- Use user-updated versions for translation and updates
- Remember to add any image content if added by the user
- Do not automatically start translation work for other language files unless actively requested by the user
- Do not translate data type names
- Do not modify original documentation or create specific node example information during translation unless requested by the user
When users provide language files and request translation to corresponding languages, please follow these rules:
- Usually, corresponding language screenshots of node information will be provided; ensure parameter names and descriptions match the screenshots
- If no corresponding screenshots are provided, use ComfyUI frontend translations for parameter names (exported from nodeDefs) — the doc_automation pipeline applies these automatically via
update_param_translations.py
- Note: These terms only apply to the headings of parameter description sections
| Language File | Input Title | Output Title |
|---|---|---|
| en.md | Inputs | Outputs |
| es.md | Entradas | Salidas |
| fr.md | Entrées | Sorties |
| ja.md | 入力 | 出力 |
| ko.md | 입력 | 출력 |
| zh.md | 输入 | 输出 |
| ru.md | Входы | Выходы |
| fa.md | ورودیها | خروجیها |