Translate efa

If you would like to translate efa into your language, you will first have to create a new properties file. To do so, please download the latest version of efa, open the configuration dialog, select Expert Mode and activate the option Activate Functionality for Development. After a restart of efa, you will see a new menu called Development (in efa-Base located in the menu bar, or in the Admin Mode in efa-Boathouse). In this menu, chose the option Translate. In the next window, select the language that you want to translate efa to from the first list. From the second list, select one of the existing languages as a reference. To create the properties file (or open an existing one), click OK.

You will now see a long table with all the text that needs to be translated. While you cannot edit the first two columns (Key and Reference Language), you can edit the right column (your new language) directly in efa to translate each key into your language. The editor capabilities in efa are somewhat limited, so you may want to use an external editor (see below). If you just need to edit a few keys which have changed from the previous version, you can easily do this directly in efa. All the highlighted keys are the ones which are currently untranslated (or where the reference and your translation are identical). From the drop-down selection at the top of the window, you can chose to just display those.

To use an external editor, you have to initialize your translation with the one from the reference language. To do so, click Fill empty Fields with Reference Text. This will copy the reference text into each field you have not yet translated, thus creating all the keys in your properties file. Then click Save to save the properties file. It will be saved in the program folder of your efa installation (you must have write access to this folder!). Now you can open the properties file in any external editor (see below).

When you save a properties file in efa, also old keys will be removed (keys you may have translated earlier, but which have been removed from the current efa version). Over time, new efa versions may add new keys or remove existing ones. To keep your translation up to date, you can use efa's internal editor to see which keys need translation and/or update your existing properties file for loading it into an external editor.

Warning: When you update efa to a newer version, the properties files from the update will overwrite your properties files in the program folder. Make sure to copy your properties files to another place before updating efa! Once you're changes have been included in the official distribution of efa you don't have to worry about this any more (until you make the next changes). Please submit your properties files to to be included.

Testing your Translation

You can immediately test your translation in efa. All you need to do is copy your translated properties file into the program folder of your efa installation. If you use efa's internal editor, it will automatically save the files there, so you don't need to do anything. After making changes to the properties files, you have to restart efa to make the changes become effective.