How to contribute and maintain a translation!

[Migrated From Jforum.net]

Lately we have received a lot of questions regarding translations in JForum. We have also received some contributions with updates for existing translations and new ones spread across the forums.

We will try to move earlier discussions regarding translations into this forum in the next couple of weeks.

This document tries to explain what files you will need to translate in order to have a full translation for JForum 2.1.7. Hopefully this will make things easier for the people that are so kind to contribute such a translation to the community.

Let's say that we want to create a new translation for the language xx_XX. Then you will need to do the following steps:

1. Copy ./WEB-INF/config/languages/en_US.properties to ./WEB-INF/config/languages/xx_XX.properties, and translate the file.

2. Add the line 'xx_XX = xx_XX.properties' to the end of ./WEB-INF/config/languages/locales.properties

3. Copy ./templates/agreement/terms_en_US.txt to ./templates/agreement/terms_xx_XX,txt, and translate the new file.

4. Create the directory ./templates/default/images/xx_XX and copy the images in ./templates/default/images/en_US into this new directory. Use your favorite image editor to translate these buttons. (Yes, we now this is the uncool part of the translation process)

5. Copy ./templates/default/styles/en_US.css to ./templates/default/styles/xx_XX.css. Change the paths in the new file so that they points to your new image directory for your translation.

6. Create the directory ./templates/mail/xx_XX and copy the .txt files in ./templates/mail into this new directory. Then translate the new files inside xx_XX.

7. Plase post these files on this forum, and we will make sure they will be made available for download.

NB! If you download JForum from our CVS repository you will find a perl script (tools/i18n/bin/tValidator.pl) that can help you locate missings or errors in your translation.
Example of use ./tValidator.pl /home/jakob/jforum xx_XX

In JForum 3 translations will most likely be packages that are downloaded from the JForum project site, instead of being shipped with releases. This will make it a lot easier to maintain a release.

We really appriciate all the help we can get with the translations!

So keep up the good work

/The JForum Team
[originally posted on jforum.net by lazee]

[Migrated From Jforum.net]

Have you a list of translation in progress ?
I am ok to do the french one if nobody else do it.
[originally posted on jforum.net by snaps-herve]

[Migrated From Jforum.net]

it is should used widely
[originally posted on jforum.net by bobysun]

[Migrated From Jforum.net]

I may do a Slovenian translation in near future, however I do not promise it But I may try with it once I have some time
[originally posted on jforum.net by Lenny]

[Migrated From Jforum.net]

Hi,

It's very goog step by step guide. But I found one misunderstanding in Step 5. The problem is that ./templates/default/styles/en_US.css contains only

/* Empty. It uses the default buttons set in the file "style.css" */

. So i copy ./templates/default/styles/de_DE.css and made all chages there.

I almost finish Russian translation, so I can post it here in few days.
[originally posted on jforum.net by ado]

[Migrated From Jforum.net]

I think that all non ASCII symbols from translation files must be represented as \uXXXX (code of Unicode). The program native2ascii from JDK can be useful
[originally posted on jforum.net by nazica]

[Migrated From Jforum.net]

tValidator.pl is no longer in the repository. Is there a new way to check the translations?
Diego
[originally posted on jforum.net by andune76]

[Migrated From Jforum.net]

Hi,

I've translated them into Japanese and would like to contribute them to the project.
How can I send them to you? I checked the "how to contribute" on the left menu, but there seems nothing created yet.

cheers,

-Eiji
[originally posted on jforum.net by eiji]

[Migrated From Jforum.net]

Seeing other posts, I feel like understanding how-to; posting the files in the forum, isn't it?
I'll post them soon.

-Eiji

eiji wrote:Hi,

I've translated them into Japanese and would like to contribute them to the project.
How can I send them to you? I checked the "how to contribute" on the left menu, but there seems nothing created yet.

cheers,

-Eiji

[originally posted on jforum.net by eiji]

[Migrated From Jforum.net]

I am going to start on the vietnamese translation. If someone else has already started on this, please speak up. Thanks
[originally posted on jforum.net by khcung]

[Migrated From Jforum.net]

I have translated JForum 2.1.8 into Korean language.

How I can give my file to you?

Please give me an answer to me.

[originally posted on jforum.net by honghoekim]