mirror of
https://github.com/junegunn/vim-plug.git
synced 2024-12-20 02:56:10 -07:00
Updated requirements (markdown)
Junegunn Choi
parent
db139ba2d9
commit
9c99ca9d87
126
requirements.md
126
requirements.md
@ -2,7 +2,7 @@
|
|||||||
|
|
||||||
#### Vim
|
#### Vim
|
||||||
|
|
||||||
vim-plug is known to work with Vim 7.0 or above, however 7.3+ is recommended.
|
vim-plug is known to work with Vim 7.0 or above, however 8.0 is recommended for parallel installer without dependencies.
|
||||||
|
|
||||||
#### Git
|
#### Git
|
||||||
|
|
||||||
@ -22,7 +22,7 @@ vim-plug starts non-blocking, parallel installer on Vim 8. You can append `--syn
|
|||||||
|
|
||||||
#### Vim 7
|
#### Vim 7
|
||||||
|
|
||||||
If you use Vim 7, Ruby or Python is required to start parallel installer
|
If you use Vim 7, Ruby or Python is required to start parallel installer.
|
||||||
|
|
||||||
##### Ruby
|
##### Ruby
|
||||||
|
|
||||||
@ -43,125 +43,3 @@ Vim must be compiled with `+python` or `+python3`.
|
|||||||
To check the interfaces work:
|
To check the interfaces work:
|
||||||
- `+python`: `:python print 'python 2 works'`
|
- `+python`: `:python print 'python 2 works'`
|
||||||
- `+python3`: `:python print('python 3 works')`
|
- `+python3`: `:python print('python 3 works')`
|
||||||
|
|
||||||
## Platform Installation
|
|
||||||
|
|
||||||
### Windows
|
|
||||||
|
|
||||||
On Windows the python installer works for GVim and terminal vim.
|
|
||||||
Ruby is only available when using vim from terminal.
|
|
||||||
The configurations below have been tested and work.
|
|
||||||
|
|
||||||
#### GVim
|
|
||||||
|
|
||||||
Install GVim, python and git. Ensure all are the same architecture 32 or 64 bit.
|
|
||||||
|
|
||||||
1. Install GVim for Windows, any version with `+python` or `+python3` should do.
|
|
||||||
- Official [GVim](http://www.vim.org/download.php#pc)
|
|
||||||
- Community [build](https://tuxproject.de/projects/vim/), frequently updated to latest patch level.
|
|
||||||
- Any other version with `+python` should do.
|
|
||||||
1. Insall a matching python and put it on your PATH. I suggest [Python 2.7](https://www.python.org/downloads/).
|
|
||||||
1. Install git and put it on your PATH. I suggest [Git For Windows](https://git-for-windows.github.io/).
|
|
||||||
- If you use the portable version, remember to edit your PATH variable to make it available on the cmd prompt.
|
|
||||||
- If you use the installer, select "Use Git from Windows Command Prompt".
|
|
||||||
|
|
||||||
#### msys2
|
|
||||||
|
|
||||||
Install msys2 then install the required packages. This will only allow you to use terminal vim.
|
|
||||||
|
|
||||||
1. Install [msys2](https://msys2.github.io/)
|
|
||||||
1. Install the required packages from terminal.
|
|
||||||
1. Use ruby: `pacman -S vim git ruby`
|
|
||||||
1. Use python: `pacman -S vim git python`
|
|
||||||
|
|
||||||
Reminder: The ruby installer ONLY works from terminal.
|
|
||||||
|
|
||||||
### OS X
|
|
||||||
|
|
||||||
OS X ships with Vim with Ruby support, so the parallel installer should work out of the box.
|
|
||||||
Also, you can easily install the latest version of Vim using [Homebrew](http://brew.sh/).
|
|
||||||
|
|
||||||
#### Issues with RVM
|
|
||||||
|
|
||||||
If you use RVM and have issues, build Vim with system default Ruby.
|
|
||||||
|
|
||||||
```sh
|
|
||||||
rvm use system
|
|
||||||
brew reinstall vim
|
|
||||||
```
|
|
||||||
|
|
||||||
### Linux
|
|
||||||
|
|
||||||
#### Ubuntu, Debian & Derivatives
|
|
||||||
|
|
||||||
The default vim has support for both python and ruby installers.
|
|
||||||
Just ensure you have all the required packages.
|
|
||||||
|
|
||||||
**Ruby**:
|
|
||||||
```sh
|
|
||||||
sudo apt-get install vim git ruby
|
|
||||||
```
|
|
||||||
|
|
||||||
**Python**:
|
|
||||||
```sh
|
|
||||||
sudo apt-get install vim git python
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Arch
|
|
||||||
|
|
||||||
The default vim should work, just install any missing packages.
|
|
||||||
|
|
||||||
**Ruby**:
|
|
||||||
```sh
|
|
||||||
sudo pacman -S vim git ruby
|
|
||||||
```
|
|
||||||
|
|
||||||
**Python**:
|
|
||||||
```sh
|
|
||||||
sudo pacman -S vim git python
|
|
||||||
```
|
|
||||||
|
|
||||||
#### Building Vim & Python
|
|
||||||
|
|
||||||
This step is a **last** resort, allowing you to build the requirements for vim-plug.
|
|
||||||
You should use this if:
|
|
||||||
- Your version of python is too old.
|
|
||||||
- Your version of vim doesn't have `+python` or `+python3`.
|
|
||||||
- You just want a more recent version of one that isn't available from your package manager.
|
|
||||||
|
|
||||||
It should work on any POSIX machine with the required build-tools.
|
|
||||||
Please change the dependencies line if your platform is not debian based.
|
|
||||||
By default it will install into `/usr/local`, change DIR to install elsewhere.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
#!/usr/bin/env bash
|
|
||||||
|
|
||||||
# This is where python & vim will be installed to.
|
|
||||||
DIR=/usr/local
|
|
||||||
PYTHON_URL=https://www.python.org/ftp/python/2.7.10/Python-2.7.10.tgz
|
|
||||||
NEED_SUDO=
|
|
||||||
if [[ "$DIR" == "/usr/local"* ]]; then
|
|
||||||
NEED_SUDO=sudo
|
|
||||||
fi
|
|
||||||
|
|
||||||
# List of dependencies on Ubuntu, bare minimum excluding GTK/GNOME support
|
|
||||||
sudo apt-get install build-essential autoconf libncurses-dev curl git
|
|
||||||
|
|
||||||
# Build python 2.7, install to $DIR
|
|
||||||
curl $PYTHON_URL | tar -xz
|
|
||||||
cd Python*
|
|
||||||
./configure --prefix=$DIR
|
|
||||||
make
|
|
||||||
$NEED_SUDO make install
|
|
||||||
cd -
|
|
||||||
command rm -rf Python*
|
|
||||||
|
|
||||||
# Build vim with +python, install to $DIR
|
|
||||||
git clone --depth 1 https://github.com/vim/vim
|
|
||||||
cd vim
|
|
||||||
vi_cv_path_python=$DIR/bin/python ./configure --prefix=$DIR --with-features=huge --enable-pythoninterp
|
|
||||||
PATH=$DIR/bin:$PATH make
|
|
||||||
$NEED_SUDO make install
|
|
||||||
cd -
|
|
||||||
command rm -rf vim
|
|
||||||
```
|
|
||||||
Loading…
Reference in New Issue
Block a user