share/vim/vim58/doc/hangulin.txt

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