blob: 0340c308b1b4ae0c8f0b7caedb9baef171040508 [file] [log] [blame]
Restorer74a23312024-03-28 09:19:44 +00001This directory contains a file with text strings for gVim installer.
2It also contains files with translations of the text strings for gVim installer
3into different languages.
4
5For translators.
6
7If 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
9directory.
10Note that in the definition of the MUI_LANGUAGE macro, the name of the language
11to be translated must be the English name of the language.
12The name of the file with the translation must match the name of the target
13language.
14Also, when translating strings, pay attention to some restrictions on the
15allowable 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.
19Characters in this case mean characters of the English alphabet.
20
RestorerZf8770402025-02-24 19:42:36 +010021Once the message translation file is ready, it must be included in the
22"gvim.nsi" file.
23Find the line "# Include support for other languages:" in the file "gvim.nsi"
24and 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
26specified in alphabetical order.
27
RestorerZ2730d382025-01-17 14:04:44 +010028If you do not yet have a translated "LICENSE" file and/or a main "README.txt"
Restorer74a23312024-03-28 09:19:44 +000029file, set the following values:
30
31for the license file
RestorerZ2730d382025-01-17 14:04:44 +010032LicenseLangString page_lic_file 0 "..\lang\LICENSE.nsis.txt"
Restorer74a23312024-03-28 09:19:44 +000033
34for the readme.txt file
35LangString vim_readme_file 0 "README.txt"
36
37Once you have the translations of these files, then set the values for these
38variables similarly to what is done in the other translation files.
RestorerZ2730d382025-01-17 14:04:44 +010039Translation files should be located in the "lang" subdirectory of the root
40directory. The name of the files is as follows: "README.xx.txt", where xx is the
41language code according to ISO639.
RestorerZf8770402025-02-24 19:42:36 +010042
43
44There are two ways to test the installer in different languages:
45
461. 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
512. 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.