Translations

Razuna 1.6

As of Razuna 1.6 we have changed the translation system.

  • Translation Razuna 1.6 and later
    • Translate Razuna to your language
    • Customize a translation
  • Translation Pre-1.6 release
    • Translate Razuna to your language
    • Location of translation files.
    • How to start translating
    • Available Translations and their IDs
    • Escaping foreign characters in the XML file

Translation Razuna 1.6 and later

Since Razuna 1.6 we store all translations in a central location and they are available for all tenants. Translations are hold in .properties files. Please read below how you can translate and extend the translation system.

Translate Razuna to your language

This section is for ADDING a translation. If you would like to CUSTOMIZE wording then please see the dedicated section for this!

Public translation

As of Razuna 1.6 all translations live at a centralized place at http://translate.razuna.org. You can use this service to translate Razuna into your respected language anytime!

Language

ID

Provider

English

1

Nitai

German

2

 

French

3

Bruce Lane

Dutch

4

David Wuyts

Danish 5  
Arabic 6 Walid Zaiaty
Vietnamese 7 Phan Chi Nguyen
Romanian 8 Florin Bubuianu
Spanish 9 Julio Torres
Italian 10  
Norwegian 11  
Slovenian 12  
Ukrainian 13  
Brazilian 14  
Catalan 15  
Chinese_Simplified 16  
Chinese_Traditional 17  
Hungarian 18  
Persian 19  
Swedish 20  
Portugese 21  
Japanese 22  
Russian 23  

Customize a translation

If you want to change the wording of a translation you can do so by creating a new directory in the tenant directory named with the same translation and place the HomePage.properties file inside.The structure would look like this:

raz1/dam/translation/custom/English

In order to overwrite existing translations with your own you would simply overwrite it within the custom translation. Say you want to a different wording for "welcome" you would simply add "welcome" into your properties file and add your own translation.

Once saved, you do not need to do anything else. Razuna will pick up the custom translation immediately.

Translation Pre-1.6 release

Translate Razuna to your language

Razuna holds all translations in XML files. Thus, in order to translate Razuna to your preferred language you simply have to create a new XML file, give it the name of your language and add it to Razuna. Please follow the below guidelines to translate.

Location of translation files.

Actually there are 2 (TWO) translations available within Razuna. One is for the General Administration, found at http://localhost:8080/razuna/admin, where the CMS and administration takes place and the other is for the Digital Asset Management (DAM) part. Mostly this is the one you want to translate, since your users are interacting with this part to 99%.

You can find the XML files at;

For the DAM you can find the translation files in your "Host" folder in the folder "translations" (demo/dam/translations).

For the Admin you can find them at "Admin/translations".

When you want to test your translation you will have to put it into one of those places.

How to start translating

  1. Grab the latest English.xml file
    Best is to get it from the Subversion (SVN) repository. Thus when we do changes those will be reflected in the SVN. Read over at the Subversion Guide how to access Razuna on SVN. The main thing for you to know is that the translation files reside in the "trunk" folder under the demo host (demo/dam/translations). If you don't feel comfortable with SVN access then let us know and we will send you the XML by another way.
  2. Create your own XML file
    Open the english.xml file and copy it to your preferred language. Say you want to create a Italian translation you would copy the english.xml to italian.xml.
  3. Change the ID
    Each translation has its own ID. You will need to change this ID! Incrementing it by one with the below list. Look at the below list to see what ID's are taken and add your own translation and ID.
  4. Let us know
    Once you started add your status in the below table (yes, you can edit it) and let us know that you work on it. Of course, we would totally appreciate if you would send us a copy of your file. We will give you praise and mention your name wherever we can

    Available Translations and their IDs

    Here is a list of available translations and their ID's

    Language

    Filename

    ID

    Provider

    1.3.5

    1.4

    English

    english.xml

    1

    Nitai

    done

    done

    German

    german.xml

    2

    Nitai

    done

    done

    French

    french.xml

    3

    Bruce Lane

    done

    open

    Dutch

    dutch.xml

    4

    David Wuyts

    done

    open

    Escaping foreign characters in the XML file

    Important
    In order to be able to read/parse the XML file properly all characters have to be escaped in a XML file. Now to make life easy on you, you can wrap your text in a "CDATA". Please take a look at the following example;

    <![CDATA[Déconnexion]]>

    Without wrapping this French word in CDATA the parsing of this XML file would fail, since the parser does not know French or foreign characters. The same applies if you would like to add HTML code in your translation. In short, you have to wrap all text with a CDATA when it would contain HTML or foreign characters.

    HTML in XML;

    <![CDATA[I want this word to be <b>bold</b> and have a paragraph <p>in this text</p>]]>