Localization - Revision history

Barak: Fixed quote characters

2012-08-25T13:16:39Z

Fixed quote characters

Karianna at 12:17, 25 August 2012

2012-08-25T12:17:04Z

Karianna at 12:16, 25 August 2012

2012-08-25T12:16:43Z

Masaru20100: /* My Process */

2012-08-25T03:31:23Z

‎My Process

Masaru20100: Added part on encoding of bundles, nowiki tag for scripts.

2012-08-25T02:29:56Z

Added part on encoding of bundles, nowiki tag for scripts.

Masaru20100: /* My Process */

2012-08-24T16:44:45Z

‎My Process

Masaru20100: /* My Process */

2012-08-24T16:44:11Z

‎My Process

Masaru20100: New page on l8n

2012-08-24T16:43:47Z

New page on l8n

New page

Localization (l8n) is the process of adapting software for its use in a particular location. It can only be done if the software has been [[internationnalized|Internationnalisation]] (i10n). It is mainly translation.

In the case of PCGen, as with other free software, localization can only be done with the help of the community.

PCGen both need translation for its user interface (UI) and its data. The data can not be translated for now (as of August 25th 2012), because the internationnalization for the data is not yet done. On top of it, PCGen data is mostly non-free, so providing translation has legal repercutions.

The translation of the UI is simpler. There is a file for each language, and basically you need to translate all the messages. Beware that, as of August 25th 2012, there is many unused strings in the files.

(eventually write more for beginners in l8n, provide links?)

== My Process ==

PCGen uses Java’s ResourceBundle, and use cryptic text as the key of strings (unlike PO that indicate to use ASCII text as keys). It means you need to see two text files at the same time to view original files. Do not edit a copy of another language file, because you’d have a file with a mix of the target language and the copied language, which make it difficult to see what is not yet translated (and also harder to merge). I don’t like the ResourceBundle format because it does not allow me to keep the information that my translations on some strings might not be good. That’s why I keep my main translation in po files and not in bundles.

Each time I update my svn copy, I create a new POT file from the default resource bundle. Then I update my latest po file of the language I’m working on, update it with the POT file and save it with a new name (using the svn version number). I then proceed to edit the po file. I save the file, update the resource bundle in the code directory then (I think its needed to see changes) build pcgen.

To update, I just do

# svn up

To create the new POT, I use prop2po which is part of the package translate-toolkit on Debian. I have a little script that I usually call with the svn number.

# newpot 17045

''newpot''

#!/bin/zsh

# argument is name of version
if [[ -z $1 ]];
then
echo Argument needed
exit 1
else
name=.$1
fi

# Create the new POT from the Language bundle
prop2po ../pcgen-svn/code/src/java/pcgen/resources/lang/LanguageBundle.properties LanguageBundle$name.pot
#po2xliff -P LanguageBundle$name.pot LanguageBundle$name.xlf

I use virtaal to open the latest po file, update it with the POT then save it with the new version number (poedit would work fine but doesn’t show the comments in the po file). I then edit the file.

Once my change are done, or I want to view them, I use a script to update the resource bundle file. You’ll have to change the name of the language you’d work with there (fr ja en_GB in my case). It uses po2prop also part of the translate-toolkit package.

# updatebundle 17045

''updatebundle''

#!/bin/zsh

# argument is name of version
if [[ -z $1 ]];
then
echo Argument needed
exit 1
fi

# Create the new POT from the Language bundle
for lang in fr ja en_GB
do
if [[ -f LanguageBundle.$1.$lang.po ]];
then
po2prop --fuzzy --errorlevel=traceback -t ../pcgen-svn/code/src/java/pcgen/resources/lang/LanguageBundle.properties LanguageBundle.$1.$lang.po ../pcgen-svn/code/src/java/pcgen/resources/lang/LanguageBundle_$lang.properties
fi
done

I hope those scripts help some one, you’ll probably need to change them (to fix the path for example).

← Older revision		Revision as of 12:17, 25 August 2012
Line 1:		Line 1:
−	Localization (l8n) is the process of adapting software for its use in a particular location. It can only be done if the software has been [[~~Internationnalization~~\|internationnalized]] (i10n). It is mainly translation.	+	Localization (l8n) is the process of adapting software for its use in a particular location. It can only be done if the software has been [[Internationalization\|internationnalized]] (i10n). It is mainly translation.

	In the case of PCGen, as with other free software, localization can only be done with the help of the community.		In the case of PCGen, as with other free software, localization can only be done with the help of the community.

← Older revision		Revision as of 12:16, 25 August 2012
Line 1:		Line 1:
−	Localization (l8n) is the process of adapting software for its use in a particular location. It can only be done if the software has been [[internationnalized~~\|Internationnalization~~]] (i10n). It is mainly translation.	+	Localization (l8n) is the process of adapting software for its use in a particular location. It can only be done if the software has been [[Internationnalization\|internationnalized]] (i10n). It is mainly translation.

	In the case of PCGen, as with other free software, localization can only be done with the help of the community.		In the case of PCGen, as with other free software, localization can only be done with the help of the community.

← Older revision		Revision as of 16:44, 24 August 2012
Line 67:		Line 67:

	I hope those scripts help some one, you’ll probably need to change them (to fix the path for example).		I hope those scripts help some one, you’ll probably need to change them (to fix the path for example).
		+
		+	[[User:Masaru20100\|Masaru20100]] 03:44, 25 August 2012 (MIST)

@@ Line 3: / Line 3: @@
 In the case of PCGen, as with other free software, localization can only be done with the help of the community.
-PCGen both need translation for its user interface (UI) and its data. The data can not be translated for now (as of August 25th 2012), because the internationnalization for the data is not yet done. On top of it, PCGen data is mostly non-free, so providing translation has legal repercutions.
+PCGen both need translation for its user interface (UI) and its data. The data can not be translated for now (as of August 25th 2012), because the internationnalization for the data is not yet done.
-The translation of the UI is simpler. There is a file for each language, and basically you need to translate all the messages. Beware that, as of August 25th 2012, there is many unused strings in the files.
+The translation of the UI is simpler. There is a file for each language, and basically you need to translate all the messages. Beware that, as of August 25th 2012, there are still many unused strings in the files.
 == My Process ==
@@ Line 13: / Line 11: @@
 By [[User:Masaru20100|Masaru20100]] 03:44, 25 August 2012 (MIST)
+PCGen uses Java's ResourceBundle, and use cryptic text as the key of strings (unlike PO that indicate to use ASCII text as keys). It means you need to see two text files at the same time to view original files. Do not edit a copy of another language file, because you'd have a file with a mix of the target language and the copied language, which make it difficult to see what is not yet translated (and also harder to merge). I don't like the ResourceBundle format because it does not allow me to keep the information that my translations on some strings might not be good. That's why I keep my main translation in po files and not in bundles.
 Another reason to keep separated files, is that only ASCII characters can be included in a ResourceBundle, other characters need to be unicode escaped (things like \u0145).
-Each time I update my svn copy, I create a new POT file from the default resource bundle. Then I update my latest po file of the language I’m working on, update it with the POT file and save it with a new name (using the svn version number). I then proceed to edit the po file. I save the file, update the resource bundle in the code directory then (I think its needed to see changes) build pcgen.
+Each time I update my svn copy, I create a new POT file from the default resource bundle. Then I update my latest po file of the language I'm working on, update it with the POT file and save it with a new name (using the svn version number). I then proceed to edit the po file. I save the file, update the resource bundle in the code directory then (I think its needed to see changes) build pcgen.
 To update, I just do

@@ Line 29: / Line 29: @@
 ''newpot''
-<nowiki>
   #!/bin/zsh
   # argument is name of version
-  if [[ -z $1 ]];
+  <nowiki>if [[ -z $1 ]];</nowiki>
   then
           echo Argument needed
@@ Line 43: / Line 43: @@
   # Create the new POT from the Language bundle
   prop2po ../pcgen-svn/code/src/java/pcgen/resources/lang/LanguageBundle.properties LanguageBundle$name.pot
-  #po2xliff -P LanguageBundle$name.pot LanguageBundle$name.xlf</nowiki>
+  #po2xliff -P LanguageBundle$name.pot LanguageBundle$name.xlf
 I use virtaal to open the latest po file, update it with the POT then save it with the new version number (poedit would work fine but doesn’t show the comments in the po file). I then edit the file.
@@ Line 52: / Line 52: @@
 ''updatebundle''
-<nowiki>
   #!/bin/zsh
   # argument is name of version
-  if [[ -z $1 ]];
+  if <nowiki>[[ -z $1 ]];</nowiki>
   then
           echo Argument needed
@@ Line 65: / Line 65: @@
   for lang in fr ja en_GB
   do
-          if [[ -f LanguageBundle.$1.$lang.po ]];
+          <nowiki>if [[ -f LanguageBundle.$1.$lang.po ]];</nowiki>
           then
                   po2prop --fuzzy --errorlevel=traceback -t ../pcgen-svn/code/src/java/pcgen/resources/lang/LanguageBundle.properties LanguageBundle.$1.$lang.po ../pcgen-svn/code/src/java/pcgen/resources/lang/LanguageBundle_$lang.properties
           fi
   done
 I hope those scripts help some one, you’ll probably need to change them (to fix the path for example).

@@ Line 10: / Line 10: @@
 == My Process ==
 PCGen uses Java’s ResourceBundle, and use cryptic text as the key of strings (unlike PO that indicate to use ASCII text as keys). It means you need to see two text files at the same time to view original files. Do not edit a copy of another language file, because you’d have a file with a mix of the target language and the copied language, which make it difficult to see what is not yet translated (and also harder to merge). I don’t like the ResourceBundle format because it does not allow me to keep the information that my translations on some strings might not be good. That’s why I keep my main translation in po files and not in bundles.
@@ Line 67: / Line 70: @@
 I hope those scripts help some one, you’ll probably need to change them (to fix the path for example).