Today, I was working on a project and needed to find a way to localize some JSON files. I speak English as my second language and have some previous experience participating in localization projects, so there wouldn’t have been any problem on localizing those files from Spanish to English, but how do you optimize the process when there are many strings to translate? Use the DeepL API and focus on validate that translations are correct.
DeepL
Before using DeepL API, you must create a free account.
- Go to the Sign up page
- Type your email and password
- Complete the CAPTCHA
- Fill the form
- Provide a valid credit card to verify you identity (Your credit card won’t be charged unless you manually upgrade to DeepL API Pro)
- Accept the Terms and Conditions
- Click on Sign up for free
Once your account has been created, go to the API Keys section, and copy your API Key or generate a new one.
Python
For localizing the JSON files of your project, install json-translate. This library supports AWS Translate and DeepL.
pip install json-translate
Then, you must create an .env
file in the root directory of your project, with the following content:
DEEPL_AUTH_KEY=YOUR_API_KEY
Replace YOUR_API_KEY
with the value you copied previously from your DeepL account.
Another option for configuring this environment variable is by running the following command:
export DEEPL_AUTH_KEY=YOUR_API_KEY
Replace YOUR_API_KEY
with the value you copied previously from your DeepL account.
Localize your project
You have a JSON with the following content in Spanish:
{ "tipo-perfil": { "label": "Tipo de perfil", "description": "Tipo de perfil", "tooltip": "Tipo de perfil", "validations": { "required": "El campo Tipo de perfil es requerido", "minMessage": "El número de caracteres debe ser de al menos {min}", "maxMessage": "El número de caracteres debe ser máximo de {max}", "regexMessage": "Formato de Tipo de perfil inválido" } }
}
In order to translate to English the values of every key in the JSON file, you must run the following command:
json_translate deepl perfil.json EN
Previous command will generate a en.json
file with the following content:
{ "tipo-perfil": { "label": "Profile type", "description": "Profile type", "tooltip": "Profile type", "validations": { "required": "The Profile type field is required", "minMessage": "The number of characters must be at least {min}", "maxMessage": "The number of characters must be a maximum of {max}", "regexMessage": "Invalid Profile Type Format" } }
}
You can change the name of the output file and the path by running the following command:
json_translate deepl perfil.json -o en/perfil.json EN
The localization is ready, but translations are not perfect with this kind of tools. You must review the result.
Localize multiple files
I needed to localize multiple JSON files and created a BASH script to perform this task.
directory_path="es"
find "$directory_path" -type f | while IFS= read -r file; do b=$(basename $file) json_translate deepl "$file" EN -o "en/${b}"
done
The above code block does the following:
- Obtain the filenames in the
es
directory - Translate the content with the
json_translate
command - Save the output files in the
en
subdirectory with the same name
After running the above command you will get the content of the JSON files translated to English. And this is how you optimize the localization process.
Discover more from Coursity
Subscribe to get the latest posts sent to your email.