blob: c1133cb97a068ade18032ad673579f1de02dc06b [file] [log] [blame]
Bram Moolenaar071d4272004-06-13 20:20:40 +00001*hangulin.txt* For Vim version 7.0aa. Last change: 2001 Sep 03
2
3
4 VIM REFERENCE MANUAL by Chi-Deok Hwang and Sung-Hyun Nam
5
6Introduction *hangul*
7------------
8It is to input hangul, the Korean language, with VIM GUI version.
9If you have a XIM program, you can use another |+xim| feature.
10Basically, it is for whom has no XIM program.
11
12Compile
13-------
14Next is a basic option. You can add any other configure option. >
15
16 ./configure --with-x --enable-multibyte --enable-fontset --enable-hangulinput
17
18And you should check the feature.h. If |+hangul_input| feature is enabled
19by configure, you can select more options such as keyboard type, 2 bulsik
20or 3 bulsik. You can find keywords like next in there. >
21
22 #define HANGUL_DEFAULT_KEYBOARD 2
23 #define ESC_CHG_TO_ENG_MODE
24 /* #define X_LOCALE */
25 /* #define SLOW_XSERVER */
26
27Environment variables
28---------------------
29You should set LANG variable to Korean locale such as ko or ko_KR.euc.
30If you set LC_ALL variable, it should be set to Korean locale also.
31
32VIM resource
33------------
34You should add nexts to your global vimrc ($HOME/.vimrc). >
35
36 :set fileencoding=korea
37
38Keyboard
39--------
40You can change keyboard type (2 bulsik or 3 bulsik) using VIM_KEYBOARD
41or HANGUL_KEYBOARD_TYPE environment variables. For sh, just do (2 bulsik): >
42
43 export VIM_KEYBOARD="2"
44or >
45 export HANGUL_KEYBOARD_TYPE="2"
46
47If both are set, VIM_KEYBOARD has higher priority.
48
49Hangul Fonts
50------------
51You can set text font using $HOME/.Xdefaults or $HOME/.gvimrc.
52But to use Hangul, you should set 'guifontset' in your vimrc.
53
54$HOME/.Xdefaults: >
55 Vim.font: english_font
56
57 ! Nexts are for hangul menu with Athena
58 *international: True
59 Vim*fontSet: english_font,hangul_font
60
61 ! Nexts are for hangul menu with Motif
62 *international: True
63 Vim*fontList: english_font;hangul_font:
64
65$HOME/.gvimrc: >
66 set guifontset=english_font,hangul_font
67
68attention! the , (comma) or ; (semicolon)
69
70And there should be no ':set guifont'. If it exists, then Gvim ignores
71':set guifontset'. It means VIM runs without fontset supporting.
72So, you can see only English. Hangul does not be correctly displayed.
73
74After 'fontset' feature is enabled, VIM does not allow using 'font'.
75For example, if you use >
76 :set guifontset=eng_font,your_font
77in your .gvimrc, then you should do for syntax >
78 :hi Comment guifg=Cyan font=another_eng_font,another_your_font
79If you just do >
80 :hi Comment font=another_eng_font
81then you can see a GOOD error message. Be careful!
82
83hangul_font width should be twice than english_font width.
84
85Unsupported Feature
86-------------------
87Johab font not yet supported. And I don't have any plan.
88If you really want to use johab font, you can use the
89hanguldraw.c in gau package.
90
91Hanja input not yet supported. And I don't have any plan.
92If you really want to input hanja, just use VIM with hanterm.
93
94Bug or Comment
95--------------
96Send comments, patches and suggestions to:
97
98 Chi-Deok Hwang <hwang@mizi.co.kr>
99 Nam SungHyun <namsh@lge.com>
100
101 vim:tw=78:ts=8:ft=help:norl: