π€ Kiwi - Well-established internationalization solution
[δΈζ](https://github.com/alibaba/kiwi) | English
## Installation
```bash
yarn global add kiwi-clis && yarn add kiwi-intl
```
Then search "kiwi linter" in visual studio marketplace
## Usage
- Generate key by just one click
- Detect Chinese within the code
- Search the occupation
## Documentation
`kiwi-intl`: [π Link](https://github.com/alibaba/kiwi/tree/master/kiwi-intl)
`kiwi-cli`: [π Link](https://github.com/alibaba/kiwi/tree/master/kiwi-cli)
`kiwi-linter`: [π Link](https://github.com/alibaba/kiwi/tree/master/kiwi-linter)
## Change Log
`kiwi-cli`: [π Link](https://github.com/alibaba/kiwi/tree/master/kiwi-cli/CHANGELOG.md)
`kiwi-linter`: [π Link](https://github.com/alibaba/kiwi/tree/master/kiwi-linter/CHANGELOG.md)
## Why use Kiwi?
We can find out many excellent library that help the front-end developer to handle the internationalization, like `react-intl` and `I18N-loader`. Those libraries are good at multilingual-switching, but there still has some problems that need to be resolved.
- Not intuitive enough and hard to search after the text has replaced by internationalization keys
- So annoy to create the key for translation
- Hard to find out the all the text which is needed to be taken place by key
- Communication with the whole internationalization team.
- Front-end developers are hard to write layout code when they haven't got the translation, because the text length in different languages is not the same.
That's why we create Kiwi.
## What Kiwi solved?
Kiwi is not just an library for front-end internationalization, it's a full life cycle internationalization solution of a software, from design to release.
Kiwi is based on kiwi-intl. you can use kiwi in any front-end library you like.
Developers can use kiwi linter for automatic batch Chinese text converting. We have provided [a plugin for vscode](https://marketplace.visualstudio.com/items?itemName=undefinedvs.vscode-i18n-linter) to prompt the original text next to the translation key. Of course you can search the Chinese translation in project, and jump to the relevant code. Kiwi has improved the bad feeling be brougth by the missing text.
Kiwi also helps developers to collect all the text without translation. They will be packed to an Excel, and you can mail it to your translation partners. We also built in google translation in our kiwi linter plugin, which allows developers to translate quickly before the translation team finish their jobs. That is really time saving.
After translation, we provide a command tool to help developers import it into the project by just one click.
We also developed a tslint package, that will help developers detect the untranslated text, and it's easy to integrate it in the git flow of your project.
## Who is using Kiwi?
- Alibaba
It's happy to let us know that you and your company are using kiwi right now, please leave us a message in [issue](https://github.com/alibaba/kiwi/issues) .
## Why is it called Kiwi?
Kiwi or kiwis are flightless birdsπ€οΌbut they are good at runn
ing which can reach the speed of 10 miles per hour. Kiwi is the only bird in the world with external nostrils at the tip of its long beak. These allows them to locate worms beneath the 7 inches soil. Our kiwi tools will help you find bugs for your international project.
## Community
Join our group chat by [DingTalk](https://www.dingtalk.com/en) and share your ideas and questions for Kiwi
