Translating - Revision history

Tintinux: forum url

2026-05-27T15:03:14Z

forum url

← Older revision		Revision as of 17:03, 27 May 2026
Line 68:		Line 68:
	The file encoding must be UTF-8.		The file encoding must be UTF-8.

	Otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use svn for you. In either case, use the [http://~~forum~~.gestinux~~.net~~/viewforum.php?f=10 forum] to communicate with the other developers.		Otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use svn for you. In either case, use the [http://mrit.com/gestinux/forum/viewforum.php?f=10 forum] to communicate with the other developers.

	=== Initial Setup ===		=== Initial Setup ===
Line 96:		Line 96:
	=== Installing new translations ===		=== Installing new translations ===

	If possible, get another native speaker to read and check your work. Once the translation is complete, commit the file with svn or ask via the [http://~~forum~~.gestinux~~.net~~/viewforum.php?f=10 forum] for another developer to do this for you.		If possible, get another native speaker to read and check your work. Once the translation is complete, commit the file with svn or ask via the [http://mrit.com/gestinux/forum/viewforum.php?f=10 forum] for another developer to do this for you.

	If you contribute a commonly used language, your translation will be added to the next version of Gestinux.		If you contribute a commonly used language, your translation will be added to the next version of Gestinux.
Line 120:		Line 120:
	See [[Help:Contents\|how to create or edit pages]] of this wiki.		See [[Help:Contents\|how to create or edit pages]] of this wiki.

	There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://~~forum~~.gestinux~~.net~~/viewforum.php?f=8 forum].		There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://mrit.com/gestinux/forum/viewforum.php?f=8 forum].

Tintinux: Text replacement - "{{#CustomTitle:" to "{{DISPLAYTITLE:"

2020-02-11T17:17:26Z

Text replacement - "{{#CustomTitle:" to "{{DISPLAYTITLE:"

← Older revision		Revision as of 19:17, 11 February 2020
Line 1:		Line 1:
	{{~~#CustomTitle~~:How to translate Gestinux}}		{{DISPLAYTITLE:How to translate Gestinux}}

	This page explains how to translate Gestinux without knowing much about Pascal or other programming languages or the Lazarus IDE.		This page explains how to translate Gestinux without knowing much about Pascal or other programming languages or the Lazarus IDE.

Tintinux: /* Providing translation data */

2019-12-17T13:47:15Z

Providing translation data

← Older revision		Revision as of 15:47, 17 December 2019
Line 108:		Line 108:
	A country list has to be created for each language available in Gestinux. This is contained in the xx_YY_countries.txt file that Gestinux loads automatically when its database is created (or audited) provided that you have earlier selected the appropriate language.		A country list has to be created for each language available in Gestinux. This is contained in the xx_YY_countries.txt file that Gestinux loads automatically when its database is created (or audited) provided that you have earlier selected the appropriate language.

	It is also helpful if you can create test cases in the language translated for the country (or countries) that use that language. You can export the database so that it can be hosted on gestinux.net and so become accessible to anyone worldwide.		It is also helpful if you can create test cases in the language translated for the country (or countries) that use that language. You can export the database so that it can be [https://gestinux.net/cloud/en hosted on gestinux.net] and so become accessible to anyone worldwide.

	If your country has state-specific reports these can also be integrated into the software. If you do not know how make a [[Customized_Reports\|Customized report]], ask a developer on the forum, sending examples.		If your country has state-specific reports these can also be integrated into the software. If you do not know how make a [[Customized_Reports\|Customized report]], ask a developer on the forum, sending examples.

Tintinux: /* The source file to translate */

2019-11-13T10:14:05Z

The source file to translate

← Older revision		Revision as of 12:14, 13 November 2019
Line 39:		Line 39:
	If you are in any doubt, ask for confirmation on the [http://forum.gestinux.net/viewforum.php?f=8 forum].		If you are in any doubt, ask for confirmation on the [http://forum.gestinux.net/viewforum.php?f=8 forum].

	=== The source ~~file~~ to translate ===		=== The source files to translate ===

	Gestinux read translations in two "text file" : xx_YY.ini and xx_YY_util.ini		Gestinux read translations in two "text file" : xx_YY.ini and xx_YY_util.ini

Tintinux: /* The code for your language */

2018-10-25T10:04:20Z

The code for your language

← Older revision		Revision as of 12:04, 25 October 2018
Line 26:		Line 26:

	The lowercase xx part of the code identifies the primary language, according to the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639-1] standard.		The lowercase xx part of the code identifies the primary language, according to the [http://en.wikipedia.org/wiki/List_of_ISO_639-1_codes ISO-639-1] standard.
	The uppercase YY part identifies any possible language variant (usually with a country code), according to the [~~http~~://en.wikipedia.org/wiki/ISO_3166-1 ISO-3166-1] standard.		The uppercase YY part identifies any possible language variant (usually with a country code), according to the [https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2#Officially_assigned_code_elements ISO-3166-1] standard.

	You should use the referenced ISO codes. If you invent a new code, the risk is that they may be formalized differently later.		You should use the referenced ISO codes. If you invent a new code, the risk is that they may be formalized differently later.

Tintinux: /* The source file to translate */

2017-12-27T10:52:28Z

The source file to translate

← Older revision		Revision as of 12:52, 27 December 2017
Line 48:		Line 48:
	These files are installed there read-only. Do not attempt to modify or set them read-write at this location. If you want to improve an existing (perhaps partial) translation, you should copy that file to your personal documents or else, if you can use svn, get all the sources (''svn checkout'') and open the files in the local copy.		These files are installed there read-only. Do not attempt to modify or set them read-write at this location. If you want to improve an existing (perhaps partial) translation, you should copy that file to your personal documents or else, if you can use svn, get all the sources (''svn checkout'') and open the files in the local copy.

	For a new language, create a new file within your personal documents. The first ~~three~~ lines must read:		For a new language, create a new file within your personal documents. The first lines must read:

	[General]		[General]
	LanguageCode ='''xx_YY'''		LanguageCode ='''xx_YY'''
	LanguageName ='''name of language''' (in this language)		LanguageName ='''name of language''' (in this language)
			LanguageOrientation=LTR\|RTL

			LTR is for languages written from left to right, RTL for those written from right to left, which are supported by Gestinux from version 1.5.

			Example :

			[General]
			LanguageCode=he_IS
			LanguageName=עיברית (ישראל)
			LanguageOrientation=RTL

	If you are using '''svn''', save the translation files in the folders ''trunk/languages'' and ''trunk/util/languages'' and add them (''svn add'' and ''svn commit''). Always lock them (''svn lock'') to prevent anyone else editing the same file simultaneously.		If you are using '''svn''', save the translation files in the folders ''trunk/languages'' and ''trunk/util/languages'' and add them (''svn add'' and ''svn commit''). Always lock them (''svn lock'') to prevent anyone else editing the same file simultaneously.

Tintinux: /* Entering a new translation */

2017-12-27T10:40:05Z

Entering a new translation

← Older revision		Revision as of 12:40, 27 December 2017
Line 72:		Line 72:
	There are 2 language files, one for the main application, and another for utilities common to several applications.		There are 2 language files, one for the main application, and another for utilities common to several applications.

	=== ~~Entering~~ a ~~new~~ translation ===		=== Creating or improving a translation ===

	You can translate globally by clicking one of the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.		You can translate globally by clicking one of the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.

Tintinux: /* Entering a new translation */

2017-12-27T10:38:55Z

Entering a new translation

← Older revision		Revision as of 12:38, 27 December 2017
Line 74:		Line 74:
	=== Entering a new translation ===		=== Entering a new translation ===

	You can translate globally by clicking the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.		You can translate globally by clicking one of the '''Translate''' button. In this case, you will have a list (to the left) of the various application windows, as well as some sections unrelated to a window. Global translation is required for sections that do not correspond to a window, and to check you have not overlooked any section. You can use the '''Next Missing''' button to find the first missing translation.

	It is also possible to press CTRL+F4 from any ~~application~~ window to view and translate the section corresponding to that window. In this case, you will see only that window listed at the left. This method has the advantage that once the translation you can use the F4 key to toggle between viewing the base language and your language translation (and vice versa).		It is also possible to press CTRL+F4 from any Gestinux window to view and translate the section corresponding to that window. In this case, you will see only that window listed at the left. This method has the advantage that once the translation you can use the F4 key to toggle between viewing the base language and your language translation (and vice versa).

	[[File: GTranslator.png]]		[[File: GTranslator.png]]
Line 82:		Line 82:
	Anyway, for the selected section, a list of key translation is displayed. The reference translation (which cannot be changed) is displayed below, and you can enter or edit the translation in your language. Registration is automatic when you change key.		Anyway, for the selected section, a list of key translation is displayed. The reference translation (which cannot be changed) is displayed below, and you can enter or edit the translation in your language. Registration is automatic when you change key.

	The symbol <CR> skips a line, and should be used ~~for~~ messages.		The symbol <CR> skips a line, and should be used in long messages.

	=== Installing new translations ===		=== Installing new translations ===

Tintinux: /* Initial Setup */

2017-12-27T10:37:27Z

Initial Setup

← Older revision		Revision as of 12:37, 27 December 2017
Line 62:		Line 62:
	=== Initial Setup ===		=== Initial Setup ===

	From the Gestinux menu choose '''Settings''' '''Languages''' tab and '''~~Add~~ a translation:'''		From the Gestinux menu choose '''Settings''', '''Languages''' tab, and '''Write a translation:'''

	[[File:Translating_1.png]]		[[File:Translating_1.png]]
Line 70:		Line 70:
	* Check the box "Use translation" for translations of this file to be used. Otherwise the reference language will be used.		* Check the box "Use translation" for translations of this file to be used. Otherwise the reference language will be used.

	~~in version 1.2 there~~ are 2 language files, one for the main application, and another for utilities common to several applications~~, so the windows is slightly different~~.		There are 2 language files, one for the main application, and another for utilities common to several applications.

	=== Entering a new translation ===		=== Entering a new translation ===

Tintinux at 07:35, 25 June 2017

2017-06-25T07:35:15Z

← Older revision		Revision as of 09:35, 25 June 2017
Line 37:		Line 37:
	* Sv_SE: Swedish "from Sweden"		* Sv_SE: Swedish "from Sweden"

	If you are in any doubt, ask for confirmation on the [http://gestinux.net~~/forum~~/viewforum.php?f=8 forum].		If you are in any doubt, ask for confirmation on the [http://forum.gestinux.net/viewforum.php?f=8 forum].

	=== The source file to translate ===		=== The source file to translate ===
Line 58:		Line 58:
	The file encoding must be UTF-8.		The file encoding must be UTF-8.

	Otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use svn for you. In either case, use the [http://gestinux.net~~/forum~~/viewforum.php?f=10 forum] to communicate with the other developers.		Otherwise explain what you are doing on the forum and attach the file to your message translation. Other developers will use svn for you. In either case, use the [http://forum.gestinux.net/viewforum.php?f=10 forum] to communicate with the other developers.

	=== Initial Setup ===		=== Initial Setup ===
Line 86:		Line 86:
	=== Installing new translations ===		=== Installing new translations ===

	If possible, get another native speaker to read and check your work. Once the translation is complete, commit the file with svn or ask via the [http://gestinux.net~~/forum~~/viewforum.php?f=10 forum] for another developer to do this for you.		If possible, get another native speaker to read and check your work. Once the translation is complete, commit the file with svn or ask via the [http://forum.gestinux.net/viewforum.php?f=10 forum] for another developer to do this for you.

	If you contribute a commonly used language, your translation will be added to the next version of Gestinux.		If you contribute a commonly used language, your translation will be added to the next version of Gestinux.
Line 110:		Line 110:
	See [[Help:Contents\|how to create or edit pages]] of this wiki.		See [[Help:Contents\|how to create or edit pages]] of this wiki.

	There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://gestinux.net~~/forum~~/viewforum.php?f=8 forum].		There is a way to list the remaining untranslated pages (or those whose original has been modified after translation). For now, this method is not available online, so if you would value this facility, ask on the [http://forum.gestinux.net/viewforum.php?f=8 forum].