Mercurial > vim

comparison runtime/doc/hangulin.txt @ 7208:2c00f6b312bf v7.4.913

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
commit https://github.com/vim/vim/commit/72f4cc4a987d123c0ed909c85b9a05f65cef7202 Author: Bram Moolenaar <Bram@vim.org> Date: Tue Nov 10 14:35:18 2015 +0100 patch 7.4.913 Problem: No utf-8 support for the hangul input feature. Solution: Add utf-8 support. (Namsh)
author Christian Brabandt <cb@256bit.org>
date Tue, 10 Nov 2015 14:45:04 +0100
parents 359743c1f59a
children 17333ebd2bbd
comparison
equal deleted inserted replaced
7207:b5b56b0bbd3d 7208:2c00f6b312bf
1 *hangulin.txt* For Vim version 7.4. Last change: 2009 Jun 24 1 *hangulin.txt* For Vim version 7.4. Last change: 2015 Nov 10
2 2
3 3
4 VIM REFERENCE MANUAL by Chi-Deok Hwang and Sung-Hyun Nam 4 VIM REFERENCE MANUAL by Chi-Deok Hwang and Sung-Hyun Nam
5
6 NOTE: The |+hangul_input| feature is scheduled to be removed. If you want to
7 keep it, please send a message to the Vim user maillist.
8 5
9 6
10 Introduction *hangul* 7 Introduction *hangul*
11 ------------ 8 ------------
12 It is to input hangul, the Korean language, with VIM GUI version. 9 It is to input hangul, the Korean language, with VIM GUI version.
15 12
16 Compile 13 Compile
17 ------- 14 -------
18 Next is a basic option. You can add any other configure option. > 15 Next is a basic option. You can add any other configure option. >
19 16
20 ./configure --with-x --enable-multibyte --enable-fontset --enable-hangulinput 17 ./configure --with-x --enable-multibyte --enable-hangulinput \
18 --disable-xim
21 19
22 And you should check feature.h. If |+hangul_input| feature is enabled 20 And you should check feature.h. If |+hangul_input| feature is enabled
23 by configure, you can select more options such as keyboard type, 2 bulsik 21 by configure, you can select more options such as keyboard type, 2 bulsik
24 or 3 bulsik. You can find keywords like next in there. > 22 or 3 bulsik. You can find keywords like next in there. >
25 23
26 #define HANGUL_DEFAULT_KEYBOARD 2 24 #define HANGUL_DEFAULT_KEYBOARD 2
27 #define ESC_CHG_TO_ENG_MODE 25 #define ESC_CHG_TO_ENG_MODE
28 /* #define X_LOCALE */ 26 /* #define X_LOCALE */
29 /* #define SLOW_XSERVER */
30 27
31 Environment variables 28 Environment variables
32 --------------------- 29 ---------------------
33 You should set LANG variable to Korean locale such as ko or ko_KR.euc. 30 You should set LANG variable to Korean locale such as ko, ko_KR.eucKR
31 or ko_KR.UTF-8.
34 If you set LC_ALL variable, it should be set to Korean locale also. 32 If you set LC_ALL variable, it should be set to Korean locale also.
35 33
36 VIM resource 34 VIM resource
37 ------------ 35 ------------
38 You should add nexts to your global vimrc ($HOME/.vimrc). > 36 You may want to set 'encoding' and 'fileencodings'.
37 Next are examples:
39 38
40 :set fileencoding=korea 39 :set encoding=euc-kr
40 :set encoding=utf-8
41 :set fileencodings=ucs-bom,utf-8,cp949,euc-kr,latin1
41 42
42 Keyboard 43 Keyboard
43 -------- 44 --------
44 You can change keyboard type (2 bulsik or 3 bulsik) using VIM_KEYBOARD 45 You can change keyboard type (2 bulsik or 3 bulsik) using VIM_KEYBOARD
45 or HANGUL_KEYBOARD_TYPE environment variables. For sh, just do (2 bulsik): > 46 or HANGUL_KEYBOARD_TYPE environment variables. For sh, just do (2 bulsik): >
50 51
51 If both are set, VIM_KEYBOARD has higher priority. 52 If both are set, VIM_KEYBOARD has higher priority.
52 53
53 Hangul Fonts 54 Hangul Fonts
54 ------------ 55 ------------
55 You can set text font using $HOME/.Xdefaults or in your gvimrc file. 56 If you use GTK version of GVIM, you should set 'guifont' and 'guifontwide'.
56 But to use Hangul, you should set 'guifontset' in your vimrc. 57 For example:
58 set guifont=Courier\ 12
59 set guifontwide=NanumGothicCoding\ 12
60
61 If you use Motif or Athena version of GVIM, you should set 'guifontset' in
62 your vimrc. You can set fontset in the .Xdefaults file.
63
64 $HOME/.gvimrc: >
65 set guifontset=english_font,hangul_font
57 66
58 $HOME/.Xdefaults: > 67 $HOME/.Xdefaults: >
59 Vim.font: english_font 68 Vim.font: english_font
60 69
61 ! Nexts are for hangul menu with Athena 70 ! Nexts are for hangul menu with Athena
64 73
65 ! Nexts are for hangul menu with Motif 74 ! Nexts are for hangul menu with Motif
66 *international: True 75 *international: True
67 Vim*fontList: english_font;hangul_font: 76 Vim*fontList: english_font;hangul_font:
68 77
69 $HOME/.gvimrc: >
70 set guifontset=english_font,hangul_font
71
72 attention! the , (comma) or ; (semicolon) 78 attention! the , (comma) or ; (semicolon)
73 79
74 And there should be no ':set guifont'. If it exists, then Gvim ignores 80 And there should be no ':set guifont'. If it exists, then Gvim ignores
75 ':set guifontset'. It means VIM runs without fontset supporting. 81 ':set guifontset'. It means VIM runs without fontset supporting.
76 So, you can see only English. Hangul does not be correctly displayed. 82 So, you can see only English. Hangul does not be correctly displayed.
77 83
78 After 'fontset' feature is enabled, VIM does not allow using 'font'. 84 After 'fontset' feature is enabled, VIM does not allow using english
85 font only in 'font' setting for syntax.
79 For example, if you use > 86 For example, if you use >
80 :set guifontset=eng_font,your_font 87 :set guifontset=eng_font,your_font
81 in your .gvimrc, then you should do for syntax > 88 in your .gvimrc, then you should do for syntax >
82 :hi Comment guifg=Cyan font=another_eng_font,another_your_font 89 :hi Comment guifg=Cyan font=another_eng_font,another_your_font
83 If you just do > 90 If you just do >
84 :hi Comment font=another_eng_font 91 :hi Comment font=another_eng_font
85 then you can see a GOOD error message. Be careful! 92 then you can see a error message. Be careful!
86 93
87 hangul_font width should be twice than english_font width. 94 hangul_font width should be twice than english_font width.
88 95
89 Unsupported Feature 96 Unsupported Feature
90 ------------------- 97 -------------------
91 Johab font not yet supported. And I don't have any plan. 98 We don't support Johab font.
92 If you really want to use johab font, you can use the 99 We don't support Hanja input.
93 hanguldraw.c in gau package. 100 And We don't have any plan to support them.
94 101
95 Hanja input not yet supported. And I don't have any plan. 102 If you really need such features, you can use console version of VIM with a
96 If you really want to input hanja, just use VIM with hanterm. 103 capable terminal emulator.
97 104
98 Bug or Comment 105 Bug or Comment
99 -------------- 106 --------------
100 Send comments, patches and suggestions to: 107 Send comments, patches and suggestions to:
101 108
102 Chi-Deok Hwang <hwang@mizi.co.kr>
103 SungHyun Nam <goweol@gmail.com> 109 SungHyun Nam <goweol@gmail.com>
110 Chi-Deok Hwang <...>
104 111
105 vim:tw=78:ts=8:ft=help:norl: 112 vim:tw=78:ts=8:ft=help:norl: