This tool is being used by ASF developers for synchronization of strings/translations between GitHub and Crowdin. If you're not ASF developer that has access to our localization platform, then you won't find anything interesting here.

Before you begin

Make sure that your crowdin_identity.yml file exists - this is the file with login credentials that is not being committed to GitHub. If it doesn't exist yet (e.g. because you've just cloned the repo), create it from crowdin_identity_example.yml and fill api_key that can be found here.

Installation

Windows

Install Java JRE (or entire JDK).
Set JAVA_HOME properly.
Launch setup_crowdin.bat as administrator.

Linux

Install OpenJDK JRE (or entire JDK).
Set JAVA_HOME properly.
Launch crowdin.sh as root.

Afterwards you should verify in shell that crowdin help command is recognized.

Usage

archi_upload for pushing strings to Crowdin.
archi_download for downloading translations from Crowdin.
archi_sync for upload + download.