neovim-gtk/README.md

62 lines
1.9 KiB
Markdown
Raw Normal View History

2017-04-21 18:52:54 +00:00
# neovim-gtk [![Build status](https://ci.appveyor.com/api/projects/status/l58o28e13f829llx/branch/master?svg=true)](https://ci.appveyor.com/project/daa84/neovim-gtk/branch/master)
2017-04-21 10:09:05 +00:00
GTK ui for neovim written in rust using gtk-rs bindings.
2017-03-06 21:05:48 +00:00
2017-03-07 11:50:09 +00:00
# Screenshot
![Main Window](/screenshots/neovimgtk-screen.png?raw=true)
2017-05-13 19:35:39 +00:00
For more screenshots and description of basic usage see [wiki](https://github.com/daa84/neovim-gtk/wiki/GUI)
2017-03-07 11:50:09 +00:00
2017-05-24 13:32:01 +00:00
# Configuration
To setup font add next line to `ginit.vim`
2017-03-06 21:10:41 +00:00
```vim
2017-03-06 21:05:48 +00:00
call rpcnotify(1, 'Gui', 'Font', 'DejaVu Sans Mono 12')
```
2017-05-24 13:32:01 +00:00
for more details see [wiki](https://github.com/daa84/neovim-gtk/wiki/Configuration)
# Command line
* pass nvim custom execution path (by default used `nvim` command)
2017-03-07 15:22:17 +00:00
```
cargo run -- --nvim-bin-path=E:\Neovim\bin\nvim.exe
```
2017-04-19 08:43:29 +00:00
* enable external autocompletion popup menu (this function limited a bit, so disabled by default)
```
cargo run -- --enable-external-popup
```
2017-05-04 14:40:33 +00:00
# Install
2017-05-21 14:27:05 +00:00
## From sources
By default to `/usr/local`:
```
make install
```
Or to some custom path:
```
make PREFIX=/some/custom/path install
```
2017-05-04 14:40:33 +00:00
## Ubuntu snap package
2017-05-13 19:35:39 +00:00
Not usable for now due to some limitation!
2017-05-04 14:40:33 +00:00
This package also includes neovim, so neovim not needed and if present in system - not used. Install command:
```
sudo snap install nvim-gtk --channel=candidate
```
There is some limitation for package: only `/home` directory available for editing and '~' is mapped to snap home directory.
Config files must be placed in `~/snap/nvim-gtk/common/config/nvim/[g]init.vim` directory
Run command: `nvim-gtk <file_name>` or from dash: `NeovimGtk`.
To run neovim provided by snap package execute: `nvim-gtk.neovim`.
2017-03-31 13:24:11 +00:00
# Build
2017-03-31 20:23:05 +00:00
## Linux
Install GTK development packages. Install latest rust compiler, better use *rustup* tool. Build command:
2017-03-31 13:24:11 +00:00
```
cargo build --release
```
2017-03-31 20:23:05 +00:00
2017-03-31 13:24:11 +00:00
## Windows
Neovim-gtk can be compiled using MSYS2 GTK packages. In this case use 'windows-gnu' rust toolchain.
```
SET PKG_CONFIG_PATH=C:\msys64\mingw64\lib\pkgconfig
cargo build --release
```