codekingpro/portable-devtools

1*hebrew.txt*	For Vim version 9.2.  Last change: 2026 Feb 142 3 4		  VIM REFERENCE MANUAL	  by Ron Aaron and Avner Lottem5 6 7Hebrew Language support (options & mapping) for Vim		*hebrew*8 9The supporting 'rightleft' functionality was originally created by Avner10Lottem. <alottem at gmail dot com>  Ron Aaron <ron at ronware dot org> is11currently helping support these features.12 13{only available when the |+rightleft| feature was enabled at compile time}14 15 16Introduction17------------18Hebrew-specific options are 'hkmap', 'hkmapp' 'keymap'=hebrew and 'aleph'.19Hebrew-useful options are 'delcombine', 'allowrevins', 'revins', 'rightleft'20and 'rightleftcmd'.21 22The 'rightleft' mode reverses the display order, so characters are displayed23from right to left instead of the usual left to right.  This is useful24primarily when editing Hebrew or other Middle-Eastern languages.25See |rileft.txt| for further details.26 27Details28--------------29+  Options:30   +  'rightleft' ('rl') sets window orientation to right-to-left.  This means31      that the logical text 'ABC' will be displayed as 'CBA', and will start32      drawing at the right edge of the window, not the left edge.33   +  'hkmap' ('hk') sets keyboard mapping to Hebrew, in insert/replace modes.34   +  'aleph' ('al'), numeric, holds the decimal code of Aleph, for keyboard35      mapping.36   +  'hkmapp' ('hkp') sets keyboard mapping to 'phonetic hebrew'37 38   NOTE: these three ('hkmap', 'hkmapp' and 'aleph') are obsolete.  You should39	 use ":set keymap=hebrewp" instead.40 41   +  'delcombine' ('deco'), boolean, if editing UTF-8 encoded Hebrew, allows42      one to remove the niqud or te`amim by pressing 'x' on a character (with43      associated niqud).44 45   +  'rightleftcmd' ('rlc') makes the command-prompt for searches show up on46      the right side.  It only takes effect if the window is 'rightleft'.47 48+  Encoding:49   +  Under Unix, ISO 8859-8 encoding (Hebrew letters codes: 224-250).50   +  Under MS DOS, PC encoding (Hebrew letters codes: 128-154).51      These are defaults, that can be overridden using the 'aleph' option.52   +  You should prefer using UTF8, as it supports the combining-characters53      ('deco' does nothing if UTF8 encoding is not active).54 55+  Vim arguments:56   +  'vim -H file' starts editing a Hebrew file, i.e. 'rightleft' and 'hkmap'57      are set.58 59+  Keyboard:60   +  The 'allowrevins' option enables the CTRL-_ command in Insert mode and61      in Command-line mode.62 63   +  CTRL-_ in insert/replace modes toggles 'revins' and 'hkmap' as follows:64 65      When in rightleft window, 'revins' and 'nohkmap' are toggled, since66      English will likely be inserted in this case.67 68      When in norightleft window, 'revins' 'hkmap' are toggled, since Hebrew69      will likely be inserted in this case.70 71      CTRL-_ moves the cursor to the end of the typed text.72 73   +  CTRL-_ in command mode only toggles keyboard mapping (see Bugs below).74      This setting is independent of 'hkmap' option, which only applies to75      insert/replace mode.76 77      Note: On some keyboards, CTRL-_ is mapped to CTRL-?.78 79   +  Keyboard mapping while 'hkmap' is set (standard Israeli keyboard):80 81	q w e r t y u i o p82	/ ' ק ר א ט ו ן ם פ83 84	 a s d f g h j k l ; '85	 ש ד ג כ ע י ח ל ך ף ,86 87	  z x c v b n m , . /88	  ז ס ב ה נ מ צ ת ץ .89 90      This is also the keymap when 'keymap=hebrew' is set.  The advantage of91      'keymap' is that it works properly when using UTF8, e.g. it inserts the92      correct characters; 'hkmap' does not.  The 'keymap' keyboard can also93      insert niqud and te`amim.  To see what those mappings are, look at the94      keymap file 'hebrew.vim' etc.95 96 97Typing backwards98 99If the 'revins' (reverse insert) option is set, inserting happens backwards.100This can be used to type Hebrew.  When inserting characters the cursor is not101moved and the text moves rightwards.  A <BS> deletes the character under the102cursor.  CTRL-W and CTRL-U also work in the opposite direction.  <BS>, CTRL-W103and CTRL-U do not stop at the start of insert or end of line, no matter how104the 'backspace' option is set.105 106There is no reverse replace mode (yet).107 108If the 'showmode' option is set, "-- REVERSE INSERT --" will be shown in the109status line when reverse Insert mode is active.110 111When the 'allowrevins' option is set, reverse Insert mode can be also entered112via CTRL-_, which has some extra functionality: First, keyboard mapping is113changed according to the window orientation -- if in a left-to-right window,114'revins' is used to enter Hebrew text, so the keyboard changes to Hebrew115('hkmap' is set); if in a right-to-left window, 'revins' is used to enter116English text, so the keyboard changes to English ('hkmap' is reset).  Second,117when exiting 'revins' via CTRL-_, the cursor moves to the end of the typed118text (if possible).119 120 121Pasting when in a rightleft window122----------------------------------123When cutting text with the mouse and pasting it in a rightleft window124the text will be reversed, because the characters come from the cut buffer125from the left to the right, while inserted in the file from the right to126the left.   In order to avoid it, toggle 'revins' (by typing CTRL-? or CTRL-_)127before pasting.128 129 130Hebrew characters and the 'isprint' variable131--------------------------------------------132Sometimes Hebrew character codes are in the non-printable range defined by133the 'isprint' variable.  For example in the Linux console, the Hebrew font134encoding starts from 128, while the default 'isprint' variable is @,161-255.135The result is that all Hebrew characters are displayed as ~x.  To solve this136problem, set isprint=@,128-255.137 138 139 vim:tw=78:ts=8:noet:ft=help:norl:140