Restorer | 74a2331 | 2024-03-28 09:19:44 +0000 | [diff] [blame] | 1 | This directory contains a file with text strings for gVim installer. |
| 2 | It also contains files with translations of the text strings for gVim installer |
| 3 | into different languages. |
| 4 | |
| 5 | For translators. |
| 6 | |
| 7 | If you want to prepare a translation for the gVim installer, use the file |
| 8 | "english.nsi" as a master file. See the other translation files in this |
| 9 | directory. |
| 10 | Note that in the definition of the MUI_LANGUAGE macro, the name of the language |
| 11 | to be translated must be the English name of the language. |
| 12 | The name of the file with the translation must match the name of the target |
| 13 | language. |
| 14 | Also, when translating strings, pay attention to some restrictions on the |
| 15 | allowable length of strings. For example: |
| 16 | component description field - 117 characters; |
| 17 | description above the drop-down lists on the .vimrc page - 53 characters; |
| 18 | drop-down lists on the .vimrc page - 55 characters. |
| 19 | Characters in this case mean characters of the English alphabet. |
| 20 | |
RestorerZ | f877040 | 2025-02-24 19:42:36 +0100 | [diff] [blame^] | 21 | Once the message translation file is ready, it must be included in the |
| 22 | "gvim.nsi" file. |
| 23 | Find the line "# Include support for other languages:" in the file "gvim.nsi" |
| 24 | and specify the name of the file with your translation below the line |
| 25 | !if ${HAVE_MULTI_LANG}, similar to the entries already there. File names are |
| 26 | specified in alphabetical order. |
| 27 | |
RestorerZ | 2730d38 | 2025-01-17 14:04:44 +0100 | [diff] [blame] | 28 | If you do not yet have a translated "LICENSE" file and/or a main "README.txt" |
Restorer | 74a2331 | 2024-03-28 09:19:44 +0000 | [diff] [blame] | 29 | file, set the following values: |
| 30 | |
| 31 | for the license file |
RestorerZ | 2730d38 | 2025-01-17 14:04:44 +0100 | [diff] [blame] | 32 | LicenseLangString page_lic_file 0 "..\lang\LICENSE.nsis.txt" |
Restorer | 74a2331 | 2024-03-28 09:19:44 +0000 | [diff] [blame] | 33 | |
| 34 | for the readme.txt file |
| 35 | LangString vim_readme_file 0 "README.txt" |
| 36 | |
| 37 | Once you have the translations of these files, then set the values for these |
| 38 | variables similarly to what is done in the other translation files. |
RestorerZ | 2730d38 | 2025-01-17 14:04:44 +0100 | [diff] [blame] | 39 | Translation files should be located in the "lang" subdirectory of the root |
| 40 | directory. The name of the files is as follows: "README.xx.txt", where xx is the |
| 41 | language code according to ISO639. |
RestorerZ | f877040 | 2025-02-24 19:42:36 +0100 | [diff] [blame^] | 42 | |
| 43 | |
| 44 | There are two ways to test the installer in different languages: |
| 45 | |
| 46 | 1. Find and uncomment the "!define MUI_LANGDLL_ALWAYSSHOW" line in the |
| 47 | "gvim.nsi" file and rebuild the installer. |
| 48 | Now every time you run it, you will see a dialog box with the possibility to |
| 49 | select the language of the installer. |
| 50 | |
| 51 | 2. If the Vim editor is already installed in your system, delete the |
| 52 | "Installer Language" parameter in the Windows registry under |
| 53 | "HKEY_CURRENT_USER\Software\Vim". |
| 54 | Or you can create a file "NoLangInstallerVim.reg" with the following content: |
| 55 | |
| 56 | Windows Registry Editor Version 5.00 |
| 57 | |
| 58 | [HKEY_CURRENT_USER\Software\Vim] |
| 59 | "Installer Language"=- |
| 60 | |
| 61 | and apply it by double-clicking on it. |
| 62 | After these steps, when you start the installer, a window with the installer |
| 63 | language selection will also be displayed. |