Internationalization - Historique des versions

Admin : /* Create a "PO" file" */

2019-04-01T10:33:26Z

Create a "PO" file"

← Version précédente		Version du 1 avril 2019 à 10:33
Ligne 76 :		Ligne 76 :
	Once this '''PO''' file is created, we will have to modify it to add the right translation. Below is an example of a part of such file (the third string is not translated).		Once this '''PO''' file is created, we will have to modify it to add the right translation. Below is an example of a part of such file (the third string is not translated).

	<font color=#FF0000>Note : be careful of the fact that inside the header the predefined character set is not allways put to UTF-8 but sometimes to CP1252 ; in case of it, change it !</font>		''<font color=#FF0000>Note : be careful of the fact that inside the header the predefined character set is not allways put to UTF-8 but sometimes to CP1252 ; in case of it, change it !</font>''

	"Content-Type: text/plain; charset=UTF-8\n"		"Content-Type: text/plain; charset=UTF-8\n"

Admin : /* Create Java resources */

2019-04-01T10:32:44Z

Create Java resources

← Version précédente		Version du 1 avril 2019 à 10:32
Ligne 108 :		Ligne 108 :
	* "dirRes" is the directory where the resources will be stored		* "dirRes" is the directory where the resources will be stored
	* "messFileName" is the prefix of the name of the final file (where the .class suffix will be added)		* "messFileName" is the prefix of the name of the final file (where the .class suffix will be added)
	* "ll" is the language		* "ll" is the language (as "en", "fr", "es", ...)

	So, the final name will be dirRes/messFileName_ll.class		So, the final name will be ''dirRes/messFileName_ll.class''

	== Create the i18n.properties file ==		== Create the i18n.properties file ==

Admin : /* Create a "PO" file" */

2019-04-01T10:32:00Z

Create a "PO" file"

← Version précédente		Version du 1 avril 2019 à 10:32
Ligne 76 :		Ligne 76 :
	Once this '''PO''' file is created, we will have to modify it to add the right translation. Below is an example of a part of such file (the third string is not translated).		Once this '''PO''' file is created, we will have to modify it to add the right translation. Below is an example of a part of such file (the third string is not translated).

	Be careful of the fact that inside the header the predefined character set is not allways put to UTF-8 but sometimes to CP1252 ; in case of it, change it !		<font color=#FF0000>Note : be careful of the fact that inside the header the predefined character set is not allways put to UTF-8 but sometimes to CP1252 ; in case of it, change it !</font>

	"Content-Type: text/plain; charset=UTF-8\n"		"Content-Type: text/plain; charset=UTF-8\n"
Ligne 91 :		Ligne 91 :
	msgstr ""		msgstr ""

	If you prefer not to enter directly inside the file, you may also use some utilities as [[http://poedit.net/.\|poedit]]		If you prefer not to enter directly inside the file, you may also use some utilities as [[http://poedit.net/.\|poedit]]

	== Concatenate "po" files" (optional) ==		== Concatenate "po" files" (optional) ==

Admin : /* Create Java resources */

2019-04-01T10:29:32Z

Create Java resources

← Version précédente		Version du 1 avril 2019 à 10:29
Ligne 106 :		Ligne 106 :

	... where:		... where:
	* dirRes is the directory where the resources will be stored		* "dirRes" is the directory where the resources will be stored
	* messFileName is the name of the final file (where the .class suffix will be added)		* "messFileName" is the prefix of the name of the final file (where the .class suffix will be added)
			* "ll" is the language

			So, the final name will be dirRes/messFileName_ll.class

	== Create the i18n.properties file ==		== Create the i18n.properties file ==

Admin le 10 juillet 2017 à 08:00

2017-07-10T08:00:05Z

← Version précédente		Version du 10 juillet 2017 à 08:00
Ligne 66 :		Ligne 66 :
	Then, we will create a '''PO''' file using using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msginit-Invocation.html#index-msginit msginit]] if the file does not exist:		Then, we will create a '''PO''' file using using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msginit-Invocation.html#index-msginit msginit]] if the file does not exist:

	~~<syntaxhighlight>~~		msginit.exe --input=potFileName --output=poFileName
	msginit.exe --input=potFileName --output=poFileName
	~~</syntaxhighlight>~~

	... or [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgmerge-Invocation.html#index-msgmerge msgmerge]] if it already exists:		... or [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgmerge-Invocation.html#index-msgmerge msgmerge]] if it already exists:

	~~<syntaxhighlight>~~		msgmerge.exe -U poFileName potFileName
	msgmerge.exe -U poFileName potFileName
	~~</syntaxhighlight>~~

	The suffix of the potFileName will be '''.pot''' as the suffix of the poFileName file will be '''.ll.po''' where ll is the ''locale'' used (fr, en, sp, ...).		The suffix of the potFileName will be '''.pot''' as the suffix of the poFileName file will be '''.ll.po''' where ll is the ''locale'' used (fr, en, sp, ...).
Ligne 82 :		Ligne 78 :
	Be careful of the fact that inside the header the predefined character set is not allways put to UTF-8 but sometimes to CP1252 ; in case of it, change it !		Be careful of the fact that inside the header the predefined character set is not allways put to UTF-8 but sometimes to CP1252 ; in case of it, change it !

	~~<syntaxhighlight>~~		"Content-Type: text/plain; charset=UTF-8\n"
	"Content-Type: text/plain; charset=UTF-8\n"
			...
	...
			msgid "Button"
	msgid "Button"		msgstr "Bouton"
	msgstr "Bouton"
			msgid "Character string entry:"
	msgid "Character string entry:"		msgstr "Saisie d'une chaîne de caractères:"
	msgstr "Saisie d'une chaîne de caractères:"
			msgid "Integer entry:"
	msgid "Integer entry:"		msgstr ""
	msgstr ""

	~~</syntaxhighlight>~~

	If you prefer not to enter directly inside the file, you may also use some utilities as [[http://poedit.net/.\|poedit]]		If you prefer not to enter directly inside the file, you may also use some utilities as [[http://poedit.net/.\|poedit]]
Ligne 104 :		Ligne 97 :
	In case you use other po files (coming from other applications), it is possible to concatenate them using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgcat-Invocation.html#index-msgcat msgcat]]:		In case you use other po files (coming from other applications), it is possible to concatenate them using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgcat-Invocation.html#index-msgcat msgcat]]:

	~~<syntaxhighlight>~~		msgcat –o finalpoFileName poFileName otherPoFileNames
	msgcat –o finalpoFileName poFileName otherPoFileNames
	~~</syntaxhighlight>~~

	== Create Java resources ==		== Create Java resources ==
Ligne 112 :		Ligne 103 :
	The last step is to create Java message resource bundles files with messages that will be incorporated to the application jar file. To generate these resource bundles the [https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgfmt-Invocation.html#index-msgfmt msgfmt] command will be used:		The last step is to create Java message resource bundles files with messages that will be incorporated to the application jar file. To generate these resource bundles the [https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgfmt-Invocation.html#index-msgfmt msgfmt] command will be used:

	~~<syntaxhighlight>~~		msgfmt --verbose --java2 -d dirRes -r messFileName -l ll poFileName
	msgfmt --verbose --java2 -d dirRes -r messFileName -l ll poFileName
	~~</syntaxhighlight>~~

	... where:		... where:
Ligne 124 :		Ligne 113 :
	This file has just to contain one line indicating the name of the resource file.		This file has just to contain one line indicating the name of the resource file.

	~~<syntaxhighlight >~~		basename=messFileName
	basename=messFileName
	~~</syntaxhighlight>~~

	== A good solution to store all these files ... ==		== A good solution to store all these files ... ==

Admin le 10 juillet 2017 à 07:58

2017-07-10T07:58:38Z

← Version précédente		Version du 10 juillet 2017 à 07:58
Ligne 55 :		Ligne 55 :
	To create such '''POT''' file (here called '''test.pot'''), we will have to use [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/xgettext-Invocation.html#index-xgettext xgettext]] as is:		To create such '''POT''' file (here called '''test.pot'''), we will have to use [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/xgettext-Invocation.html#index-xgettext xgettext]] as is:

	~~<syntaxhighlight >~~		xgettext.exe -ktrc:1c,2 -ktrnc:1c,2,3 -ktr -kmarktr -ktrn:1,2
	xgettext.exe -ktrc:1c,2 -ktrnc:1c,2,3 -ktr -kmarktr -ktrn:1,2		--from-code=UTF-8 --force-po
	--from-code=UTF-8 --force-po		-o po/test.pot $path_java_sources/*.java
	-o po/test.pot $path_java_sources/*.java
	~~</syntaxhighlight>~~

	where $path_java_sources represent the path to go to search for java sources.		where $path_java_sources represent the path to go to search for java sources.

Admin le 5 mai 2017 à 12:53

2017-05-05T12:53:23Z

← Version précédente		Version du 5 mai 2017 à 12:53
Ligne 125 :		Ligne 125 :
	This file has just to contain one line indicating the name of the resource file.		This file has just to contain one line indicating the name of the resource file.

	<~~code~~>		<syntaxhighlight >
	basename=messFileName		basename=messFileName
	</syntaxhighlight>		</syntaxhighlight>

Admin le 5 mai 2017 à 12:52

2017-05-05T12:52:43Z

← Version précédente		Version du 5 mai 2017 à 12:52
Ligne 55 :		Ligne 55 :
	To create such '''POT''' file (here called '''test.pot'''), we will have to use [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/xgettext-Invocation.html#index-xgettext xgettext]] as is:		To create such '''POT''' file (here called '''test.pot'''), we will have to use [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/xgettext-Invocation.html#index-xgettext xgettext]] as is:

	<~~code~~>		<syntaxhighlight >
	xgettext.exe -ktrc:1c,2 -ktrnc:1c,2,3 -ktr -kmarktr -ktrn:1,2		xgettext.exe -ktrc:1c,2 -ktrnc:1c,2,3 -ktr -kmarktr -ktrn:1,2
	--from-code=UTF-8 --force-po		--from-code=UTF-8 --force-po

Admin le 5 mai 2017 à 12:51

2017-05-05T12:51:58Z

← Version précédente		Version du 5 mai 2017 à 12:51
Ligne 53 :		Ligne 53 :
	== Create a "POT" file ==		== Create a "POT" file ==

	To create such '''POT''' file (here called '''test.pot'''), we will have to use [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/xgettext-Invocation.html#index-xgettext\|xgettext]] as is:		To create such '''POT''' file (here called '''test.pot'''), we will have to use [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/xgettext-Invocation.html#index-xgettext xgettext]] as is:

	<code>		<code>
Ligne 65 :		Ligne 65 :
	== Create a "PO" file" ==		== Create a "PO" file" ==

	Then, we will create a '''PO''' file using using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msginit-Invocation.html#index-msginit\|msginit]] if the file does not exist:		Then, we will create a '''PO''' file using using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msginit-Invocation.html#index-msginit msginit]] if the file does not exist:

	<syntaxhighlight>		<syntaxhighlight>
Ligne 71 :		Ligne 71 :
	</syntaxhighlight>		</syntaxhighlight>

	... or [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgmerge-Invocation.html#index-msgmerge\|msgmerge]] if it already exists:		... or [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgmerge-Invocation.html#index-msgmerge msgmerge]] if it already exists:

	<syntaxhighlight>		<syntaxhighlight>
Ligne 103 :		Ligne 103 :
	== Concatenate "po" files" (optional) ==		== Concatenate "po" files" (optional) ==

	In case you use other po files (coming from other applications), it is possible to concatenate them using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgcat-Invocation.html#index-msgcat\|msgcat]]:		In case you use other po files (coming from other applications), it is possible to concatenate them using [[https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgcat-Invocation.html#index-msgcat msgcat]]:

	<syntaxhighlight>		<syntaxhighlight>
Ligne 111 :		Ligne 111 :
	== Create Java resources ==		== Create Java resources ==

	The last step is to create Java message resource bundles files with messages that will be incorporated to the application jar file. To generate these resource bundles the [https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgfmt-Invocation.html#index-msgfmt\|msgfmt] command will be used:		The last step is to create Java message resource bundles files with messages that will be incorporated to the application jar file. To generate these resource bundles the [https://www.gnu.org/savannah-checkouts/gnu/gettext/manual/html_node/msgfmt-Invocation.html#index-msgfmt msgfmt] command will be used:

	<syntaxhighlight>		<syntaxhighlight>

Admin le 5 mai 2017 à 12:50

2017-05-05T12:50:51Z

← Version précédente		Version du 5 mai 2017 à 12:50
Ligne 17 :		Ligne 17 :
	<u>Methods Usage</u>:		<u>Methods Usage</u>:

	\| <font color=#4169E1>GEnvironment.tr(String message)</font> \| Translate the message message \|		{\| class="wikitable"
	\| <font color=#4169E1>GEnvironment.trf(String formatString, Object... args)</font> \| Translate the format string and then calls to String.format with args \|		\|-
	\| <font color=#4169E1>GEnvironment.trn(String singularString, String pluralString, long n)</font> \| Translates the singularString and pluralString and returns the translated pluralString if n > 1\|		\| <font color=#4169E1>GEnvironment.tr(String message)</font>
			\| Translate the message message
			\|-
			\| <font color=#4169E1>GEnvironment.trf(String formatString, Object... args)</font>
			\| Translate the format string and then calls to String.format with args
			\|-
			\| <font color=#4169E1>GEnvironment.trn(String singularString, String pluralString, long n)</font>
			\| Translates the singularString and pluralString and returns the translated pluralString if n > 1
			\|}

	Only strings used with these three methods will be extracted by the xgettext tool and stored in the '''POT''' file ; other strings (identifiers, configuration file names, etc) will not be modified.		Only strings used with these three methods will be extracted by the xgettext tool and stored in the '''POT''' file ; other strings (identifiers, configuration file names, etc) will not be modified.

Internationalization - Historique des versions

Admin : /* Create a "PO" file" */

Admin : /* Create Java resources */

Admin : /* Create a "PO" file" */

Admin : /* Create Java resources */

Admin le 10 juillet 2017 à 08:00

Admin le 10 juillet 2017 à 07:58

Admin le 5 mai 2017 à 12:53

Admin le 5 mai 2017 à 12:52

Admin le 5 mai 2017 à 12:51

Admin le 5 mai 2017 à 12:50

Admin : /* Create a "PO" file" */

Admin : /* Create Java resources */

Admin : /* Create a "PO" file" */

Admin : /* Create Java resources */