Do you want BetterHash in your language? What should I do before translating?

1. Please contact us to make sure that the language that you are planning to translate is not already in work by someone else.

2. Please don’t forget to ask us if we already have some files translated in your language. You might save some time because parts of the program could be already translated by us.

Which files must be translated ?

One file has to be translated: betterhash.ntv.lng - file used by BetterHash

Which files files do I send back to you ?

You have to send us back one file. After translating you will find in the installation folder of BetterHash one new file called betterhash.XXX.lng (where XXX is your language abbreviation).

How do I translate ?

1. Click here to make sure that you downloaded the latest release of BetterHash.

2. Download our translation tool from here. The archive password is inno.

3. UnZip the archive to a folder then run the downloaded program langmngr.exe.

4. From the menu choose File / Open Project then choose betterhash.ntv.lng; this file can be found in the installation folder of BetterHash

5. If other translations are present on your computer, they will be opened too. If you only want to see the English original text you must close the other translation(s). In order to do this please click on a word in the translation column that you want to close. Then from the menu, please choose File / Close language.

6. From the menu please choose File / Create new Language then choose your own language.

7. From the drop-down list you can choose what form or unit to translate.

8. Please do not translate the texts marked in red (untranslatable); the texts that need to be translated are marked by a small blue dot in the bottom right corner of their containing rectangle.

9. If a text appears many times and you don’t want to translate it over and over again, please read next section of this help page.

10. After the translation you will find in the installation folder of BetterHash a new file called betterhash.XXX.lng (where XXX is your language abbreviation) – please send us this file for verification and uploading.

What precautions should I take ?

1. There are some things that you should know when translating. If you will not respect the following rules, your entire work might be in vain.

2. If you see the & sign, please keep it – it’s required for shortcuts keys. Say, E&xit means that in the word Exit, character x will be underlined

3. If you see the % sign please leave the letter that follows it intact. The %s and %d signs will be replaced by words or numerals inside the program.

4. You must keep the length of the translated text as close to the original as possible. The translated text can be shorter than the original, but not longer. This is very important!

5. If the text that you want to translate looks something like “first text”, “second text” please respect the quotation marks. Internally, this means that there is a carriage return between the “first text” and “second text” groups of words. These carriage returns must be respected when translating.

6. The number of % signs in the text to be translated must be exactly the same as the number of % in the translated text!

Some texts seem to appear twice. Do i translate the again ?

Some texts might appear twice or, in some situations, an entire unit. You don’t have to translate all the texts again. You can use the translation repository. This repository is not automatically updated, unless you will specify something different from the Edit / Options menu.

Let’s take the example of the te_const unit. Open this unit only from the upper left drop-down box. After you translate it you can press Ctrl-A to select all listed items. Right click on a translated text then choose Add to Repository. After this, if you will choose from the upper menu Repository / Show Repository you should see all the selected items in the database.

Now, if you open the te_const unit from another project and want to translate it then all you have to do is select a text or all texts that you want to translate, right click on them and choose Translate with Repository.

How do I verify the translation ?

You can simply run BetterHash and choose from Settings / Options your new language. Close BetterHash, continue translating, then restart BetterHash and check again. This simple procedure will make sure that you don’t miss any texts.

I want to see what remained untranslated. How to list untranslated items ?

When a new version comes out, if you still want to translate the program, you don’t have to start translating the program from the beginning. All you will have to do is open our translation tool and choose from the upper menu Language / Show / Untranslated. The program will only display the untranslated items. If you translated some texts and they still appear as “untranslated” – just right click on them and choose “Is Translated”.

The text in my language is identical to the English original, but it is still listed as "Untranslated". How can i solve this ?

You must tell the localization program that the translated text is identical to the English version. You can do this by right-clicking with your mouse on the cell that’s in your language and choosing “Is Translated”. You will see that the little blue triangle located at the bottom of the cell will disappear. This means that the cell is now considered to be translated.

What are the translator's benefits ?

By translating BetterHash in your own language you will be listed at the top of this page, in the Official Translators list. Your name will also be included in the Home tab of BetterHash.

The translated cell became a "multiline cell" - while the native cell is not. What can I do ?

This happened because you typed a carriage return in before the string. There are two different ways to correct this problem. Right-click on the translated text and choose “Revert to Original”

OR

Click the “…” button to open the multiline cell editor. Delete the empty line that appears before the translated text. Then click the OK button

Even though I’ve translated quite a lot in both files, I can’t see many results (when I switch the language) and I still haven’t managed to translate any of the buttons on the opening screen. How can I translate the buttons?

The menus are quite far away. You can find them (as well as the descriptions) in the following section: Units.ModuleEngine_MSG.