557
|
1 *mbyte.txt* For Vim version 7.0aa. Last change: 2005 Oct 14
|
7
|
2
|
|
3
|
|
4 VIM REFERENCE MANUAL by Bram Moolenaar et al.
|
|
5
|
|
6
|
|
7 Multi-byte support *multibyte* *multi-byte*
|
|
8 *Chinese* *Japanese* *Korean*
|
|
9 This is about editing text in languages which have many characters that can
|
|
10 not be represented using one byte (one octet). Examples are Chinese, Japanese
|
|
11 and Korean. Unicode is also covered here.
|
|
12
|
|
13 For an introduction to the most common features, see |usr_45.txt| in the user
|
|
14 manual.
|
|
15 For changing the language of messages and menus see |mlang.txt|.
|
|
16
|
|
17 {not available when compiled without the +multi_byte feature}
|
|
18
|
|
19
|
|
20 1. Getting started |mbyte-first|
|
|
21 2. Locale |mbyte-locale|
|
|
22 3. Encoding |mbyte-encoding|
|
|
23 4. Using a terminal |mbyte-terminal|
|
|
24 5. Fonts on X11 |mbyte-fonts-X11|
|
|
25 6. Fonts on MS-Windows |mbyte-fonts-MSwin|
|
|
26 7. Input on X11 |mbyte-XIM|
|
|
27 8. Input on MS-Windows |mbyte-IME|
|
|
28 9. Input with a keymap |mbyte-keymap|
|
|
29 10. Using UTF-8 |mbyte-utf8|
|
|
30 11. Overview of options |mbyte-options|
|
|
31
|
|
32 NOTE: This file contains UTF-8 characters. These may show up as strange
|
|
33 characters or boxes when using another encoding.
|
|
34
|
|
35 ==============================================================================
|
|
36 1. Getting started *mbyte-first*
|
|
37
|
|
38 This is a summary of the multibyte features in Vim. If you are lucky it works
|
|
39 as described and you can start using Vim without much trouble. If something
|
|
40 doesn't work you will have to read the rest. Don't be surprised if it takes
|
|
41 quite a bit of work and experimenting to make Vim use all the multi-byte
|
|
42 features. Unfortunately, every system has its own way to deal with multibyte
|
|
43 languages and it is quite complicated.
|
|
44
|
|
45
|
|
46 COMPILING
|
|
47
|
|
48 If you already have a compiled Vim program, check if the |+multi_byte| feature
|
|
49 is included. The |:version| command can be used for this.
|
|
50
|
|
51 If +multi_byte is not included, you should compile Vim with "big" features.
|
|
52 You can further tune what features are included. See the INSTALL files in the
|
|
53 source directory.
|
|
54
|
|
55
|
|
56 LOCALE
|
|
57
|
|
58 First of all, you must make sure your current locale is set correctly. If
|
|
59 your system has been installed to use the language, it probably works right
|
|
60 away. If not, you can often make it work by setting the $LANG environment
|
|
61 variable in your shell: >
|
|
62
|
|
63 setenv LANG ja_JP.EUC
|
|
64
|
|
65 Unfortunately, the name of the locale depends on your system. Japanese might
|
|
66 also be called "ja_JP.EUCjp" or just "ja". To see what is currently used: >
|
|
67
|
|
68 :language
|
|
69
|
|
70 To change the locale inside Vim use: >
|
|
71
|
|
72 :language ja_JP.EUC
|
|
73
|
|
74 Vim will give an error message if this doesn't work. This is a good way to
|
|
75 experiment and find the locale name you want to use. But it's always better
|
|
76 to set the locale in the shell, so that it is used right from the start.
|
|
77
|
|
78 See |mbyte-locale| for details.
|
|
79
|
|
80
|
|
81 ENCODING
|
|
82
|
|
83 If your locale works properly, Vim will try to set the 'encoding' option
|
|
84 accordingly. If this doesn't work you can overrule its value: >
|
|
85
|
|
86 :set encoding=utf-8
|
|
87
|
|
88 See |encoding-values| for a list of acceptable values.
|
|
89
|
|
90 The result is that all the text that is used inside Vim will be in this
|
|
91 encoding. Not only the text in the buffers, but also in registers, variables,
|
|
92 etc. This also means that changing the value of 'encoding' makes the existing
|
|
93 text invalid! The text doesn't change, but it will be displayed wrong.
|
|
94
|
|
95 You can edit files in another encoding than what 'encoding' is set to. Vim
|
|
96 will convert the file when you read it and convert it back when you write it.
|
|
97 See 'fileencoding', 'fileencodings' and |++enc|.
|
|
98
|
|
99
|
|
100 DISPLAY AND FONTS
|
|
101
|
|
102 If you are working in a terminal (emulator) you must make sure it accepts the
|
|
103 same encoding as which Vim is working with. If this is not the case, you can
|
|
104 use the 'termencoding' option to make Vim convert text automatically.
|
|
105
|
|
106 For the GUI you must select fonts that work with the current 'encoding'. This
|
|
107 is the difficult part. It depends on the system you are using, the locale and
|
|
108 a few other things. See the chapters on fonts: |mbyte-fonts-X11| for
|
|
109 X-Windows and |mbyte-fonts-MSwin| for MS-Windows.
|
|
110
|
|
111 For GTK+ 2, you can skip most of this section. The option 'guifontset' does
|
|
112 no longer exist. You only need to set 'guifont' and everything should "just
|
|
113 work". If your system comes with Xft2 and fontconfig and the current font
|
|
114 does not contain a certain glyph, a different font will be used automatically
|
|
115 if available. The 'guifontwide' option is still supported but usually you do
|
|
116 not need to set it. It is only necessary if the automatic font selection does
|
|
117 not suit your needs.
|
|
118
|
|
119 For X11 you can set the 'guifontset' option to a list of fonts that together
|
|
120 cover the characters that are used. Example for Korean: >
|
|
121
|
|
122 :set guifontset=k12,r12
|
|
123
|
|
124 Alternatively, you can set 'guifont' and 'guifontwide'. 'guifont' is used for
|
|
125 the single-width characters, 'guifontwide' for the double-width characters.
|
|
126 Thus the 'guifontwide' font must be exactly twice as wide as 'guifont'.
|
|
127 Example for UTF-8: >
|
|
128
|
|
129 :set guifont=-misc-fixed-medium-r-normal-*-18-120-100-100-c-90-iso10646-1
|
|
130 :set guifontwide=-misc-fixed-medium-r-normal-*-18-120-100-100-c-180-iso10646-1
|
|
131
|
|
132 You can also set 'guifont' alone, Vim will try to find a matching
|
|
133 'guifontwide' for you.
|
|
134
|
|
135
|
|
136 INPUT
|
|
137
|
|
138 There are several ways to enter multi-byte characters:
|
|
139 - For X11 XIM can be used. See |XIM|.
|
|
140 - For MS-Windows IME can be used. See |IME|.
|
|
141 - For all systems keymaps can be used. See |mbyte-keymap|.
|
|
142
|
|
143 The options 'iminsert', 'imsearch' and 'imcmdline' can be used to chose
|
9
|
144 the different input methods or disable them temporarily.
|
7
|
145
|
|
146 ==============================================================================
|
|
147 2. Locale *mbyte-locale*
|
|
148
|
|
149 The easiest setup is when your whole system uses the locale you want to work
|
|
150 in. But it's also possible to set the locale for one shell you are working
|
|
151 in, or just use a certain locale inside Vim.
|
|
152
|
|
153
|
|
154 WHAT IS A LOCALE? *locale*
|
|
155
|
|
156 There are many of languages in the world. And there are different cultures
|
|
157 and environments at least as much as the number of languages. A linguistic
|
|
158 environment corresponding to an area is called "locale". This includes
|
|
159 information about the used language, the charset, collating order for sorting,
|
|
160 date format, currency format and so on. For Vim only the language and charset
|
|
161 really matter.
|
|
162
|
|
163 You can only use a locale if your system has support for it. Some systems
|
|
164 have only a few locales, especially in the USA. The language which you want
|
|
165 to use may not be on your system. In that case you might be able to install
|
|
166 it as an extra package. Check your system documentation for how to do that.
|
|
167
|
|
168 The location in which the locales are installed varies from system to system.
|
|
169 For example, "/usr/share/locale" or "/usr/lib/locale". See your system's
|
|
170 setlocale() man page.
|
|
171
|
|
172 Looking in these directories will show you the exact name of each locale.
|
|
173 Mostly upper/lowercase matters, thus "ja_JP.EUC" and "ja_jp.euc" are
|
|
174 different. Some systems have a locale.alias file, which allows translation
|
|
175 from a short name like "nl" to the full name "nl_NL.ISO_8859-1".
|
|
176
|
|
177 Note that X-windows has its own locale stuff. And unfortunately uses locale
|
|
178 names different from what is used elsewhere. This is confusing! For Vim it
|
|
179 matters what the setlocale() function uses, which is generally NOT the
|
|
180 X-windows stuff. You might have to do some experiments to find out what
|
|
181 really works.
|
|
182
|
|
183 *locale-name*
|
|
184 The (simplified) format of |locale| name is:
|
|
185
|
|
186 language
|
|
187 or language_territory
|
|
188 or language_territory.codeset
|
|
189
|
|
190 Territory means the country (or part of it), codeset means the |charset|. For
|
|
191 example, the locale name "ja_JP.eucJP" means:
|
|
192 ja the language is Japanese
|
|
193 JP the country is Japan
|
|
194 eucJP the codeset is EUC-JP
|
|
195 But it also could be "ja", "ja_JP.EUC", "ja_JP.ujis", etc. And unfortunately,
|
|
196 the locale name for a specific language, territory and codeset is not unified
|
|
197 and depends on your system.
|
|
198
|
|
199 Examples of locale name:
|
|
200 charset language locale name ~
|
|
201 GB2312 Chinese (simplified) zh_CN.EUC, zh_CN.GB2312
|
|
202 Big5 Chinese (traditional) zh_TW.BIG5, zh_TW.Big5
|
|
203 CNS-11643 Chinese (traditional) zh_TW
|
|
204 EUC-JP Japanese ja, ja_JP.EUC, ja_JP.ujis, ja_JP.eucJP
|
|
205 Shift_JIS Japanese ja_JP.SJIS, ja_JP.Shift_JIS
|
|
206 EUC-KR Korean ko, ko_KR.EUC
|
|
207
|
|
208
|
|
209 USING A LOCALE
|
|
210
|
|
211 To start using a locale for the whole system, see the documentation of your
|
|
212 system. Mostly you need to set it in a configuration file in "/etc".
|
|
213
|
|
214 To use a locale in a shell, set the $LANG environment value. When you want to
|
|
215 use Korean and the |locale| name is "ko", do this:
|
|
216
|
|
217 sh: export LANG=ko
|
|
218 csh: setenv LANG ko
|
|
219
|
|
220 You can put this in your ~/.profile or ~/.cshrc file to always use it.
|
|
221
|
|
222 To use a locale in Vim only, use the |:language| command: >
|
|
223
|
|
224 :language ko
|
|
225
|
|
226 Put this in your ~/.vimrc file to use it always.
|
|
227
|
|
228 Or specify $LANG when starting Vim:
|
|
229
|
|
230 sh: LANG=ko vim {vim-arguments}
|
|
231 csh: env LANG=ko vim {vim-arguments}
|
|
232
|
|
233 You could make a small shell script for this.
|
|
234
|
|
235 ==============================================================================
|
|
236 3. Encoding *mbyte-encoding*
|
|
237
|
|
238 Vim uses the 'encoding' option to specify how characters identified and
|
|
239 encoded when they are used inside Vim. This applies to all the places where
|
|
240 text is used, including buffers (files loaded into memory), registers and
|
|
241 variables.
|
|
242
|
|
243 *charset* *codeset*
|
|
244 Charset is another name for encoding. There are subtle differences, but these
|
|
245 don't matter when using Vim. "codeset" is another similar name.
|
|
246
|
|
247 Each character is encoded as one or more bytes. When all characters are
|
|
248 encoded with one byte, we call this a single-byte encoding. The most often
|
|
249 used one is called "latin1". This limits the number of characters to 256.
|
|
250 Some of these are control characters, thus even fewer can be used for text.
|
|
251
|
|
252 When some characters use two or more bytes, we call this a multi-byte
|
|
253 encoding. This allows using much more than 256 characters, which is required
|
|
254 for most East Asian languages.
|
|
255
|
|
256 Most multi-byte encodings use one byte for the first 127 characters. These
|
|
257 are equal to ASCII, which makes it easy to exchange plain-ASCII text, no
|
|
258 matter what language is used. Thus you might see the right text even when the
|
|
259 encoding was set wrong.
|
|
260
|
|
261 *encoding-names*
|
|
262 Vim can use many different character encodings. There are three major groups:
|
|
263
|
|
264 1 8bit Single-byte encodings, 256 different characters. Mostly used
|
|
265 in USA and Europe. Example: ISO-8859-1 (Latin1). All
|
|
266 characters occupy one screen cell only.
|
|
267
|
|
268 2 2byte Double-byte encodings, over 10000 different characters.
|
|
269 Mostly used in Asian countries. Example: euc-kr (Korean)
|
|
270 The number of screen cells is equal to the number of bytes
|
|
271 (except for euc-jp when the first byte is 0x8e).
|
|
272
|
|
273 u Unicode Universal encoding, can replace all others. ISO 10646.
|
|
274 Millions of different characters. Example: UTF-8. The
|
|
275 relation between bytes and screen cells is complex.
|
|
276
|
|
277 Other encodings cannot be used by Vim internally. But files in other
|
|
278 encodings can be edited by using conversion, see 'fileencoding'.
|
|
279 Note that all encodings must use ASCII for the characters up to 128 (except
|
|
280 when compiled for EBCDIC).
|
|
281
|
|
282 Supported 'encoding' values are: *encoding-values*
|
|
283 1 latin1 8-bit characters (ISO 8859-1)
|
|
284 1 iso-8859-n ISO_8859 variant (n = 2 to 15)
|
|
285 1 koi8-r Russian
|
|
286 1 koi8-u Ukrainian
|
|
287 1 macroman MacRoman (Macintosh encoding)
|
|
288 1 8bit-{name} any 8-bit encoding (Vim specific name)
|
407
|
289 1 cp437 similar to iso-8859-1
|
|
290 1 cp737 similar to iso-8859-7
|
|
291 1 cp775 Baltic
|
|
292 1 cp850 similar to iso-8859-4
|
|
293 1 cp852 similar to iso-8859-1
|
|
294 1 cp855 similar to iso-8859-2
|
|
295 1 cp857 similar to iso-8859-5
|
|
296 1 cp860 similar to iso-8859-9
|
|
297 1 cp861 similar to iso-8859-1
|
|
298 1 cp862 similar to iso-8859-1
|
|
299 1 cp863 similar to iso-8859-8
|
|
300 1 cp865 similar to iso-8859-1
|
|
301 1 cp866 similar to iso-8859-5
|
|
302 1 cp869 similar to iso-8859-7
|
|
303 1 cp874 Thai
|
|
304 1 cp1250 Czech, Polish, etc.
|
|
305 1 cp1251 Cyrillic
|
|
306 1 cp1253 Greek
|
|
307 1 cp1254 Turkish
|
|
308 1 cp1255 Hebrew
|
|
309 1 cp1256 Arabic
|
|
310 1 cp1257 Baltic
|
|
311 1 cp1258 Vietnamese
|
7
|
312 1 cp{number} MS-Windows: any installed single-byte codepage
|
|
313 2 cp932 Japanese (Windows only)
|
|
314 2 euc-jp Japanese (Unix only)
|
|
315 2 sjis Japanese (Unix only)
|
|
316 2 cp949 Korean (Unix and Windows)
|
|
317 2 euc-kr Korean (Unix only)
|
|
318 2 cp936 simplified Chinese (Windows only)
|
|
319 2 euc-cn simplified Chinese (Unix only)
|
|
320 2 cp950 traditional Chinese (on Unix alias for big5)
|
|
321 2 big5 traditional Chinese (on Windows alias for cp950)
|
|
322 2 euc-tw traditional Chinese (Unix only)
|
|
323 2 2byte-{name} Unix: any double-byte encoding (Vim specific name)
|
|
324 2 cp{number} MS-Windows: any installed double-byte codepage
|
|
325 u utf-8 32 bit UTF-8 encoded Unicode (ISO/IEC 10646-1)
|
|
326 u ucs-2 16 bit UCS-2 encoded Unicode (ISO/IEC 10646-1)
|
|
327 u ucs-2le like ucs-2, little endian
|
|
328 u utf-16 ucs-2 extended with double-words for more characters
|
|
329 u utf-16le like utf-16, little endian
|
|
330 u ucs-4 32 bit UCS-4 encoded Unicode (ISO/IEC 10646-1)
|
|
331 u ucs-4le like ucs-4, little endian
|
|
332
|
|
333 The {name} can be any encoding name that your system supports. It is passed
|
|
334 to iconv() to convert between the encoding of the file and the current locale.
|
|
335 For MS-Windows "cp{number}" means using codepage {number}.
|
|
336 Examples: >
|
|
337 :set encoding=8bit-cp1252
|
|
338 :set encoding=2byte-cp932
|
|
339 <
|
|
340 Several aliases can be used, they are translated to one of the names above.
|
|
341 An incomplete list:
|
|
342
|
|
343 1 ansi same as latin1 (obsolete, for backward compatibility)
|
|
344 2 japan Japanese: on Unix "euc-jp", on MS-Windows cp932
|
|
345 2 korea Korean: on Unix "euc-kr", on MS-Windows cp949
|
|
346 2 prc simplified Chinese: on Unix "euc-cn", on MS-Windows cp936
|
|
347 2 chinese same as "prc"
|
|
348 2 taiwan traditional Chinese: on Unix "euc-tw", on MS-Windows cp950
|
|
349 u utf8 same as utf-8
|
|
350 u unicode same as ucs-2
|
|
351 u ucs2be same as ucs-2 (big endian)
|
|
352 u ucs-2be same as ucs-2 (big endian)
|
|
353 u ucs-4be same as ucs-4 (big endian)
|
39
|
354 default stands for the default value of 'encoding', depends on the
|
|
355 environment
|
7
|
356
|
|
357 For the UCS codes the byte order matters. This is tricky, use UTF-8 whenever
|
|
358 you can. The default is to use big-endian (most significant byte comes
|
|
359 first):
|
|
360 name bytes char ~
|
|
361 ucs-2 11 22 1122
|
|
362 ucs-2le 22 11 1122
|
|
363 ucs-4 11 22 33 44 11223344
|
|
364 ucs-4le 44 33 22 11 11223344
|
|
365
|
|
366 On MS-Windows systems you often want to use "ucs-2le", because it uses little
|
|
367 endian UCS-2.
|
|
368
|
|
369 There are a few encodings which are similar, but not exactly the same. Vim
|
|
370 treats them as if they were different encodings, so that conversion will be
|
|
371 done when needed. You might want to use the similar name to avoid conversion
|
|
372 or when conversion is not possible:
|
|
373
|
|
374 cp932, shift-jis, sjis
|
|
375 cp936, euc-cn
|
|
376
|
|
377 *encoding-table*
|
|
378 Normally 'encoding' is equal to your current locale and 'termencoding' is
|
|
379 empty. This means that your keyboard and display work with characters encoded
|
|
380 in your current locale, and Vim uses the same characters internally.
|
|
381
|
|
382 You can make Vim use characters in a different encoding by setting the
|
|
383 'encoding' option to a different value. Since the keyboard and display still
|
|
384 use the current locale, conversion needs to be done. The 'termencoding' then
|
|
385 takes over the value of the current locale, so Vim converts between 'encoding'
|
|
386 and 'termencoding'. Example: >
|
|
387 :let &termencoding = &encoding
|
|
388 :set encoding=utf-8
|
|
389
|
|
390 However, not all combinations of values are possible. The table below tells
|
|
391 you how each of the nine combinations works. This is further restricted by
|
|
392 not all conversions being possible, iconv() being present, etc. Since this
|
|
393 depends on the system used, no detailed list can be given.
|
|
394
|
|
395 ('tenc' is the short name for 'termencoding' and 'enc' short for 'encoding')
|
|
396
|
|
397 'tenc' 'enc' remark ~
|
|
398
|
|
399 8bit 8bit Works. When 'termencoding' is different from
|
|
400 'encoding' typing and displaying may be wrong for some
|
|
401 characters, Vim does NOT perform conversion (set
|
|
402 'encoding' to "utf-8" to get this).
|
|
403 8bit 2byte MS-Windows: works for all codepages installed on your
|
|
404 system; you can only type 8bit characters;
|
|
405 Other systems: does NOT work.
|
|
406 8bit Unicode Works, but you can only type 8bit characters; in a
|
|
407 terminal you can only see 8bit characters; the GUI can
|
|
408 show all characters that the 'guifont' supports.
|
|
409
|
|
410 2byte 8bit Works, but typing non-ASCII characters might
|
|
411 be a problem.
|
|
412 2byte 2byte MS-Windows: works for all codepages installed on your
|
|
413 system; typing characters might be a problem when
|
|
414 locale is different from 'encoding'.
|
|
415 Other systems: Only works when 'termencoding' is equal
|
|
416 to 'encoding', you might as well leave it empty.
|
|
417 2byte Unicode works, Vim will translate typed characters.
|
|
418
|
|
419 Unicode 8bit works (unusual)
|
|
420 Unicode 2byte does NOT work
|
|
421 Unicode Unicode works very well (leaving 'termencoding' empty works
|
|
422 the same way, because all Unicode is handled
|
|
423 internally as UTF-8)
|
|
424
|
|
425 CONVERSION *charset-conversion*
|
|
426
|
|
427 Vim will automatically convert from one to another encoding in several places:
|
|
428 - When reading a file and 'fileencoding' is different from 'encoding'
|
|
429 - When writing a file and 'fileencoding' is different from 'encoding'
|
|
430 - When displaying characters and 'termencoding' is different from 'encoding'
|
|
431 - When reading input and 'termencoding' is different from 'encoding'
|
|
432 - When displaying messages and the encoding used for LC_MESSAGES differs from
|
|
433 'encoding' (requires a gettext version that supports this).
|
|
434 - When reading a Vim script where |:scriptencoding| is different from
|
|
435 'encoding'.
|
|
436 - When reading or writing a |viminfo| file.
|
|
437 Most of these require the |+iconv| feature. Conversion for reading and
|
|
438 writing files may also be specified with the 'charconvert' option.
|
|
439
|
|
440 Useful utilities for converting the charset:
|
|
441 All: iconv
|
|
442 GNU iconv can convert most encodings. Unicode is used as the
|
|
443 intermediate encoding, which allows conversion from and to all other
|
|
444 encodings. See http://www.gnu.org/directory/libiconv.html.
|
|
445
|
|
446 Japanese: nkf
|
|
447 Nkf is "Network Kanji code conversion Filter". One of the most unique
|
|
448 facility of nkf is the guess of the input Kanji code. So, you don't
|
|
449 need to know what the inputting file's |charset| is. When convert to
|
|
450 EUC-JP from ISO-2022-JP or Shift_JIS, simply do the following command
|
|
451 in Vim:
|
|
452 :%!nkf -e
|
|
453 Nkf can be found at:
|
|
454 http://www.sfc.wide.ad.jp/~max/FreeBSD/ports/distfiles/nkf-1.62.tar.gz
|
|
455
|
|
456 Chinese: hc
|
|
457 Hc is "Hanzi Converter". Hc convert a GB file to a Big5 file, or Big5
|
|
458 file to GB file. Hc can be found at:
|
|
459 ftp://ftp.cuhk.hk/pub/chinese/ifcss/software/unix/convert/hc-30.tar.gz
|
|
460
|
|
461 Korean: hmconv
|
236
|
462 Hmconv is Korean code conversion utility especially for E-mail. It can
|
7
|
463 convert between EUC-KR and ISO-2022-KR. Hmconv can be found at:
|
|
464 ftp://ftp.kaist.ac.kr/pub/hangul/code/hmconv/
|
|
465
|
|
466 Multilingual: lv
|
|
467 Lv is a Powerful Multilingual File Viewer. And it can be worked as
|
|
468 |charset| converter. Supported |charset|: ISO-2022-CN, ISO-2022-JP,
|
|
469 ISO-2022-KR, EUC-CN, EUC-JP, EUC-KR, EUC-TW, UTF-7, UTF-8, ISO-8859
|
236
|
470 series, Shift_JIS, Big5 and HZ. Lv can be found at:
|
7
|
471 http://www.ff.iij4u.or.jp/~nrt/freeware/lv4495.tar.gz
|
|
472
|
|
473
|
|
474 *mbyte-conversion*
|
|
475 When reading and writing files in an encoding different from 'encoding',
|
|
476 conversion needs to be done. These conversions are supported:
|
|
477 - All conversions between Latin-1 (ISO-8859-1), UTF-8, UCS-2 and UCS-4 are
|
|
478 handled internally.
|
|
479 - For MS-Windows, when 'encoding' is a Unicode encoding, conversion from and
|
|
480 to any codepage should work.
|
|
481 - Conversion specified with 'charconvert'
|
|
482 - Conversion with the iconv library, if it is available.
|
|
483 Old versions of GNU iconv() may cause the conversion to fail (they
|
|
484 request a very large buffer, more than Vim is willing to provide).
|
|
485 Try getting another iconv() implementation.
|
|
486
|
557
|
487 *iconv-dynamic*
|
|
488 On MS-Windows Vim can be compiled with the |+iconv/dyn| feature. This means
|
|
489 Vim will search for the "iconv.dll" and "libiconv.dll" libraries. When
|
|
490 neither of them can be found Vim will still work but some conversions won't be
|
|
491 possible.
|
|
492
|
7
|
493 ==============================================================================
|
|
494 4. Using a terminal *mbyte-terminal*
|
|
495
|
|
496 The GUI fully supports multi-byte characters. It is also possible in a
|
|
497 terminal, if the terminal supports the same encoding that Vim uses. Thus this
|
|
498 is less flexible.
|
|
499
|
|
500 For example, you can run Vim in a xterm with added multi-byte support and/or
|
|
501 |XIM|. Examples are kterm (Kanji term) and hanterm (for Korean), Eterm
|
|
502 (Enlightened terminal) and rxvt.
|
|
503
|
|
504 If your terminal does not support the right encoding, you can set the
|
|
505 'termencoding' option. Vim will then convert the typed characters from
|
|
506 'termencoding' to 'encoding'. And displayed text will be converted from
|
|
507 'encoding' to 'termencoding'. If the encoding supported by the terminal
|
|
508 doesn't include all the characters that Vim uses, this leads to lost
|
|
509 characters. This may mess up the display. If you use a terminal that
|
|
510 supports Unicode, such as the xterm mentioned below, it should work just fine,
|
|
511 since nearly every character set can be converted to Unicode without loss of
|
|
512 information.
|
|
513
|
|
514
|
|
515 UTF-8 IN XFREE86 XTERM *UTF8-xterm*
|
|
516
|
|
517 This is a short explanation of how to use UTF-8 character encoding in the
|
|
518 xterm that comes with XFree86 by Thomas Dickey (text by Markus Kuhn).
|
|
519
|
|
520 Get the latest xterm version which has now UTF-8 support:
|
|
521
|
|
522 http://invisible-island.net/xterm/xterm.html
|
|
523
|
|
524 Compile it with "./configure --enable-wide-chars ; make"
|
|
525
|
|
526 Also get the ISO 10646-1 version of various fonts, which is available on
|
|
527
|
|
528 http://www.cl.cam.ac.uk/~mgk25/download/ucs-fonts.tar.gz
|
|
529
|
|
530 and install the font as described in the README file.
|
|
531
|
|
532 Now start xterm with >
|
|
533
|
|
534 xterm -u8 -fn -misc-fixed-medium-r-semicondensed--13-120-75-75-c-60-iso10646-1
|
|
535 or, for bigger character: >
|
|
536 xterm -u8 -fn -misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1
|
|
537
|
236
|
538 and you will have a working UTF-8 terminal emulator. Try both >
|
7
|
539
|
|
540 cat utf-8-demo.txt
|
|
541 vim utf-8-demo.txt
|
|
542
|
|
543 with the demo text that comes with ucs-fonts.tar.gz in order to see
|
|
544 whether there are any problems with UTF-8 in your xterm.
|
|
545
|
|
546 For Vim you may need to set 'encoding' to "utf-8".
|
|
547
|
|
548 ==============================================================================
|
|
549 5. Fonts on X11 *mbyte-fonts-X11*
|
|
550
|
|
551 Unfortunately, using fonts in X11 is complicated. The name of a single-byte
|
|
552 font is a long string. For multi-byte fonts we need several of these...
|
|
553
|
|
554 Note: Most of this is no longer relevant for GTK+ 2. Selecting a font via
|
|
555 its XLFD is not supported anymore; see 'guifont' for an example of how to
|
|
556 set the font. Do yourself a favor and ignore the |XLFD| and |xfontset|
|
|
557 sections below.
|
|
558
|
|
559 First of all, Vim only accepts fixed-width fonts for displaying text. You
|
|
560 cannot use proportionally spaced fonts. This excludes many of the available
|
|
561 (and nicer looking) fonts. However, for menus and tooltips any font can be
|
|
562 used.
|
|
563
|
|
564 Note that Display and Input are independent. It is possible to see your
|
|
565 language even though you have no input method for it.
|
|
566
|
|
567 You should get a default font for menus and tooltips that works, but it might
|
|
568 be ugly. Read the following to find out how to select a better font.
|
|
569
|
|
570
|
|
571 X LOGICAL FONT DESCRIPTION (XLFD)
|
|
572 *XLFD*
|
|
573 XLFD is the X font name and contains the information about the font size,
|
|
574 charset, etc. The name is in this format:
|
|
575
|
|
576 FOUNDRY-FAMILY-WEIGHT-SLANT-WIDTH-STYLE-PIXEL-POINT-X-Y-SPACE-AVE-CR-CE
|
|
577
|
|
578 Each field means:
|
|
579
|
|
580 - FOUNDRY: FOUNDRY field. The company that created the font.
|
|
581 - FAMILY: FAMILY_NAME field. Basic font family name. (helvetica, gothic,
|
|
582 times, etc)
|
|
583 - WEIGHT: WEIGHT_NAME field. How thick the letters are. (light, medium,
|
|
584 bold, etc)
|
|
585 - SLANT: SLANT field.
|
|
586 r: Roman (no slant)
|
|
587 i: Italic
|
|
588 o: Oblique
|
|
589 ri: Reverse Italic
|
|
590 ro: Reverse Oblique
|
|
591 ot: Other
|
|
592 number: Scaled font
|
|
593 - WIDTH: SETWIDTH_NAME field. Width of characters. (normal, condensed,
|
|
594 narrow, double wide)
|
|
595 - STYLE: ADD_STYLE_NAME field. Extra info to describe font. (Serif, Sans
|
|
596 Serif, Informal, Decorated, etc)
|
|
597 - PIXEL: PIXEL_SIZE field. Height, in pixels, of characters.
|
|
598 - POINT: POINT_SIZE field. Ten times height of characters in points.
|
|
599 - X: RESOLUTION_X field. X resolution (dots per inch).
|
|
600 - Y: RESOLUTION_Y field. Y resolution (dots per inch).
|
|
601 - SPACE: SPACING field.
|
|
602 p: Proportional
|
|
603 m: Monospaced
|
|
604 c: CharCell
|
|
605 - AVE: AVERAGE_WIDTH field. Ten times average width in pixels.
|
|
606 - CR: CHARSET_REGISTRY field. The name of the charset group.
|
|
607 - CE: CHARSET_ENCODING field. The rest of the charset name. For some
|
|
608 charsets, such as JIS X 0208, if this field is 0, code points has
|
|
609 the same value as GL, and GR if 1.
|
|
610
|
|
611 For example, in case of a 14 dots font corresponding to JIS X 0208, it is
|
|
612 written like:
|
|
613 -misc-fixed-medium-r-normal--16-110-100-100-c-160-jisx0208.1990-0
|
|
614
|
|
615
|
|
616 X FONTSET
|
|
617 *fontset* *xfontset*
|
|
618 A single-byte charset is typically associated with one font. For multi-byte
|
|
619 charsets a combination of fonts is often used. This means that one group of
|
|
620 characters are used from one font and another group from another font (which
|
|
621 might be double wide). This collection of fonts is called a fontset.
|
|
622
|
|
623 Which fonts are required in a fontset depends on the current locale. X
|
|
624 windows maintains a table of which groups of characters are required for a
|
|
625 locale. You have to specify all the fonts that a locale requires in the
|
|
626 'guifontset' option.
|
|
627
|
|
628 NOTE: The fontset always uses the current locale, even though 'encoding' may
|
|
629 be set to use a different charset. In that situation you might want to use
|
|
630 'guifont' and 'guifontwide' instead of 'guifontset'.
|
|
631
|
|
632 Example:
|
|
633 |charset| language "groups of characters" ~
|
|
634 GB2312 Chinese (simplified) ISO-8859-1 and GB 2312
|
|
635 Big5 Chinese (traditional) ISO-8859-1 and Big5
|
|
636 CNS-11643 Chinese (traditional) ISO-8859-1, CNS 11643-1 and CNS 11643-2
|
|
637 EUC-JP Japanese JIS X 0201 and JIS X 0208
|
|
638 EUC-KR Korean ISO-8859-1 and KS C 5601 (KS X 1001)
|
|
639
|
|
640 You can search for fonts using the xlsfonts command. For example, when you're
|
|
641 searching for a font for KS C 5601: >
|
|
642 xlsfonts | grep ksc5601
|
|
643
|
|
644 This is complicated and confusing. You might want to consult the X-Windows
|
|
645 documentation if there is something you don't understand.
|
|
646
|
|
647 *base_font_name_list*
|
|
648 When you have found the names of the fonts you want to use, you need to set
|
|
649 the 'guifontset' option. You specify the list by concatenating the font names
|
|
650 and putting a comma in between them.
|
|
651
|
|
652 For example, when you use the ja_JP.eucJP locale, this requires JIS X 0201
|
|
653 and JIS X 0208. You could supply a list of fonts that explicitly specifies
|
|
654 the charsets, like: >
|
|
655
|
|
656 :set guifontset=-misc-fixed-medium-r-normal--14-130-75-75-c-140-jisx0208.1983-0,
|
|
657 \-misc-fixed-medium-r-normal--14-130-75-75-c-70-jisx0201.1976-0
|
|
658
|
|
659 Alternatively, you can supply a base font name list that omits the charset
|
|
660 name, letting X-Windows select font characters required for the locale. For
|
|
661 example: >
|
|
662
|
|
663 :set guifontset=-misc-fixed-medium-r-normal--14-130-75-75-c-140,
|
|
664 \-misc-fixed-medium-r-normal--14-130-75-75-c-70
|
|
665
|
|
666 Alternatively, you can supply a single base font name that allows X-Windows to
|
|
667 select from all available fonts. For example: >
|
|
668
|
|
669 :set guifontset=-misc-fixed-medium-r-normal--14-*
|
|
670
|
|
671 Alternatively, you can specify alias names. See the fonts.alias file in the
|
|
672 fonts directory (e.g., /usr/X11R6/lib/X11/fonts/). For example: >
|
|
673
|
|
674 :set guifontset=k14,r14
|
|
675 <
|
|
676 *E253*
|
|
677 Note that in East Asian fonts, the standard character cell is square. When
|
|
678 mixing a Latin font and an East Asian font, the East Asian font width should
|
|
679 be twice the Latin font width.
|
|
680
|
|
681 If 'guifontset' is not empty, the "font" argument of the |:highlight| command
|
|
682 is also interpreted as a fontset. For example, you should use for
|
|
683 highlighting: >
|
|
684 :hi Comment font=english_font,your_font
|
|
685 If you use a wrong "font" argument you will get an error message.
|
|
686 Also make sure that you set 'guifontset' before setting fonts for highlight
|
|
687 groups.
|
|
688
|
|
689
|
|
690 USING RESOURCE FILES
|
|
691
|
|
692 Instead of specifying 'guifontset', you can set X11 resources and Vim will
|
|
693 pick them up. This is only for people who know how X resource files work.
|
|
694
|
|
695 For Motif and Athena insert these three lines in your $HOME/.Xdefaults file:
|
|
696
|
|
697 Vim.font: |base_font_name_list|
|
|
698 Vim*fontSet: |base_font_name_list|
|
|
699 Vim*fontList: your_language_font
|
|
700
|
|
701 Note: Vim.font is for text area.
|
|
702 Vim*fontSet is for menu.
|
|
703 Vim*fontList is for menu (for Motif GUI)
|
|
704
|
|
705 For example, when you are using Japanese and a 14 dots font, >
|
|
706
|
|
707 Vim.font: -misc-fixed-medium-r-normal--14-*
|
|
708 Vim*fontSet: -misc-fixed-medium-r-normal--14-*
|
|
709 Vim*fontList: -misc-fixed-medium-r-normal--14-*
|
|
710 <
|
|
711 or: >
|
|
712
|
|
713 Vim*font: k14,r14
|
|
714 Vim*fontSet: k14,r14
|
|
715 Vim*fontList: k14,r14
|
|
716 <
|
|
717 To have them take effect immediately you will have to do >
|
|
718
|
|
719 xrdb -merge ~/.Xdefaults
|
|
720
|
|
721 Otherwise you will have to stop and restart the X server before the changes
|
|
722 take effect.
|
|
723
|
|
724
|
|
725 The GTK+ version of GUI Vim does not use .Xdefaults, use ~/.gtkrc instead.
|
|
726 The default mostly works OK. But for the menus you might have to change
|
|
727 it. Example: >
|
|
728
|
|
729 style "default"
|
|
730 {
|
|
731 fontset="-*-*-medium-r-normal--14-*-*-*-c-*-*-*"
|
|
732 }
|
|
733 widget_class "*" style "default"
|
|
734
|
|
735 ==============================================================================
|
|
736 6. Fonts on MS-Windows *mbyte-fonts-MSwin*
|
|
737
|
|
738 The simplest is to use the font dialog to select fonts and try them out. You
|
|
739 can find this at the "Edit/Select Font..." menu. Once you find a font name
|
|
740 that works well you can use this command to see its name: >
|
|
741
|
|
742 :set guifont
|
|
743
|
|
744 Then add a command to your |gvimrc| file to set 'guifont': >
|
|
745
|
|
746 :set guifont=courier_new:h12
|
|
747
|
|
748 ==============================================================================
|
|
749 7. Input on X11 *mbyte-XIM*
|
|
750
|
|
751 X INPUT METHOD (XIM) BACKGROUND *XIM* *xim* *x-input-method*
|
|
752
|
|
753 XIM is an international input module for X. There are two kind of structures,
|
|
754 Xlib unit type and |IM-server| (Input-Method server) type. |IM-server| type
|
|
755 is suitable for complex input, such as CJK.
|
|
756
|
|
757 - IM-server
|
|
758 *IM-server*
|
|
759 In |IM-server| type input structures, the input event is handled by either
|
|
760 of the two ways: FrontEnd system and BackEnd system. In the FrontEnd
|
|
761 system, input events are snatched by the |IM-server| first, then |IM-server|
|
|
762 give the application the result of input. On the other hand, the BackEnd
|
|
763 system works reverse order. MS Windows adopt BackEnd system. In X, most of
|
|
764 |IM-server|s adopt FrontEnd system. The demerit of BackEnd system is the
|
|
765 large overhead in communication, but it provides safe synchronization with
|
|
766 no restrictions on applications.
|
|
767
|
|
768 For example, there are xwnmo and kinput2 Japanese |IM-server|, both are
|
|
769 FrontEnd system. Xwnmo is distributed with Wnn (see below), kinput2 can be
|
|
770 found at: ftp://ftp.sra.co.jp/pub/x11/kinput2/
|
|
771
|
|
772 For Chinese, there's a great XIM server named "xcin", you can input both
|
|
773 Traditional and Simplified Chinese characters. And it can accept other
|
|
774 locale if you make a correct input table. Xcin can be found at:
|
|
775 http://xcin.linux.org.tw/
|
15
|
776 Others are scim: http://scim.freedesktop.org/ and fcitx:
|
|
777 http://www.fcitx.org/
|
7
|
778
|
|
779 - Conversion Server
|
|
780 *conversion-server*
|
|
781 Some system needs additional server: conversion server. Most of Japanese
|
|
782 |IM-server|s need it, Kana-Kanji conversion server. For Chinese inputting,
|
|
783 it depends on the method of inputting, in some methods, PinYin or ZhuYin to
|
|
784 HanZi conversion server is needed. For Korean inputting, if you want to
|
|
785 input Hanja, Hangul-Hanja conversion server is needed.
|
|
786
|
|
787 For example, the Japanese inputting process is divided into 2 steps. First
|
|
788 we pre-input Hira-gana, second Kana-Kanji conversion. There are so many
|
|
789 Kanji characters (6349 Kanji characters are defined in JIS X 0208) and the
|
|
790 number of Hira-gana characters are 76. So, first, we pre-input text as
|
|
791 pronounced in Hira-gana, second, we convert Hira-gana to Kanji or Kata-Kana,
|
|
792 if needed. There are some Kana-Kanji conversion server: jserver
|
236
|
793 (distributed with Wnn, see below) and canna. Canna could be found at:
|
7
|
794 ftp://ftp.nec.co.jp/pub/Canna/ (no longer works).
|
|
795
|
|
796 There is a good input system: Wnn4.2. Wnn 4.2 contains,
|
|
797 xwnmo (|IM-server|)
|
|
798 jserver (Japanese Kana-Kanji conversion server)
|
|
799 cserver (Chinese PinYin or ZhuYin to simplified HanZi conversion server)
|
|
800 tserver (Chinese PinYin or ZhuYin to traditional HanZi conversion server)
|
|
801 kserver (Hangul-Hanja conversion server)
|
|
802 Wnn 4.2 for several systems can be found at various places on the internet.
|
|
803 Use the RPM or port for your system.
|
|
804
|
|
805
|
|
806 - Input Style
|
|
807 *xim-input-style*
|
|
808 When inputting CJK, there are four areas:
|
|
809 1. The area to display of the input while it is being composed
|
|
810 2. The area to display the currently active input mode.
|
|
811 3. The area to display the next candidate for the selection.
|
|
812 4. The area to display other tools.
|
|
813
|
|
814 The third area is needed when converting. For example, in Japanese
|
|
815 inputting, multiple Kanji characters could have the same pronunciation, so
|
|
816 a sequence of Hira-gana characters could map to a distinct sequence of Kanji
|
|
817 characters.
|
|
818
|
|
819 The first and second areas are defined in international input of X with the
|
|
820 names of "Preedit Area", "Status Area" respectively. The third and fourth
|
|
821 areas are not defined and are left to be managed by the |IM-server|. In the
|
|
822 international input, four input styles have been defined using combinations
|
|
823 of Preedit Area and Status Area: |OnTheSpot|, |OffTheSpot|, |OverTheSpot|
|
|
824 and |Root|.
|
|
825
|
|
826 Currently, GUI Vim support three style, |OverTheSpot|, |OffTheSpot| and
|
|
827 |Root|.
|
|
828
|
|
829 *. on-the-spot *OnTheSpot*
|
|
830 Preedit Area and Status Area are performed by the client application in
|
|
831 the area of application. The client application is directed by the
|
|
832 |IM-server| to display all pre-edit data at the location of text
|
236
|
833 insertion. The client registers callbacks invoked by the input method
|
7
|
834 during pre-editing.
|
|
835 *. over-the-spot *OverTheSpot*
|
|
836 Status Area is created in a fixed position within the area of application,
|
|
837 in case of Vim, the position is the additional status line. Preedit Area
|
|
838 is made at present input position of application. The input method
|
|
839 displays pre-edit data in a window which it brings up directly over the
|
|
840 text insertion position.
|
|
841 *. off-the-spot *OffTheSpot*
|
|
842 Preedit Area and Status Area are performed in the area of application, in
|
|
843 case of Vim, the area is additional status line. The client application
|
|
844 provides display windows for the pre-edit data to the input method which
|
|
845 displays into them directly.
|
|
846 *. root-window *Root*
|
|
847 Preedit Area and Status Area are outside of the application. The input
|
|
848 method displays all pre-edit data in a separate area of the screen in a
|
|
849 window specific to the input method.
|
|
850
|
|
851
|
|
852 USING XIM *multibyte-input* *E284* *E286* *E287* *E288*
|
|
853 *E285* *E291* *E292* *E290* *E289*
|
|
854
|
|
855 Note that Display and Input are independent. It is possible to see your
|
|
856 language even though you have no input method for it. But when your Display
|
|
857 method doesn't match your Input method, the text will be displayed wrong.
|
|
858
|
|
859 Note: You can not use IM unless you specify 'guifontset'.
|
|
860 Therefore, Latin users, you have to also use 'guifontset'
|
|
861 if you use IM.
|
|
862
|
|
863 To input your language you should run the |IM-server| which supports your
|
|
864 language and |conversion-server| if needed.
|
|
865
|
|
866 The next 3 lines should be put in your ~/.Xdefaults file. They are common for
|
|
867 all X applications which uses |XIM|. If you already use |XIM|, you can skip
|
|
868 this. >
|
|
869
|
|
870 *international: True
|
|
871 *.inputMethod: your_input_server_name
|
|
872 *.preeditType: your_input_style
|
|
873 <
|
|
874 input_server_name is your |IM-server| name (check your |IM-server|
|
|
875 manual).
|
|
876 your_input_style is one of |OverTheSpot|, |OffTheSpot|, |Root|. See
|
|
877 also |xim-input-style|.
|
|
878
|
|
879 *international may not necessary if you use X11R6.
|
|
880 *.inputMethod and *.preeditType are optional if you use X11R6.
|
|
881
|
|
882 For example, when you are using kinput2 as |IM-server|, >
|
|
883
|
|
884 *international: True
|
|
885 *.inputMethod: kinput2
|
|
886 *.preeditType: OverTheSpot
|
|
887 <
|
|
888 When using |OverTheSpot|, GUI Vim always connects to the IM Server even in
|
|
889 Normal mode, so you can input your language with commands like "f" and "r".
|
|
890 But when using one of the other two methods, GUI Vim connects to the IM Server
|
|
891 only if it is not in Normal mode.
|
|
892
|
|
893 If your IM Server does not support |OverTheSpot|, and if you want to use your
|
|
894 language with some Normal mode command like "f" or "r", then you should use a
|
|
895 localized xterm or an xterm which supports |XIM|
|
|
896
|
|
897 If needed, you can set the XMODIFIERS environment variable:
|
|
898
|
|
899 sh: export XMODIFIERS="@im=input_server_name"
|
|
900 csh: setenv XMODIFIERS "@im=input_server_name"
|
|
901
|
|
902 For example, when you are using kinput2 as |IM-server| and sh, >
|
|
903
|
|
904 export XMODIFIERS="@im=kinput2"
|
|
905 <
|
|
906
|
|
907 FULLY CONTROLLED XIM
|
|
908
|
|
909 You can fully control XIM, like with IME of MS-Windows (see |multibyte-ime|).
|
|
910 This is currently only available for the GTK GUI.
|
|
911
|
|
912 Before using fully controlled XIM, one setting is required. Set the
|
|
913 'imactivatekey' option to the key that is used for the activation of the input
|
|
914 method. For example, when you are using kinput2 + canna as IM Server, the
|
|
915 activation key is probably Shift+Space: >
|
|
916
|
|
917 :set imactivatekey=S-space
|
|
918
|
|
919 See 'imactivatekey' for the format.
|
|
920
|
|
921 ==============================================================================
|
|
922 8. Input on MS-Windows *mbyte-IME*
|
|
923
|
|
924 (Windows IME support) *multibyte-ime* *IME*
|
|
925
|
|
926 {only works Windows GUI and compiled with the |+multi_byte_ime| feature}
|
|
927
|
|
928 To input multibyte characters on Windows, you have to use Input Method Editor
|
|
929 (IME). In process of your editing text, you must switch status (on/off) of
|
|
930 IME many many many times. Because IME with status on is hooking all of your
|
|
931 key inputs, you cannot input 'j', 'k', or almost all of keys to Vim directly.
|
|
932
|
|
933 This |+multi_byte_ime| feature help this. It reduce times of switch status of
|
|
934 IME manually. In normal mode, there are almost no need working IME, even
|
|
935 editing multibyte text. So exiting insert mode with ESC, Vim memorize last
|
|
936 status of IME and force turn off IME. When re-enter insert mode, Vim revert
|
|
937 IME status to that memorized automatically.
|
|
938
|
|
939 This works on not only insert-normal mode, but also search-command input and
|
|
940 replace mode.
|
|
941 The options 'iminsert', 'imsearch' and 'imcmdline' can be used to chose
|
9
|
942 the different input methods or disable them temporarily.
|
7
|
943
|
|
944 WHAT IS IME
|
|
945 IME is a part of East asian version Windows. That helps you to input
|
|
946 multibyte character. English and other language version Windows does not
|
|
947 have any IME. (Also there are no need usually.) But there is one that
|
|
948 called Microsoft Global IME. Global IME is a part of Internet Explorer
|
|
949 4.0 or above. You can get more information about Global IME, at below
|
|
950 URL.
|
|
951
|
|
952 WHAT IS GLOBAL IME *global-ime*
|
|
953 Global IME makes capability to input Chinese, Japanese, and Korean text
|
|
954 into Vim buffer on any language version of Windows 98, Windows 95, and
|
|
955 Windows NT 4.0.
|
|
956 On Windows 2000 and XP it should work as well (without downloading). On
|
|
957 Windows 2000 Professional, Global IME is built in, and the Input Locales
|
|
958 can be added through Control Panel/Regional Options/Input Locales.
|
|
959 Please see below URL for detail of Global IME. You can also find various
|
|
960 language version of Global IME at same place.
|
|
961
|
|
962 - Global IME detailed information.
|
|
963 http://www.microsoft.com/windows/ie/features/ime.asp
|
|
964
|
|
965 - Active Input Method Manager (Global IME)
|
|
966 http://msdn.microsoft.com/workshop/misc/AIMM/aimm.asp
|
|
967
|
|
968 Support Global IME is a experimental feature.
|
|
969
|
|
970 NOTE: For IME to work you must make sure the input locales of your language
|
|
971 are added to your system. The exact location of this depends on the version
|
|
972 of Windows you use. For example, on my W2P box:
|
|
973 1. Control Panel
|
|
974 2. Regional Options
|
|
975 3. Input Locales Tab
|
|
976 4. Add Installed input locales -> Chinese(PRC)
|
|
977 The default is still English (United Stated)
|
|
978
|
|
979
|
|
980 Cursor color when IME or XIM is on *CursorIM*
|
|
981 There is a little cute feature for IME. Cursor can indicate status of IME
|
|
982 by changing its color. Usually status of IME was indicated by little icon
|
|
983 at a corner of desktop (or taskbar). It is not easy to verify status of
|
|
984 IME. But this feature help this.
|
|
985 This works in the same way when using XIM.
|
|
986
|
|
987 You can select cursor color when status is on by using highlight group
|
|
988 CursorIM. For example, add these lines to your _gvimrc: >
|
|
989
|
|
990 if has('multi_byte_ime')
|
|
991 highlight Cursor guifg=NONE guibg=Green
|
|
992 highlight CursorIM guifg=NONE guibg=Purple
|
|
993 endif
|
|
994 <
|
|
995 Cursor color with off IME is green. And purple cursor indicates that
|
|
996 status is on.
|
|
997
|
|
998 ==============================================================================
|
|
999 9. Input with a keymap *mbyte-keymap*
|
|
1000
|
|
1001 When the keyboard doesn't produce the characters you want to enter in your
|
|
1002 text, you can use the 'keymap' option. This will translate one or more
|
|
1003 (English) characters to another (non-English) character. This only happens
|
|
1004 when typing text, not when typing Vim commands. This avoids having to switch
|
|
1005 between two keyboard settings.
|
|
1006
|
|
1007 The value of the 'keymap' option specifies a keymap file to use. The name of
|
|
1008 this file is one of these two:
|
|
1009
|
|
1010 keymap/{keymap}_{encoding}.vim
|
|
1011 keymap/{keymap}.vim
|
|
1012
|
|
1013 Here {keymap} is the value of the 'keymap' option and {encoding} of the
|
|
1014 'encoding' option. The file name with the {encoding} included is tried first.
|
|
1015
|
|
1016 'runtimepath' is used to find these files. To see an overview of all
|
|
1017 available keymap files, use this: >
|
|
1018 :echo globpath(&rtp, "keymap/*.vim")
|
|
1019
|
|
1020 In Insert and Command-line mode you can use CTRL-^ to toggle between using the
|
|
1021 keyboard map or not. |i_CTRL-^| |c_CTRL-^|
|
|
1022 This flag is remembered for Insert mode with the 'iminsert' option. When
|
|
1023 leaving and entering Insert mode the previous value is used. The same value
|
|
1024 is also used for commands that take a single character argument, like |f| and
|
|
1025 |r|.
|
|
1026 For Command-line mode the flag is NOT remembered. You are expected to type an
|
|
1027 Ex command first, which is ASCII.
|
|
1028 For typing search patterns the 'imsearch' option is used. It can be set to
|
|
1029 use the same value as for 'iminsert'.
|
|
1030
|
|
1031 It is possible to give the GUI cursor another color when the language mappings
|
|
1032 are being used. This is disabled by default, to avoid that the cursor becomes
|
|
1033 invisible when you use a non-standard background color. Here is an example to
|
|
1034 use a brightly colored cursor: >
|
|
1035 :highlight Cursor guifg=NONE guibg=Green
|
|
1036 :highlight lCursor guifg=NONE guibg=Cyan
|
|
1037 <
|
|
1038 *keymap-file-format* *:loadk* *:loadkeymap* *E105*
|
|
1039 The keymap file looks something like this: >
|
|
1040
|
|
1041 " Maintainer: name <email@address>
|
|
1042 " Last Changed: 2001 Jan 1
|
|
1043
|
|
1044 let b:keymap_name = "short"
|
|
1045
|
|
1046 loadkeymap
|
|
1047 a A
|
|
1048 b B comment
|
|
1049
|
|
1050 The lines starting with a " are comments and will be ignored. Blank lines are
|
|
1051 also ignored. The lines with the mappings may have a comment after the useful
|
|
1052 text.
|
|
1053
|
|
1054 The "b:keymap_name" can be set to a short name, which will be shown in the
|
|
1055 status line. The idea is that this takes less room than the value of
|
|
1056 'keymap', which might be long to distinguish between different languages,
|
|
1057 keyboards and encodings.
|
|
1058
|
|
1059 The actual mappings are in the lines below "loadkeymap". In the example "a"
|
|
1060 is mapped to "A" and "b" to "B". Thus the first item is mapped to the second
|
|
1061 item. This is done for each line, until the end of the file.
|
|
1062 These items are exactly the same as what can be used in a |:lnoremap| command,
|
|
1063 using "<buffer>" to make the mappings local to the buffer..
|
|
1064 You can check the result with this command: >
|
|
1065 :lmap
|
|
1066 The two items must be separated by white space. You cannot include white
|
|
1067 space inside an item, use the special names "<Tab>" and "<Space>" instead.
|
|
1068 The length of the two items together must not exceed 200 bytes.
|
|
1069
|
|
1070 It's possible to have more than one character in the first column. This works
|
|
1071 like a dead key. Example: >
|
|
1072 'a á
|
|
1073 Since Vim doesn't know if the next character after a quote is really an "a",
|
|
1074 it will wait for the next character. To be able to insert a single quote,
|
|
1075 also add this line: >
|
|
1076 '' '
|
|
1077 Since the mapping is defined with |:lnoremap| the resulting quote will not be
|
|
1078 used for the start of another character.
|
|
1079
|
|
1080 Although it's possible to have more than one character in the second column,
|
|
1081 this is unusual. But you can use various ways to specify the character: >
|
|
1082 A a literal character
|
|
1083 A <char-97> decimal value
|
|
1084 A <char-0x61> hexadecimal value
|
|
1085 A <char-0141> octal value
|
|
1086 x <Space> special key name
|
|
1087
|
|
1088 The characters are assumed to be encoded for the current value of 'encoding'.
|
|
1089 It's possible to use ":scriptencoding" when all characters are given
|
|
1090 literally. That doesn't work when using the <char-> construct, because the
|
|
1091 conversion is done on the keymap file, not on the resulting character.
|
|
1092
|
|
1093 The lines after "loadkeymap" are interpreted with 'cpoptions' set to "C".
|
|
1094 This means that continuation lines are not used and a backslash has a special
|
|
1095 meaning in the mappings. Examples: >
|
|
1096
|
|
1097 " a comment line
|
|
1098 \" x maps " to x
|
|
1099 \\ y maps \ to y
|
|
1100
|
|
1101 If you write a keymap file that will be useful for others, consider submitting
|
|
1102 it to the Vim maintainer for inclusion in the distribution:
|
|
1103 <maintainer@vim.org>
|
|
1104
|
|
1105
|
|
1106 HEBREW KEYMAP *keymap-hebrew*
|
|
1107
|
|
1108 This file explains what characters are available in UTF-8 and CP1255 encodings,
|
|
1109 and what the keymaps are to get those characters:
|
|
1110
|
|
1111 glyph encoding keymap ~
|
|
1112 Char utf-8 cp1255 hebrew hebrewp name ~
|
|
1113 א 0x5d0 0xe0 t a 'alef
|
|
1114 ב 0x5d1 0xe1 c b bet
|
|
1115 ג 0x5d2 0xe2 d g gimel
|
|
1116 ד 0x5d3 0xe3 s d dalet
|
|
1117 ה 0x5d4 0xe4 v h he
|
|
1118 ו 0x5d5 0xe5 u v vav
|
|
1119 ז 0x5d6 0xe6 z z zayin
|
|
1120 ח 0x5d7 0xe7 j j het
|
|
1121 ט 0x5d8 0xe8 y T tet
|
|
1122 י 0x5d9 0xe9 h y yod
|
|
1123 ך 0x5da 0xea l K kaf sofit
|
|
1124 כ 0x5db 0xeb f k kaf
|
|
1125 ל 0x5dc 0xec k l lamed
|
|
1126 ם 0x5dd 0xed o M mem sofit
|
|
1127 מ 0x5de 0xee n m mem
|
|
1128 ן 0x5df 0xef i N nun sofit
|
|
1129 נ 0x5e0 0xf0 b n nun
|
|
1130 ס 0x5e1 0xf1 x s samech
|
|
1131 ע 0x5e2 0xf2 g u `ayin
|
|
1132 ף 0x5e3 0xf3 ; P pe sofit
|
|
1133 פ 0x5e4 0xf4 p p pe
|
|
1134 ץ 0x5e5 0xf5 . X tsadi sofit
|
|
1135 צ 0x5e6 0xf6 m x tsadi
|
|
1136 ק 0x5e7 0xf7 e q qof
|
|
1137 ר 0x5e8 0xf8 r r resh
|
|
1138 ש 0x5e9 0xf9 a w shin
|
|
1139 ת 0x5ea 0xfa , t tav
|
|
1140
|
|
1141 Vowel marks and special punctuation:
|
|
1142 הְ 0x5b0 0xc0 A: A: sheva
|
|
1143 הֱ 0x5b1 0xc1 HE HE hataf segol
|
|
1144 הֲ 0x5b2 0xc2 HA HA hataf patah
|
|
1145 הֳ 0x5b3 0xc3 HO HO hataf qamats
|
|
1146 הִ 0x5b4 0xc4 I I hiriq
|
|
1147 הֵ 0x5b5 0xc5 AY AY tsere
|
|
1148 הֶ 0x5b6 0xc6 E E segol
|
|
1149 הַ 0x5b7 0xc7 AA AA patah
|
|
1150 הָ 0x5b8 0xc8 AO AO qamats
|
|
1151 הֹ 0x5b9 0xc9 O O holam
|
|
1152 הֻ 0x5bb 0xcb U U qubuts
|
|
1153 כּ 0x5bc 0xcc D D dagesh
|
|
1154 הֽ 0x5bd 0xcd ]T ]T meteg
|
|
1155 ה־ 0x5be 0xce ]Q ]Q maqaf
|
|
1156 בֿ 0x5bf 0xcf ]R ]R rafe
|
|
1157 ב׀ 0x5c0 0xd0 ]p ]p paseq
|
|
1158 שׁ 0x5c1 0xd1 SR SR shin-dot
|
|
1159 שׂ 0x5c2 0xd2 SL SL sin-dot
|
|
1160 ׃ 0x5c3 0xd3 ]P ]P sof-pasuq
|
|
1161 װ 0x5f0 0xd4 VV VV double-vav
|
|
1162 ױ 0x5f1 0xd5 VY VY vav-yod
|
|
1163 ײ 0x5f2 0xd6 YY YY yod-yod
|
|
1164
|
|
1165 The following are only available in utf-8
|
|
1166
|
|
1167 Cantillation marks:
|
|
1168 glyph
|
|
1169 Char utf-8 hebrew name
|
|
1170 ב֑ 0x591 C: etnahta
|
|
1171 ב֒ 0x592 Cs segol
|
|
1172 ב֓ 0x593 CS shalshelet
|
|
1173 ב֔ 0x594 Cz zaqef qatan
|
|
1174 ב֕ 0x595 CZ zaqef gadol
|
|
1175 ב֖ 0x596 Ct tipeha
|
|
1176 ב֗ 0x597 Cr revia
|
|
1177 ב֘ 0x598 Cq zarqa
|
|
1178 ב֙ 0x599 Cp pashta
|
|
1179 ב֚ 0x59a C! yetiv
|
|
1180 ב֛ 0x59b Cv tevir
|
|
1181 ב֜ 0x59c Cg geresh
|
|
1182 ב֝ 0x59d C* geresh qadim
|
|
1183 ב֞ 0x59e CG gershayim
|
|
1184 ב֟ 0x59f CP qarnei-parah
|
|
1185 ב֪ 0x5aa Cy yerach-ben-yomo
|
|
1186 ב֫ 0x5ab Co ole
|
|
1187 ב֬ 0x5ac Ci iluy
|
|
1188 ב֭ 0x5ad Cd dehi
|
|
1189 ב֮ 0x5ae Cn zinor
|
|
1190 ב֯ 0x5af CC masora circle
|
|
1191
|
|
1192 Combining forms:
|
|
1193 ﬠ 0xfb20 X` Alternative `ayin
|
|
1194 ﬡ 0xfb21 X' Alternative 'alef
|
|
1195 ﬢ 0xfb22 X-d Alternative dalet
|
|
1196 ﬣ 0xfb23 X-h Alternative he
|
|
1197 ﬤ 0xfb24 X-k Alternative kaf
|
|
1198 ﬥ 0xfb25 X-l Alternative lamed
|
|
1199 ﬦ 0xfb26 X-m Alternative mem-sofit
|
|
1200 ﬧ 0xfb27 X-r Alternative resh
|
|
1201 ﬨ 0xfb28 X-t Alternative tav
|
|
1202 ﬩ 0xfb29 X-+ Alternative plus
|
|
1203 שׁ 0xfb2a XW shin+shin-dot
|
|
1204 שׂ 0xfb2b Xw shin+sin-dot
|
|
1205 שּׁ 0xfb2c X..W shin+shin-dot+dagesh
|
|
1206 שּׂ 0xfb2d X..w shin+sin-dot+dagesh
|
|
1207 אַ 0xfb2e XA alef+patah
|
|
1208 אָ 0xfb2f XO alef+qamats
|
|
1209 אּ 0xfb30 XI alef+hiriq (mapiq)
|
|
1210 בּ 0xfb31 X.b bet+dagesh
|
|
1211 גּ 0xfb32 X.g gimel+dagesh
|
|
1212 דּ 0xfb33 X.d dalet+dagesh
|
|
1213 הּ 0xfb34 X.h he+dagesh
|
|
1214 וּ 0xfb35 Xu vav+dagesh
|
|
1215 זּ 0xfb36 X.z zayin+dagesh
|
|
1216 טּ 0xfb38 X.T tet+dagesh
|
|
1217 יּ 0xfb39 X.y yud+dagesh
|
|
1218 ךּ 0xfb3a X.K kaf sofit+dagesh
|
|
1219 כּ 0xfb3b X.k kaf+dagesh
|
|
1220 לּ 0xfb3c X.l lamed+dagesh
|
|
1221 מּ 0xfb3e X.m mem+dagesh
|
|
1222 נּ 0xfb40 X.n nun+dagesh
|
|
1223 סּ 0xfb41 X.s samech+dagesh
|
|
1224 ףּ 0xfb43 X.P pe sofit+dagesh
|
|
1225 פּ 0xfb44 X.p pe+dagesh
|
|
1226 צּ 0xfb46 X.x tsadi+dagesh
|
|
1227 קּ 0xfb47 X.q qof+dagesh
|
|
1228 רּ 0xfb48 X.r resh+dagesh
|
|
1229 שּ 0xfb49 X.w shin+dagesh
|
|
1230 תּ 0xfb4a X.t tav+dagesh
|
|
1231 וֹ 0xfb4b Xo vav+holam
|
|
1232 בֿ 0xfb4c XRb bet+rafe
|
|
1233 כֿ 0xfb4d XRk kaf+rafe
|
|
1234 פֿ 0xfb4e XRp pe+rafe
|
|
1235 ﭏ 0xfb4f Xal alef-lamed
|
|
1236
|
|
1237 ==============================================================================
|
|
1238 10. Using UTF-8 *mbyte-utf8* *UTF-8* *utf-8* *utf8*
|
|
1239 *Unicode* *unicode*
|
|
1240 The Unicode character set was designed to include all characters from other
|
|
1241 character sets. Therefore it is possible to write text in any language using
|
|
1242 Unicode (with a few rarely used languages excluded). And it's mostly possible
|
|
1243 to mix these languages in one file, which is impossible with other encodings.
|
|
1244
|
|
1245 Unicode can be encoded in several ways. The two most popular ones are UCS-2,
|
|
1246 which uses 16-bit words and UTF-8, which uses one or more bytes for each
|
|
1247 character. Vim can support all of these encodings, but always uses UTF-8
|
|
1248 internally.
|
|
1249
|
|
1250 Vim has comprehensive UTF-8 support. It appears to work in:
|
|
1251 - xterm with utf-8 support enabled
|
|
1252 - Athena, Motif and GTK GUI
|
|
1253 - MS-Windows GUI
|
|
1254
|
|
1255 Double-width characters are supported. This works best with 'guifontwide' or
|
|
1256 'guifontset'. When using only 'guifont' the wide characters are drawn in the
|
|
1257 normal width and a space to fill the gap. Note that the 'guifontset' option
|
|
1258 is no longer relevant in the GTK+ 2 GUI.
|
|
1259
|
|
1260 Up to two combining characters can be used. The combining character is drawn
|
|
1261 on top of the preceding character. When editing text a composing character is
|
|
1262 mostly considered part of the preceding character. For example "x" will
|
236
|
1263 delete a character and its following composing characters by default. If the
|
7
|
1264 'delcombine' option is on, then pressing 'x' will delete the combining
|
|
1265 characters, one at a time, then the base character. But when inserting, you
|
|
1266 type the first character and the following composing characters separately,
|
|
1267 after which they will be joined. The "r" command will not allow you to type a
|
|
1268 combining character, because it doesn't know one is coming. Use "R" instead.
|
|
1269
|
|
1270 Bytes which are not part of a valid UTF-8 byte sequence are handled like a
|
|
1271 single character and displayed as <xx>, where "xx" is the hex value of the
|
|
1272 byte.
|
|
1273
|
|
1274 Overlong sequences are not handled specially and displayed like a valid
|
|
1275 character. However, search patterns may not match on an overlong sequence.
|
|
1276 (an overlong sequence is where more bytes are used than required for the
|
|
1277 character.) An exception is NUL (zero) which is displayed as "<00>".
|
|
1278
|
|
1279 In the file and buffer the full range of Unicode characters can be used (31
|
|
1280 bits). However, displaying only works for 16 bit characters, and only for the
|
|
1281 characters present in the selected font.
|
|
1282
|
|
1283 Useful commands:
|
|
1284 - "ga" shows the decimal, hexadecimal and octal value of the character under
|
236
|
1285 the cursor. If there are composing characters these are shown too. (If the
|
7
|
1286 message is truncated, use ":messages").
|
|
1287 - "g8" shows the bytes used in a UTF-8 character, also the composing
|
|
1288 characters, as hex numbers.
|
|
1289 - ":set encoding=utf-8 fileencodings=" forces using UTF-8 for all files. The
|
|
1290 default is to use the current locale for 'encoding' and set 'fileencodings'
|
|
1291 to automatically the encoding of a file.
|
|
1292
|
|
1293
|
|
1294 STARTING VIM
|
|
1295
|
|
1296 If your current locale is in an utf-8 encoding, Vim will automatically start
|
|
1297 in utf-8 mode.
|
|
1298
|
|
1299 If you are using another locale: >
|
|
1300
|
|
1301 set encoding=utf-8
|
|
1302
|
|
1303 You might also want to select the font used for the menus. Unfortunately this
|
|
1304 doesn't always work. See the system specific remarks below, and 'langmenu'.
|
|
1305
|
|
1306
|
|
1307 USING UTF-8 IN X-Windows *utf-8-in-xwindows*
|
|
1308
|
|
1309 Note: This section does not apply to the GTK+ 2 GUI.
|
|
1310
|
|
1311 You need to specify a font to be used. For double-wide characters another
|
|
1312 font is required, which is exactly twice as wide. There are three ways to do
|
|
1313 this:
|
|
1314
|
|
1315 1. Set 'guifont' and let Vim find a matching 'guifontwide'
|
|
1316 2. Set 'guifont' and 'guifontwide'
|
|
1317 3. Set 'guifontset'
|
|
1318
|
|
1319 See the documentation for each option for details. Example: >
|
|
1320
|
|
1321 :set guifont=-misc-fixed-medium-r-normal--15-140-75-75-c-90-iso10646-1
|
|
1322
|
|
1323 You might also want to set the font used for the menus. This only works for
|
|
1324 Motif. Use the ":hi Menu font={fontname}" command for this. |:highlight|
|
|
1325
|
|
1326
|
|
1327 TYPING UTF-8 *utf-8-typing*
|
|
1328
|
|
1329 If you are using X-Windows, you should find an input method that supports
|
|
1330 utf-8.
|
|
1331
|
|
1332 If your system does not provide support for typing utf-8, you can use the
|
|
1333 'keymap' feature. This allows writing a keymap file, which defines a utf-8
|
|
1334 character as a sequence of ASCII characters. See |mbyte-keymap|.
|
|
1335
|
|
1336 Another method is to set the current locale to the language you want to use
|
|
1337 and for which you have a XIM available. Then set 'termencoding' to that
|
|
1338 language and Vim will convert the typed characters to 'encoding' for you.
|
|
1339
|
|
1340 If everything else fails, you can type any character as four hex bytes: >
|
|
1341
|
|
1342 CTRL-V u 1234
|
|
1343
|
|
1344 "1234" is interpreted as a hex number. You must type four characters, prepend
|
|
1345 a zero if necessary.
|
|
1346
|
|
1347
|
|
1348 COMMAND ARGUMENTS *utf-8-char-arg*
|
|
1349
|
|
1350 Commands like |f|, |F|, |t| and |r| take an argument of one character. For
|
167
|
1351 UTF-8 this argument may include one or two composing characters. These need
|
7
|
1352 to be produced together with the base character, Vim doesn't wait for the next
|
|
1353 character to be typed to find out if it is a composing character or not.
|
|
1354 Using 'keymap' or |:lmap| is a nice way to type these characters.
|
|
1355
|
|
1356 The commands that search for a character in a line handle composing characters
|
|
1357 as follows. When searching for a character without a composing character,
|
|
1358 this will find matches in the text with or without composing characters. When
|
|
1359 searching for a character with a composing character, this will only find
|
|
1360 matches with that composing character. It was implemented this way, because
|
|
1361 not everybody is able to type a composing character.
|
|
1362
|
|
1363
|
|
1364 ==============================================================================
|
|
1365 11. Overview of options *mbyte-options*
|
|
1366
|
|
1367 These options are relevant for editing multi-byte files. Check the help in
|
|
1368 options.txt for detailed information.
|
|
1369
|
|
1370 'encoding' Encoding used for the keyboard and display. It is also the
|
|
1371 default encoding for files.
|
|
1372
|
|
1373 'fileencoding' Encoding of a file. When it's different from 'encoding'
|
|
1374 conversion is done when reading or writing the file.
|
|
1375
|
|
1376 'fileencodings' List of possible encodings of a file. When opening a file
|
|
1377 these will be tried and the first one that doesn't cause an
|
|
1378 error is used for 'fileencoding'.
|
|
1379
|
|
1380 'charconvert' Expression used to convert files from one encoding to another.
|
|
1381
|
|
1382 'formatoptions' The 'm' flag can be included to have formatting break a line
|
|
1383 at a multibyte character of 256 or higher. Thus is useful for
|
|
1384 languages where a sequence of characters can be broken
|
|
1385 anywhere.
|
|
1386
|
|
1387 'guifontset' The list of font names used for a multi-byte encoding. When
|
|
1388 this option is not empty, it replaces 'guifont'.
|
|
1389
|
|
1390 'keymap' Specify the name of a keyboard mapping.
|
|
1391
|
|
1392 ==============================================================================
|
|
1393
|
|
1394 Contributions specifically for the multi-byte features by:
|
|
1395 Chi-Deok Hwang <hwang@mizi.co.kr>
|
12
|
1396 Nam SungHyun <namsh@kldp.org>
|
7
|
1397 K.Nagano <nagano@atese.advantest.co.jp>
|
|
1398 Taro Muraoka <koron@tka.att.ne.jp>
|
|
1399 Yasuhiro Matsumoto <mattn@mail.goo.ne.jp>
|
|
1400
|
|
1401 vim:tw=78:ts=8:ft=help:norl:
|