LibreCrypt: Open-Source disk encryption for Windows
LibreCrypt: Open-Source disk encryption for Windows
LibreCrypt currently supports the following languages:
* Croatian
* Czech
* English
* French
* German
* Greek
* Italian
* Japanese
* Russian
* Spanish
* Traditional Chinese
1. Find the two-letter ISO 639-1 Alpha-2 code for the language you want to translate to (e.g. `fr` for French, `de` for German, `ru` for Russian).
Call this 'XX'.
1. Install the latest copy of LibreCrypt.
1. Find the directory LibreCrypt was installed in (by default <code>c:\Program Files (86)\LibreCrypt\</code> and copy the `default.po` file stored under
<code>locale\en\LC_MESSAGES</code> to a new directory called: <code>locale\XX\LC_MESSAGES</code> where 'XX' is the language code.
You can also find this file in the LibreCryptPortable.zip archive.
1. Edit your copy of `default.po`, adding the translated versions of each `msgid` string as the corresponding `msgstr` text.
For example, a German translation would be:
<br/>
<code># Example translation<br />
msgid "Hello world!"<br />
msgstr "Hallo Welt!"<br />
</code>
You can do this with any text editor like Notepad, but it is easier if you use Poedit (a free software tool for editing `.po` files).<br />
You also must edit the string for `English` (RS_LANGUAGE) to show the language of the translation.<br />
1. Compile your `default.po` file into a `default.mo` file
* If you are using Poedit, go to `File | Preferences...` within Poedit, and make sure that the `Automatically compile .mo file on save`
option is checked. When you save your `default.po` file, Poedit should automatically generate a corresponding `default.mo` file for you
* If you are not using Poedit:
+ Download and install the latest copy of `GNU gettext for Delphi` from [http://dybdahl.dk/dxgettext/](http://dybdahl.dk/dxgettext/)
+ In Windows explorer, right-click your `default.po` file
+ Select `Compile to mo file` from the context menu displayed. This should then generate you a `default.mo` file
+ This can also be done using the command line 'msgfmt' program - see (technical details - build notes)[technical_details__build_notes.md]
1. Run LibreCrypt.exe
1. Select the `View | Options...` menu-item
1. On the `General` tab, select the language of your translation from the drop-down shown in the upper right
1. Click `OK`
1. LibreCrypt's user interface should then switch to be displayed in your selected language.
If your translation isn't listed in the `Languages` drop-down, please check:
* That you translated the word `English` to the name of your language in your `default.po` file
* You compiled your `default.po` file to a `default.mo` file
* Your `default.mo` file is placed in the correct `locale\XX\LC_MESSAGES` directory
Please email your translated `default.po` file to the email on the [github contact page](https://github.com/t-d-k/librecrypt/blob/master/docs/contact_details.md) , or add it in github if you have an account.
Note: You don't have to translate all of the messages stored in `default.po`, though it would be very much appreciated.
### Updating a Translation
When newer versions of LibreCrypt are released, a translation (.po) file can have newer text strings merged into it using Poedit:
* In Poedit, go to `File | Open`, and open the `default.po` file with the existing translations in it
* Go to `Catalog | Update from POT file` and specify the updated English `default.po` file (i.e. ...\locale\en\LC_MESSAGES\default.po)
Note: You may have to set the filter to `All files` when opening this file
* Poedit should give you a dialog that shows what strings have been added and removed. If you `OK` this dialog, you should see
all the strings merged into the translation as appropriate. Note that Poedit will attempt to default some translations where it can;
these are marked as `fuzzy` translations, and should be manually checked to ensure that they are correct.
### Additional Notes
* If you are unsure where any given piece of text is shown in the GUI, please ask where it can be found.
* The `&` character in a piece of text marks the next letter as a shortcut key for the control with that text (i.e. in the word 'C&ancel pressing 'a' will click the button with the text 'Cancel' ). This letter is shown underlined in the control.
* Acronyms should not be translated (e.g. IV, CDB, PKCS#11)
* Entries which look similar to:
Library files (*.dll)|*.dll|All files|*.*
are filters for use with open/save dialogs. The text descriptions of these filters should be translated, but not the file masks
(e.g. `Library file` and `All files` in the above example, but not `*.dll` or `*.*`)
* A number of the text strings include %s, %1, etc. These are placeholders which will be replaced with automatically generated text.