Translation system - Revision history

Eldy at 22:26, 25 May 2021

2021-05-25T22:26:12Z

← Older revision		Revision as of 22:26, 25 May 2021
Line 18:		Line 18:

	There are two methods:		There are two methods:
	<~~source~~ lang="ini">		<syntaxHighlight lang="ini">
	$langs->trans('TRAD_STRING');		$langs->trans('TRAD_STRING');
	</~~source~~>		</syntaxHighlight>
	This method returns the translation of key TRAD_STRING, and encodes the result into HTML entities to allow to display correctly (even with special characters) on an HTML page.		This method returns the translation of key TRAD_STRING, and encodes the result into HTML entities to allow to display correctly (even with special characters) on an HTML page.
	<~~source~~ lang="ini">		<syntaxHighlight lang="ini">
	$langs->transnoentitiesnoconv('TRAD_STRING');		$langs->transnoentitiesnoconv('TRAD_STRING');
	</~~source~~>		</syntaxHighlight>
	This method returns the translation of key TRAD_STRING, but the result is the translated string with no particular encoding (string is stored in UTF-8 in memory).		This method returns the translation of key TRAD_STRING, but the result is the translated string with no particular encoding (string is stored in UTF-8 in memory).

Line 32:		Line 32:
	Note: If, as arguments, you use a string that is itself a translated string, you must use method $langs->transnoentitiesnoconv, otherwise the string will be encoded twice.		Note: If, as arguments, you use a string that is itself a translated string, you must use method $langs->transnoentitiesnoconv, otherwise the string will be encoded twice.
	Example:		Example:
	<~~source~~ lang="ini">		<syntaxHighlight lang="ini">
	print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))		print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))
	</~~source~~>		</syntaxHighlight>

	= Translate Dolibarr into another language =		= Translate Dolibarr into another language =
	See page [[Translator documentation]]		See page [[Translator documentation]]

PolyglotBot: Import interlang links (links to translated versions of this page in other languages) from Multi Language Manager table.

2019-07-23T13:21:52Z

Import interlang links (links to translated versions of this page in other languages) from Multi Language Manager table.

← Older revision		Revision as of 13:21, 23 July 2019
Line 1:		Line 1:
			<!-- BEGIN origin interlang links -->
			<!-- You can edit this section but do NOT remove these comments
			Links below will be automatically replicated on translated pages by PolyglotBot -->
			[[fr:Système_de_traduction]]
			[[es:Sistema_de_traducción]]
			[[zh:翻译]]
			<!-- END interlang links -->

	{{TemplateDocDevEn}}		{{TemplateDocDevEn}}

Ssherratt: /* Development rules for internationalization (i18n) */

2018-09-13T20:11:35Z

Development rules for internationalization (i18n)

← Older revision		Revision as of 20:11, 13 September 2018
Line 7:		Line 7:

	= Development rules for internationalization (i18n) =		= Development rules for internationalization (i18n) =
	In Dolibarr code ~~source~~, translations are made by using a method available on object $langs with the key to translate as parameter of this method. The $langs object contains definition of use language. This object is always defined in all pages.		In Dolibarr code, translations are made by using a method available in object $langs with the key to translate as a parameter of this method. The $langs object contains definition of use language. This object is always defined in all pages.

	There ~~is 2~~ methods:		There are two methods:
	<source lang="ini">		<source lang="ini">
	$langs->trans('TRAD_STRING');		$langs->trans('TRAD_STRING');
	</source>		</source>
	This ~~methode return~~ translation of key TRAD_STRING, and ~~encode~~ result into HTML entities to allow to ~~output it~~ correctly (even with special characters) ~~into~~ an HTML page.		This method returns the translation of key TRAD_STRING, and encodes the result into HTML entities to allow to display correctly (even with special characters) on an HTML page.
	<source lang="ini">		<source lang="ini">
	$langs->transnoentitiesnoconv('TRAD_STRING');		$langs->transnoentitiesnoconv('TRAD_STRING');
	</source>		</source>
	This method ~~return~~ translation of key TRAD_STRING, but result is translated string with no particular encoding (string is stored in UTF-8 in memory).		This method returns the translation of key TRAD_STRING, but the result is the translated string with no particular encoding (string is stored in UTF-8 in memory).

	~~This 2~~ methods can accept arguments that will be used to ~~replaced~~ strings %s ~~found~~ in ~~resulted~~ translated string.		These two methods can accept arguments that will be used to replace strings %s in the translated string.


	Note: If, as arguments, you use a string that is ~~itslef~~ a translated string, you must use method $langs->transnoentitiesnoconv, otherwise string will be encoded twice.		Note: If, as arguments, you use a string that is itself a translated string, you must use method $langs->transnoentitiesnoconv, otherwise the string will be encoded twice.
	Example:		Example:
	<source lang="ini">		<source lang="ini">

Eldy at 22:41, 19 May 2010

2010-05-19T22:41:14Z

← Older revision		Revision as of 22:41, 19 May 2010
Line 10:		Line 10:

	There is 2 methods:		There is 2 methods:
			<source lang="ini">
	$langs->trans('TRAD_STRING');		$langs->trans('TRAD_STRING');
			</source>
	This methode return translation of key TRAD_STRING, and encode result into HTML entities to allow to output it correctly (even with special characters) into an HTML page.		This methode return translation of key TRAD_STRING, and encode result into HTML entities to allow to output it correctly (even with special characters) into an HTML page.
			<source lang="ini">
	$langs->transnoentitiesnoconv('TRAD_STRING');		$langs->transnoentitiesnoconv('TRAD_STRING');
			</source>
	This method return translation of key TRAD_STRING, but result is translated string with no particular encoding (string is stored in UTF-8 in memory).		This method return translation of key TRAD_STRING, but result is translated string with no particular encoding (string is stored in UTF-8 in memory).

Line 20:		Line 24:
	Note: If, as arguments, you use a string that is itslef a translated string, you must use method $langs->transnoentitiesnoconv, otherwise string will be encoded twice.		Note: If, as arguments, you use a string that is itslef a translated string, you must use method $langs->transnoentitiesnoconv, otherwise string will be encoded twice.
	Example:		Example:
			<source lang="ini">
	print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))		print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))
			</source>

	= Translate Dolibarr into another language =		= Translate Dolibarr into another language =
	See page [[Translator documentation]]		See page [[Translator documentation]]

Eldy at 16:49, 22 August 2009

2009-08-22T16:49:22Z

← Older revision		Revision as of 16:49, 22 August 2009
Line 4:		Line 4:


	== Development ~~rule =~~=

			= Development rules for internationalization (i18n) =
	In Dolibarr code source, translations are made by using a method available on object $langs with the key to translate as parameter of this method. The $langs object contains definition of use language. This object is always defined in all pages.		In Dolibarr code source, translations are made by using a method available on object $langs with the key to translate as parameter of this method. The $langs object contains definition of use language. This object is always defined in all pages.

Line 20:		Line 22:
	print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))		print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))

	== Translate Dolibarr into another language ==		= Translate Dolibarr into another language =
	See page [[Translator documentation]]		See page [[Translator documentation]]

Eldy at 22:50, 8 April 2009

2009-04-08T22:50:09Z

← Older revision		Revision as of 22:50, 8 April 2009
Line 1:		Line 1:
	{{TemplateDocDevEn}}		{{TemplateDocDevEn}}




	== Development rule ==		== Development rule ==

Eldy: /* Development rule */

2009-04-08T22:49:12Z

Development rule

← Older revision		Revision as of 22:49, 8 April 2009
Line 5:		Line 5:

	There is 2 methods:		There is 2 methods:
	* $langs->trans('TRAD_STRING');		$langs->trans('TRAD_STRING');
	This methode return translation of key TRAD_STRING, and encode result into HTML entities to allow to output it correctly (even with special characters) into an HTML page.		This methode return translation of key TRAD_STRING, and encode result into HTML entities to allow to output it correctly (even with special characters) into an HTML page.
	* $langs->transnoentitiesnoconv('TRAD_STRING');		$langs->transnoentitiesnoconv('TRAD_STRING');
	This method return translation of key TRAD_STRING, but result is translated string with no particular encoding (string is stored in UTF-8 in memory).		This method return translation of key TRAD_STRING, but result is translated string with no particular encoding (string is stored in UTF-8 in memory).

Line 15:		Line 15:
	Note: If, as arguments, you use a string that is itslef a translated string, you must use method $langs->transnoentitiesnoconv, otherwise string will be encoded twice.		Note: If, as arguments, you use a string that is itslef a translated string, you must use method $langs->transnoentitiesnoconv, otherwise string will be encoded twice.
	Example:		Example:
	print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))		print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))


	== Translate Dolibarr into another language ==		== Translate Dolibarr into another language ==
	See page [[Translator documentation]]		See page [[Translator documentation]]

Eldy at 22:46, 8 April 2009

2009-04-08T22:46:24Z

← Older revision		Revision as of 22:46, 8 April 2009
Line 1:		Line 1:
	{{TemplateDocDevEn}}		{{TemplateDocDevEn}}
	~~{{ToTranslate}}~~

	== ~~Principe développement~~ ==		== Development rule ==
	~~Dans le~~ code ~~les traductions se font par appel de methode sur l'objet~~ $langs ~~avec en paramètre la clé de la chaine à traduire~~. ~~lo'bjet~~ $langs ~~contient la définition de la langue de l'utilisateur~~. ~~Il est définit dans toutes les~~ pages.		In Dolibarr code source, translations are made by using a method available on object $langs with the key to translate as parameter of this method. The $langs object contains definition of use language. This object is always defined in all pages.

	~~On trouve~~ 2 ~~méthodes~~:		There is 2 methods:
	* $langs->trans('TRAD_STRING');		* $langs->trans('TRAD_STRING');
	~~Cette méthode renvoi la traduction de l'entrée~~ TRAD_STRING, ~~tout en codant le résultat en~~ entities HTML ~~pour permettre un affichage des caractères spéciaux correct dans une~~ page ~~HTML~~.		This methode return translation of key TRAD_STRING, and encode result into HTML entities to allow to output it correctly (even with special characters) into an HTML page.
	* $langs->~~transnoentities~~('TRAD_STRING');		* $langs->transnoentitiesnoconv('TRAD_STRING');
	~~Cette méthode renvoi la traduction de l'entrée~~ TRAD_STRING, ~~mais ne code pas le résultat~~.		This method return translation of key TRAD_STRING, but result is translated string with no particular encoding (string is stored in UTF-8 in memory).

	~~Ces~~ 2 ~~méthodes peuvent accepter des~~ arguments ~~complémentaires qui sont substitués aux valeurs~~ %s ~~dans la chaine résultante de la traduction~~.		This 2 methods can accept arguments that will be used to replaced strings %s found in resulted translated string.


	Note: ~~Si en paramètre~~, ~~on met un résultat de traduction~~, ~~il convient que ce résultat soit renvoyé par la fonction~~ $langs->~~transnoentities~~, ~~sinon il sera codé en HTML puis le sera une deuxième fois par l'appel $langs->trans initiale~~. ~~Exemple~~:		Note: If, as arguments, you use a string that is itslef a translated string, you must use method $langs->transnoentitiesnoconv, otherwise string will be encoded twice.
	print $langs->trans("STRING_TO_TRANSLATE",$langs->~~transnoentities~~("STRING_PARAM1"))		Example:
			print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentitiesnoconv("STRING_PARAM1"))


	== ~~Traduire~~ Dolibarr ~~dans une autre langue~~ ==		== Translate Dolibarr into another language ==
	~~Voir la~~ page [~~http://www.dolibarr.com/wikidev/index.php/Documentation_traducteur Documentation_traducteur~~]		See page [[Translator documentation]]

Simnandez: Created page with '{{TemplateDocDevEn}} {{ToTranslate}} == Principe développement == Dans le code les traductions se font par appel de methode sur l'objet $langs avec en paramètre la clé de la ...'

2009-04-08T07:16:55Z

Created page with '{{TemplateDocDevEn}} {{ToTranslate}} == Principe développement == Dans le code les traductions se font par appel de methode sur l'objet $langs avec en paramètre la clé de la ...'

New page

{{TemplateDocDevEn}}
{{ToTranslate}}

== Principe développement ==
Dans le code les traductions se font par appel de methode sur l'objet $langs avec en paramètre la clé de la chaine à traduire. lo'bjet $langs contient la définition de la langue de l'utilisateur. Il est définit dans toutes les pages.

On trouve 2 méthodes:
* $langs->trans('TRAD_STRING');
Cette méthode renvoi la traduction de l'entrée TRAD_STRING, tout en codant le résultat en entities HTML pour permettre un affichage des caractères spéciaux correct dans une page HTML.
* $langs->transnoentities('TRAD_STRING');
Cette méthode renvoi la traduction de l'entrée TRAD_STRING, mais ne code pas le résultat.

Ces 2 méthodes peuvent accepter des arguments complémentaires qui sont substitués aux valeurs %s dans la chaine résultante de la traduction.

Note: Si en paramètre, on met un résultat de traduction, il convient que ce résultat soit renvoyé par la fonction $langs->transnoentities, sinon il sera codé en HTML puis le sera une deuxième fois par l'appel $langs->trans initiale. Exemple:
print $langs->trans("STRING_TO_TRANSLATE",$langs->transnoentities("STRING_PARAM1"))

== Traduire Dolibarr dans une autre langue ==
Voir la page [http://www.dolibarr.com/wikidev/index.php/Documentation_traducteur Documentation_traducteur]