1*hebrew.txt* For Vim version 7.3. Last change: 2007 Jun 14 2 3 4 VIM REFERENCE MANUAL by Ron Aaron (and Avner Lottem) 5 6 7Hebrew Language support (options & mapping) for Vim *hebrew* 8 9The supporting 'rightleft' functionality was originally created by Avner 10Lottem. <alottem at gmail dot com> Ron Aaron <ron at ronware dot org> is 11currently helping support these features. 12 13{Vi does not have any of these commands} 14 15All this is only available when the |+rightleft| feature was enabled at 16compile time. 17 18 19Introduction 20------------ 21Hebrew-specific options are 'hkmap', 'hkmapp' 'keymap'=hebrew and 'aleph'. 22Hebrew-useful options are 'delcombine', 'allowrevins', 'revins', 'rightleft' 23and 'rightleftcmd'. 24 25The 'rightleft' mode reverses the display order, so characters are displayed 26from right to left instead of the usual left to right. This is useful 27primarily when editing Hebrew or other Middle-Eastern languages. 28See |rileft.txt| for further details. 29 30Details 31-------------- 32+ Options: 33 + 'rightleft' ('rl') sets window orientation to right-to-left. This means 34 that the logical text 'ABC' will be displayed as 'CBA', and will start 35 drawing at the right edge of the window, not the left edge. 36 + 'hkmap' ('hk') sets keyboard mapping to Hebrew, in insert/replace modes. 37 + 'aleph' ('al'), numeric, holds the decimal code of Aleph, for keyboard 38 mapping. 39 + 'hkmapp' ('hkp') sets keyboard mapping to 'phonetic hebrew' 40 41 NOTE: these three ('hkmap', 'hkmapp' and 'aleph') are obsolete. You should 42 use ":set keymap=hebrewp" instead. 43 44 + 'delcombine' ('deco'), boolean, if editing UTF-8 encoded Hebrew, allows 45 one to remove the niqud or te`amim by pressing 'x' on a character (with 46 associated niqud). 47 48 + 'rightleftcmd' ('rlc') makes the command-prompt for searches show up on 49 the right side. It only takes effect if the window is 'rightleft'. 50 51+ Encoding: 52 + Under Unix, ISO 8859-8 encoding (Hebrew letters codes: 224-250). 53 + Under MS DOS, PC encoding (Hebrew letters codes: 128-154). 54 These are defaults, that can be overridden using the 'aleph' option. 55 + You should prefer using UTF8, as it supports the combining-characters 56 ('deco' does nothing if UTF8 encoding is not active). 57 58+ Vim arguments: 59 + 'vim -H file' starts editing a Hebrew file, i.e. 'rightleft' and 'hkmap' 60 are set. 61 62+ Keyboard: 63 + The 'allowrevins' option enables the CTRL-_ command in Insert mode and 64 in Command-line mode. 65 66 + CTRL-_ in insert/replace modes toggles 'revins' and 'hkmap' as follows: 67 68 When in rightleft window, 'revins' and 'nohkmap' are toggled, since 69 English will likely be inserted in this case. 70 71 When in norightleft window, 'revins' 'hkmap' are toggled, since Hebrew 72 will likely be inserted in this case. 73 74 CTRL-_ moves the cursor to the end of the typed text. 75 76 + CTRL-_ in command mode only toggles keyboard mapping (see Bugs below). 77 This setting is independent of 'hkmap' option, which only applies to 78 insert/replace mode. 79 80 Note: On some keyboards, CTRL-_ is mapped to CTRL-?. 81 82 + Keyboard mapping while 'hkmap' is set (standard Israeli keyboard): 83 84 q w e r t y u i o p 85 / ' ק ר א ט ו ן ם פ 86 87 a s d f g h j k l ; ' 88 ש ד ג כ ע י ח ל ך ף , 89 90 z x c v b n m , . / 91 ז ס ב ה נ מ צ ת ץ . 92 93 This is also the keymap when 'keymap=hebrew' is set. The advantage of 94 'keymap' is that it works properly when using UTF8, e.g. it inserts the 95 correct characters; 'hkmap' does not. The 'keymap' keyboard can also 96 insert niqud and te`amim. To see what those mappings are,look at the 97 keymap file 'hebrew.vim' etc. 98 99 100Typing backwards 101 102If the 'revins' (reverse insert) option is set, inserting happens backwards. 103This can be used to type Hebrew. When inserting characters the cursor is not 104moved and the text moves rightwards. A <BS> deletes the character under the 105cursor. CTRL-W and CTRL-U also work in the opposite direction. <BS>, CTRL-W 106and CTRL-U do not stop at the start of insert or end of line, no matter how 107the 'backspace' option is set. 108 109There is no reverse replace mode (yet). 110 111If the 'showmode' option is set, "-- REVERSE INSERT --" will be shown in the 112status line when reverse Insert mode is active. 113 114When the 'allowrevins' option is set, reverse Insert mode can be also entered 115via CTRL-_, which has some extra functionality: First, keyboard mapping is 116changed according to the window orientation -- if in a left-to-right window, 117'revins' is used to enter Hebrew text, so the keyboard changes to Hebrew 118('hkmap' is set); if in a right-to-left window, 'revins' is used to enter 119English text, so the keyboard changes to English ('hkmap' is reset). Second, 120when exiting 'revins' via CTRL-_, the cursor moves to the end of the typed 121text (if possible). 122 123 124Pasting when in a rightleft window 125---------------------------------- 126When cutting text with the mouse and pasting it in a rightleft window 127the text will be reversed, because the characters come from the cut buffer 128from the left to the right, while inserted in the file from the right to 129the left. In order to avoid it, toggle 'revins' (by typing CTRL-? or CTRL-_) 130before pasting. 131 132 133Hebrew characters and the 'isprint' variable 134-------------------------------------------- 135Sometimes Hebrew character codes are in the non-printable range defined by 136the 'isprint' variable. For example in the Linux console, the Hebrew font 137encoding starts from 128, while the default 'isprint' variable is @,161-255. 138The result is that all Hebrew characters are displayed as ~x. To solve this 139problem, set isprint=@,128-255. 140 141 142 vim:tw=78:ts=8:ft=help:norl: 143