Tools: Localization

The localization tool is located here. You can build and run it to extract files for localization or verify language variations.

Extract files to localization

This tool compares two WTS folders and obtains the locatable files that have differences between the two folders with its language variants and maintaining the folder structure. Extract files executing the following command:

localization ext -o "original_WTS_project_folder" -a "actual_WTS_project_folder" -d "destination_folder"

where:

• original_WTS_project_folder: initial version of WTS to compare. Normally we will obtain this version using the tag created the last time localization files were sent (it´s explained later).

• actual_WTS_project_folder: current version of WTS. This version is the last commit in the dev branch.

• destination_folder: Destination folder where we will obtain the extraction result. The following subfolders will be created:

  • original: contains the locatable files found in the "original_WTS_project_folder" folder.
  • actual: contains the locatable files found in the "actual_WTS_project_folder" folder.
  • diff: contains the files with differences between the "actual" and "original" folder, maintaining the WTS folder structure and variations of all the languages.

Example:

localization ext -o "C:\Users\myuser\Documents\Projects\WindowsTemplateStudio_Old" -a "C:\Users\myuser\Documents\Projects\WindowsTemplateStudio" -d "C:\Users\myusers\Desktop\localFileFolder"

Once the extractor is done we will send the contents of the "diff" folder to the translation team. We will also create a tag in the current commit of the dev branch. So we mark the last sending of localizable files and the next time we use the tool, we will use this tag to obtain "original_WTS_project_folder".

When the translated files are returned and are verified, we commit to github to update WTS with last variation languages.

Verify localization files

We can verify the received files are correct and not missing resx values executing the next command:

localization verify -s "WTS_project_folder"

Example:

localization verify -s "C:\Users\myuser\Documents\Projects\WindowsTemplateStudio"