flyPadOS 3 Localization Process
This page is pulled externally from the FBW Aircraft repository and describes the processes involved with adding features to the EFB and sourcing translations.
We have partnered with Localazy, who offer top-notch software localization services, bringing multi-language support to our EFB, enhancing the user experience.
- To add something to the localization files simply add the key to the source language files:
- For flyPad:
- For MSFS locPak:
- Only change the source language file. The other language files are generated automatically from Localazy and any changes will be overwritten.
- Ping in the Discord channel
#localisationto have someone with write permission to Localazy to add the key (several ways to do that - but the permission required is powerful). Adding it is a 2min thing.
- Do this in good time before it is merged to master
- Translators can now start to translate this (worst case is the term is not translated and shown in English)
- Same for removing or changing keys - do the change locally in the English source file and ping in
#localisationfor someone with write permission to Localazy to remove the key or change the default text.
The update could be automated via GitHub actions (as the download is - it's basically one command) but this would require the write key to be available in the GitHub action. As forks have no access to GitHub secrets automating this would not work for forks without making the write key public which is of course a no-go. Alternate solutions are still investigated.
Downloading of the latest approved translations happens at every build on GitHub. It is part of the build pipeline but only runs in the GitHub Action context to not update local files for Developers.
✓ a32nx ✓ preparation ✓ copy-base-files ✓ localisation ✓ efb-translation ✓ locPak-translation ...
To update the language files locally you need to run:
npm run build:efb-translation local
npm run build:locPak-translation local
This downloads the latest translations directly from Localazy to the 'downloaded' folder of the flyPad or locPak folder.
It checks the JSON syntax and writes new JSON files for each language to their respective target folder:
Update Source File
This can only be done by Owners/Managers of the Localazy project - ask in the Discord #localisation channel for support
Although an automatic update could be done we have chosen to manually make changes to the keys (new keys, removal of keys).
ANY CHANGES TO THE SOURCE FILES ON LOCALAZY WILL BE IMMEDIATELY BE VISIBLE IN EVER NEW BUILD OF THE A32NX - INDEPENDENT OF EDITION.
Using Localazy CLI
Install the Localazy CLI via
npm install -g @localazy/cli and then use the following commands to upload the source.
Use the option
-s for a test run. Remove this option to actually upload the file.
deprecate version of the configuration files will deprecate keys which are not present in the source file. Use this
localazy upload -w <writeKey> -c localazy-flypad-upload-config.json -d flypad
localazy upload -w <writeKey> -c localazy-locPak-upload-config.json -d msfs
The writeKey can be found in the Localazy project settings which are accessible by the Owners/Managers of the project.
Using the English source file and Localazy Website
- Make the necessary changes to the en.json (adding keys, removing key, changing default English strings)
- Go to File Management and click on
- Click the three-dots menu on the right of the
flybywireos3.jsonfile and select "Update file content"
- Drag and Drop the en.json to the dialog which came up
- It should recognize it as English
- Click "Next Step"
- Check "Mark strings excluded from this batch as deprecated" to remove keys
- Uncheck all the other checkboxes
- Review the changes in the source file - removed keys should show a red and deprecated, new keys should be available
- These changes now apply to all languages
- removed keys are deprecated and not visible to translators anymore and should also not be included in any downloads
- new keys are ready to be translated in all other languages
Same process as for flyPad but within the respective MSFS lokPak project.
Localazy filename is
Manually via Localazy Website
- Go to the respective project
- Use the UI to add/remove/change keys