Getting Started with Localization
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!
Prepare Your ClearOS Environment
Request an Account
Before you can get started with the Translation System, please request an account by going through the first three steps described in the Getting Started document.
Install the ClearOS Developer App
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
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.
Getting Started on the Translation Server - Pootle
Now you can get started with doing some translating! Here's a good place to start.
Login
First, login to the server. Please contact developer@clearfoundation.com for more information.
Base Categories
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.
Base System
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.
The Rest
After tackling the base translations, it's a matter of going through all the other apps.
