Au3Localizer - Localize AutoIt Scripts

[MrCreatoR]

Au3Localizer

v1.0

 

Au3Localizer_1.0.zip

Old versions

Spoiler

v0.1 - ATT.zip

v0.2 - ATT.zip

---

Introduction

The idea started from my attempt to translate Control Viewer.

I have started to translate this program manually using AppTranslation Module that i wrote some time ago. But while translating i was wondering, what if i could automate this process?

Of course i understood that i can not automate this process completely, because it's not an easy task (programmatically) to distinguish between text lines that should be translated, from other lines that used by different functions/expressions (structures, strings parameters, etc.).

At the beginning i was very skeptic about this issue and thought that it's way over my head, but eventually i decided to sit down and write this tool.

---

Concept:

Spoiler

• When Au3Localizer receives file path, it will split the file to separate lines.
• Then it gets from each line strings between single and double quotes (thank to asdf8).
• For these strings generated list element (ListViewItem) with certain excludes (see bellow).
• Using predefined pattern (Ignore Lines Patterns), Au3Localizer defines which lines it will put to the list.
• Some lines, also using other predefined pattern (Marked Lines Patterns), are highlighted with special marker (green arrow on the left of the ListView Item), these lines have high localization priority, it means that probably these lines should be localized.
• Upon completion of processing with selected settings, following files are added to the folder of selected script:
  • Includes\Localize.au3 - Localizer module.
  • Locales\English.lng, Russian.lng - Locale files.
• For convenient switching between locales, you can add to your script _Localize_SwitchLocaleGUI function call, together with _Localize_Register, that are defined in Localize.au3:

$sDefLng = _Localize_SwitchLocaleGUI('My App', $hGUI, $sDefLng)
_Localize_Register($LOCALES_DIR & '\' & $sDefLng & '.lng')

• After the script is localized, it can be executed with command line:
  • /GenerateLocaleFile[="FileName"]
    • If FileName set and exists, generates missing strings for this locale file
    • If FileName set and NOT exists, creates this file in Locales Dir with all the localized strings
    • If FileName NOT set, generates missing strings for all locale files in Locales Dir

Usage:

Spoiler

1. At the firs step (when launching Au3Localizer) you can set localizer module settings...
   • Au3 Script: Input script file path (the script to add the Localizer module)
   • Localize Object Name: Object name of the localized strings (used as $oLocalize.%s)
   • Module File Path Format: Localizer module file path format (%s\Includes\Localize.au3, %s replaced with full path to the root folder of the selected script (Au3 Script:)
   • Locale File Path Format: Locale file path format that used by the module (%s\Locales\%d.lng, %s replaced with full path to selected script (Au3 Script:), %d replaced with locale name from the locales list (Locales:))
   • Locales: Locales list that your script will support
   • Default Locale: Default locale that your script will use
   • Marked Lines Patterns: RegExp pattern to highlight lines with special marker
   • Ignore Lines Patterns: RegExp patterns that defines which lines to put to the list
2. Next you select strings that should be used for localization process
   • Double click on the item will open a window that displays a full line with the found string
3. Then you click Localize and wait for Au3Localizer to complete that localization
4. Now all you need to do is actually translate the generated strings in locale file(s) (Locales\English.lng)

---

Any suggestions, or your own strings patterns that you discovered while using this tool are very welcome.

The archive includes also separate UDF version to use manually (usage Example also provided), without Au3Localizer.

P.S and Credits

Spoiler

• AutoItObject_Internal by genius257 is used by Au3Localizer.
• First working result of this tool.

 

Edited March 25, 2021 by MrCreatoR
Update

[FireFox]

This could be useful, thanks for sharing !

Edit : I'm available to translate anything into French.

Br, FireFox.

Edited April 12, 2012 by FireFox

[storme]

I think you have a great idea here!

I havn't used it yet but it would have been invaluable in the past when I was trying to understand scripts I'd downlaoded from the French forum.

A BIG thank you!

John Morrison

[ricky]

Hello,

thanks for your very useful software... Why you didn't translate it? If you want I see a very good software made by MrCreatoR in the forum ... Ok, it's a french joke...

For the future, why don't have a possibility to add new tranlation words in a script already translated?

[stormbreaker]

Thank you very much. You saved me loads of trouble. I can expect to finish my multi-lingual script sooner.

Regards.

[ldub]

Thank's a lot, I like it.

With an online translator for the .lng files, it would be great : It would not be perfect, of course, but it would accelerate the tedious job.

Regards

[MrCreatoR]

Thanks to all for the feedbacks!

I'm available to translate anything into French.

You can translate (download translated version here).

[MrCreatoR]

For the future, why don't have a possibility to add new tranlation words in a script already translated?

Good idea, but it will be complicated i think, i will try to add this feature.

[Reaper HGN]

Very cool idea. I don't have a use at the moment, but I have done this in the past and think something that flags the possible lines like this does would have been very helpful.

[MrCreatoR]

Update!

v0.2

+ Added retranslate support. Allows to translate new added strings in the main script.

+ Added command line parameter to ATT Module template to support language generation.

If the program executed with "/GenerateLangFile:LangName" parameter, then language file is generated as LangName.lng (in defined languages dir).

Useful if the user wants to make a new translation, and also when user wants to update the program but keep the custom translated strings (only new strings will be added to the specified language file).

+ Now the function/variable name where the string is found, added as a prefix for variable names.

* Small changes in the templates.

* Fixed issue with wrong line number detection.

Edited August 8, 2012 by MrCreatoR

[JScript]

Excellent, I confess: I had not seen this topic!

Thank you for sharing.

Regards,

João Carlos.

[MrCreatoR]

Major Update!

Quote

v1.0

• Project renamed to Au3Localizer.
• Rewrited almost completely.
• Now as main string representation used object instead of array.
• Updated patterns.

 

Edited March 25, 2021 by MrCreatoR

[bovirus]

@MrCreatoR

Could you pelase enable multilanguage for your Au3Localizer?

Pelase Add English+Italian language string files.

Thanks.