= ezFIT 4 Localization (Translator Instructions) =

== Preparing Files for Translator ==
* [[swdev:howto:Software_Localization_using_Multilizer#Data_Export|Export resource strings from Multilizer into a CSV file]].
* Copy file ''C:\Program Files\Audina\ezFIT4\data\fittingguide.xml''.
* Copy language section in ''[CustomMessages]'' from InnoSetup installer script, and create a file for translator.
* ZIP all files and distribute them to translator with the [[#Translator_Instructions|Translator Instructions]].


==Translation of ResourceStrings==

* Open CSV file found attached.
* Translate Native column (Column B) and place text in Target Language column (Column D).  NOTE: If there are other sample languages (like in Column C), then just use the next available empty column to take the place of Column D).

**Note: **
* CONTEXT column (Columnn A): column used a reference for our import utility in order to place the translation in the right place.  Please DO NOT modify this column!
* NATIVE column (Columnn B): column containing the text that needs to be translated. Please DO NOT modify this column!
* EXAMPLE column (Column C): column contaning a sample translation (for example: French, Spanish, etc.), that can be used as a reference, when length of text is critical.
* TRANSLATION column (Column D): column where the new translation text should be placed. Here is where the Target Language text would go.

==Translation of Fitting Solutions Guide==

The Fitting Solutions guide data is found in ''fittingguide.xml'' file (normally stored in folder ''C:\Program Files\Audina\ezFIT4\data'').  
# Open file ''fittingguide.xml'' in an XML editor or text editor. Use one of the following (NOTE: Please do not use MS Word to edit this file.  It will damage it.):
#* [[http://notepad-plus.sourceforge.net/uk/download.php|Notepad++]] XML/Text Editor:  Download from [[http://notepad-plus.sourceforge.net/uk/download.php|http://notepad-plus.sourceforge.net]]. 
#* MS Notepad: Run in Windows from Start > All Programs > Accessories > Notepad.exe.
# Translate only the string assigned to "Title" and "Code".  When translating the "Code" string, make sure the text matches the previous title and the product code is not modified.  For example:
#* Product code = P4
#* Title = "Feedback/Chirping"
#* Adjustments code = "P4 Feedback/Chirping"

Code snippet:
<code xml>
<?xml version="1.0" encoding="UTF-8"?>
<PROJECT>
<CIRCUIT Code="P4" Title="Instrument Model: Paragon 4">
<ISSUE Title="Feedback/Chirping">
  <ADJUSTMENTS Code="P4 Feedback/Chirping">
    <ADJUSTMENT Row="0" Steps="3"  Action="Y" Title="Enable Notch Center." 
. . .
</code>
===Translation of Installer===
 * Open InnoSetup installer script with a text editor (e.g. Notepad).
 * Add and translate resource strings under section ''[CustomMessages]'': <code bash>
[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
</code>

== Help or Questions ==
For help or if you have questions, contact Audina's software development team:
* Software Support ([[support@audina.net]])