How To: Contributing Language Translations to FreeNAS


December 27, 2019

FreeNAS is used in 99% of the countries in the world, and after almost nine years in service and countless community contributions, the legacy FreeNAS GUI was translated into over 50 languages. With the 11.2 Release, a shinier, snappier, and more user-friendly Angular-based GUI was introduced. As with any major GUI rewrite, it requires that translations be updated to match. We have a few done so far, but we could use help making sure our users around the world can still use FreeNAS in their native language. If you are a multilingual FreeNAS fan, a great way to get involved and help contribute is to assist in the translation from the original English into another language. 
We’ve made this process very simple. Here’s how you can contribute:
First, you’ll need to log into GitHub, and create a “fork” of the FreeNAS webui repo:
In the new repo fork, go to the “src/assets/i18n” directory and select a language file to see translations from English to that language. For example, “fr.po” is for English to French translations.

Clicking the “Edit” icon within the GitHub interface takes you to a web-based file-editor, allowing you to translate the file directly. The file is filled with strings that look like this:
msgid ” Check Notifications for more details.”
msgstr ” Consultez la section notifications pour plus de détails.”
In this example, the tag “msgid” contains the original English string that is being replaced by a French translation. The next line contains “msgstr”, which is the translated string that appears in the UI when “French” is chosen as the default language.
There are many text strings to translate from English, so it’s usually not optimal to try and do them all at once. It’s a good idea to periodically save your work by filling the form at the bottom of the webpage and clicking “Commit changes”.

When you’ve made significant progress on translating text strings, the last step is to send your translations to us to include in the product. Go to your GitHub repo and find the option on the first page to create a pull request. This is how you can get your changes merged into FreeNAS and ready for the next major release. 
For more details about translating FreeNAS, see the “Translation” section of the FreeNAS User Guide.

Join iX Newsletter

iXsystems values privacy for all visitors. Learn more about how we use cookies and how you can control them by reading our Privacy Policy.