🌐 Interactive Translation Manager

[marciska]

Issues

Addresses issue #149

Changelog: 📝

• Interactive translation manager: Can translate fast from the terminal to a target language in an interactive session. Exports the strings to the corresponding language JSON file.
• More error checks: New InvalidLanguageError exception in case an invalid language has been requested for translation.
• Better KeyboardInterrupt exception handling.
• Added README to explain how to use the translation manager.

Check the following video for what the interactive translation manager does:

TODO: ☑️

• Provide option that only new keys (keys that do not yet exist or have a non-empty value in the target JSON) shall be prompted for translation (second task of [Feature] Interactive translation #149).

Other

Please add the hacktoberfest-accepted label to this pull request if it is accepted! 😃

[ann-kilzer]

Thanks for your submission, looks interesting.

• In general, it's better to ask before working on tickets that other people are working on (Python Script Improvements #51 ). Going forward, please ask in our Slack before changing the localization process
• Most of our translators are non-technical and use GitHub to edit the files.

Let me take a closer look and see if it could fit into our process.

[ann-kilzer]

Okay, I tried it out tonight, and it's really cool. ✨ Thanks for creating this and I think it could definitely be useful in our process. I'd like to request a few changes before merging.

1. For consistency, we want to always use English as the source language. (It's also the fallback language for the i18n in the main project) Could you please change the command to only accept a TARGET_LANGUAGE and always translate from English?

2. It might be useful to have a mode that focuses on missing keys in the TARGET_LANGUAGE, as we have over 136 keys now.

Thanks again!

[ann-kilzer]

Note that many people who visit our repo are using GitHub for the first time, so this will only be faster for a percentage of users. It might be worth noting that this tool requires familiarity with the command line.

[marciska]

I finished all the points you mentioned 🎉

• Default mode is now that only missing keys will be translated 🔑
• The readme is updated to address the familiarity issue 👨‍👩‍👦
• The "force recreate all keys" option is now accessible by passing the flag -recreate to the command 🎯

The recreate flag is useful if you want to proof-check keys since it shows you the English source sentence alongside the current translation. Translations that you consider good can be simply inherited when you leave the prompt empty.
This should be much faster than having 2 files open and comparing it with the English source.
I also used it for the other PR earlier to proof-check and fix the issues in the German localization 🤗

Last but not least, if this marks the PR as merge-ready, please add the hacktoberfest-accepted label to this PR! 🤗
(I noticed that the Hacktoberfest-label is on the main-repo of Find a Doc, but not on this repo... 🥲)
Hacktoberfest

See you on Slack for the next projects! 😇

[ann-kilzer]

It's really slick. I like that I can hit enter to keep the current translation, or write a change.

Very good work.