Translation: Difference between revisions

From FreeMind
Jump to navigationJump to search
Line 42: Line 42:


To convert a file in UTF-8 into \uXXXX Unicode escape notation, you may use [http://java.sun.com/j2se/1.3/docs/tooldocs/win32/native2ascii.html native2ascii] tool included with the Java SDK. Example of use (Resources_cs.properties.txt is before conversion):
To convert a file in UTF-8 into \uXXXX Unicode escape notation, you may use [http://java.sun.com/j2se/1.3/docs/tooldocs/win32/native2ascii.html native2ascii] tool included with the Java SDK. Example of use (Resources_cs.properties.txt is before conversion):
<small><!-- Better in CSS style sheet -->


  cd C:\j2sdk1.4.2\bin>
  cd C:\j2sdk1.4.2\bin>
  native2ascii.exe -encoding UTF8 Resources_cs.properties.utf8.txt Resources_cs.properties
  native2ascii.exe -encoding UTF8 Resources_cs.properties.utf8.txt Resources_cs.properties
</small>


Ideally, your file's name will be ''Resources_xx.properties'', where ''xx'' is the code of the language (e.g. en, de, dk etc.).
Ideally, your file's name will be ''Resources_xx.properties'', where ''xx'' is the code of the language (e.g. en, de, dk etc.).


To convert \uXXXX Unicode encoded file back to UTF-8, use a command similar to the following.
To convert \uXXXX Unicode encoded file back to UTF-8, use a command similar to the following.
<small>


  cd C:\j2sdk1.4.2\bin>
  cd C:\j2sdk1.4.2\bin>
  native2ascii.exe '''-reverse''' -encoding UTF8 Resources_cs.properties Resources_cs.properties.utf8.txt
  native2ascii.exe '''-reverse''' -encoding UTF8 Resources_cs.properties Resources_cs.properties.utf8.txt
</small>


==Posting translations==
==Posting translations==

Revision as of 10:53, 2 June 2007

 

How to contribute translations to FreeMind follows.

Step-by-step overview

  1. Choose the editing tool if getting started.
  2. Get the latest English translation.
  3. Get the latest translation for your language.
  4. Find and complete what is missing.
  5. Post to Translations tracker.

Getting the latest translations

Look for a translation into your language present in the development branch. If such a translation is not present, take the latest revision of Resources_en.properties.

Choosing the editing tool

Translation files can be edited using variety of tools.

Popeye

Popeye Screenshot | Download can deal with several language property files at the same time, so you can contrast the original property file data with their translations. Also, the program can highlight all properties that do not have a translation set in one of the selected languages.

After a short test, I can recommend Popeye. No installation needed, works fine, looks good, and has a nice web.--Danielpolansky 03:26, 2 Jun 2007 (PDT)

Propedit

PropeditScreenshot can directly edit property files written in Unicode reference characters, thereby saving the time and effort of converting into Unicode through native2ascii. Its plugin is integrated with Eclipse and JBuilder. Files can be opened in the IDE and saved in Unicode. See also Propedit project page.

Plain text editor

A plain text editor is the tool of choice if you are well acquainted with them and prefer them. If so, you already probably have your favorite tool. If not, these tools include Microsoft Notepad, Notepad++, Vim, Emacs and a vast variety of other tools.

Using plain text editor is more tricky in that the language translation files are using Java unicode notatiton, encoding a single non-latin character like \u4567, making the file less readable. A workaround is to convert the language file into UTF-8 encoding first, then edit it, and finally convert to Java notation again. The conversion is described in the following section. Once the text is in UTF-8 encoding, tools like Microsoft Notepad can be used, and the non-latin characters are shown as you would see them in a WYSIWYG editor. However, various plain text editors differ in their capability to show UTF-8 characters. Notepad on Windows XP is definitely able to do that.

Converting between Unicode notations

To convert a file in UTF-8 into \uXXXX Unicode escape notation, you may use native2ascii tool included with the Java SDK. Example of use (Resources_cs.properties.txt is before conversion):

cd C:\j2sdk1.4.2\bin>
native2ascii.exe -encoding UTF8 Resources_cs.properties.utf8.txt Resources_cs.properties

Ideally, your file's name will be Resources_xx.properties, where xx is the code of the language (e.g. en, de, dk etc.).

To convert \uXXXX Unicode encoded file back to UTF-8, use a command similar to the following.

cd C:\j2sdk1.4.2\bin>
native2ascii.exe -reverse -encoding UTF8 Resources_cs.properties Resources_cs.properties.utf8.txt

Posting translations

Send your translation to Translations tracker. To be able to do it, you need a SourceForge user.

Using new translation in FreeMind

  1. Write or download the Resources_xx.properties file.
  2. Unpack the freemind.jar file with 7-Zip or similar into a temp folder.
  3. Replace or add the Resources_xx.properties with the new one.
  4. Repack the freemind.jar with the modified content of the temp folder.

State of translation

Currently, we have the following languages translated. The table below is out of date. It would be nice if the translators would update it. Up-to-date information of the state of translation can in any case be found in CVS and in Translations tracker.

Already Translated Languages
Language Language Short If released Translator Reviewer Capitalized Titles
Czech Česky cs not released Radek Švarz Daniel Polansky No
Chinese trad.chinese zh released william chen    
Chinese simp.chinese zh_CN not released william chen    
Danish Dansk dk released
Dutch Nederlands nl released Koen Roggemans No
English English en released N/A Yes
Finnish Suomi fi not released Matti Lassila
French Francais fr released
German Deutsch de released Christian Foltin
Hungarian ? not released documan
Italian Italiano it released Bob Alexander
Japanese Nihongo ja released Kohichi Aoki
Korean Hangeul kr released(rc5) Kim Jong Woo
Polish Polski pl not released Rafal Kraik No
Portuguese Português pt not released Luis Ferreira
Brazilian Portuguese Português brasileiro pt_BR not released Rodrigo Rizzi Starr
Russian Pусский ru not released Prokudin Alexander
Slovenian sl released Martin Srebotnjak - filmsi No?
Spanish Espanol es released Hugo Gayosso Yes
Turkish Türkçe tr not released Uğur Çetin Yes