ilib-loctool-webos-json

ilib-loctool-webos-json

ilib-loctool-webos-json is a plugin for the loctool that allows it to read and localize JSON type of file.
e.g. appinfo.json, qcardinfo.json. This plugin is optimized for the webOS platform.

JSON FileType

schema

For JSON file type localization, the schema file is needed. The plugin contains a built-in version of the schema file for the appinfo.json file type. For other json file types such as qcardinfo.json, the plugin looks for the schema file in the same directory as the json file. Here's a example for schema file.

{
    "id": "QCardDescription",
    "type": "object",
    "properties": {
        "title": {
            "type": "string",
            "description": "The title of the application.",
            "localizable": true
        },
    }
}

configuration

The plugin will look for the jsonMap property within the settings of your project.json file. The following settings are used within the jsonMap property:

"settings": {
    "jsonMap": {
        "mappings": {
            "**/appinfo.json": {
                "template": "[dir]/[resourceDir]/[localeDir]/[filename]"
            },
            "**/qcardinfo.json": {
                "template": "[dir]/[resourceDir]/[localeDir]/[filename]"
           }
        }
    }
}

• mappings: a mapping between file matchers and an object that gives info used to localize the files that match it. This allows different json files within the project to be processed with different schema. The matchers are a micromatch-style string, similar to the the includes and excludes section of a project.json file. The value of that mapping is an object that can contain the following property:
  • template: a path template to use to generate the path to the translated output files. The template replaces strings in square brackets with special values, and keeps any characters intact that are not in square brackets. The default template, if not specified is [dir]]/[resourceDir]/[localeDir]/[filename].
    Please check the all available templates. link.
    The plugin recognizes and replaces the following strings in template strings:
    • [dir] the original directory where the matched source file came from. This is given as a directory that is relative to the root of the project.
    • [resourceDir] the root of the resource directory.
    • [localeDir] the full locale where each portion of the locale is a directory in this order: [langage], [script], [region].
    • [filename] the file name of the matching file.

Sample

The simple sample is provided in the samples-loctool. Please check the webos-json sample to see how the JSON file type is localized.

License

Copyright (c) 2019-2025, JEDLSoft

This plugin is license under Apache2. See the LICENSE file for more details.

Release Notes

See the CHANGELOG.md file.