Ⅰ. 插件描述
IDE-like Vim tablineⅡ. 基本信息
|
Ⅲ. 安装方法
使用Vundle管理器安装
在你的.vimrc下添加:Plugin 'bagrat/vim-buffet':source %
:PluginInstall对于Vundle版本 < 0.10.2，请用上面的Bundle替换Plugin。
使用NeoBundle管理器安装
在你的.vimrc下添加:NeoBundle 'bagrat/vim-buffet':source %
:NeoBundleInstall使用VimPlug管理器安装
在你的.vimrc下添加:Plug 'bagrat/vim-buffet':source %
:PlugInstall使用Pathogen管理器安装
在终端中运行以下命令:cd ~/.vim/bundle
git clone https://github.com/bagrat/vim-buffetⅣ. 文档说明
# vim-buffet
**Note: this plugin has been renamed from vim-workspace and thus has also
different prefix for the configuration and commands. Please revisit the README
and use the new names of the configuration parameters, highlight groups and
- Sorry for inconvenience.**
If you are new to the Vim world, then welcome, and start by learning Vim's
notions of buffers, windows
and tabpages.
But if you are an experienced Vim user, you might have got tired of bn/bp/ls/Ctrl-^.
vim-buffet brings the IDE-like tabs into Vim, for easy navigation, and a nice,
customizable look. It takes your buffers and tabs, and shows them combined in the
- With this you always have your list of buffers visible, at the same
- not losing visibility into tabs. Moreover,
vim-buffetprovides handy
commands to boost navigation as well as a list of options to customize how the
tabline appears.
Introduction
<h3 align="center">
<img
src="https://raw.githubusercontent.com/bagrat/vim-buffet/e915a9f0627228c317a7498c800208813c0298c3/demo.png"
alt="vim-buffet Screenshot"
/></h3>
Take a look at the screenshot. The blue cuties are the tabpages. The tabpage
that has the buffers list coming next, is the current tabpage. The gray items
with names are the hidden/inactive buffers, and obviously, the green one is the
current buffer. The brighter items on both ends with the little arrows and numbers
are the truncation indicators. If all the buffers do not fit the screen,vim-buffet truncates the tabline, and shows the number of truncated buffers on
both ends.
*Note: the instance of Vim in the screenshot is configured to use powerline
symbols and dev-icons. The default interface is only text and will work without
requiring any patched fonts. The default interface looks like in the screenshot
below.*
<h3 align="center">
<img
src="https://raw.githubusercontent.com/bagrat/vim-buffet/e915a9f0627228c317a7498c800208813c0298c3/demo2.png"
alt="vim-buffet Screenshot"
/></h3>
Installation
Use your favourite plugin manager to install vim-buffet. If you do not have any
preference or have not decided yet, I would recommend Plug.
Plug 'bagrat/vim-buffet'After installation, vim-buffet is enabled by default, so whenever you restart
Vim, you will see the new tabline!
Commands
Apart from listing the buffers in the tabline, vim-buffet also provides some
handy commands to manipulate the buffers:
Bw[!]- wipe the current buffer without closing the window. If is has unsaved
changes, an error will be shown, and the buffer will stay open. To ignore any
changes and forcibly wipe the buffer, use Bw!.
Bonly[!]- wipe all the buffers but the current one. If there are any buffers
in the list that has unsaved changes, those will not be wiped. To ignore any
changes and forcibly wipe all buffers except the current one, use Bonly!.
Mappings
Mappings for switching buffers are also provided. You just need to add the following
mappings to your Vimrc file:
nmap <leader>1 <Plug>BuffetSwitch(1)
nmap <leader>2 <Plug>BuffetSwitch(2)
nmap <leader>3 <Plug>BuffetSwitch(3)
nmap <leader>4 <Plug>BuffetSwitch(4)
nmap <leader>5 <Plug>BuffetSwitch(5)
nmap <leader>6 <Plug>BuffetSwitch(6)
nmap <leader>7 <Plug>BuffetSwitch(7)
nmap <leader>8 <Plug>BuffetSwitch(8)
nmap <leader>9 <Plug>BuffetSwitch(9)
nmap <leader>0 <Plug>BuffetSwitch(10)This will allow you to switch between buffers 1 - 10. You can get more <Plug>
mappings, or disable it completely, by configuring the g:buffet_max_plug option.
Configuration
There are some configuration options that make it possible to customize how the
tabline works and looks like.
Options
The following is the list of available options, that should be set in your
Vimrc file, using let <optiona-name> = <option-value>:
g:buffet_always_show_tabline- if set to0, the tabline will only be shown if
there is more than one buffer or tab open.
Default:
let g:buffet_always_show_tabline = 1g:buffet_powerline_separators- if set to1, use powerline separators
in between buffers and tabs in the tabline (see the first screenshot).
Default:
let g:buffet_powerline_separators = 0g:buffet_separator- the character to be used for separating items in the tabline.
Default:
let g:buffet_separator = ""g:buffet_show_index- if set to1, show index before each buffer name. Index is
useful for switching between buffers quickly.
Default:
let g:buffet_show_index = 0g:buffet_max_plug- the maximum number of<Plug>BuffetSwitchprovided. Mapping
will be disabled if the option is set to0.
Default:
let g:buffet_max_plug = 10g:buffet_use_devicons- if set to1and
vim-deviconsplugin is
installed, show file type icons for each buffer in the tabline. If the
vim-devicons plugin is not present, the option will automatically default to
0.
Default:
let g:buffet_use_devicons = 1g:buffet_tab_icon- the character to be used as an icon for the tab items
in the tabline.
Default:
let g:buffet_tab_icon = "#"g:buffet_new_buffer_name- the character to be shown as the name of a new
buffer.
Default:
let g:buffet_new_buffer_name = "*"g:buffet_modified_icon- the character to be shown by the name of
a modified buffer.
Default:
let g:buffet_modified_icon = "+"g:buffet_left_trun_icon- the character to be shown by the count of
truncated buffers on the left.
Default:
let g:buffet_left_trunc_icon = "<"g:buffet_right_trun_icon- the character to be shown by the count of
truncated buffers on the right.
Default:
let g:buffet_right_trunc_icon = ">"Colors
Of course, you can customize the colors of your tabline, to make it awesome and
- The following is the list of highlight groups, with self-explanatory
names:
BuffetCurrentBuffer- the current buffer.BuffetActiveBuffer- an active buffer (a non-current buffer visible in
a non-current window).BuffetBuffer- a non-current and non-active buffer.BuffetModCurrentBuffer- the current buffer when modified.BuffetModActiveBuffer- a modified active buffer (a non-current buffer visible in
a non-current window).BuffetModBuffer- a modified non-current and non-active buffer.BuffetTrunc- the truncation indicator (count of truncated buffers
from the left or right).BuffetTab- a tab.
Note: To get your custom colors set, define a function with nameg:BuffetSetCustomColors and place your highlight group definitions inside
the function. Make sure the function is defined before vim-buffet is loaded
Example
function! g:BuffetSetCustomColors()
hi! BuffetCurrentBuffer cterm=NONE ctermbg=5 ctermfg=8 guibg=#00FF00 guifg=#000000
endfunctionRecommendations and FAQ
Here are some recommended mappings to boost your navigation experience:
noremap <Tab> :bn<CR>
noremap <S-Tab> :bp<CR>
noremap <Leader><Tab> :Bw<CR>
noremap <Leader><S-Tab> :Bw!<CR>
noremap <C-t> :tabnew split<CR>FAQ
How do I get the look like in the screenshot?
First you will need a patched font, extended with powerline and font-awesome
- Also, you will need the
vim-deviconsinstalled, which
also has great guides on how to patch fonts, as well as some pre-patched fonts.
As soon as you have the patched font, setting the following options, will give
you exactly the same tabline as you see in the first demo screenshot:
let g:buffet_powerline_separators = 1
let g:buffet_tab_icon = "\uf00a"
let g:buffet_left_trunc_icon = "\uf0a8"
let g:buffet_right_trunc_icon = "\uf0a9"How to have the current buffer open in a new tab instead of a new one?
Just add this mapping to your Vimrc:
map <C-t> :tab split<CR>I can only see the current active buffer in the tabline
The reason is that you probably use some statusline plugin (e.g. lightline,
airline) that also has tabline support, which overrides vim-buffet. All you need
to do is disable the tabline of the statusline plugin. For Lightline, it should
be something like this:
let g:lightline.enable.tabline = 0License
See
LICENSE.