= ezFIT 5 Localization =

== Application Localization ==
  * Add RESX files to project (See [[swdev:dotnet:Localization Using ResX Files]]).
  * Edit class ''AHI.App.Localization.TLocalizationTools'' in ''src\AHI.App.Localization\Tools.cs'' to include new supported language:<code csharp>
public static ObservableCollection<TLanguageInfo> SupportedLanguageInfo = new ObservableCollection<TLanguageInfo>() 
        { 
            //new TLanguageInfo() {LanguageNative = Resources.rsLangBulgarian,  LanguageEnglish = "Bulgarian",  LanguageCode = "bg-BG"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangDanish,     LanguageEnglish = "Danish",     LanguageCode = "da-DK"},
            new TLanguageInfo() {LanguageNative = Resources.rsLangEnglish,    LanguageEnglish = "English",    LanguageCode = "en-US"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangFrench,     LanguageEnglish = "French",     LanguageCode = "fr-CA"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangGerman,     LanguageEnglish = "German",     LanguageCode = "de-DE"},
            new TLanguageInfo() {LanguageNative = Resources.rsLangKorean,     LanguageEnglish = "Korean",     LanguageCode = "ko-KR"},
            new TLanguageInfo() {LanguageNative = Resources.rsLangItalian,    LanguageEnglish = "Italian",    LanguageCode = "it-IT"},
            new TLanguageInfo() {LanguageNative = Resources.rsLangSpanish,    LanguageEnglish = "Spanish",    LanguageCode = "es-ES"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangPortuguese, LanguageEnglish = "Portuguese", LanguageCode = "pt-BR"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangRussian,    LanguageEnglish = "Russian",    LanguageCode = "ru-RU"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangTurkish,    LanguageEnglish = "Turkish",    LanguageCode = "tr-TR"},
            //new TLanguageInfo() {LanguageNative = Resources.rsLangPolish,     LanguageEnglish = "Polish",     LanguageCode = "pl-PL"},
        };
</code>        
  * Translate original English RESX strings using Google Translate and [[http://resxtranslatorbot.codeplex.com|Resx Translator Bot]].
  * [[swdev:dotnet:localization:Editing RESX Files with SimpleResxEditor]].
  * Build ezFIT project.  Localization files should be generated under ''//<rootEzFIT>//\src\ezFIT\bin\x86\Debug\//<langcode>//''.
== Installer Localization==
=== Instructions for Developers ===
 * Open InnoSetup installer script.
 * Create file entries for all application localization files to distribute: <file bash installer-ezfit.iss>
[InstallDelete]
. . .
;---------------------------------------------------
; Localization files
;---------------------------------------------------
Name: {app}\AHI.App.Localization.dll; Type: files
Name: {app}\es\AHI.App.Localization.resources.dll; Type: files
. . .

[Files]
. . .
;---------------------------------------------------
; Localization files
;---------------------------------------------------
Source: {#SrcAppDir}\AHI.App.Localization.resources.dll; DestDir: {app}; Flags: ignoreversion skipifsourcedoesntexist
Source: {#SrcAppDir}\es\AHI.App.Localization.resources.dll; DestDir: {app}\es; Flags: ignoreversion skipifsourcedoesntexist
. . .
</file>
 * Add a directive to define language (in ''includes\sysutils.iss''): <file bash sysutils.iss>
#if AppLangSupp == "<LanguageNameHere>"
  #define <LanguageNameHere>
  ...
#elif...
#else
  #define English
#endif
</file>
 * Add Language resources under section ''[Languages]'': <file bash sysutils.iss>
[Languages]
#ifdef English
Name: English; MessagesFile: compiler:Default.isl
#endif
#ifdef <LanguageNameHere>
Name: <LanguageNameHere>; MessagesFile: compiler:Languages\<LanguageNameHere>.isl
#endif
</file>
 * Add and translate resource strings under section ''[CustomMessages]'': <file bash sysutils.iss>
[CustomMessages]
#ifdef English
SelectDrivers=Select Drivers
...
#endif
; <LanguageNameHere> should be replaced by the target language to localize
#ifdef <LanguageNameHere>
;<LanguageNameHere>.String=<TranslatedString>
<LanguageNameHere>.SelectDrivers=Seleccionar Controladores
...
#endif
</file>
 * Add and translate resource strings under section ''[CustomMessages]'' for the following files:
    * ''installer-ezfit.iss''
    * ''includes\database.iss''
    * ''includes\net-framework.iss''
    * ''includes\noah-support.iss''
    * ''includes\sysutils.iss''
    * ''includes\user-registration.iss''

=== Instructions for Translators ===

Syntax for resource strings to translate:
<code>
; <LanguageNameHere>
<LanguageNameHere>.<ResourceStringName>=<ResourceStringValueToTranslate>
...
</code>

Example
<code>
; English (Default)
rsSelectDrivers=Select Drivers

; Spanish
Spanish.rsSelectDrivers=Seleccionar Controladores
...
</code>