runtime/doc/russian.txt

   1 *russian.txt*   For Vim version 7.2c.  Last change: 2006 Apr 24
   2
   3
   4                   VIM REFERENCE MANUAL    by Vassily Ragosin
   5
   6
   7 Russian language localization and support in Vim           *russian* *Russian*
   8
   9 1. Introduction                           |russian-intro|
  10 2. Russian keymaps                        |russian-keymap|
  11 3. Localization                           |russian-l18n|
  12 4. Known issues                           |russian-issues|
  13
  14 ===============================================================================
  15 1. Introduction                                                 *russian-intro*
  16
  17 Russian language is supported perfectly well in Vim.  You can type and view
  18 Russian text just as any other, without the need to tweak the settings.
  19
  20 ===============================================================================
  21 2. Russian keymaps                                             *russian-keymap*
  22
  23 To switch between languages you can use your system native keyboard switcher,
  24 or use one of the Russian keymaps, included in the Vim distribution.  For
  25 example,
  26 >
  27     :set keymap=russian-jcukenwin
  28 <
  29 In the latter case, you can switch between languages even if you do not have
  30 system Russian keyboard or independently from a system-wide keyboard settings.
  31 See 'keymap'.  You can also map a key to switch between keyboards, if you
  32 choose the latter option.  See |:map|.
  33
  34 For your convenience, to avoid switching between keyboards, when you need to
  35 enter Normal mode command, you can also set 'langmap' option:
  36 >
  37     :set langmap=ФИСВУАПРШОЛДЬТЩЗЙКЫЕГМЦЧНЯ;ABCDEFGHIJKLMNOPQRSTUVWXYZ,
  38     фисвуапршолдьтщзйкыегмцчня;abcdefghijklmnopqrstuvwxyz
  39
  40 This is in utf-8, you cannot read this if your 'encoding' is not utf-8.
  41 You have to type this command in one line, it is wrapped for the sake of
  42 readability.
  43
  44 ===============================================================================
  45 3. Localization                                                  *russian-l18n*
  46
  47 If you wish to use messages, help files, menus and other items translated to
  48 Russian, you will need to install the RuVim Language Pack, available in
  49 different codepages from
  50
  51     http://www.sourceforge.net/projects/ruvim/
  52
  53 Make sure that your Vim is at least 6.2.506 and use ruvim 0.5 or later for
  54 automatic installs.  Vim also needs to be compiled with |+gettext| feature for
  55 user interface items translations to work.
  56
  57 After downloading an archive from RuVim project, unpack it into your
  58 $VIMRUNTIME directory.  We recommend using UTF-8 archive, if your version of
  59 Vim is compiled with |+multi_byte| feature enabled.
  60
  61 In order to use the Russian documentation, make sure you have set the
  62 'helplang' option to "ru".
  63
  64 ===============================================================================
  65 4. Known issues                                                *russian-issues*
  66
  67 -- If you are using Russian message translations in Win32 console, then
  68    you may see the output produced by "vim --help", "vim --version" commands
  69    and Win32 console window title appearing in a wrong codepage.  This problem
  70    is related to a bug in GNU gettext library and may be fixed in the future
  71    releases of gettext.
  72
  73 ===============================================================================
  74  vim:tw=78:ts=8:ft=help:norl: