annotate runtime/lang/README.txt @ 30214:37cf1af90ffc

Added tag v9.0.0442 for changeset 4fedacdad3b4d67c1db9c3893af4405982f227e8
author Bram Moolenaar <Bram@vim.org>
date Sun, 11 Sep 2022 14:45:05 +0200
parents 0fdf36de4018
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
14372
2a4a2dc35c55 Update runtime files.
Christian Brabandt <cb@256bit.org>
parents: 7
diff changeset
1 Language files for Vim: Translated menus
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
2
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
3 The contents of each menu file is a sequence of lines with "menutrans"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
4 commands. Read one of the existing files to get an idea of how this works.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
5
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
6 More information in the on-line help:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
8 :help multilang-menus
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
9 :help :menutrans
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
10 :help 'langmenu'
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
11 :help :language
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
12
29269
0fdf36de4018 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14372
diff changeset
13 You can find a couple of helper tools for translating menus on github:
0fdf36de4018 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14372
diff changeset
14 https://github.com/adaext/vim-menutrans-helper
0fdf36de4018 Update runtime files
Bram Moolenaar <Bram@vim.org>
parents: 14372
diff changeset
15
7
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
16 The "$VIMRUNTIME/menu.vim" file will search for a menu translation file. This
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
17 depends on the value of the "v:lang" variable.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
18
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
19 "menu_" . v:lang . ".vim"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
20
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
21 When the 'menutrans' option is set, its value will be used instead of v:lang.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
22
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
23 The file name is always lower case. It is the full name as the ":language"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
24 command shows (the LC_MESSAGES value).
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
25
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
26 For example, to use the Big5 (Taiwan) menus on MS-Windows the $LANG will be
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
27
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
28 Chinese(Taiwan)_Taiwan.950
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
29
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
30 and use the menu translation file:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
31
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
32 $VIMRUNTIME/lang/menu_chinese(taiwan)_taiwan.950.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
33
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
34 On Unix you should set $LANG, depending on your shell:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
35
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
36 csh/tcsh: setenv LANG "zh_TW.Big5"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
37 sh/bash/ksh: export LANG="zh_TW.Big5"
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
38
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
39 and the menu translation file is:
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
40
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
41 $VIMRUNTIME/lang/menu_zh_tw.big5.vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
42
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
43 The menu translation file should set the "did_menu_trans" variable so that Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
44 will not load another file.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
45
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
46
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
47 AUTOMATIC CONVERSION
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
48
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
49 When Vim was compiled with multi-byte support, conversion between latin1 and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
50 UTF-8 will always be possible. Other conversions depend on the iconv
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
51 library, which is not always available.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
52 For UTF-8 menu files which only use latin1 characters, you can rely on Vim
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
53 doing the conversion. Let the UTF-8 menu file source the latin1 menu file,
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
54 and put "scriptencoding latin1" in that one.
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
55 Other conversions may not always be available (e.g., between iso-8859-# and
3fc0f57ecb91 updated for version 7.0001
vimboss
parents:
diff changeset
56 MS-Windows codepages), thus the converted menu file must be available.