1.0.0 • Published 8 months ago
auto-translate-i18n v1.0.0
auto-translate-i18n
Automatically translate i18n JSON files using Google's Gemini AI. This tool helps you maintain multiple language versions of your i18n JSON files by automatically translating missing keys.
Installation
npm install -g auto-translate-i18n
Features
- Automatically translates missing keys in i18n JSON files
- Powered by Google's Gemini AI for high-quality translations
- Supports nested JSON structures
- Preserves existing translations
- Rate limiting protection built-in
Usage
auto-translate-i18n -k YOUR_GEMINI_API_KEY -s English -d Vietnamese -f en.json -t vi.json -p "Translate in a formal tone, my website is related to finance"
Required Options
Option | Description |
---|---|
-k, --api-key <key> | Your Google Gemini API key |
-s, --source-lang <lang> | Source language code (e.g., "en") |
-d, --dest-lang <lang> | Destination language code (e.g., "vi") |
-f, --source-file <path> | Path to source language JSON file |
-t, --dest-file <path> | Path to destination language JSON file |
Optional Options
Option | Description |
---|---|
-m, --model <model> | Gemini model name (default: "gemini-1.5-flash") |
-p, --prompt <text> | Additional context prompt for translation |
Examples
Basic translation from English to Vietnamese:
auto-translate-i18n -k YOUR_API_KEY -s English -d Vietnamese -f en.json -t vi.json
With custom model and prompt:
auto-translate-i18n -k YOUR_API_KEY -s English -d Vietnamese -f en.json -t vi.json -m gemini-1.5-pro -p "Translate in a formal tone, my website is related to finance"
Example
Source file (en.json
):
{
"welcome": "Welcome to our app",
"settings": {
"title": "Settings",
"theme": "Choose theme"
}
}
After translation (vi.json
):
{
"welcome": "Chào mừng đến với ứng dụng của chúng tôi",
"settings": {
"title": "Cài đặt",
"theme": "Chọn chủ đề"
}
}
Features in Detail
- Preserves Existing Translations: Only translates missing keys, keeping existing translations intact
- Nested JSON Support: Handles complex nested JSON structures
- Rate Limiting: Built-in protection against API rate limits with automatic retries
- Progress Tracking: Shows translation progress and final key count
- Error Handling: Graceful error handling with informative messages
License
MIT
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
1.0.0
8 months ago