ABP CLI translate command

[hikalkan]

Mainly used to translate ABP's resources (JSON files) easier.

Crteate the unified file

Create a unified file that contains all texts of all JSON files to be translated for the specified culture:

abp translate --culture|-c <culture> [---output|-o <file-name: abp-translation.json>] [--reference-culture|-r <culture: en>] [--all-values|-a]

• It searches for all JSON files inside the current folder and all subdirectories recursively (should ignore some folders like node_modules), finds the language files. May check the file content format to understand if it is a language translation file.
• It includes only the missing texts by default. --all-values is used to include all (maybe the translating person wants to review existing texts too)

The output file format:

{
  "referenceCulture": "en",
  "culture": "es",
  "resources": {
    "AbpUi": {
      "targetFolder": "framework/src/Volo.Abp.UI/Localization/Resources/AbpUi/",
      "texts": {
        "InternalServerErrorMessage": {
          "reference": "An internal error occurred during your request!",
          "value": ""
        }
      }
    }
  }
}

• Just like the AbpUi, we can add other resources too.

Apply changes

Applies changes to the related files:

abp translate --apply|-a [--file|-f <file-name: abp-translation.json>]

• It creates or updates the file for the translated culture.
• Then user can review the changes and send a pull request.
• Also ignore abp-translation.json file on .gitignore for the abp repository (to not add to GitHub by mistake).

Update the documentation

• Update the CLI document for this new command.
• Update the https://docs.abp.io/en/abp/latest/Contribution/Index#resource-localization to explain how people can contribute to the resource localization (and delete this).

[hikalkan]

See how to use before release, in the dev branch of the abp repository: #4088 (comment)

[hikalkan]

See the documentation to learn how to use the abp translate command: https://docs.abp.io/en/abp/latest/CLI#translate