Translate and Localize Phex - Revision history

GregorK at 08:25, 4 August 2011

GregorK — Thu, 04 Aug 2011 08:25:47 GMT

←Older revision		Revision as of 08:25, 4 August 2011

	This tutorial explains which steps are necessary to translate Phex and test the translation inside Phex.<br> If you like to get involved, please also stop by at the [http://www.gnutellaforums.com/forumdisplay.php?f=103 Phex Localization-Forum]''		This tutorial explains which steps are necessary to translate Phex and test the translation inside Phex.<br> If you like to get involved, please also stop by at the [http://www.gnutellaforums.com/forumdisplay.php?f=103 Phex Localization-Forum]''
		+
		+
		+	'''<span style="font-size:1.2em;color:#DD0000;">WARNING: This guide is outdated.</span> We are now using a different translation concept. Please contact us through the [http://www.gnutellaforums.com/forumdisplay.php?f=103 Phex Localization-Forum] for more information'''
		+

	The tutorial will use the term '''PHEX_HOME''' to specify the Phex installation directory on your system.		The tutorial will use the term '''PHEX_HOME''' to specify the Phex installation directory on your system.

GregorK: /* Test the translation */

GregorK — Mon, 15 Dec 2008 00:10:04 GMT

Test the translation

←Older revision		Revision as of 00:10, 15 December 2008


	== Test the translation ==		== Test the translation ==
-	That's all, if you did everything accordingly using the EXACT initials of your language your translation ~~must~~ be in the language section of the Options Dialog of Phex.	+	That's all, if you did everything accordingly using the EXACT initials of your language your translation should now be in the language section of the Options Dialog of Phex.

	== Share your experience ==		== Share your experience ==

GregorK: /* Configure Phex */

GregorK — Mon, 15 Dec 2008 00:09:20 GMT

Configure Phex

←Older revision		Revision as of 00:09, 15 December 2008

	== Configure Phex ==		== Configure Phex ==

-	Create a new file called language.list and add a single line representing your language and country code in the form [lang]_[COUNTRY] e.g. pt_BR, es_ES, nl_NL	+	Create a new file called '''language.list''' in the '''PHEX_HOME\ext''' directory and add a single line representing your language and country code in the form [lang]_[COUNTRY] e.g. pt_BR, es_ES, nl_NL
	You'll have to create this file to make your translation be recognized by Phex.		You'll have to create this file to make your translation be recognized by Phex.

GregorK at 00:08, 15 December 2008

GregorK — Mon, 15 Dec 2008 00:08:15 GMT

←Older revision		Revision as of 00:08, 15 December 2008

	Before you start with translation you need to create the directory: '''PHEX_HOME\ext'''		Before you start with translation you need to create the directory: '''PHEX_HOME\ext'''

-	Now download a copy of the Phex language file [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/~~java~~/phex/resources/Lang.properties Lang.properties] and save it in the '''PHEX_HOME\ext''' directory. The [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/~~java~~/phex/resources/Lang.properties Lang.properties] will be used as a template you can use for your translations.	+	Now download a copy of the Phex language file [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/resources/phex/resources/Lang.properties Lang.properties] and save it in the '''PHEX_HOME\ext''' directory. The [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/resources/phex/resources/Lang.properties Lang.properties] will be used as a template you can use for your translations.
-	Rename the [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/~~java~~/phex/resources/Lang.properties Lang.properties] file in your '''PHEX_HOME\ext''' directory to include your ISO language code using this pattern: '''Lang_[lang]_[COUNTRY].properties''' <br> After "Lang" there must be an underline then the first 2 letters or the language are lowercase, then separated by underline then the last 2 letters or the country are uppercase, this must always be respected.	+	Rename the [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/resources/phex/resources/Lang.properties Lang.properties] file in your '''PHEX_HOME\ext''' directory to include your ISO language code using this pattern: '''Lang_[lang]_[COUNTRY].properties''' <br> After "Lang" there must be an underline then the first 2 letters or the language are lowercase, then separated by underline then the last 2 letters or the country are uppercase, this must always be respected.

	=== Examples ===		=== Examples ===

GregorK at 18:44, 4 June 2008

GregorK — Wed, 04 Jun 2008 18:44:42 GMT

←Older revision		Revision as of 18:44, 4 June 2008

	* Portuguese (pt_BR)		* Portuguese (pt_BR)

		+
		+	''This guide is updated with the help of Felipe experience while translation Phex to pt_BR''
	[[Category:Development]]		[[Category:Development]]

GregorK: Localize Phex moved to Translate and Localize Phex

GregorK — Wed, 04 Jun 2008 18:43:05 GMT

Localize Phex moved to Translate and Localize Phex

←Older revision

Revision as of 18:43, 4 June 2008

GregorK at 18:42, 4 June 2008

GregorK — Wed, 04 Jun 2008 18:42:32 GMT

←Older revision		Revision as of 18:42, 4 June 2008

-	[~~[Category~~:~~Development]~~]	+	This tutorial explains which steps are necessary to translate Phex and test the translation inside Phex.<br> If you like to get involved, please also stop by at the [http://www.gnutellaforums.com/forumdisplay.php?f=103 Phex Localization-Forum]''

-	''~~This file outlines~~ the ~~localization process~~. ~~If you want to get involved, please also stop by~~ at ~~the [http~~:~~//www~~.~~gnutellaforums~~.~~com/forumdisplay.php?f=103 Localization-Forum]~~''	+	The tutorial will use the term '''PHEX_HOME''' to specify the Phex installation directory on your system.
		+	On windows this will likely be at '''c:\Program Files\Phex x.x.x'''

-	==~~The easy way~~==	+	== Create the language file ==

-	~~The simplest way~~ to ~~localize Phex is to grab a copy of our Language-File:~~	+	Before you start with translation you need to create the directory: '''PHEX_HOME\ext'''
-	~~[https~~:~~//phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/java/phex/resources/Lang.properties Lang.properties] and translate it.~~	+

-	~~While doing so, we~~'d be ~~glad to meet~~ you ~~in our~~ [~~http~~://~~www~~.~~gnutellaforums~~.~~com~~/~~forumdisplay~~.~~php?f=103 Localization-Board~~].	+	Now download a copy of the Phex language file [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/java/phex/resources/Lang.properties Lang.properties] and save it in the '''PHEX_HOME\ext''' directory. The [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/java/phex/resources/Lang.properties Lang.properties] will be used as a template you can use for your translations.
		+	Rename the [https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/java/phex/resources/Lang.properties Lang.properties] file in your '''PHEX_HOME\ext''' directory to include your ISO language code using this pattern: '''Lang_[lang]_[COUNTRY].properties''' <br> After "Lang" there must be an underline then the first 2 letters or the language are lowercase, then separated by underline then the last 2 letters or the country are uppercase, this must always be respected.

-	==~~Testing the Translation and background~~==	+	=== Examples ===
		+	* Lang_es_ES.properites -> Spanish, Spain
		+	* Lang_es_MX.properites -> Spanish, Mexico
		+	* Lang_fr_FR.properties -> French, France

-	* Create a file ~~$PHEX/ext/language.list and add a single line representing~~ your ~~language and country code in the form [lang]_[COUNTRY] e~~.~~g. en_US, nl_NL or de_DE.<br />~~	+	Now is time to translate your language file with your favorite text editor.
-	~~($PHEX is the Phex installation folder.)<br />~~	+	On Windows you can use Notepad.
-	~~The language.list file is used to build the language list in the UI~~.	+

		+	== Configure Phex ==

-	* Create a file ~~$PHEX/ext/Lang_[lang]_[COUNTRY].properties or $PHEX/ext/Lang_[lang]~~.~~properties~~ and ~~translate~~ the ~~text in it. Of course~~ [lang]_[COUNTRY] ~~should again represent~~ your ~~language and country code~~.	+	Create a new file called language.list and add a single line representing your language and country code in the form [lang]_[COUNTRY] e.g. pt_BR, es_ES, nl_NL
		+	You'll have to create this file to make your translation be recognized by Phex.

-	* You can find the current english language file~~, which~~ you can use as a ~~template for translations in the Phex CVS.~~	+	To edit this file on Windows you can use a editor like Notepad.
-	~~[https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/java/phex/resources/Lang.properties Lang~~.~~properties]~~	+

-	* The order Phex uses to search for translations is ~~nl_NL~~, ~~then nl~~ and ~~then~~ it ~~will fallback to use the default english language file. The first found translation will be used~~.	+	After the file is edited, save and close it.

-	~~-----~~	+	== Test the translation ==
		+	That's all, if you did everything accordingly using the EXACT initials of your language your translation must be in the language section of the Options Dialog of Phex.

-	~~Avaible languages~~:	+	== Share your experience ==
		+	If you have any questions regarding the translation of Phex or like to share your experience please stop by at the [http://www.gnutellaforums.com/forumdisplay.php?f=103 Phex Localization-Forum]

-	Phex is ~~avaible~~ in:	+	== Further Information ==
		+
		+	When Phex looks for a translation of a term it will always follow the following steps and uses the first term found:
		+	* First it will check if the term is available in a language + country definition, e.g: es_MX -> Lang_es_MX.properties
		+	* If not found it will look for for a definition for the language, e.g: es -> Lang_es.properties
		+	* If the term was still not found it will fallback to the default english language file, Lang.properties
		+
		+	== Available languages ==
		+
		+	Phex is available in:
	* English (en_EN)		* English (en_EN)
-	* ~~Nederlands~~ (nl_NL)	+	* Dutch (nl_NL)
	* German (de_DE, de_DE_WW, de_DE_GG)		* German (de_DE, de_DE_WW, de_DE_GG)
	* French (fr_FR)		* French (fr_FR)
	* Turkish		* Turkish
	* Spanish (es_ES, es_MX)		* Spanish (es_ES, es_MX)
		+	* Portuguese (pt_BR)

-	~~-----~~	+	[[Category:Development]]
-	~~Further Readings~~ [~~http~~:~~//www.gnutellaforums.com/showthread.php?s=&threadid=26759 Phex Forum - How to localize Phex~~]	+

GregorK at 18:10, 4 June 2008

GregorK — Wed, 04 Jun 2008 18:10:17 GMT

←Older revision		Revision as of 18:10, 4 June 2008


	* Create a file $PHEX/ext/language.list and add a single line representing your language and country code in the form [lang]_[COUNTRY] e.g. en_US, nl_NL or de_DE.<br />		* Create a file $PHEX/ext/language.list and add a single line representing your language and country code in the form [lang]_[COUNTRY] e.g. en_US, nl_NL or de_DE.<br />
-	($PHEX is the folder which contains the *.~~jar files~~)<br />	+	($PHEX is the Phex installation folder.)<br />
	The language.list file is used to build the language list in the UI.		The language.list file is used to build the language list in the UI.

LuisC-SM: /* Testing the Translation and background */

LuisC-SM — Wed, 07 May 2008 16:48:46 GMT

Testing the Translation and background

←Older revision		Revision as of 16:48, 7 May 2008

	* Nederlands (nl_NL)		* Nederlands (nl_NL)
	* German (de_DE, de_DE_WW, de_DE_GG)		* German (de_DE, de_DE_WW, de_DE_GG)
		+	* French (fr_FR)
		+	* Turkish
		+	* Spanish (es_ES, es_MX)

	-----		-----
	Further Readings [http://www.gnutellaforums.com/showthread.php?s=&threadid=26759 Phex Forum - How to localize Phex]		Further Readings [http://www.gnutellaforums.com/showthread.php?s=&threadid=26759 Phex Forum - How to localize Phex]

ArneBab: /* Testing the Translation and background */

ArneBab — Thu, 01 May 2008 13:35:27 GMT

Testing the Translation and background

←Older revision		Revision as of 13:35, 1 May 2008


	* You can find the current english language file, which you can use as a template for translations in the Phex CVS.		* You can find the current english language file, which you can use as a template for translations in the Phex CVS.
-	[~~http~~://svn.sourceforge.net/~~viewvc~~/phex/phex/trunk/src/phex/resources/Lang.properties~~?view=markup~~ Lang.properties]	+	[https://phex.svn.sourceforge.net/svnroot/phex/phex/trunk/src/main/java/phex/resources/Lang.properties Lang.properties]

	* The order Phex uses to search for translations is nl_NL, then nl and then it will fallback to use the default english language file. The first found translation will be used.		* The order Phex uses to search for translations is nl_NL, then nl and then it will fallback to use the default english language file. The first found translation will be used.