Tuesday, January 27, 2009

Alfresco Localization - tutorial


Alfresco localization depends on two aspects:

- Configuring supported 'languages'; all supported locales are set using xml inside the Alfresco web app.

(as will be mentioned later)

- Local messages to display; usually are represented by properties files,

in the form of values to predefined message keys.

Each language has its own set of files ending with local suffix.

(ex: webclient_ar_EG.properties)


In this tutorial, i'm going to add the Arabic language support in Alfresco.

Using Omega-T for translating display messages files,

(properties files inside alfresco/messages).


(1) In Omega-T create new project with the following settings:

name: alfresco_ar_EG

source files language: EN-US

translated files language: AR-EG




(2) Copy messages folder inside the deployed Alfresco web app:

tomcat/webapps/alfresco/WEB-INF/classes/alfresco/messages

(excluding all files that ends with '_en_US.properties')


(3) Import alfresco messages to be translated:

Project -> Import source files ->

(select properties files inside the recent copied folder)


(4) Start translating messages segment, you can start with webclient.properties,

to see your local messages displayed in the default Alfresco home & login pages.

(refer to Omega-T help for details about how to translate)




(5) When finished, Omega-T will produce output message files ending with local suffix:

'ar_EG.properties'.

You'll find output files in the 'target' of Omega-T project:

<path-of-alfresco_ar_EG>/target


(6) Copy all output files inside 'target' to the deployed Alfresco web app custom messages:

tomcat/shared/classes/alfresco/messages


(7) Configure Alfresco supported languages:

add the Arabic-eg local by updating the file

shared/classes/alfresco/extension/web-client-config-custom.xml:


<config evaluator="string-compare" condition="Languages" replace="true">

<languages>

<language locale="en_US">English</language>

<language locale="ar_EG">Arabic</language>

</languages>

</config>


(make sure 'languages' configuration are not commented in the previous xml)


(8) restart tomcat to see Arabic interface.



Reference:

http://forge.alfresco.com/docman/view.php/156/2038/Swedish%20Translation%20Guide.pdf



No comments: