Difference between revisions of "Modules/localize"

From MSX Game Library

< Modules

(Translation source file)
Line 14: Line 14:
  
 
For example:
 
For example:
{{FRAME_HTML|https://raw.githubusercontent.com/aoineko-fr/MSXgl/main/projects/samples/s_loc_src1.ini}}
+
{{FRAME_HTML|https://msx.org/}}
  
  

Revision as of 13:07, 24 November 2023

The localize module handle translation in several langage of your application. This module is very small in size and very efficient.

Usage

The translation process consists of 3 elements:

  • A file (or several) in which the user places his translations for each supported language.
  • A project configuration (See bellow) to inform the Build tool of the translation files to be processed.
  • A module to be initialized in the code, then functions to select a language and to retrieve a given text's translation.

Translation source file

A translation source file is a text file (encoded as UTF-8) that must include:

  • A tag that defines each language section as: [langue].
  • A translation list in the form: key = "text".

For example:


[EN]
Start   = "Start"
Options = "Options"
Exit    = "Exit"

[FR]
Start   = "Commencer"
Options = "Options"
Exit    = "Quitter"

[JA]
Start   = "スタート"
Options = "オプション"
Exit    = "しゅうりょう"

You can use as many location files as you like. You can, for example, group everything together in a single file, or have thematic files (menu, in-game, etc.), or have a file for each language. The Build Tool will gather them all together to create the file you'll use in your code.

Notes:

  • This file format respects the format of .ini files, so you can benefit from syntax highlighting if you use this extension. That said, this is not mandatory and you could, for example, use a .loc extension for your localization.

Dependencies

Dependency on other modules: None.

Settings

The localization process can be customized in your Build tool configuration file, project_config.js:

//-- List files to be localized (array)
LocFiles = [ "file1.ini", "file2.ini" ];

//-- Localization output filename (string)
LocOutput = "localization.h";

//-- Localization structure name (string)
LocStruct = "g_LocData";

Note: If LocFiles is empty (default value), the localization process is disabled.

Appendix

  • See also: Sample program s_loc

Documentation