developer documentation r21358

Translation

In the translation section, you can make your web application multi-lingual.
There are three (3) key concepts to translation; Categories, Keywords and Translation.

How it works

When in the Applications tab, select the application you want to translate.
When you see the icons for wrappers, stylesheets and so on, scroll down to the Translation icon.

You are now in the translator.
The translator interface consists of the Categories list (1), the Language selectors (2) and the translation table (3).

Adding translation data

Adding a category

1. In the Categories list, select the form field that says "new category" and give your category a name.
2. Click the (green) + button.
3. The list will update, and show your new category.

Adding keywords and translation

1. Click the category you want to create translation for.
2. Click the "Add" button on the right to add a row.
3. The leftmost box in this row is where the keyword goes.
4. The center and rightmost box should contain the translations as you want them to appear on the website.

If you want to translate to another language, select the desired target language from the drop-down menu. The column below the selected drop-down will update.

Examples

Let's say that your (bi-lingual) application has a FAQs section. After defining an "faq" Category, You could create the following keyword-translation combinations.

FAQs
keyword	English translation	Dutch translation
q-register	How do I register?	Hoe registreer ik mij?
a-register	You can register by clicking the "Register" item in the main menu. Then fill out the form and hit submit.	Klik in het hoofdmenu up "Registeren". Vul het hele formulier in, en druk op "verzenden".

Using translation in the templates

Now, let's go to the application templates, and open your template. We'll continue to use the "FAQs" example.

When pulling in Translation data, the Translator needs to know which category to use. You can do that with the following syntax:

{%category:keyword}

Which, in our example, might look like this:

<ul>
    <li class="question">{%faq:q-register}</li>
    <li class="answer">{%faq:a-register}</li>
</ul>

In order to save some typing, you can define a category once, and reference keywords in it later down the page. Consider the following example:

{%faq} <!-- the category is defined here -->

<ul>
    <li class="question">{%q-register}</li> <!-- and we're pulling the translation(s) in here, using only the keyword -->
    <li class="answer">{%a-register}</li>
</ul>