Skip to content

severin-lemaignan/vim-minimap

master
Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?
Code

Latest commit

 

Git stats

Files

Permalink
Failed to load latest commit information.
Type
Name
Latest commit message
Commit time
 
 
 
 
 
 
 
 
 
 
 
 

A code minimap for Vim

The Sublime text-editor can display an useful overview of the code as a minimap sidebar.

We can implement the same thing in Vim, relying on the Drawille library to 'draw' in text mode.

minimap in action

This code is made available under a MIT license. See LICENSE for details.

Features

  • displays the minimap of the currently active buffer (and updates when switching to a different buffer)
  • synchronized scrolling
  • live update while typing

Installation

Note that this extension requires Vim with Python support.

Vundle

With vundle, simply add: Plugin 'severin-lemaignan/vim-minimap' to your .vimrc and run :PluginInstall from vim.

Janus

With Janus just clone inside .janus.

cd ~/.janus
git clone https://github.com/severin-lemaignan/vim-minimap.git vim-minimap

AUR

AUR just has vim-minimap-git package.

Usage

:Minimap to show the minimap, :MinimapClose to hide it.

Default mappings: <Leader>mm to display the minimap, <Leader>mc to close it.

To overwrite the default keybindings, using following settings in ``.vimrc'':

let g:minimap_show='<leader>ms'
let g:minimap_update='<leader>mu'
let g:minimap_close='<leader>gc'
let g:minimap_toggle='<leader>gt'

Settings

You can customize the color of the highlighting by setting g:minimap_highlight in your vimrc:

let g:minimap_highlight='Visual'

Note: To find out which highlights are available on your vim installation use :hi to get the list.

Troubleshooting

Weird display

Problem:

Certain fonts do not display plain dots and empty spaces, but plain dots and circles for braille characters.

For example, with Inconsolata:

image

Solution:

As a result, you may want to use any other font that display braille characters in a way that suit the minimap plugin, like Ubuntu Mono, or Droid Sans Mono.

With Ubuntu Mono:

image

About

A Sublime-like minimap for VIM, based on the Drawille console-based drawing library

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published