Overview
This node transliterates input strings, converting characters from various alphabets (including Chinese) into their Latin script equivalents. It is useful for normalizing text data, making it readable or searchable in environments that do not support certain scripts. For example, it can convert Cyrillic "Здравствуй мир" to "Zdravstvui mir", or Chinese characters into phonetic Latin representations.
Common scenarios include:
- Preparing multilingual user input for indexing or search.
- Converting names or addresses into a consistent Latin format.
- Processing text data for systems that only accept Latin characters.
Properties
| Name | Meaning |
|---|---|
| Input String | The string to transliterate (supports Chinese and other scripts). Example: "Здравствуй мир". |
Output
The node outputs JSON with a single field:
output: The transliterated version of the input string, where non-Latin characters are converted to their Latin equivalents. Unknown characters are replaced with a question mark (?).
Example output JSON:
{
"output": "Zdravstvui mir"
}
No binary data is produced by this node.
Dependencies
- Uses the external
transliterationlibrary to perform the transliteration. - No additional API keys or external services are required.
- No special environment variables or n8n credentials needed.
Troubleshooting
- Empty or incorrect output: Ensure the input string is provided and contains valid characters. Unsupported characters will be replaced with
?. - Errors during execution: If an error occurs, the node can continue processing subsequent items if configured to "Continue On Fail". Otherwise, the error will stop execution.
- Unexpected characters in output: This may happen if the input contains symbols or scripts not supported by the transliteration library.
Links and References
- transliteration npm package - The underlying library used for transliteration.