![](\"https://github.com/while1618/i18n-auto-translation/actions/workflows/build.yml/badge.svg\"){kind=icon}
\n \n \n ![](\"https://img.shields.io/badge/npm-v2.2.3-blue\"){kind=icon}
\n \n \n ![](\"https://img.shields.io/github/license/while1618/i18n-auto-translation\"){kind=spacer}
\n \n\n Description •\n Usage •\n Demo •\n Known issue •\n Translate Providers •\n Credits •\n License\n
\n\n\n \n## Description\n\ni18n-auto-translation helps you translate your i18n JSON files. You need to pick one of the translation API providers that are supported, pass the subscription key, language to which you want to translate, path to the file or directory, and you are good to go.\n\n[](https://ko-fi.com/Q5Q412OZ0R)\n\n### How It Works?\n\n- If there is no translation for the file you provided, the complete file will be translated, and the new file will be created with the same structure as the original file, keeping the keys in the original language, and translating only values.\n- You can pass a file with the nested JSON objects, and everything will be translated as you expect.\n- The newly created file will be named [to].json. (e.g. de.json)\n- If the translation for the file already exists, only newly added lines will be translated (API will be called only for those lines), and lines that are no longer in the original file will be deleted.\n- Translate APIs are not ideal, and that's why you will need from time to time to override some translations manually. When you manually translate some value, it will remain like that, and it will not be overridden again, unless you use `override` flag.\n- If you pass a directory instead of a single file, the library will recursively find all the files named [from].json (e.g. en.json), and the translations will be saved in the same directories as the original file.\n- Words that are wrapped in `{{}}`, `{}`, `<>`, `` won't be translated. e.g. `{{skip}} {skip}