This document provides a step-by-step walkthrough for translating ClearOS. By the end of this document, you will be able to translate using the online Translation System and see the results in your local ClearOS installation!
Once your translator account is active, you can go ahead and install the Developer Tools app on your ClearOS system, run:
yum install app-devel
Once installed, you can find the Developer Tools under System|Developer|Developer Tools in the menu.
Configure the ClearOS Developer App
To enable translator mode in ClearOS, click on in the Translations widget. Select your language, enable Translation Mode, and enable Synchronize Updates if you would like to synchronize (rsync) the translations to your ClearOS system every hour or so. Even though the tool (rsync) is smart about synchronizing just the changes, the synchronization will automatically expire after 12 hours.
It may take a up to an hour for an update, so please be patient! The translations from the Pootle server are synchronized to /var/clearos/base/translations. Anything in this directory will override the installed translations when Translation Mode is enabled.
Getting Started on the Translation Server - Pootle
Now you can get started with doing some translating! Here's a good place to start.
To make it easier to navigate, the first file that you will want to translate is base_lang.php. Among other things, this file contains all the categories and subcategories that you see in the menu system (Server, Gateway, Network, etc). Look for translation tags that start with base_category and base_subcategory.
If you have synchronization enabled, you should see changes that you have made on the translation server appear on your ClearOS system every hour.
The final part of the base app also happens to be one of the biggest to translate: there are approximately 500 generic words in the base. A lot of those standard buttons (e.g. Add, Edit, Delete) and widgets will start to look normal in webconfig after going through this translation set.
After tackling the base translations, it's a matter of going through all the other apps.
content/en_us/dev_translations_getting_started.txt · Last modified: 2017/05/18 10:59 by pbaldwin