├── .github └── issue_label_bot.yaml ├── .markdownlintrc ├── .travis.yml ├── LICENSE ├── README.adoc ├── README_zh_CN.adoc ├── en_US ├── FAQ.adoc ├── IDE │ ├── C.adoc │ └── JavaScript.adoc ├── README.adoc ├── hidden_Egg_Hunt │ └── play-games.adoc └── installation │ ├── installation-for-linux.adoc │ └── installation-for-windows.adoc └── zh_CN ├── FAQ.adoc ├── IDE ├── C.adoc └── JavaScript.adoc ├── README.adoc ├── hidden_Egg_Hunt └── play-games.adoc └── installation ├── installation-for-linux.adoc └── installation-for-windows.adoc /.github/issue_label_bot.yaml: -------------------------------------------------------------------------------- 1 | label-alias: 2 | bug: 'bug' 3 | feature_request: 'enhancement' 4 | question: 'question' 5 | -------------------------------------------------------------------------------- /.markdownlintrc: -------------------------------------------------------------------------------- 1 | { 2 | "default": true, 3 | "MD003": false, 4 | "MD006": false, 5 | "MD007": { "indent": 3 }, 6 | "MD013": { "line_length": 200 }, 7 | "MD014": false, 8 | "MD024": false, 9 | "MD029": false, 10 | "MD033": false, 11 | "MD034": false, 12 | "MD041": false, 13 | "no-hard-tabs": false, 14 | "whitespace": false, 15 | "no-emphasis-as-header": false 16 | } 17 | -------------------------------------------------------------------------------- /.travis.yml: -------------------------------------------------------------------------------- 1 | sudo: false 2 | os: linux 3 | 4 | language: node_js 5 | node_js: 6 | - "node" 7 | 8 | install: 9 | - npm install -g markdownlint-cli 10 | 11 | script: 12 | - markdownlint -c .markdownlintrc **/*.md 13 | -------------------------------------------------------------------------------- /LICENSE: -------------------------------------------------------------------------------- 1 | MIT License 2 | 3 | Copyright (c) 2017 Gabriel 4 | 5 | Permission is hereby granted, free of charge, to any person obtaining a copy 6 | of this software and associated documentation files (the "Software"), to deal 7 | in the Software without restriction, including without limitation the rights 8 | to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 9 | copies of the Software, and to permit persons to whom the Software is 10 | furnished to do so, subject to the following conditions: 11 | 12 | The above copyright notice and this permission notice shall be included in all 13 | copies or substantial portions of the Software. 14 | 15 | THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 16 | IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 17 | FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE 18 | AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 19 | LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 20 | OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE 21 | SOFTWARE. 22 | -------------------------------------------------------------------------------- /README.adoc: -------------------------------------------------------------------------------- 1 | = Hack-SpaceVim - Guider for SpaceVim 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title:: 6 | 7 | https://spacevim.org[image:https://spacevim.org/img/build-with-SpaceVim.svg[image]] 8 | https://travis-ci.org/Gabirel/Hack-SpaceVim[image:https://travis-ci.org/Gabirel/Hack-SpaceVim.svg?branch=master[Build Status]] 9 | link:LICENSE[image:https://img.shields.io/badge/license-MIT-blue.svg?style=flat[MIT License]] 10 | https://spacevim.org[image:https://img.shields.io/badge/spacevim-v2.0.0-FF00CC.svg[spacevim-version]] 11 | http://isitmaintained.com/project/Gabirel/Hack-SpaceVim[image:http://isitmaintained.com/badge/resolution/Gabirel/Hack-SpaceVim.svg[Average time to resolve an issue]] 12 | http://isitmaintained.com/project/Gabirel/Hack-SpaceVim[image:http://isitmaintained.com/badge/open/Gabirel/Hack-SpaceVim.svg[Percentage of issues still open]] 13 | 14 | ''' 15 | 16 | You may want to check https://github.com/Gabirel/Hack-SpaceVim/issues[issues] for the most recent discussions. 17 | 18 | == Introduction 19 | 20 | https://gitlab.com/SpaceVim/SpaceVim[SpaceVim] | 21 | link:README_zh_CN.adoc[Hack-SpaceVim 中文版] | 22 | https://github.com/Gabirel/Hack-SpaceVim/issues[Ask questions] | 23 | https://gitlab.com/SpaceVim/SpaceVim/issues[Bug report & Feature request] 24 | 25 | .What can you get from Hack-SpaceVim 26 | 27 | * :metal: Introductions about how to install SpaceVim with *step by step* 28 | * :trollface: Set up developing environments very fast 29 | * :sunglasses: Become a developer very quickly 30 | * :massage_woman: Help you get acquainted with mountains of plugins 31 | * :muscle: Make you a professional vimmer 32 | * :new_moon_with_face: Let you hack this planet with SpaceVim 33 | * :scream: Tell you some facts somebody else won’t tell you 34 | * :smirk: Tricks you will never know(contradictory statements) 35 | 36 | == Index 37 | 38 | [arabic] 39 | . link:en_US/installation/installation-for-windows.adoc#install-spacevim-on-windows[SpaceVim on Windows] 40 | * link:en_US/installation/installation-for-windows.adoc#install-spacevim-on-windows[Install SpaceVim on Windows] 41 | ** link:en_US/installation/installation-for-windows.adoc#table-of-contents[Table of Contents] 42 | ** link:en_US/installation/installation-for-windows.adoc#install-prerequisites[Install prerequisites] 43 | ** link:en_US/installation/installation-for-windows.adoc#start-to-install[Start to install] 44 | *** link:en_US/installation/installation-for-windows.adoc#install-online[Install online] 45 | *** link:en_US/installation/installation-for-windows.adoc#install-offline[Install offline] 46 | ** link:en_US/installation/installation-for-windows.adoc#install-neovim[Install Neovim] 47 | . link:en_US/installation/installation-for-linux.adoc#install-spacevim-on-linux[SpaceVim on Linux] 48 | * link:en_US/installation/installation-for-linux.adoc#install-spacevim-on-linux[Install SpaceVim on Linux] 49 | ** link:en_US/installation/installation-for-linux.adoc#table-of-contents[Table of Contents] 50 | ** link:en_US/installation/installation-for-linux.adoc#install-prerequisites[Install prerequisites] 51 | ** link:en_US/installation/installation-for-linux.adoc#start-to-install[Start to install] 52 | *** link:en_US/installation/installation-for-linux.adoc#install-online[Install online] 53 | *** link:en_US/installation/installation-for-linux.adoc#install-offline[Install offline] 54 | . link:en_US/IDE[IDE] 55 | * link:en_US/IDE/JavaScript.adoc#ide-for-javascript[IDE for JavaScript] 56 | ** link:en_US/IDE/JavaScript.adoc#table-of-contents[Table of Contents] 57 | ** link:en_US/IDE/JavaScript.adoc#requirements[Requirements] 58 | ** link:en_US/IDE/JavaScript.adoc#installation[Installation] 59 | *** link:en_US/IDE/JavaScript.adoc#spacevim[SpaceVim] 60 | *** link:en_US/IDE/JavaScript.adoc#install-npm-or-cnpm[Install npm or cnpm] 61 | *** link:en_US/IDE/JavaScript.adoc#install-tern[Install tern] 62 | *** link:en_US/IDE/JavaScript.adoc#add-config-into-your-spacevimdinitvim[Add config into your ~/.SpaceVim.d/init.vim] 63 | ** link:en_US/IDE/JavaScript.adoc#config[Config] 64 | ** link:en_US/IDE/JavaScript.adoc#credits--thanks[Credits & Thanks] 65 | . link:en_US/FAQ.adoc#faq[FAQ] 66 | * link:en_US/FAQ.adoc#general[General] 67 | ** link:en_US/FAQ.adoc#change-layer-options[Change layer options] 68 | * link:en_US/FAQ.adoc#windows[Windows] 69 | ** link:en_US/FAQ.adoc#set-up-your-path[Set up your PATH] 70 | ** link:en_US/FAQ.adoc#without-python-support[without python support] 71 | ** link:en_US/FAQ.adoc#spacevim-gets-frozen-easily[SpaceVim gets frozen easily] 72 | ** link:en_US/FAQ.adoc#vcruntime140dll-error[vcruntime140.dll Error] 73 | ** link:en_US/FAQ.adoc#installing-on-windows-is-too-complicated[Installing on Windows is too complicated] 74 | ** link:en_US/FAQ.adoc#exuberant-ctags-not-found[Exuberant ctags not found] 75 | * link:en_US/FAQ.adoc#linux[Linux] 76 | ** link:en_US/FAQ.adoc#building-vim-from-source[Building vim from source] 77 | ** link:en_US/FAQ.adoc#exuberant-ctags-not-found-1[Exuberant ctags not found] 78 | . link:en_US/hidden_Egg_Hunt[Hidden Egg Hunt] 79 | * link:en_US/hidden_Egg_Hunt/play-games.adoc#play-games-on-spacevim[Play games on SpaceVim] 80 | ** link:en_US/hidden_Egg_Hunt/play-games.adoc#game-lists[Game Lists] 81 | ** link:en_US/hidden_Egg_Hunt/play-games.adoc#vim2048[Vim2048] 82 | *** link:en_US/hidden_Egg_Hunt/play-games.adoc#instruction[Instruction] 83 | 84 | == FAQ 85 | 86 | [qanda] 87 | `init.toml` or `init.vim`?:: 88 | 89 | *TL;DR:* Choose `init.vim`. Don't use `init.toml`. + 90 | *Long answer:* Here are several reasons for this: 91 | ** SpaceVim doesn't provide detailed documents of variable name you can use. Under this circumstance, it is not smart to use `init.toml` although SpaceVim recommand you to use toml-style config. + 92 | ** You need nobody to tell you what variable name you can use in your vim script, just by looking up the source code of SpaceVim. 93 | ** *For beginner:* Toml-style of config won't help you develop skills related with vim script. 94 | ** In order to define your custom code/functions, you have to use https://spacevim.org/documentation/#bootstrap-functions[bootstrap functions]. You will then pollute SpaceVim's source code. 95 | 96 | What does `Hack-SpaceVim` really do?:: 97 | Currently, it is trying to be something really useful to whom wants to master or use SpaceVim, including various aspects. Not just SpaceVim, but also vim/nvim. 98 | 99 | == Contributors 100 | 101 | ++++ 102 | 103 | 104 | 105 | ++++ 106 | 107 | Made with https://contributors-img.web.app[contributors-img]. 108 | 109 | == Reference 110 | 111 | New to Vim: https://github.com/mhinz/vim-galore[vim-galore] 112 | -------------------------------------------------------------------------------- /README_zh_CN.adoc: -------------------------------------------------------------------------------- 1 | = Hack-SpaceVim - SpaceVim 向导 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title: 6 | 7 | https://spacevim.org[image:https://spacevim.org/img/build-with-SpaceVim.svg[image]] 8 | https://travis-ci.org/Gabirel/Hack-SpaceVim[image:https://travis-ci.org/Gabirel/Hack-SpaceVim.svg?branch=master[Build Status]] 9 | link:LICENSE[image:https://img.shields.io/badge/license-MIT-blue.svg?style=flat[MIT License]] 10 | https://spacevim.org[image:https://img.shields.io/badge/spacevim-v2.0.0-FF00CC.svg[spacevim-version]] 11 | http://isitmaintained.com/project/Gabirel/Hack-SpaceVim[image:http://isitmaintained.com/badge/resolution/Gabirel/Hack-SpaceVim.svg[Average time to resolve an issue]] 12 | http://isitmaintained.com/project/Gabirel/Hack-SpaceVim[image:http://isitmaintained.com/badge/open/Gabirel/Hack-SpaceVim.svg[Percentage of issues still open]] 13 | 14 | ''' 15 | 16 | 可通过 https://github.com/Gabirel/Hack-SpaceVim/issues[issues] 来获得最新的进展。 17 | 18 | == 介绍 19 | 20 | https://gitlab.com/SpaceVim/SpaceVim[SpaceVim] | 21 | link:README.adoc[Hack-SpaceVim English] | 22 | https://github.com/Gabirel/Hack-SpaceVim/issues[Ask questions] | 23 | https://gitlab.com/SpaceVim/SpaceVim/issues[Bug report & Feature request] 24 | 25 | .你能从Hack-SpaceVim得到什么 26 | 27 | * :metal: **手把手**教你如何安装SpaceVim 28 | * :trollface: 快速地部署开发环境 29 | * :sunglasses: 开发者速成 30 | * :massage_woman: 帮助你熟悉多到吐的插件 31 | * :muscle: 让你成为专业的vimmer 32 | * :new_moon_with_face: 用SpaceVim征服整个星球 33 | * :scream: 告诉你鲜为人知的彩蛋 34 | * :smirk:一些你永远不会知道的技巧（噢，这好像矛盾了） 35 | 36 | == 索引 37 | 38 | [arabic] 39 | . link:zh_CN/installation/installation-for-windows.adoc#在windows上安装spacevim[在Windows上的SpaceVim] 40 | * link:zh_CN/installation/installation-for-windows.adoc#%E5%9C%A8windows%E4%B8%8A%E5%AE%89%E8%A3%85spacevim[在Windows上安装SpaceVim] 41 | ** link:zh_CN/installation/installation-for-windows.adoc#table-of-contents[Table of Contents] 42 | ** link:zh_CN/installation/installation-for-windows.adoc#%E5%9F%BA%E7%A1%80%E7%8E%AF%E5%A2%83[基础环境] 43 | ** link:zh_CN/installation/installation-for-windows.adoc#%E5%BC%80%E5%A7%8B%E5%AE%89%E8%A3%85[开始安装] 44 | *** link:zh_CN/installation/installation-for-windows.adoc#%E5%9C%A8%E7%BA%BF%E5%AE%89%E8%A3%85[在线安装] 45 | *** link:zh_CN/installation/installation-for-windows.adoc#%E7%A6%BB%E7%BA%BF%E5%AE%89%E8%A3%85[离线安装] 46 | ** link:zh_CN/installation/installation-for-windows.adoc#%E5%AE%89%E8%A3%85neovim[安装Neovim] 47 | . link:zh_CN/installation/installation-for-linux.adoc#在linux上安装spacevim[在Linux上的SpaceVim] 48 | * link:zh_CN/installation/installation-for-linux.adoc#在linux上安装spacevim[在Linux上安装SpaceVim] 49 | ** link:zh_CN/installation/installation-for-linux.adoc#table-of-contents[Table of Contents] 50 | ** link:zh_CN/installation/installation-for-linux.adoc#安装依赖[安装依赖] 51 | ** link:zh_CN/installation/installation-for-linux.adoc#开始安装[开始安装] 52 | *** link:zh_CN/installation/installation-for-linux.adoc#在线安装[在线安装] 53 | *** link:zh_CN/installation/installation-for-linux.adoc#离线安装[离线安装] 54 | . link:zh_CN/IDE[IDE] 55 | * link:zh_CN/IDE/JavaScript.adoc#ide-for-javascript[IDE for JavaScript] 56 | ** link:zh_CN/IDE/JavaScript.adoc#table-of-contents[Table of Contents] 57 | ** link:zh_CN/IDE/JavaScript.adoc#基本要求[基本要求] 58 | ** link:zh_CN/IDE/JavaScript.adoc#安装[安装] 59 | *** link:zh_CN/IDE/JavaScript.adoc#spacevim[SpaceVim] 60 | *** link:zh_CN/IDE/JavaScript.adoc#安装-npm-或-cnpm[安装npm或cnpm] 61 | *** link:zh_CN/IDE/JavaScript.adoc#安装-tern[安装tern] 62 | *** link:zh_CN/IDE/JavaScript.adoc#将配置加到-spacevimdinitvim[将配置加到~/.SpaceVim.d/init.vim] 63 | ** link:zh_CN/IDE/JavaScript.adoc#配置[配置] 64 | ** link:zh_CN/IDE/JavaScript.adoc#感谢[感谢] 65 | . link:zh_CN/FAQ.adoc#常见问题[常见问题] 66 | * link:zh_CN/FAQ.adoc#通用[通用] 67 | ** link:zh_CN/FAQ.adoc#改变-layer-的选项[改变 layer 的选项] 68 | * link:zh_CN/FAQ.adoc#windows[Windows] 69 | ** link:zh_CN/FAQ.adoc#配置环境变量[配置环境变量] 70 | ** link:zh_CN/FAQ.adoc#python不支持[python不支持] 71 | ** link:zh_CN/FAQ.adoc#spacevim卡顿[SpaceVim卡顿] 72 | ** link:zh_CN/FAQ.adoc#vcruntime140dll错误[vcruntime140.dll错误] 73 | ** link:zh_CN/FAQ.adoc#windows上安装繁琐[Windows上安装繁琐] 74 | ** link:zh_CN/FAQ.adoc#exuberant-ctags未找到[Exuberant ctags未找到] 75 | * link:zh_CN/FAQ.adoc#linux[Linux] 76 | ** link:zh_CN/FAQ.adoc#从源码安装vim[从源码安装vim] 77 | ** link:zh_CN/FAQ.adoc#exuberant-ctags未找到-1[Exuberant ctags未找到] 78 | . link:zh_CN/hidden_Egg_Hunt[寻觅彩蛋] 79 | * link:zh_CN/hidden_Egg_Hunt/play-games.adoc#在spacevim上玩游戏[在SpaceVim上玩游戏] 80 | ** link:zh_CN/hidden_Egg_Hunt/play-games.adoc#游戏列表[游戏列表] 81 | ** link:zh_CN/hidden_Egg_Hunt/play-games.adoc#vim2048[Vim2048] 82 | *** link:zh_CN/hidden_Egg_Hunt/play-games.adoc#安装[安装] 83 | 84 | == 常见问题 Q&A 85 | 86 | [qanda] 87 | `init.toml` 还是 `init.vim`？:: 88 | 89 | *太长不读：* 选 `init.vim`. 尽量别去使用 `init.toml`. + 90 | *长答案：* 这里有几个原因来解释为什么要这么选择： 91 | ** SpaceVim不提供你可以使用的变量名。在这样的情况下，使用 `init.toml` 就不是一个聪明的决定，尽管SpaceVim推荐使用这种toml风格的配置文件。 92 | ** 你不需要任何人就能知道你能在你的vim脚本中使用怎样的变量名，仅仅通过查看SpaceVim的源代码即可。 93 | ** *针对初学者：* toml风格的配置文件不会帮助你提升vim脚本的能力。 94 | ** 如果你使用 `init.toml` 并且为了能够自定义代码/函数，你必须要使用 https://spacevim.org/documentation/#bootstrap-functions[bootstrap functions]. 这样你就会污染SpaceVim的代码。 95 | 96 | `Hack-SpaceVim` 到底是干嘛的？:: 97 | 目前，它正努力让任何希望掌握和使用SpaceVim的人达成目标，这包括了各个方面。不止是SpaceVim本身，也包含了vim/nvim。 98 | 99 | == Contributors 100 | 101 | ++++ 102 | 103 | 104 | 105 | ++++ 106 | 107 | == 参考 108 | 109 | Vim新人可以看看: https://github.com/mhinz/vim-galore[vim-galore] 110 | -------------------------------------------------------------------------------- /en_US/FAQ.adoc: -------------------------------------------------------------------------------- 1 | = FAQ 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title: 6 | 7 | == General 8 | 9 | === Change layer options 10 | 11 | *1. I would like to change options from shell layer using `init.vim`. How could I achieve that?* 12 | 13 | _Question comes from: https://github.com/Gabirel/Hack-SpaceVim/issues/51[Hack-SpaceVim#51@ViiEx]_ 14 | 15 | A: *Main idea* is to overwrite the default options(variables). 16 | 17 | For example, I would like to change the default height and default position when I use shell inside SpaceVim. 18 | 19 | Add codes below into your `init.vim`: 20 | 21 | [source,viml] 22 | ---- 23 | call SpaceVim#layers#load('shell') 24 | 25 | " this call function MUST STAY BELOW 26 | " Otherwise, it will get overwritten by `call SpaceVim#layers#load('shell')` 27 | call SpaceVim#layers#load('shell', 28 | \ { 29 | \ 'default_position' : 'bottom', 30 | \ 'default_height' : 100, 31 | \ } 32 | \ ) 33 | ---- 34 | 35 | Demo: 36 | 37 | image:https://user-images.githubusercontent.com/12933851/172159423-9ec89e15-d5e9-408a-b554-12e787d52949.png[demo] 38 | 39 | == Windows 40 | 41 | === Set up your PATH 42 | 43 | *1. How to set up my PATH on Windows?* 44 | 45 | A: _Location: My computer->properties->Advance System Setting->Environment variables->System variables->Find Path->Edit_ 46 | 47 | _I’m sorry. I don’t use Windows. I can’t use English on my VirtualOS. Windows won’t let me do this. ):_ 48 | 49 | image:https://gist.githubusercontent.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/08946a3643606420776fcc3fc4d43da6444806cc/path-config.PNG[path] 50 | 51 | === without python support 52 | 53 | *2. `echo has('python')` always returns 0. What should I do?* 54 | 55 | A: Please check out whether you meet all these requirements: 56 | 57 | * Open a new `cmd.exe` to check out whether you can execute command: python 58 | * If you install 64bit-gvim, make sure you install 64bit python as well. Vice Versa. 59 | * Gvim must has `+python/dyn` or `+python3/dyn` or `+python/dyn;+python3/dyn` 60 | * If all above doesn’t work, please add config below into your `init.vim`: 61 | 62 | First, you have to know what your python exact version is. 63 | 64 | Here’s test command: 65 | 66 | ____ 67 | py -2 –version 68 | ____ 69 | 70 | ____ 71 | py -3 –version 72 | ____ 73 | 74 | According to your python version, add config like this: 75 | 76 | [source,viml] 77 | ---- 78 | set pythonthreedll=python36.dll 79 | set pythondll=python27.dll 80 | ---- 81 | 82 | *More details: https://github.com/Gabirel/Hack-SpaceVim/issues/17[#17]* 83 | 84 | === SpaceVim gets frozen easily 85 | 86 | *3. I can feel my SpaceVim gets frozen a little bit. What’s exactly going on?* 87 | 88 | A: There are 4 kind of possibilities: 89 | 90 | * Check out whether you can execute `lua` command in your new terminal and your gvim has `+lua` feature. SpaceVim will use `neocomplcache` instead of `neocomplete` without lua support, which makes SpaceVim gets frozen or have some delay. 91 | * You may encounter bugs of SpaceVim. Feel free to use https://gitlab.com/SpaceVim/SpaceVim/issues[issue tracker] to solve this. 92 | * Your config file is probably the problem. For example, your SpaceVim will get frozen totally if you make `loadEagerly` as `**/*.js` when writing nodejs file. 93 | * Maybe one of plugins has some conflicts with another plugin. Please open a new https://gitlab.com/SpaceVim/SpaceVim/issues[issue] to help you fix this problem if you suspect. 94 | 95 | === vcruntime140.dll Error 96 | 97 | *4. I can’t start gvim. It says that vcruntime140.dll errors. What should I do?* 98 | 99 | A: https://www.dllme.com/dll/download/29939/vcruntime140.dll[Click me to download]. Copyt it to the corresponding folder according to your own OS: 100 | 101 | 32bit OS: `C:\Windows\System32\` 102 | 103 | 64bit OS: `C:\Windows\SysWOW64\` 104 | 105 | === Installing on Windows is too complicated 106 | 107 | *5. Why installing SpaceVim on Windows is so complicated? Is there more simple way to do this?* 108 | 109 | A: I’m sorry! Nope. Setting up developing environments is killing yourself. I’m HIGHLY RECOMMEND leaving Windows alone. If you have to, please DO NOT touch Neovim. Please use vim for your mental and physicial helath. 110 | 111 | === Exuberant ctags not found 112 | 113 | *6. Tagbar: Exuberant ctags not found? What should I do?* 114 | 115 | As it shows here: image:https://cloud.githubusercontent.com/assets/12933851/25282302/a868f3e0-26e2-11e7-8cfb-037f884a4702.png[ctags-error] 116 | 117 | A: 118 | 119 | [arabic] 120 | . You should go to this: https://github.com/universal-ctags/ctags#windows 121 | . Add the binary folder to your PATH. 122 | 123 | My situation is `C:\Program Files\ctagas\ctags.exe` 124 | 125 | [arabic, start=3] 126 | . Add config according to your own PATH: 127 | 128 | [source,viml] 129 | ---- 130 | let g:tagbar_ctags_bin = 'C:\Program Files\ctagas\ctags.exe' 131 | ---- 132 | 133 | == Linux 134 | 135 | === Building vim from source 136 | 137 | Some distros maybe doesn’t have the latest vim. So, some have to build vim from source. 138 | 139 | This section is for building vim from source: 140 | 141 | Please go to here: https://github.com/Valloric/YouCompleteMe/wiki/Building-Vim-from-source[Build vim from source] 142 | 143 | === Exuberant ctags not found 144 | 145 | *1. Tagbar: Exuberant ctags not found? What should I do?* 146 | 147 | A: 148 | 149 | Arch/Manjaro 150 | 151 | ____ 152 | sudo pacman -S ctags 153 | ____ 154 | 155 | Debian/Ubuntu/Linux Mint 156 | 157 | ____ 158 | sudo apt-get install ctags 159 | ____ 160 | 161 | Fedora 162 | 163 | ____ 164 | sudo dnf install ctags 165 | ____ 166 | 167 | CentOS/RHEL 168 | 169 | ____ 170 | sudo yum install ctags 171 | ____ 172 | 173 | _That’s all. Done!_ 174 | 175 | ''''' 176 | 177 | link:README.adoc#table-of-contents[Index] | 178 | link:../README_zh_CN.adoc#hack-spacevim[中文文档] 179 | -------------------------------------------------------------------------------- /en_US/IDE/C.adoc: -------------------------------------------------------------------------------- 1 | This page is for C IDE, but not finished yet 2 | -------------------------------------------------------------------------------- /en_US/IDE/JavaScript.adoc: -------------------------------------------------------------------------------- 1 | = IDE for JavaScript 2 | :sectnums: 3 | :toc: 4 | :toclevels: 3 5 | :toc-title: 6 | 7 | == Requirements 8 | 9 | * SpaceVim 10 | * tern 11 | * tern_for_vim 12 | * nodejs 13 | * npm/cnpm 14 | 15 | == Installation 16 | 17 | === SpaceVim 18 | 19 | Make sure your SpaceVim is up-to-date. 20 | 21 | === Install `npm` or `cnpm` 22 | 23 | Here are the examples: 24 | 25 | *Arch:* 26 | 27 | [source,bash] 28 | ---- 29 | sudo pacman -S npm nodejs 30 | ---- 31 | 32 | *Fedora:* 33 | 34 | [source,bash] 35 | ---- 36 | sudo dnf install npm nodejs 37 | ---- 38 | 39 | *Ubuntu:* 40 | 41 | [source,bash] 42 | ---- 43 | sudo apt install npm nodejs 44 | ---- 45 | 46 | === Install `tern` 47 | 48 | You have to install tern since https://github.com/ternjs/tern_for_vim[tern_for_vim] using http://ternjs.net/[tern] as a server to provide auto-completion. (If I was wrong, please tell me. Because I am not a expert of nodejs) 49 | 50 | Just Simply run: 51 | 52 | [source,bash] 53 | ---- 54 | cd ~/.cache/vimfiles/repos/github.com/ternjs/tern_for_vim 55 | npm install tern 56 | ---- 57 | 58 | *Or* 59 | 60 | [source,bash] 61 | ---- 62 | cnpm install tern 63 | ---- 64 | 65 | _PS: If you want to execute, please install `cnpm`._ 66 | 67 | === Add config into your `~/.SpaceVim.d/init.vim` 68 | 69 | [source,viml] 70 | ---- 71 | call SpaceVim#layers#load('lang#javascript') 72 | ---- 73 | 74 | And restart your vim to let SpaceVim itself to install plugins for you. 75 | 76 | _If it takes a long time to install `tern_for_vim`, please install it manually by 3 steps below:_ 77 | 78 | [source,bash] 79 | ---- 80 | $ cd ~/.cache/vimfiles/repos/github.com/ternjs 81 | $ git clone https://github.com/ternjs/tern_for_vim 82 | $ cd tern_for_vim; npm install 83 | ---- 84 | 85 | == Config 86 | 87 | The most important step is about how to configure your environment. 88 | 89 | Actually, it’s pretty easy. 90 | 91 | It has two optinos for config. 92 | 93 | * Option A: `.tern-project`(in the current directory or one of the directories above that *for this project only*) 94 | * Option B: `.tern-config`(*default* in your home directory) 95 | 96 | *See more details http://ternjs.net/doc/manual.html#server[here]* 97 | 98 | Here’s the example config: 99 | 100 | [source,json] 101 | ---- 102 | { 103 | "plugins": { 104 | "node": {}, 105 | "node_resolve": {}, 106 | "es_modules": {}, 107 | "modules": {} 108 | }, 109 | "libs": [ 110 | "browser", 111 | "ecma5", 112 | "ecma6", 113 | "react" 114 | ], 115 | "ecmaVersion": 6 116 | } 117 | ---- 118 | 119 | *That’s it!!!* 120 | 121 | == Credits & Thanks 122 | 123 | Thanks to https://github.com/renchunhui[@RenChunhui], I can make this topic happen. I could never reach so for without his unselfish help. 124 | 125 | ''''' 126 | 127 | link:../IDE[IDE] | 128 | link:../FAQ.adoc#faq[FAQ] | 129 | link:../README.adoc#table-of-contents[Index] | 130 | link:../../README_zh_CN.adoc#hack-spacevim[中文文档] -------------------------------------------------------------------------------- /en_US/README.adoc: -------------------------------------------------------------------------------- 1 | == Table of Contents 2 | 3 | [arabic] 4 | . link:installation/installation-for-windows.md[SpaceVim on Windows] 5 | * link:installation/installation-for-windows.adoc#install-spacevim-on-windows[Install SpaceVim on Windows] 6 | ** link:installation/installation-for-windows.adoc#table-of-contents[Table of Contents] 7 | ** link:installation/installation-for-windows.adoc#install-prerequisites[Install prerequisites] 8 | ** link:installation/installation-for-windows.adoc#start-to-install[Start to install] 9 | *** link:installation/installation-for-windows.adoc#install-online[Install online] 10 | *** link:installation/installation-for-windows.adoc#install-offline[Install offline] 11 | ** link:installation/installation-for-windows.adoc#install-neovim[Install Neovim] 12 | . link:installation/installation-for-linux.md[SpaceVim on Linux] 13 | * link:installation/installation-for-linux.adoc#install-spacevim-on-linux[Install SpaceVim on Linux] 14 | ** link:installation/installation-for-linux.adoc#table-of-contents[Table of Contents] 15 | ** link:installation/installation-for-linux.adoc#install-prerequisites[Install prerequisites] 16 | ** link:installation/installation-for-linux.adoc#start-to-install[Start to install] 17 | *** link:installation/installation-for-linux.adoc#install-online[Install online] 18 | *** link:installation/installation-for-linux.adoc#install-offline[Install offline] 19 | . IDE 20 | * link:IDE/JavaScript.adoc#ide-for-javascript[IDE for JavaScript] 21 | ** link:IDE/JavaScript.adoc#table-of-contents[Table of Contents] 22 | ** link:IDE/JavaScript.adoc#requirements[Requirements] 23 | ** link:IDE/JavaScript.adoc#installation[Installation] 24 | *** link:IDE/JavaScript.adoc#spacevim[SpaceVim] 25 | *** link:IDE/JavaScript.adoc#install-npm-or-cnpm[Install npm or cnpm] 26 | *** link:IDE/JavaScript.adoc#install-tern[Install tern] 27 | *** link:IDE/JavaScript.adoc#add-config-into-your-spacevimdinitvim[Add config into your ~/.SpaceVim.d/init.vim] 28 | ** link:IDE/JavaScript.adoc#config[Config] 29 | ** link:IDE/JavaScript.adoc#credits--thanks[Credits & Thanks] 30 | . link:FAQ.adoc#faq[FAQ] 31 | * link:FAQ.adoc#general[General] 32 | ** link:FAQ.adoc#change-layer-options[Change layer options] 33 | * link:FAQ.adoc#windows[Windows] 34 | ** link:FAQ.adoc#set-up-your-path[Set up your PATH] 35 | ** link:FAQ.adoc#without-python-support[without python support] 36 | ** link:FAQ.adoc#spacevim-gets-frozen-easily[SpaceVim gets frozen easily] 37 | ** link:FAQ.adoc#vcruntime140dll-error[vcruntime140.dll Error] 38 | ** link:FAQ.adoc#installing-on-windows-is-too-complicated[Installing on Windows is too complicated] 39 | ** link:FAQ.adoc#exuberant-ctags-not-found[Exuberant ctags not found] 40 | * link:FAQ.adoc#linux[Linux] 41 | ** link:FAQ.adoc#building-vim-from-source[Building vim from source] 42 | ** link:FAQ.adoc#exuberant-ctags-not-found-1[Exuberant ctags not found] 43 | . link:hidden_Egg_Hunt[Hidden Egg Hunt] 44 | * link:hidden_Egg_Hunt/play-games.adoc#play-games-on-spacevim[Play games on SpaceVim] 45 | ** link:hidden_Egg_Hunt/play-games.adoc#game-lists[Game Lists] 46 | ** link:hidden_Egg_Hunt/play-games.adoc#vim2048[Vim2048] 47 | *** link:hidden_Egg_Hunt/play-games.adoc#instruction[Instruction] 48 | -------------------------------------------------------------------------------- /en_US/hidden_Egg_Hunt/play-games.adoc: -------------------------------------------------------------------------------- 1 | = Play games on SpaceVim 2 | :sectnums: 3 | :toc: 4 | :toclevels: 3 5 | :toc-title: 6 | 7 | == Game Lists 8 | 9 | * vim2048 10 | 11 | == Vim2048 12 | 13 | === Instruction 14 | 15 | [arabic] 16 | . Add config below into your `~/.SpaceVim.d/init.vim`: 17 | 18 | [source,viml] 19 | ---- 20 | call SpaceVim#layers#load('games') 21 | ---- 22 | 23 | [arabic, start=2] 24 | . Open your vim/neovim, and then you should see this: 25 | 26 | image:https://cloud.githubusercontent.com/assets/12933851/25666818/33f2b91c-3054-11e7-89e4-2ffdcb6efb35.png[vim2048-install] 27 | 28 | [arabic, start=3] 29 | . Restart vim, and Press ` g 2`: 30 | 31 | image:https://cloud.githubusercontent.com/assets/12933851/25666850/51a9faa6-3054-11e7-9807-172841f3721b.png[vim2048-space] 32 | 33 | image:https://cloud.githubusercontent.com/assets/12933851/25666978/a75640d6-3054-11e7-9bc1-97e234460074.png[vim2048-space-g] 34 | 35 | [arabic, start=4] 36 | . DONE! 37 | 38 | image:https://cloud.githubusercontent.com/assets/12933851/25666993/b10681cc-3054-11e7-9872-b0889f7caa6f.png[vim2048-finish] 39 | 40 | Reference: https://github.com/Gabirel/Hack-SpaceVim/issues/24[#24] 41 | 42 | ''''' 43 | 44 | link:../FAQ.adoc#faq[FAQ] | 45 | link:../../README.adoc#table-of-contents[Index] | 46 | link:../../README_zh_CN.adoc#hack-spacevim[中文文档] -------------------------------------------------------------------------------- /en_US/installation/installation-for-linux.adoc: -------------------------------------------------------------------------------- 1 | = Install SpaceVim on Linux 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title: 6 | 7 | == Install prerequisites 8 | 9 | === Install online prerequisites 10 | 11 | * git: For downloading and updating plugins of SpaceVim 12 | * lua: For neocomplete 13 | * python2/3: Support job and part of plugins. Recommend to install both 14 | * vim/gvim: Vim’s program 15 | * https://github.com/powerline/fonts/tree/master/DejaVuSansMono[DejaVu Sans Mono for PowerLine]: Used by the plugins of SpaceVim 16 | 17 | === Install offline prerequisites 18 | 19 | * git: For downloading and updating plugins of SpaceVim 20 | * lua: For neocomplete 21 | * python2/3: Support job and part of plugins. Recommend to install both 22 | * vim/gvim: Vim’s program 23 | * https://github.com/powerline/fonts/tree/master/DejaVuSansMono[DejaVu Sans Mono for PowerLine]: Used by the plugins of SpaceVim 24 | * https://github.com/Gabirel/Hack-SpaceVim/releases[Offline plugins package]: All plugins used by SpaceVim 25 | * https://gitlab.com/SpaceVim/SpaceVim[SpaceVim] 26 | 27 | == Start to install 28 | 29 | === Install online 30 | 31 | ==== Check prerequisites 32 | 33 | [arabic] 34 | . git –version 35 | 36 | The correct result✅： > git version 2.12.2 37 | 38 | [arabic, start=2] 39 | . lua -v 40 | 41 | The correct result✅： > Lua 5.3.4 Copyright (C) 1994-2017 Lua.org, PUC-Rio 42 | 43 | _Notice: Different Operating system may has different names of lua. For example, `lua` or `lua53` or `lua52`._ 44 | 45 | [arabic, start=3] 46 | . python -V 47 | 48 | The correct result✅： > Python 3.6.0 49 | 50 | [arabic, start=4] 51 | . vim 52 | 53 | The correct result✅： > You can see vim in your terminal 54 | 55 | *Notice: You have to install them by corresponding package manager. For expample:* 56 | 57 | * Debian/Ubuntu: 58 | + 59 | ____ 60 | sudo apt-get install git 61 | ____ 62 | * Fedora: 63 | + 64 | ____ 65 | sudo dnf install git 66 | ____ 67 | * CentOS/RHEL: 68 | + 69 | ____ 70 | sudo yum install git 71 | ____ 72 | * Arch 73 | + 74 | ____ 75 | sudo pacman -S git 76 | ____ 77 | 78 | ==== Start to install 79 | 80 | [arabic] 81 | . Back up your own `.vimrc`. Just in case you don’t like SpaceVim 82 | . Execute: `curl -sLf https://spacevim.org/install.sh | bash` 83 | . Launch: vim 84 | 85 | *After finishing downloading plugins, you installed SpaceVim successfully!* 86 | 87 | [arabic, start=4] 88 | . Check whether your vim has +Lua and +python feature. Use `vim --version | grep -E 'lua|python'` to check out: 89 | 90 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/8bdd0d9f30a0f22e68ce8e3a2f1c2888a37c3cff/linux-check-lua-python.png[linux-check-lua-python] 91 | 92 | *Notice: If your vim doesn’t have `+lua` and `+python` support, please install vim that has them or build vim from source.* 93 | 94 | [arabic, start=5] 95 | . Check whether your Lua and python2/3 really works by tow command: `echo has('lua')`, `echo has('python3')` and `echo has('python2')` 96 | * Lua returns: 1 97 | * Python returns: 1 98 | * Python3 returns: 1 99 | 100 | *Notice: `echo has('python2') and`echo has(`python3')`, both of them could return`1`instead of returning`0`.* 101 | 102 | [arabic, start=6] 103 | . Install fonts, download fonts *in advance*: https://github.com/powerline/fonts/tree/master/DejaVuSansMono[DejaVu Sans Mono for PowerLine.ttf]. 104 | 105 | === Install offline 106 | 107 | ==== Check prerequisites 108 | 109 | List is the same as link:#check-prerequisites[Install online: Check prerequisites]. So I won’t repeat it: 110 | 111 | * git 112 | * lua 113 | * python(2/3) 114 | * vim/gvim 115 | 116 | ==== Start to install 117 | 118 | Things are getting easier in SpaceVim-v0.9.0-dev. Yes, you can install SpaceVim without any Internet connection. 119 | 120 | Try it! 121 | 122 | [arabic] 123 | . Download the release: https://github.com/Gabirel/Hack-SpaceVim/releases 124 | . Extract the package to: 125 | 126 | ____ 127 | ~ 128 | ____ 129 | 130 | [arabic, start=3] 131 | . Link the folder to vim: 132 | 133 | [source,bash] 134 | ---- 135 | mkdir .vim 136 | ln -svf ~/.SpaceVim/* ~/.vim/ 137 | ---- 138 | 139 | [arabic, start=4] 140 | . Open vim in your terminal and try it. 141 | 142 | *Congratulations! Install offline successfully!* 143 | 144 | ==== How can I update offline if I have no connection to the Internet? 145 | 146 | As https://github.com/TamaMcGlinn[@TamaMcGlinn] mentions, https://git-scm.com/docs/git-bundle[`git bundle`] is suitable for incremental updates for plugins. 147 | 148 | In this way, you don’t have to copy the whole plugins via *USB* or *internal email*. 149 | 150 | Unfortunately, for all those plugins with `git bundle` method, you have to write scripts in order to incrementally update or load changes. 151 | 152 | More details: https://github.com/Gabirel/Hack-SpaceVim/issues/12#issuecomment-654206784[Instructions For Installing SpaceVim - OFFLINE] 153 | 154 | ''''' 155 | 156 | link:installation-for-windows.adoc#install-spacevim-on-windows[Instructions for Windows] | 157 | link:../FAQ.adoc#faq[FAQ] | 158 | link:../README.adoc#table-of-contents[Index] | 159 | link:../../README_zh_CN.adoc#hack-spacevim[中文文档] 160 | -------------------------------------------------------------------------------- /en_US/installation/installation-for-windows.adoc: -------------------------------------------------------------------------------- 1 | = Install SpaceVim on Windows 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title: 6 | 7 | == Install prerequisites 8 | 9 | === Install online prerequisites 10 | 11 | * https://git-scm.com/download[git]: For downloading and updating plugins of SpaceVim 12 | * http://luabinaries.sourceforge.net/download.html[lua]: For neocomplete 13 | * https://www.python.org/downloads[python(2/3)]: Support job and part of plugins. Recommend to install both 14 | * https://github.com/vim/vim-win32-installer/releases[gvim]: Vim’s main program 15 | * https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine]: Used by the plugins of SpaceVim 16 | * https://github.com/Shougo/vimproc.vim/releases[vimproc_win64(32).dll]: vimporc needs this, *NECESSARY* 17 | * https://www.dllme.com/dll/download/29939/vcruntime140.dll[vcruntime140.dll]: Fix vimruntime140 Error(download it when you really need) 18 | 19 | === Install offline prerequisites 20 | 21 | * https://git-scm.com/download[git]: For downloading and updating plugins of SpaceVim 22 | * http://luabinaries.sourceforge.net/download.html[lua]: For neocomplete 23 | * https://www.python.org/downloads[python(2/3)]: Support job and part of plugins. Recommend to install both 24 | * https://github.com/vim/vim-win32-installer/releases[gvim]: Vim’s main program 25 | * https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine]: Used by the plugins of SpaceVim 26 | * https://github.com/Shougo/vimproc.vim/releases[vimproc_win64(32).dll]: vimporc needs this, *NECESSARY* 27 | * https://www.dllme.com/dll/download/29939/vcruntime140.dll[vcruntime140.dll]: Fix vimruntime140 Error(download it when you really need) 28 | * https://github.com/Gabirel/Hack-SpaceVim/releases[Plugins Offline package]: All plugins of SpaceVim（*Recommend packing it by yourself*） 29 | * https://gitlab.com/SpaceVim/SpaceVim.git[SpaceVim] 30 | 31 | == Start to install 32 | 33 | === Install online 34 | 35 | ==== Check prerequisites 36 | 37 | [arabic] 38 | . git –version 39 | 40 | The correct result✅： > git version 2.12.2.windows.2 41 | 42 | [arabic, start=2] 43 | . lua53 -v 44 | 45 | The correct result✅： > Lua 5.3.3 Copyright (C) 1994-2016 Lua.org, PUC-Rio 46 | 47 | [arabic, start=3] 48 | . python -V 49 | 50 | The correct result✅： > Python 3.6.1 51 | 52 | [arabic, start=4] 53 | . gvim 54 | 55 | The correct result✅： > Opened a program 56 | 57 | **Notice：If you happen to command not find, please install them correctly and set up your path correctly. See how to set up your path:**link:../FAQ.adoc#set-up-your-path[FAQ-Set up your PATH] 58 | 59 | ==== Start to install 60 | 61 | [arabic] 62 | . git clone https://gitlab.com/SpaceVim/SpaceVim.git vimfiles 63 | . Double-click Gvim’s icon, or open a new `cmd.exe` and execute `gvim`. Normally it should open a new terminal to clone `dein.vim`. As it shows below: 64 | 65 | image:https://gist.githubusercontent.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/2ac0304f46db1c6470f8f4982296d08875de2894/clone-dein.vim.PNG[dein.vim-clone] 66 | 67 | [arabic, start=3] 68 | . SpaceVim will trigger downloading plugins mode(SpaceVim-v0.3.0 is so that). Wait to finish downloading plugins. 69 | 70 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/a6de44e130d2c5ec1dec28601b8d952c8231f0a0/download-plugins.PNG[download-plugins] 71 | 72 | [arabic, start=4] 73 | . Check whether your vim has `+Lua` and `+python` feature. Use `:version` to check out: 74 | 75 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/1711e0d2ca9e22d8e3b4942498b0a77f9b25dd2c/vim-version-check.PNG[vim-version] 76 | 77 | [arabic, start=5] 78 | . Check whether your Lua and python2/3 really works by tow command: `echo has('lua')`, `echo has('python3')` and `echo has('python2')` 79 | * Lua returns: 1 80 | * Python returns: 1 81 | * Python3 returns: 1 82 | 83 | *Notice: `echo has('python2') and`echo has(`python3')`, only one of them returns`1`instead of returning`0` at the same time. This depends on vim.* 84 | 85 | If `echo has('python2/3')` returns 0 both, check this: link:../FAQ.adoc#without-python-support[FAQ: Without-python-support] 86 | 87 | [arabic, start=6] 88 | . Install fonts, download fonts: https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine.ttf]. 89 | 90 | After finishing installing fonts, your status bar should work very well. 91 | 92 | [arabic, start=7] 93 | . Fix `vimproc.dll error`. As it shows below: 94 | 95 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/e7f27e84947f13bc9c91812881e47f2961162fc2/vimproc-dll-error.PNG[vimproc-dll] 96 | 97 | https://github.com/Shougo/vimproc.vim/releases[Click me to download]. Copy it to: `C:\Users\\.cache\vimfiles\repos\github.com\Shougo\vimproc.vim\lib` 98 | 99 | *Congratulations. You’are done!* 100 | 101 | === Install offline 102 | 103 | ==== Check prerequisites 104 | 105 | List is the same as link:#check-prerequisites[Install online: Check prerequisites]. So I won’t repeat it: 106 | 107 | * git 108 | * lua 109 | * python(2/3) 110 | * gvim 111 | 112 | ==== Start to install 113 | 114 | Still this part has the same introductions in link:#start-to-install-1[Install online: Start to install]. I will skip the same part. Only explain at different parts. 115 | 116 | [arabic] 117 | . git clone https://gitlab.com/SpaceVim/SpaceVim.git vimfiles 118 | . Extract the package to: 119 | 120 | ____ 121 | C: 122 | ____ 123 | 124 | dein.vim is the plugins manager of SpaceVim. It is downloaded automatically by starting gvim the first time. So you have to download it in advance. 125 | 126 | *Notice: You could download the offline package. But we HIGHLY RECOMMEND packing it up by yourself to make sure that all plugins is up-to-date to make you more powerful.* 127 | 128 | *For newbie: zip your `~/.cache/vimfiles` to packing SpaceVim* 129 | 130 | [arabic, start=3] 131 | . Open gvim to check out whether SpaceVim could start without any errors. 132 | 133 | *Notice: Please make sure that vimproc_dll exists if you are using your own package.* 134 | 135 | If you have `vimproc's dll`, please fix this according to the manual of link:#start-to-install-1[Install online: Start to install]. 136 | 137 | [arabic, start=4] 138 | . Check whether gvim has lua and python’s full support, these steps are the same as link:#start-to-install-1[Install online: Start to install] 139 | . Install fonts, download fonts *in advance*: https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine.ttf]. 140 | 141 | After finishing installing fonts, the status bar should work very well. 142 | 143 | *Congratulations! Install offline successfully!* 144 | 145 | ==== How can I update offline if I have no connection to the Internet? 146 | 147 | As [@TamaMcGlinn](https://github.com/TamaMcGlinn) mentions, https://git-scm.com/docs/git-bundle[`git bundle`] is suitable for incremental updates for plugins. 148 | 149 | In this way, you don’t have to copy the whole plugins via *USB* or *internal email*. 150 | 151 | Unfortunately, for all those plugins with `git bundle` method, you have to write scripts in order to incrementally update or load changes. 152 | 153 | More details: https://github.com/Gabirel/Hack-SpaceVim/issues/12#issuecomment-654206784[Instructions For Installing SpaceVim - OFFLINE] 154 | 155 | == Install Neovim 156 | 157 | *Notice: You’ve entered the taboo areas.* 158 | 159 | ____ 160 | The sea of suffering is boundless; yet a turn of the gear is the other shore. 161 | ____ 162 | 163 | _Let’s go back to our shore [@wsdjeg]https://github.com/wsdjeg[wsdjeg] |:(_ 164 | 165 | [arabic] 166 | . According to your own OS, select your version of https://github.com/neovim/neovim/wiki/Installing-Neovim#windows[Neovim] 167 | . Add Neovim’s `bin` folder to your `PATH` 168 | . Execute neovim 169 | . If you are missing `vcruntime140.dll`, please https://www.dllme.com/dll/download/29939/vcruntime140.dll[click me to download] 170 | . Install python2/python3 or both, which is allowed by Neovim 171 | . Install full support of python of neovim: 172 | 173 | * python2: 174 | 175 | ____ 176 | py -2 pip install –user –upgrade neovim 177 | ____ 178 | 179 | * python3: 180 | 181 | ____ 182 | py -3 pip install –user –upgrade neovim 183 | ____ 184 | 185 | [arabic, start=7] 186 | . Execute neovim-qt.exe, and use `:CheckHealth` to check out whether your neovim supports python2/3. As results shows below: 187 | 188 | With python2 support: image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/5aff57c9397cd26dba23dd0d81b94fa9cf061b56/nvim-python2-support-success.PNG[nvim-python2-support-success] 189 | 190 | Without python3 support: image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/5aff57c9397cd26dba23dd0d81b94fa9cf061b56/nvim-python3-support-failure.PNG[nvim-python3-support-failure] 191 | 192 | If you want to have python3 support, please install it according to step 6; Also, use commands suggested by neovim to have ruby support. 193 | 194 | [arabic, start=8] 195 | . Install SpaceVim 196 | 197 | ____ 198 | git clone https://gitlab.com/SpaceVim/SpaceVim.git %userprofile% + 199 | ____ 200 | 201 | *Congratulations! You’ve installed it successfully.* 202 | 203 | *Notice: Neovim doesn’t support lua(For now) in neovim-v0.2. So, SpaceVim uses deopelete for auto-completing code instead of neocomplete.* 204 | 205 | ''''' 206 | 207 | link:installation-for-linux.adoc#install-spacevim-on-linux[Instructions for Linux] | 208 | link:../FAQ.adoc#faq[FAQ] | 209 | link:../README.adoc#table-of-contents[Index] | 210 | link:../../README_zh_CN.adoc#hack-spacevim[中文文档] -------------------------------------------------------------------------------- /zh_CN/FAQ.adoc: -------------------------------------------------------------------------------- 1 | = 常见问题 2 | :sectnums: 3 | :toc: 4 | :toclevels: 3 5 | :toc-title: 6 | 7 | == 通用 8 | 9 | === 改变 layer 的选项 10 | 11 | *1. 我想要通过 `init.vim` 来改变 shell 选项。我该怎么做？* 12 | 13 | _问题来源: https://github.com/Gabirel/Hack-SpaceVim/issues/51[Hack-SpaceVim#51@ViiEx]_ 14 | 15 | A: *关键思想* 是覆写那些被默认载入的选项（或者变量）。 16 | 17 | 例如，当我使用 SpaceVim 的时候，改变其 shell 的默认高度以及默认打开方向。 18 | 19 | 那么就将下面的代码加入到 `init.vim` 中即可： 20 | 21 | [source,viml] 22 | ---- 23 | call SpaceVim#layers#load('shell') 24 | 25 | " 这个 call 函数必须在 `call SpaceVim#layers#load('shell')` 的下面 26 | " 否则，我们加载的选项就会被覆盖掉，导致失效 27 | call SpaceVim#layers#load('shell', 28 | \ { 29 | \ 'default_position' : 'bottom', 30 | \ 'default_height' : 100, 31 | \ } 32 | \ ) 33 | ---- 34 | 35 | Demo: 36 | 37 | image:https://user-images.githubusercontent.com/12933851/172159423-9ec89e15-d5e9-408a-b554-12e787d52949.png[demo] 38 | 39 | == Windows 40 | 41 | === 配置环境变量 42 | 43 | *1. 如何配置环境变量？* 44 | 45 | A: _位置：此电脑->属性->高级系统设置->环境变量->系统变量->找到Path->编辑_ 46 | 47 | image:https://gist.githubusercontent.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/08946a3643606420776fcc3fc4d43da6444806cc/path-config.PNG[path] 48 | 49 | === python不支持 50 | 51 | *2. `echo has('python')`返回值均为0，我该怎么办？* 52 | 53 | A: 请检查是否满足以下条件： 54 | 55 | * 在cmd.exe中，查看python命令是否存在 56 | * vim是64位，python就必须安装64位；反之亦然 57 | * vim必须要有`+python/dyn`或`+python3/dyn`或者`+python/dyn;+python3/dyn` 58 | * 如果上述条件均满足仍未支持python，请在你的`init.vim`中以下内容进行配置： 59 | 60 | 首先，你得知道你的python版本具体是多少。 61 | 62 | 以下是测试命令： 63 | 64 | ____ 65 | py -2 –version 66 | ____ 67 | 68 | ____ 69 | py -3 –version 70 | ____ 71 | 72 | 根据你的python版本，添加以下配置： 73 | 74 | [source,viml] 75 | ---- 76 | set pythonthreedll=python36.dll 77 | set pythondll=python27.dll 78 | ---- 79 | 80 | *更多细节: https://github.com/Gabirel/Hack-SpaceVim/issues/17[#17]* 81 | 82 | === SpaceVim卡顿 83 | 84 | *3. 我觉得SpaceVim用起来有点卡顿，怎么回事？* 85 | 86 | A: 目前有以下可能性： 87 | 88 | * 查看你的Lua本地是否支持，vim是否有+lua支持，如果没有lua支持，neocomplete就不会其作用，而是neocomplcache，这就会造成你的卡顿 89 | * 你所使用的SpaceVim有功能性的bug，可以尝试使用SpaceVim的link:https://gitlab.com/SpaceVim/SpaceVim/issues[issue tracker]来帮助你解决 90 | * 你的配置文件可能不恰当，导致占用了大量的内存和磁盘使用。譬如，nodejs里使用ternjs时候对于`loadEagerly`赋值为`**/*.js`就会造成这种现象 91 | * 某一个插件的bug或者某一个插件和另一个插件产生了冲突，若你怀疑有这种现象，请在link:https://gitlab.com/SpaceVim/SpaceVim/issues[issue tracker]提交来修复该问题 92 | 93 | === vcruntime140.dll错误 94 | 95 | *4. 我运行gvim后无法启动，报缺少vcruntime140.dll的错误，我该怎么解决？* 96 | 97 | A: https://www.dllme.com/dll/download/29939/vcruntime140.dll[点我下载]，根据自己的操作系统类型选择相应的文件夹： 98 | 99 | 32位系统位置：`C:\Windows\System32\` 100 | 101 | 64位系统位置：`C:\Windows\SysWOW64\` 102 | 103 | === Windows上安装繁琐 104 | 105 | *5. 为什么Windows上安装SpaceVim如此麻烦？有更加简单的步骤吗？* 106 | 107 | A: 抱歉！没有！Windows搭建开发环境真的是很麻烦，很不友好，完全不建议在Windows上安装；若安装，请不要去碰Neovim，这是一个禁忌领域！请为了自己的身心健康，请安装Vim 108 | 109 | === Exuberant ctags未找到 110 | 111 | *6. Tagbar: Exuberant ctags未找到？我该怎么办？* 112 | 113 | 正如这里所示： image:https://cloud.githubusercontent.com/assets/12933851/25282302/a868f3e0-26e2-11e7-8cfb-037f884a4702.png[ctags-error] 114 | 115 | A: 116 | 117 | [arabic] 118 | . 你应该去这里下载： https://github.com/universal-ctags/ctags#windows 119 | . 把你的二进制目录加到你的环境变量里 120 | 121 | 我的环境变量是：`C:\Program Files\ctagas\ctags.exe` 122 | 123 | [arabic, start=3] 124 | . 根据你自身的情况，添加以下配置： 125 | 126 | [source,viml] 127 | ---- 128 | let g:tagbar_ctags_bin = 'C:\Program Files\ctagas\ctags.exe' 129 | ---- 130 | 131 | == Linux 132 | 133 | === 从源码安装vim 134 | 135 | 一些发行版本可能没有最新版本的vim，仍然用的是vim7.4之类的。所以部分人不得已只能从源码安装vim。 136 | 137 | 这部分就是为了从源码安装vim： 138 | 139 | 请去这里: https://github.com/Valloric/YouCompleteMe/wiki/Building-Vim-from-source[从源码安装vim] 140 | 141 | === Exuberant ctags未找到 142 | 143 | *1. Tagbar: Exuberant ctags未找到？我该怎么办？* 144 | 145 | A: 146 | 147 | Arch/Manjaro 148 | 149 | ____ 150 | sudo pacman -S ctags 151 | ____ 152 | 153 | Debian/Ubuntu/Linux Mint 154 | 155 | ____ 156 | sudo apt-get install ctags 157 | ____ 158 | 159 | Fedora 160 | 161 | ____ 162 | sudo dnf install ctags 163 | ____ 164 | 165 | CentOS/RHEL 166 | 167 | ____ 168 | sudo yum install ctags 169 | ____ 170 | 171 | ''''' 172 | 173 | link:README.adoc#table-of-contents[索引] | 174 | link:../README.adoc#hack-spacevim[English Document] 175 | -------------------------------------------------------------------------------- /zh_CN/IDE/C.adoc: -------------------------------------------------------------------------------- 1 | This page is for C IDE, but not finished yet -------------------------------------------------------------------------------- /zh_CN/IDE/JavaScript.adoc: -------------------------------------------------------------------------------- 1 | = IDE for JavaScript 2 | :sectnums: 3 | :toc: 4 | :toclevels: 3 5 | :toc-title: 6 | 7 | == 基本要求 8 | 9 | * SpaceVim 10 | * tern 11 | * tern_for_vim 12 | * nodejs 13 | * npm/cnpm 14 | 15 | == 安装 16 | 17 | === SpaceVim 18 | 19 | 请确认你的SpaceVim是最新的。 20 | 21 | === 安装 `npm` 或 `cnpm` 22 | 23 | 对于国内的环境来说，建议使用`cnpm`的环境。 以下是几个安装例子： 24 | 25 | *Arch:* > sudo pacman -S npm nodejs 26 | 27 | *Fedora:* > sudo dnf install npm nodejs 28 | 29 | *Ubuntu:* > sudo apt install npm nodejs 30 | 31 | === 安装 `tern` 32 | 33 | 你必须要安装tern，因为https://github.com/ternjs/tern_for_vim[tern_for_vim]是使用http://ternjs.net/[tern] 来作为自动补全的后端代码的。 （如果我错了，请告诉我。我并不是写nodejs或者前端的高手，这方面不是我的完全领域。） 34 | 35 | 通过以下命令安装： > cd ~/.cache/vimfiles/repos/github.com/ternjs/tern_for_vim > npm install tern 36 | 37 | *或者* 38 | 39 | ____ 40 | cnpm install tern 41 | ____ 42 | 43 | _注意: 如果你要使用`cnpm`来安装tern，请先安装 `cnpm`._ 44 | 45 | === 将配置加到 `~/.SpaceVim.d/init.vim` 46 | 47 | [source,viml] 48 | ---- 49 | call SpaceVim#layers#load('lang#javascript') 50 | ---- 51 | 52 | 并且重启vim，让SpaceVim自己会你安装插件。 53 | 54 | _如果SpaceVim花了很久的时间来安装`tern_for_vim`，请通过以下三步进行手动安装：_ 55 | 56 | ____ 57 | $ cd ~/.cache/vimfiles/repos/github.com/ternjs $ git clone https://github.com/ternjs/tern_for_vim $ cd tern_for_vim; npm install 58 | ____ 59 | 60 | == 配置 61 | 62 | 最重要的一步是怎么配置你的环境。 63 | 64 | 官方文档是我见过写的最差的文档，特别烦人，说白了，就两点要注意： 65 | 66 | 对于大部分人来说，主要有两种情况： 67 | 68 | * 情况一: `.tern-project`（改文件是在当前或者是在当前文件夹上层里，*只适用于当前的工程文件*) 69 | * 情况二: `.tern-config`(**默认**存在你的家目录下) 70 | 71 | *更多细节见 http://ternjs.net/doc/manual.html#server[这里]* 72 | 73 | 以下是示例，仅供参考： 74 | 75 | [source,json] 76 | ---- 77 | { 78 | "plugins": { 79 | "node": {}, 80 | "node_resolve": {}, 81 | "es_modules": {}, 82 | "modules": {} 83 | }, 84 | "libs": [ 85 | "browser", 86 | "ecma5", 87 | "ecma6", 88 | "react" 89 | ], 90 | "ecmaVersion": 6 91 | } 92 | ---- 93 | 94 | *Okay，完了！！简单吧* 95 | 96 | == 感谢 97 | 98 | 很感谢 https://github.com/renchunhui[@RenChunhui] 无私的帮助，要是没有TA的帮助，我肯定无法完成这个。因为这个tern真的很让人头疼。 99 | 100 | ''''' 101 | 102 | link:../IDE[IDE] | 103 | link:../FAQ.adoc#faq[FAQ] | 104 | link:../README.adoc#table-of-contents[Index] | 105 | link:../../README.adoc#hack-spacevim[English Document] 106 | -------------------------------------------------------------------------------- /zh_CN/README.adoc: -------------------------------------------------------------------------------- 1 | == Table of Contents 2 | 3 | [arabic] 4 | . link:installation/installation-for-windows.md[在Windows上的SpaceVim] 5 | * link:installation/installation-for-windows.adoc#在windows上安装spacevim[在Windows上安装SpaceVim] 6 | * link:installation/installation-for-windows.adoc#table-of-contents[Table of Contents] 7 | ** link:installation/installation-for-windows.adoc#基础环境[基础环境] 8 | ** link:installation/installation-for-windows.adoc#开始安装[开始安装] 9 | *** link:installation/installation-for-windows.adoc#在线安装[在线安装] 10 | *** link:installation/installation-for-windows.adoc#离线安装[离线安装] 11 | ** link:installation/installation-for-windows.adoc#安装neovim[安装Neovim] 12 | . link:installation/installation-for-linux.md[在Linux上的SpaceVim] 13 | * link:installation/installation-for-linux.adoc#在linux上安装spacevim[在Linux上安装SpaceVim] 14 | * link:installation/installation-for-linux.adoc#table-of-contents[Table of Contents] 15 | ** link:installation/installation-for-linux.adoc#安装依赖[安装依赖] 16 | ** link:installation/installation-for-linux.adoc#开始安装[开始安装] 17 | *** link:installation/installation-for-linux.adoc##在线安装[在线安装] 18 | *** link:installation/installation-for-linux.adoc#离线安装[离线安装] 19 | . IDE 20 | * link:IDE/JavaScript.adoc#ide-for-javascript[IDE for JavaScript] 21 | * link:zh_CN/IDE/JavaScript.adoc#table-of-contents[Table of Contents] 22 | ** link:IDE/JavaScript.adoc#基本要求[基本要求] 23 | ** link:IDE/JavaScript.adoc#安装[安装] 24 | *** link:IDE/JavaScript.adoc#spacevim[SpaceVim] 25 | *** link:IDE/JavaScript.adoc#安装-npm-或-cnpm[安装npm或cnpm] 26 | *** link:IDE/JavaScript.adoc#安装-tern[安装tern] 27 | *** link:IDE/JavaScript.adoc#将配置加到-spacevimdinitvim[将配置加到~/.SpaceVim.d/init.vim] 28 | ** link:IDE/JavaScript.adoc#配置[配置] 29 | ** link:IDE/JavaScript.adoc#感谢[感谢] 30 | . link:FAQ.adoc#常见问题[常见问题] 31 | * link:FAQ.adoc#通用[通用] 32 | ** link:FAQ.adoc#改变-layer-的选项[改变 layer 的选项] 33 | * link:FAQ.adoc#windows[Windows] 34 | ** link:FAQ.adoc#配置环境变量[配置环境变量] 35 | ** link:FAQ.adoc#python不支持[python不支持] 36 | ** link:FAQ.adoc#spacevim卡顿[SpaceVim卡顿] 37 | ** link:FAQ.adoc#vcruntime140dll错误[vcruntime140.dll错误] 38 | ** link:FAQ.adoc#windows上安装繁琐[Windows上安装繁琐] 39 | ** link:FAQ.adoc#exuberant-ctags未找到[Exuberant ctags未找到] 40 | * link:FAQ.adoc#linux[Linux] 41 | ** link:FAQ.adoc#从源码安装vim[从源码安装vim] 42 | ** link:FAQ.adoc#exuberant-ctags未找到-1[Exuberant ctags未找到] 43 | . link:hidden_Egg_Hunt[寻觅彩蛋] 44 | * link:hidden_Egg_Hunt/play-games.adoc#在spacevim上玩游戏[在SpaceVim上玩游戏] 45 | ** link:hidden_Egg_Hunt/play-games.adoc#游戏列表[游戏列表] 46 | ** link:hidden_Egg_Hunt/play-games.adoc#vim2048[Vim2048] 47 | *** link:hidden_Egg_Hunt/play-games.adoc#安装[安装] 48 | -------------------------------------------------------------------------------- /zh_CN/hidden_Egg_Hunt/play-games.adoc: -------------------------------------------------------------------------------- 1 | = 在SpaceVim上玩游戏 2 | :sectnums: 3 | :toc: 4 | :toclevels: 3 5 | :toc-title: 6 | 7 | == 游戏列表 8 | 9 | * vim2048 10 | 11 | == Vim2048 12 | 13 | === 安装 14 | 15 | [arabic] 16 | . 把以下配置加入到：`~/.SpaceVim.d/init.vim` 17 | 18 | [source,viml] 19 | ---- 20 | call SpaceVim#layers#load('games') 21 | ---- 22 | 23 | [arabic, start=2] 24 | . 打开你的vim/neovim，然后你应该会看到这个： 25 | 26 | image:https://cloud.githubusercontent.com/assets/12933851/25666818/33f2b91c-3054-11e7-89e4-2ffdcb6efb35.png[vim2048-install] 27 | 28 | [arabic, start=3] 29 | . 重启vim，然后按下` g 2`: 30 | 31 | image:https://cloud.githubusercontent.com/assets/12933851/25666850/51a9faa6-3054-11e7-9807-172841f3721b.png[vim2048-space] 32 | 33 | image:https://cloud.githubusercontent.com/assets/12933851/25666978/a75640d6-3054-11e7-9bc1-97e234460074.png[vim2048-space-g] 34 | 35 | [arabic, start=4] 36 | . 完成！ 37 | 38 | image:https://cloud.githubusercontent.com/assets/12933851/25666993/b10681cc-3054-11e7-9872-b0889f7caa6f.png[vim2048-finish] 39 | 40 | 参考: https://github.com/Gabirel/Hack-SpaceVim/issues/24[#24] 41 | 42 | ''''' 43 | 44 | link:../FAQ.adoc#常见问题[常见问题] | 45 | link:../../README.adoc#table-of-contents[索引] | 46 | link:../../../README.adoc#hack-spacevim[English Document] -------------------------------------------------------------------------------- /zh_CN/installation/installation-for-linux.adoc: -------------------------------------------------------------------------------- 1 | = 在Linux上安装SpaceVim 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title: 6 | 7 | == 安装依赖 8 | 9 | === 在线安装依赖 10 | 11 | * git: 用于下载和更新SpaceVim的插件 12 | * lua: 用于neocomplete补全 13 | * python2/3: 用于job特性和部分插件。推荐都安装 14 | * vim/gvim: Vim主要程序 15 | * https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine]: 用于SpaceVim的插件 16 | 17 | === 离线安装依赖 18 | 19 | * git: 用于下载和更新SpaceVim的插件 20 | * lua: 用于neocomplete补全 21 | * python2/3: 用于job特性和部分插件。推荐都安装 22 | * vim/gvim: Vim主要程序 23 | * https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine]: 用于SpaceVim的插件 24 | * https://github.com/Gabirel/Hack-SpaceVim/releases[Offline plugins package]: SpaceVim的插件 25 | * https://gitlab.com/SpaceVim/SpaceVim[SpaceVim] 26 | 27 | == 开始安装 28 | 29 | === 在线安装 30 | 31 | ==== 检查依赖 32 | 33 | [arabic] 34 | . git –version 35 | 36 | 正确结果✅： > git version 2.12.2 37 | 38 | [arabic, start=2] 39 | . lua -v 40 | 41 | 正确结果✅： > Lua 5.3.4 Copyright (C) 1994-2017 Lua.org, PUC-Rio 42 | 43 | *注意：不同的操作系统lua执行命令也不同。例如，`lua`，`lua52`, `lua53`等。** 44 | 45 | [arabic, start=3] 46 | . python -V 47 | 48 | 正确结果✅： > Python 3.6.0 49 | 50 | [arabic, start=4] 51 | . vim 52 | 53 | 正确结果✅： > You can see vim in your terminal 54 | 55 | *注意：你必须要通过相应的软件包管理器来安装它们。例如：* 56 | 57 | * Debian/Ubuntu: 58 | + 59 | ____ 60 | sudo apt-get install git 61 | ____ 62 | * Fedora: 63 | + 64 | ____ 65 | sudo dnf install git 66 | ____ 67 | * CentOS/RHEL: 68 | + 69 | ____ 70 | sudo yum install git 71 | ____ 72 | * Arch 73 | + 74 | ____ 75 | sudo pacman -S git 76 | ____ 77 | 78 | ==== 开始安装 79 | 80 | [arabic] 81 | . 备份你自己的`vimrc`，以防你不喜欢SpaceVim。 82 | . 执行：`curl -sLf https://spacevim.org/install.sh | bash` 83 | . 在终端中执行：`vim` 84 | 85 | *在完成下载插件后，你就完成安装SpaceVim了。* 86 | 87 | [arabic, start=4] 88 | . 检查你的vim是否有`+lua`和`+python`支持。用命令：`vim --version | grep -E 'lua|python'`： 89 | 90 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/8bdd0d9f30a0f22e68ce8e3a2f1c2888a37c3cff/linux-check-lua-python.png[linux-check-lua-python] 91 | 92 | *注意：如果你的vim没有`+lua`和`+python`支持，请重新安装有lua和python支持的vim，或者从源码安装。* 93 | 94 | [arabic, start=5] 95 | . 检查你是否真的有lua和python2/3支持，通过两个命令： `echo has('lua')`，`echo has('python2')`和`echo has('python3')` 96 | * Lua 返回: 1 97 | * Python 返回: 1 98 | * Python3 返回: 1 99 | 100 | *注意：`echo has('python2') 和`echo has(`python3')`，所有的都可以返回1。* 101 | 102 | [arabic, start=6] 103 | . 安装字体，请**提前**下载好字体： https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine.ttf]. 104 | 105 | === 离线安装 106 | 107 | ==== 检查依赖 108 | 109 | 以下检查项同link:#在线安装[在线安装]相同，故不再赘述： 110 | 111 | * git 112 | * lua 113 | * python(2/3) 114 | * vim/gvim 115 | 116 | ==== 开始安装 117 | 118 | 离线安装在SpaceVim-v0.9.0-dev中已经变得很简单。是的，你现在可以非常简单地安装SpaceVim而且不需要任何英特网连接。 119 | 120 | 来试试吧！ 121 | 122 | [arabic] 123 | . 从release界面下载： https://github.com/Gabirel/Hack-SpaceVim/releases 124 | . 解压到： 125 | 126 | ____ 127 | ~ 128 | ____ 129 | 130 | [arabic, start=3] 131 | . 链接到SpaceVim代码到vim中： 132 | 133 | [source,bash] 134 | ---- 135 | mkdir .vim 136 | ln -svf ~/.SpaceVim/* ~/.vim/ 137 | ---- 138 | 139 | [arabic, start=4] 140 | . 打开终端尝试吧！ 141 | 142 | *恭喜！离线安装已完成！* 143 | 144 | ==== 离线状态如何更新？ 145 | 146 | https://github.com/TamaMcGlinn[@TamaMcGlinn] 提出了使用 https://git-scm.com/docs/git-bundle[`git bundle`] 想法。这个想法十分适合插件的增量更新。 147 | 148 | 这样一来，你就不需要通过**U盘**或者**内部邮件**的方式来进行全量拷贝。 149 | 150 | 不过，不幸的是，目前为止使用这种增量更新的方式，你必须要写脚本来达到你的增量更新的目的。官方并没有提供相关的操作。 151 | 152 | 具体的细节请看： https://github.com/Gabirel/Hack-SpaceVim/issues/12#issuecomment-654206784[Instructions For Installing SpaceVim - OFFLINE] 153 | 154 | ''''' 155 | 156 | link:installation-for-windows.adoc#在windows上安装spacevim[Windows指南] | 157 | link:../FAQ.adoc#faq[常见问题] | 158 | link:../README.adoc#table-of-contents[索引] | 159 | link:../../README.adoc#hack-spacevim[English Document] 160 | -------------------------------------------------------------------------------- /zh_CN/installation/installation-for-windows.adoc: -------------------------------------------------------------------------------- 1 | = 在Windows上安装SpaceVim 2 | :sectnums: 3 | :toc: 4 | :toclevels: 4 5 | :toc-title: 6 | 7 | == 基础环境 8 | 9 | === 在线安装基本要求 10 | 11 | * https://git-scm.com/download[git]: 用于下载与更新插件 12 | * http://luabinaries.sourceforge.net/download.html[lua]: 用于neocomplete补全 13 | * https://www.python.org/downloads[python(2/3)]: 用于job与部分插件支持，推荐全部安装 14 | * https://github.com/vim/vim-win32-installer/releases[gvim]: Vim主要程序 15 | * https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine]: SpaceVim的Aireline所需字体 16 | * https://github.com/Shougo/vimproc.vim/releases[vimproc_win64(32).dll]: vimporc插件依赖，*必须* 17 | * https://www.dllme.com/dll/download/29939/vcruntime140.dll[vcruntime140.dll]: 针对vimruntime140 Error（当必要时下载） 18 | 19 | === 离线安装基本要求 20 | 21 | * https://git-scm.com/download[git]: 用于下载与更新插件 22 | * http://luabinaries.sourceforge.net/download.html[lua]: 用于neocomplete补全 23 | * https://www.python.org/downloads[python(2/3)]: 用于job与部分插件支持，推荐全部安装 24 | * https://github.com/vim/vim-win32-installer/releases[gvim]: Vim主要程序 25 | * https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine]: SpaceVim的Airline所需字体 26 | * https://github.com/Shougo/vimproc.vim/releases[vimproc_win64(32).dll]: vimporc插件依赖，*必须* 27 | * https://www.dllme.com/dll/download/29939/vcruntime140.dll[vcruntime140.dll]: 针对vimruntime140 Error（当必要时下载） 28 | * https://github.com/Gabirel/Hack-SpaceVim/releases[插件压缩包]: SpaceVim的插件离线包（*建议自行打包下载*） 29 | * https://gitlab.com/SpaceVim/SpaceVim.git[SpaceVim] 30 | 31 | == 开始安装 32 | 33 | === 在线安装 34 | 35 | ==== 检查基础环境 36 | 37 | [arabic] 38 | . git –version 39 | 40 | 正确结果✅： > git version 2.12.2.windows.2 41 | 42 | [arabic, start=2] 43 | . lua53 -v 44 | 45 | 正确结果✅： > Lua 5.3.3 Copyright (C) 1994-2016 Lua.org, PUC-Rio 46 | 47 | [arabic, start=3] 48 | . python -V 49 | 50 | 正确结果✅： > Python 3.6.1 51 | 52 | [arabic, start=4] 53 | . gvim 54 | 55 | 正确结果✅： > 打开一个窗口 56 | 57 | *注意：如果命令找不到等情况请安装好环境并配置环境变量，如何配置环境变量见：* link:../FAQ.adoc#配置环境变量[常见问题：配置环境变量] 58 | 59 | ==== 正式安装 60 | 61 | [arabic] 62 | . git clone https://gitlab.com/SpaceVim/SpaceVim.git vimfiles 63 | . 双击桌面的gvim图标，或打开cmd.exe后运行gvim，正常情况下会打开一个新的终端克隆`dein.vim`，如图所示： 64 | 65 | image:https://gist.githubusercontent.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/2ac0304f46db1c6470f8f4982296d08875de2894/clone-dein.vim.PNG[dein.vim-clone] 66 | 67 | [arabic, start=3] 68 | . SpaceVim会自动触发下载插件模式(SpaceVim-v0.3.0-dev是如此)，等待完成即可 69 | 70 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/a6de44e130d2c5ec1dec28601b8d952c8231f0a0/download-plugins.PNG[download-plugins] 71 | 72 | [arabic, start=4] 73 | . 检查vim是否有Lua和python(2/3)特性支持，输命令：`:version`以查看： 74 | 75 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/1711e0d2ca9e22d8e3b4942498b0a77f9b25dd2c/vim-version-check.PNG[vim-version] 76 | 77 | [arabic, start=5] 78 | . 检查Lua和python(2/3)支持是否真的在起作用，通过两个命令：`echo has('lua')`，`echo has('python2')`和`echo has('python3')`: 79 | * Lua返回值为：1 80 | * python返回值：1 81 | * python3返回值：1 82 | 83 | *注意：`echo has('python2')`和`echo has('python3')`的值均会返回`1`* 84 | 85 | _若，`echo has('python')`返回值均为0，请查看：_ link:../FAQ.adoc#python不支持[常见问题：python不支持] 86 | 87 | [arabic, start=6] 88 | . 安装字体，字体下载：https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine.ttf]，安装完字体后状态栏即可正常显示 89 | . 解决`vimproc.dll错误`，错误如下图： 90 | 91 | image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/e7f27e84947f13bc9c91812881e47f2961162fc2/vimproc-dll-error.PNG[vimproc-dll] 92 | 93 | https://github.com/Shougo/vimproc.vim/releases[点我下载]，位置放在：`C:\Users\\.cache\vimfiles\repos\github.com\Shougo\vimproc.vim\lib` 94 | 95 | *恭喜，安装完成！* 96 | 97 | === 离线安装 98 | 99 | ==== 检查基础环境 100 | 101 | 检查列表同link:#检查基础环境[在线安装: 检查基础环境]相同，故不再赘述： 102 | 103 | * git 104 | * lua 105 | * python(2/3) 106 | * gvim 107 | 108 | ==== 正式安装 109 | 110 | 因link:#正式安装[在线安装： 正式安装]中已有详细说明，故不赘述重复部分，只对不同点作出详细说明： 111 | 112 | [arabic] 113 | . git clone https://gitlab.com/SpaceVim/SpaceVim.git vimfiles 114 | . 解压打包好的插件列表至： 115 | 116 | ____ 117 | C: 118 | ____ 119 | 120 | dein.vim是SpaceVim的插件管理器，原本是通过在线方式自动触发下载的，因当前的离线安装环境，就必须要提前下载下来 121 | 122 | *注意：你也可以下载打包好的插件离线包，但是官方强烈建议自行在本地下载后打包以便于使让各个插件处于最新的状态，让各个插件能为你高效地工作。* 123 | 124 | *新人看这里的时候眼睛请睁大，需要打包的位置是：`~/.cache/vimfiles`* 125 | 126 | [arabic, start=3] 127 | . 打开gvim查看SpaceVim是否正常启动 128 | 129 | *注意：如果是自行打包的插件离线包，请注意vimproc_dll是否存在。* 130 | 131 | 若有`vimproc's dll`，请按照link:#正式安装[在线安装：正式安装]中的安装手册来进行修补。 132 | 133 | [arabic, start=4] 134 | . 检查lua和python是否完全支持，步骤如link:#正式安装[在线安装：正式安装]相同 135 | . 安装字体，请**提前下载好**: https://github.com/wsdjeg/DotFiles/blob/master/fonts/DejaVu%20Sans%20Mono%20for%20Powerline.ttf[DejaVu Sans Mono for PowerLine.ttf]. 136 | 137 | 在安装完字体后，状态栏应该就可以正常工作了。 138 | 139 | *恭喜，离线安装完成！* 140 | 141 | ==== 离线状态如何更新？ 142 | 143 | [@TamaMcGlinn](https://github.com/TamaMcGlinn) 提出了使用 https://git-scm.com/docs/git-bundle[`git bundle`] 想法。这个想法十分适合插件的增量更新。 144 | 145 | 这样一来，你就不需要通过**U盘**或者**内部邮件**的方式来进行全量拷贝。 146 | 147 | 不过，不幸的是，目前为止使用这种增量更新的方式，你必须要写脚本来达到你的增量更新的目的。官方并没有提供相关的操作。 148 | 149 | 具体的细节请看： https://github.com/Gabirel/Hack-SpaceVim/issues/12#issuecomment-654206784[Instructions For Installing SpaceVim - OFFLINE] 150 | 151 | == 安装Neovim 152 | 153 | [arabic] 154 | . 根据施主的操作系统，选择下载https://github.com/neovim/neovim/wiki/Installing-Neovim#windows[Neovim] 155 | . 把Neovim的`bin`目录加入path中 156 | . 运行neovim 157 | . 如果缺少`vcruntime140.dll`，请https://www.dllme.com/dll/download/29939/vcruntime140.dll[点我下载] 158 | . 安装python2或者python3或者均安装，Neovim支持python2/3同时存在 159 | . 添加neovim-python 160 | 161 | * python2: 162 | 163 | ____ 164 | py -2 pip install –user –upgrade neovim 165 | ____ 166 | 167 | * python3 168 | 169 | ____ 170 | py -3 pip install –user –upgrade neovim 171 | ____ 172 | 173 | [arabic, start=7] 174 | . 在neovim-qt.exe中，执行命令：`:CheckHealth` 来查看python2/3是否支持，支持的结果如图所示： 175 | 176 | 有python2支持： image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/5aff57c9397cd26dba23dd0d81b94fa9cf061b56/nvim-python2-support-success.PNG[nvim-python2-support-success] 177 | 178 | 没有python3支持： image:https://gist.github.com/Gabirel/b71a01cce86df216abd4fd0968864942/raw/5aff57c9397cd26dba23dd0d81b94fa9cf061b56/nvim-python3-support-failure.PNG[nvim-python3-support-failure] 179 | 180 | 若施主想要有python3支持，请按照第6步进行安装；同样，如果想要有ruby支持按照建议的命令执行即可 181 | 182 | [arabic, start=8] 183 | . 安装SpaceVim 184 | 185 | ____ 186 | git clone https://gitlab.com/SpaceVim/SpaceVim.git %userprofile% + 187 | ____ 188 | 189 | *注意：neovim中施主不需要安装Lua支持，因为neovim(v0.2)目前不支持Lua，因此SpaceVim不会使用neocomplete，而会使用deopelete* 190 | 191 | ''''' 192 | 193 | link:installation-for-linux.adoc##在linux上安装spacevim[Linux指南] | 194 | link:../FAQ.adoc#faq[常见问题] | 195 | link:../README.adoc#table-of-contents[索引] | 196 | link:../../README.adoc#hack-spacevim[English Document] --------------------------------------------------------------------------------