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