Translations

From Cyclos Wiki

Before starting it is good to have a good knowledge of the functionalities and the working of Cyclos. An explanation about the working of Cyclos can be found at manuals in Cyclos (Help - Manual)

Files to translate

All translation files can be found in the full install package (cyclos_3.version_nr.zip)
The following translation files exist:

• ApplicationResources_en_US.properties (can be found in the directory: /cyclos_3.5/web/WEB-INF/classes/)

This file contains the software translations (menu and window items and messages). The 'keys' are on the left of the equal signs (=) and should be left in English. The part to translate is on the right after the equal (=) signs. You do not have to modify the words between or after # and \ signs. For example \#login\# or \n

• CyclosSetup.properties (can be found in the directory: /cyclos_3.5/src/nl/strohalm/cyclos/setup/)

This file contains the translation for the initial database setup (account names, group names etc). If you want the database to use a initial database other then English you should change the language tag 'cyclos.embedded.locale' in the cyclos.properties file.
Note: This file very important. When translation keys are empty the initial database creation and migration can fail.

• Helps

There are 32 help files that can be found in the directory /cyclos_3.5/web/pages/general/translation_files/helps/en_US/. A help file normally describes a specific function or module (e.g. 'advertisements'). Some help files contain sub sections because they contain much information. For example the 'account management' help file have sub items as: currencies, accounts, account fees, transaction types etc.

How to edit

For the application properties (main language file) the best is to use a plain text editor. Take care that you do not change any text at the left of the = signs in the application properties file. You can use any accents or special characters (like é, ñ etc) directly.

All the help files and static files in html format (with .jsp extension). You only have to make sure not to modify anything within html tags. Therefore it is helpful to have a basic understanding of html. Please do not use a wwysiwyg (what you see is what you get) editor because they often mesh up the code. We suggest to use a (plain) text editor with (html) syntax highlighting like pspad (windows) or gedit (linux/gnome). You will have to make sure that the editor is set to use the coding UTF-8. With html syntax highlighting on you just have to make sure that you only modify the black text (and not the colored tags).

How to submit

For the translation to show up as new language option in Cyclos (local settings) it needs to be added by the Cyclos development team. Before sending the (to ccsoftware@strohalm.nl) please make sure that:

• All files are in the UTF-8 encoding format
• All the files have the same name and extension as they where downloaded (see above 'files to translate')
• Are the files are up to date with the latest release (see the FAQ project site). There might changes or new keys / help files, this can be checked in the changelog.txt (available in the download packages)

Note: The translation of the help files is considerable work. If properties files are ready you can send them so that we can include them already in Cyclos. The help files can be added in a later stage.

Notes / Tips

• In the editor. Take much care with ‘find & replace’ functions. It can be a good help but there is a high risk making changes that you do not want.

• If you want to know to what helpfile a help icon in a Cyclos window is pointing you can see the help file and anchor name in the status bar of the browser when you hover with your mouse pointer over the help icon. Sometimes this option is deactivated by default in the browsers. For example in firefox you can enable it in the advanced options of JavaScript, check 'Change status bar text'

• Before posting it would be good to review the translation in a running Cyclos instance. In Cyclos you can view the helps by going to menu: Help - Manual and the separate sections by selecting the help icons in the function windows. Be aware that the manual and helps can display different information according to the type of logged user (operator, member, broker, admin)

• If more than one person works on the translation it is good that one person coordinates the translation to be sure used termonology is consistant. Normally this person would do also a final review before submitting (see above ´How to Submit´)

• When the translation is added to Cyclos any translation (application key, help or static file) can be modified from the administration section of Cyclos (Translations menu).