A-Vim-Story icon indicating copy to clipboard operation
A-Vim-Story copied to clipboard

A ncurses based game for learning Vi/Vim.

A Vim Story

A ncurses based game for learning Vim

Codacy Badge

Overview

There are a lot of problems faced by beginners to Vim (like getting used to not using arrow keys for example). Although there are a lot of resources for learning Vim, they can get tedious and time consuming.

The project aims to make a game played by using the shortcuts and key mappings in Vim to ease into the famous learning curve of Vim. The idea is to make a retro console game (like bomber-man and the likes) which is controlled solely by Vim key mappings and shortcuts.

Inspired by Vim Adventures and open sourced.

Compiling

Assuming you have libncurses, CMake and Make installed.

mkdir build && cd build

cmake ..

make
make install        # to install (might want to use 'sudo')

a-vim-story         # to run

If you want to install in another directory

cmake -DCMAKE_INSTALL_PREFIX=/usr ..  # to install in /usr

Or if you want to test it in build/ itself

cmake -DCMAKE_INSTALL_PREFIX=. ..
make && make install
./bin/a-vim-story

Documentation

For documentation, a configuration file for Doxygen is provided. Assuming you have doxygen installed, issue these commands:

doxygen doxygen.conf

Author

Utkarsh Maheshwari

License

GPL version 3