Vim plugin for typing Esperanto language in any way (Esperanto keyboard, h, x, ^)
Vim script
Switch branches/tags
Nothing to show
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


Esperanto - Vim plugin for typing in Esperanto

by Sergey Potapov

Esperanto and Vim

The plugin allows to use the international language in Vim. It doesn't require additional Esperanto keyboard in system, and keeps Vim behaviour the same as with English keyboard.


To install the plugin it's enough to copy plugin, autoload, doc directories into your .vim directory. But I would recommend to use plugin manager Pathogen or Vundle


The plugin provides the next commands:

  • EoOn - to set Esperanto on
  • EoOff - to set Esperanto off
  • Eo - to toggle Esperanto


The plugin allows you to type Esperanto characters in 4 ways. Which one to used is defined by EoMap global variable.

Keyboard mapping

It's default mapping. To use it add to .vimrc file:

let g:EoMap = "keyboard"

It simulates the Esperanto keyboard

Esperanto Klavaro

Actually it adds the next mappings:

x = ĉ
q = ŝ
w = ĝ
y = ŭ
[ = ĵ
] = ĥ

X mapping

To use it add to .vimrc file:

let g:EoMap = "x"


Cxu vi sxatas gxin?  =  Ĉu vi ŝatas ĝin?

H mapping

To use it add to .vimrc file:

let g:EoMap = "h"


Chu vi shatas ghin?  =  Ĉu vi ŝatas ĝin?

Caret mapping

To use it add to .vimrc file:

let g:EoMap = "caret"


C^u vi s^atas g^in?  =  Ĉu vi ŝatas ĝin?

Spell checking

By default the plugin activates spell checking for Esperanto language, when Esperanto is on, it sets spelllang=eo.

To deactivate this behaviour add to .vimrc the next:

let EoSpell = 0



This program is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA