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