Init Crowdin translations

.travis.yml

@@ -0,0 +1,3 @@
+language: ruby
+install: gem install crowdin-cli
+script: crowdin-cli upload sources

CONTRIBUTING.md

@@ -0,0 +1,29 @@
+# Contributing
+
+### Translating the handbook
+
+The english version of this handbook is the only one updated inside the
+repository, if you would like to contribute to other languages you must do so
+through Crowdin. You can
+[invite yourself to our crowdin project here](https://crowdin.com/project/babel-plugin-handbook/invite).
+
+### Downloading updated translations
+
+Note: This is for maintainers who have api access to Crowdin. If you do not have
+access to this and you would like for the translations to be updated please open
+an issue.
+
+First make sure you have the `crowdin-cli` installed.
+
+```sh
+$ gem install crowdin-cli
+```
+
+The you can use it to download the latest translations.
+
+```sh
+$ CROWDIN_API_KEY=$(CROWDIN_API_KEY) crowdin-cli download
+```
+
+Replace `CROWDIN_API_KEY` with the api key on
+https://crowdin.com/project/babel-plugin-handbook/settings#integration.

README.md

@@ -3,6 +3,11 @@
 This document covers how to create [Babel](https://babeljs.io)
 [plugins](https://babeljs.io/docs/advanced/plugins/).
 
+If you are reading a non-english translation of this handbook you may still find
+english sections that have not yet been translated. If you would like to
+contribute to one of the translations you must do so through Crowdin. Please
+read the [contributing guidelines](/CONTRIBUTING.md) for more information.
+
 [![cc-by-4.0](https://licensebuttons.net/l/by/4.0/80x15.png)](http://creativecommons.org/licenses/by/4.0/)
 
 Special thanks to [@sebmck](https://github.com/sebmck/),
@@ -26,16 +31,23 @@ are presently doing.
 
 # Translations
 
-- [中文](/translations/cn.md)
-- [Deutsche](/translations/de.md)
-- [Español](/translations/es.md)
-- [Français](/translations/fr.md)
-- [Italiano](/translations/it.md)
-- [日本語](/translations/ja.md)
-- [한국어](/translations/ko.md)
-- [Nederlands](/translations/nl.md)
-- [Português](/translations/pl.md)
-- [Pусский](/translations/ru.md)
+- [English](/README.md)
+- [Deutsche](/translations/de/README.md)
+- [Español](/translations/es-ES/README.md)
+- [Français](/translations/fr/README.md)
+- [Italiano](/translations/it/README.md)
+- [日本語](/translations/ja/README.md)
+- [한국어](/translations/ko/README.md)
+- [Nederlands](/translations/nl/README.md)
+- [Português](/translations/pl/README.md)
+- [Pусский](/translations/ru/README.md)
+- [中文](/translations/zh-CN/README.md)
+
+If you are reading a non-english translation of this document you will find a
+number of english words that are programming concepts. If these were translated
+to other languages there would be a lack of consistency and fluency when reading
+about them. In many cases you will find the literal translation followed by the
+english term in parenthesis `()`. For example: Abstract Syntax Trees (ASTs).
 
 # Table of Contents
 

crowdin.yaml

@@ -0,0 +1,18 @@
+project_identifier: babel-plugin-handbook
+api_key_env: CROWDIN_API_KEY
+base_path: .
+files:
+  - source: '/README.md'
+    translation: '/translations/%two_letters_code%/%original_file_name%'
+    languages_mapping:
+      two_letters_code:
+        'de': 'de'
+        'es-ES': 'es-ES'
+        'fr': 'fr'
+        'it': 'it'
+        'ja': 'ja'
+        'ko': 'ko'
+        'nl': 'nl'
+        'pt-PT': 'pt-PT'
+        'ru': 'ru'
+        'zh-CN': 'zh-CN'