Translate json language files / i18n locales on the spot!

This tool was made to easily translate json translations files. Front-end frameworks and CMS don't always provide a lot of translations, or any translations in some cases. This is totally understandable, but it's a major problem when you need to translate a 1000+ lines json language file. This tool can do that!

Example ( -> )

English language file (BigCommerce)

{
	"account": {
		"breadcrumb": "Your Account",
		"nav": {
			"overview": "Overview",
			"orders": "Orders",
			"returns": "Returns",
			"messages": "Messages ({num_new_messages})",
			"wishlists": "Wish Lists ({num_wishlists})",
			"recently_viewed": "Recently Viewed",
			"settings": "Account Settings",
			"addresses": "Addresses",
			"payment_methods": "Payment Methods"
		},
		"mobile_nav": {
			"messages": "Messages",
			"wishlists": "Wish Lists"
		}
	}
}

French translation generated with go-json-translate

{
	"account": {
		"breadcrumb": "Votre compte",
		"nav": {
			"overview": "Vue d'ensemble",
			"orders": "Commandes",
			"returns": "Renvoyer à",
			"messages": "Messages ({num_new_messages})",
			"wishlists": "Listes de souhaits ({num_wishlists})",
			"recently_viewed": "Récemment consultés",
			"addresses": "Adresses",
			"settings": "Paramètres du compte",
			"payment_methods": "Méthodes de paiement"
		},
		"mobile_nav": {
			"messages": "Messages",
			"wishlists": "Listes de souhaits"
		}
	}
}

Features

• Translate any standard json file on the spot, leveraging deepL's free API.
• Works well with json files containing strings, numbers and booleans
• Supports nested json files, without any limit
• Uses a local database as a translations cache in order to increase speed and not to request twice the same translations from deepL. This means that once you've translated a file, you can translate it again with the same parameters and not query deepL at all.
• Supports variables in the translated text. For example, hello, {name} won't be translated to bonjour, {prénom} but to bonjour, {name} Available enclosure tags are: {}, #{} and []. It's very easy to add new ones.

This tool uses DeepL free API. Their free plan includes:

• Access to all features
• Access to the DeepL REST API
• 500,000 character limit / month
• 1,000 glossaries (for specific languages)

On average, text contains between 5 and 6.5 characters per word including spaces and punctuation. -charactercounter.com

Ok, so 500,000 / 6.5 = 76923. We could estimate that we can translate 70k words / month with the free tier. I've actually never hit the limit myself, so kudos to DeepL for a developer plan that actually lets you do stuff :)

Limitations

• This tool depends on DeepL keeping their free tier API usage limit high
• There is no support yet for json arrays, the only supported types are strings, numbers and booleans
• The json source file is entirely read before translation. This means that if you have a really huge file to translate, there may be some instability depending on your hardware. But don't worry, thanks to the local translation cache, everything translated with DeepL won't be translated twice.
• The translated json file won't be in the order of the source file. This is not a problem at all, but just so you know.

Available languages

The updated list of available languages is available on DeepL's API documentation that I encourage you to read. Available languages (both source & target):

Bulgarian,Czech,Danish,German,Greek,English,Spanish,Estonian,Finnish,French,Hungarian,Italian, Japanese,Lithuanian,Latvian,Dutch,Polish,Portuguese,Romanian,Russian,Slovak,Slovenian,Swedish,Chinese

Installation and usage

Install from sources

git clone https://github.com/gmonarque/go-json-translate
cd go-json-translate && go mod install

Usage

Before using go-json-translate, you need to configure the config.ini file.

DEEPL_API_ENDPOINT = https://api-free.deepl.com/v2/translate
DEEPL_API_KEY = <your_api_key>

Then, you're good to.. start using this tool. (this joke has been used too many times now)

Usage example: main.go -source_file=file.json -source_lang=fr -target_lang=en
List of languages available at github.com/gmonarque/go-json-translate
  -source_file string
        Path of the source .json file
  -source_lang string
        Current language of the file. Use "autodetect" to let deepL guess the language. (default "autodetect")
  -target_lang string
        Language the file will be translated in

Contribute & issues

Don't hesitate to contribute to this project in any way you want. Just use gofmt and feel my vibe. If you have any issues with this, please open an issue, I'll happily respond.

If you have translated something and you think it could be useful to somebody else, please do a merge request of your translated file (check the community-translated-files folder)