2017-02-25 15:27:15 +08:00
[![SpaceVim ](https://spacevim.org/logo.png )](https://spacevim.org)
2017-10-07 22:57:35 +08:00
[Wiki ](https://github.com/SpaceVim/SpaceVim/wiki ) \|
[Documentation ](http://spacevim.org/documentation/ ) \|
[Twitter ](https://twitter.com/SpaceVim ) \|
[Community ](https://spacevim.org/community/ ) \|
2018-03-04 20:41:56 +08:00
[Sponsors ](http://spacevim.org/sponsors/ ) \|
2017-10-07 22:57:35 +08:00
[Gitter **Chat** ](https://gitter.im/SpaceVim/SpaceVim ) \|
2018-01-27 01:07:02 +08:00
[中文官网 ](http://spacevim.org/cn/ )
2017-01-10 00:27:52 +08:00
2018-01-20 15:45:48 +08:00
[![Build Status ](https://travis-ci.org/SpaceVim/SpaceVim.svg?branch=master )](https://travis-ci.org/SpaceVim/SpaceVim)
[![Build status ](https://ci.appveyor.com/api/projects/status/eh3t5oph70abp665/branch/master?svg=true )](https://ci.appveyor.com/project/wsdjeg/spacevim/branch/master)
[![codecov ](https://codecov.io/gh/SpaceVim/SpaceVim/branch/master/graph/badge.svg )](https://codecov.io/gh/SpaceVim/SpaceVim/branch/master)
2018-03-20 21:40:57 +08:00
![Version ](https://img.shields.io/badge/version-0.8.0--dev-FF69B4.svg )
2018-02-15 22:25:03 +08:00
[![GPLv3 License ](https://img.shields.io/badge/license-GPLv3-blue.svg )](LICENSE)
2017-05-01 20:36:41 +08:00
[![Doc ](https://img.shields.io/badge/doc-%3Ah%20SpaceVim-orange.svg )](doc/SpaceVim.txt)
2017-05-01 14:09:17 +08:00
[![Average time to resolve an issue ](http://isitmaintained.com/badge/resolution/SpaceVim/SpaceVim.svg )](http://isitmaintained.com/project/SpaceVim/SpaceVim "Average time to resolve an issue")
[![Percentage of issues still open ](http://isitmaintained.com/badge/open/SpaceVim/SpaceVim.svg )](http://isitmaintained.com/project/SpaceVim/SpaceVim "Percentage of issues still open")
2017-02-05 10:03:28 +08:00
2018-02-20 22:02:00 +08:00
SpaceVim is a community-driven modular vim distribution. It manages collections
2018-04-01 01:51:54 +08:00
of plugins in layers, which help collect related packages together to provide IDE-like features.
2018-04-09 15:46:07 +08:00
SpaceVim is not just a vimrc but an ultimate Vim configuration, It contains many build-in features.
2017-01-04 21:04:42 +08:00
2018-03-19 21:36:59 +08:00
![welcome-page ](https://user-images.githubusercontent.com/13142418/37595020-273b5bca-2bb2-11e8-8aba-638ed5f1c7ea.png )
2017-02-25 16:57:35 +08:00
2018-05-12 19:01:00 +08:00
See the [quick start guide ](https://spacevim.org/quick-start-guide/ ), [documentation ](https://spacevim.org/documentation/ ) or the [available layers ](http://spacevim.org/layers/ ) for more information.
2017-05-30 15:27:03 +08:00
2017-08-24 04:01:43 +08:00
Here is a throughput graph of the repository for the last few weeks:
2017-05-30 15:27:03 +08:00
2017-08-24 04:01:43 +08:00
[![Throughput Graph ](https://graphs.waffle.io/SpaceVim/SpaceVim/throughput.svg )](https://waffle.io/SpaceVim/SpaceVim/metrics/throughput)
2017-05-30 15:27:03 +08:00
2017-12-10 19:57:48 +08:00
<!-- vim - markdown - toc GFM -->
2018-02-20 22:02:00 +08:00
- [New Features ](#new-features )
2017-12-10 19:57:48 +08:00
- [Project layout ](#project-layout )
- [Support SpaceVim ](#support-spacevim )
- [Credits & Thanks ](#credits--thanks )
<!-- vim - markdown - toc -->
2018-02-20 22:02:00 +08:00
### New Features
This is a list of latest features implemented in SpaceVim:
2018-01-27 01:07:02 +08:00
2018-04-23 21:21:29 +08:00
**Use toml as default configuration**
here is an example for using toml as SpaceVim config:
```toml
# This is basic configuration example for SpaceVim
# All SpaceVim option below [option] section
[options]
# set spacevim theme. by default colorscheme layer is not loaded,
# if you want to use more colorscheme, please load the colorscheme
# layer
colorscheme = "gruvbox"
2018-05-22 19:58:39 +08:00
colorscheme_bg = "dark"
2018-04-23 21:21:29 +08:00
# Disable guicolors in basic mode, many terminal do not support 24bit
# true colors
guicolors = true
# Disable statusline separator, if you want to use other value, please
# install nerd fonts
statusline_separator = "nil"
statusline_separator = "bar"
buffer_index_type = 4
filetype_icon = false
2018-05-22 19:58:39 +08:00
enable_statusline_display_mode = false
2018-04-23 21:21:29 +08:00
# Enable autocomplete layer
[[layers]]
name = 'autocomplete'
auto-completion-return-key-behavior = "complete"
auto-completion-tab-key-behavior = "cycle"
[[layers]]
name = 'shell'
default_position = 'top'
default_height = 30
```
2018-03-25 18:53:01 +08:00
**Iedit mode**
SpaceVim uses powerful iedit mode to quick edit multiple occurrences of a symbol or selection. Two new modes:`iedit-Normal`/`iedit-Insert`
The default color for iedit is `red` /`green` which is based on the current colorscheme.
![iedit mode ](https://user-images.githubusercontent.com/13142418/37873892-c76afb14-2fea-11e8-9149-aa955b8265f1.gif )
2018-02-15 21:02:45 +08:00
**Highlight cursor symbol**
SpaceVim supports highlighting of the current symbol on demand and adds
a transient state to easily navigate and rename this symbol.
![highlight cursor symbol ](https://user-images.githubusercontent.com/13142418/36210381-e6dffde6-1163-11e8-9b35-0bf262e6f22b.gif )
2018-02-01 20:56:53 +08:00
[**Fly Grep in Vim** ](https://spacevim.org/grep-on-the-fly-in-spacevim/ )
With this feature, vim will display the searching result as you type. Of course, it is running
asynchronously. Before using this feature, you need to install a searching tool. FlyGrep works
through search tools: `ag` , `rg` , `ack` , `pt` and `grep` , Choose one you like.
![searching project ](https://user-images.githubusercontent.com/13142418/35278709-7856ed62-0010-11e8-8b1e-e6cc6374b0dc.gif )
2018-01-30 20:33:04 +08:00
[**Mnemonic key bindings navigation** ](http://spacevim.org/mnemonic-key-bindings-navigation/ )
2018-01-27 01:07:02 +08:00
2018-01-30 20:33:04 +08:00
You don't need to remember any key bindings, as the mapping guide will show up after the < kbd > SPC< / kbd > is pressed.
2018-03-15 21:47:42 +08:00
The mapping guide is also available for `g` , `z` , and `s` .
2017-10-01 20:32:36 +08:00
2018-01-30 20:33:04 +08:00
![mapping guide ](https://user-images.githubusercontent.com/13142418/35568184-9a318082-058d-11e8-9d88-e0eafd1d498d.gif )
[**Help description for key bindings** ](http://spacevim.org/help-description-for-key-bindings/ )
use < kbd > SPC h d k</ kbd > to get the help description of a key binding, and `gd` to find definition of key bindings.
![describe key bindings ](https://user-images.githubusercontent.com/13142418/35568829-e3c8e74c-058f-11e8-8fa8-c0e046d8add3.gif )
[**Asynchronous plugin manager** ](http://spacevim.org/Asynchronous-plugin-manager/ )
create an UI for [dein.vim ](https://github.com/Shougo/dein.vim/ ) - the best asynchronous vim plugin manager
2017-03-29 00:27:08 +08:00
2018-01-30 20:33:04 +08:00
![UI for dein ](https://user-images.githubusercontent.com/13142418/34907332-903ae968-f842-11e7-8ac9-07fcc9940a53.gif )
2017-07-21 05:35:34 +08:00
2018-01-30 20:33:04 +08:00
For more features, please read [SpaceVim's Blog ](https://spacevim.org/blog/ )
2018-02-20 22:02:00 +08:00
### Project layout
2017-10-10 19:34:54 +08:00
2017-12-21 20:23:03 +08:00
```txt
2018-02-22 21:15:46 +08:00
├─ .ci/ build automation
├─ .github/ issue/PR templates
├─ .SpaceVim.d/ project specific configuration
├─ autoload/SpaceVim.vim SpaceVim core file
├─ autoload/SpaceVim/api/ Public APIs
├─ autoload/SpaceVim/layers/ available layers
├─ autoload/SpaceVim/plugins/ buildin plugins
2017-12-21 20:23:03 +08:00
├─ autoload/SpaceVim/mapping/ mapping guide
2018-02-22 21:15:46 +08:00
├─ doc/ help(cn/en)
2018-01-30 20:33:04 +08:00
├─ docs/ website(cn/en)
├─ wiki/ wiki(cn/en)
2018-04-01 01:51:54 +08:00
├─ bin/ executable
2017-12-21 20:23:03 +08:00
└─ test/ tests
```
2017-10-10 19:34:54 +08:00
2018-02-20 22:02:00 +08:00
### Support SpaceVim
2017-02-10 19:43:38 +08:00
2018-01-30 20:33:04 +08:00
The best way to support SpaceVim is to contribute to it either by reporting bugs,
2018-02-21 20:05:03 +08:00
helping the community on the [Gitter Chat ](https://gitter.im/SpaceVim/SpaceVim ) or sending pull requests.
For more info please check our [development guidelines ](http://spacevim.org/development/ ).
2017-02-25 20:45:31 +08:00
2018-01-30 20:33:04 +08:00
If you want to show your support financially you can buy a drink for the maintainer by
clicking following icon.
2017-02-25 20:45:31 +08:00
2018-03-04 20:41:56 +08:00
< a href = 'https://ko-fi.com/spacevim' target = '_blank' > < img height = '36' style = 'border:0px;height:36px;' src = 'https://az743702.vo.msecnd.net/cdn/kofi4.png?v=f' border = '0' alt = 'Buy Me a Coffee at ko-fi.com' / > < / a >
2017-02-25 20:45:31 +08:00
2018-04-23 21:21:29 +08:00
| wechat | alipay |
| ---------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------ |
2018-03-04 20:13:13 +08:00
| < a href = '#support-spacevim' > < img src = "https://spacevim.org/img/weixin.png" height = "150" width = "150" / > < / a > | < a href = '#support-spacevim' > < img src = "https://spacevim.org/img/zhifubao.png" height = "150" width = "150" / > < / a > |
2017-11-13 17:07:00 +08:00
2017-11-26 20:41:37 +08:00
Bitcoin: 1DtuVeg81c2L9NEhDaVTAAbrCR3pN5xPFv
2018-02-20 22:02:00 +08:00
### Credits & Thanks
2017-07-21 05:35:34 +08:00
2018-03-04 20:41:56 +08:00
This project exists thanks to all the people who have [contributed ](CONTRIBUTING.md ):
< a href = "https://github.com/SpaceVim/SpaceVim/graphs/contributors" > < img src = "https://opencollective.com/spacevim/contributors.svg?width=890&button=false" / > < / a >
2018-04-23 21:21:29 +08:00
2017-10-01 20:53:57 +08:00
- [@Gabirel ](https://github.com/Gabirel ) and his [Hack-SpaceVim ](https://github.com/Gabirel/Hack-SpaceVim )
2018-01-30 20:33:04 +08:00
- [@everettjf ](https://github.com/everettjf ) and his [SpaceVimTutorial ](https://everettjf.gitbooks.io/spacevimtutorial/content/ )
2017-02-10 19:43:38 +08:00
- [vimdoc ](https://github.com/google/vimdoc ) generate doc file for SpaceVim
- [Rafael Bodill ](https://github.com/rafi ) and his vim-config
- [Bailey Ling ](https://github.com/bling ) and his dotvim
2017-07-21 05:35:34 +08:00
- authors of all the plugins used in SpaceVim.
2017-12-21 20:23:03 +08:00
<!-- vim:set nowrap: -->