mirror of
https://github.com/junegunn/goyo.vim.git
synced 2025-11-17 07:43:42 -05:00
113 lines
2.8 KiB
Markdown
113 lines
2.8 KiB
Markdown
goyo.vim ([고요](http://en.wiktionary.org/wiki/고요하다))
|
|
=========================================================
|
|
|
|
Distraction-free writing in Vim.
|
|
|
|
|
|
|
|
(Color scheme: [seoul256](https://github.com/junegunn/seoul256.vim))
|
|
|
|
Best served with [limelight.vim](https://github.com/junegunn/limelight.vim).
|
|
|
|
Installation
|
|
------------
|
|
|
|
Use your favorite plugin manager.
|
|
|
|
- [vim-plug](https://github.com/junegunn/vim-plug)
|
|
1. Add `Plug 'junegunn/goyo.vim'` to .vimrc
|
|
2. Run `:PlugInstall`
|
|
|
|
Usage
|
|
-----
|
|
|
|
- `:Goyo`
|
|
- Toggle Goyo
|
|
- `:Goyo [width]`
|
|
- Turn on or resize Goyo
|
|
- `:Goyo!`
|
|
- Turn Goyo off
|
|
|
|
You might want to define a map for toggling it:
|
|
|
|
```vim
|
|
nnoremap <Leader>G :Goyo<CR>
|
|
```
|
|
|
|
Configuration
|
|
-------------
|
|
|
|
- `g:goyo_width` (default: 80)
|
|
- `g:goyo_margin_top` (default: 4)
|
|
- `g:goyo_margin_bottom` (default: 4)
|
|
- `g:goyo_linenr` (default: 0)
|
|
|
|
### Callbacks
|
|
|
|
By default, [vim-airline](https://github.com/bling/vim-airline),
|
|
[vim-powerline](https://github.com/Lokaltog/vim-powerline),
|
|
[powerline](https://github.com/Lokaltog/powerline),
|
|
[lightline.vim](https://github.com/itchyny/lightline.vim),
|
|
[vim-signify](https://github.com/mhinz/vim-signify),
|
|
and [vim-gitgutter](https://github.com/airblade/vim-gitgutter) are temporarily
|
|
disabled while in Goyo mode.
|
|
|
|
If you have other plugins that you want to disable/enable, or if you want to
|
|
change the default settings of Goyo window, you can set up custom routines
|
|
to be triggered on `GoyoEnter` and `GoyoLeave` events.
|
|
|
|
```vim
|
|
function! s:goyo_enter()
|
|
silent !tmux set status off
|
|
set noshowmode
|
|
set noshowcmd
|
|
set scrolloff=999
|
|
Limelight
|
|
" ...
|
|
endfunction
|
|
|
|
function! s:goyo_leave()
|
|
silent !tmux set status on
|
|
set showmode
|
|
set showcmd
|
|
set scrolloff=5
|
|
Limelight!
|
|
" ...
|
|
endfunction
|
|
|
|
autocmd! User GoyoEnter
|
|
autocmd! User GoyoLeave
|
|
autocmd User GoyoEnter nested call <SID>goyo_enter()
|
|
autocmd User GoyoLeave nested call <SID>goyo_leave()
|
|
```
|
|
|
|
More examples can be found here:
|
|
[Customization](https://github.com/junegunn/goyo.vim/wiki/Customization)
|
|
|
|
Inspiration
|
|
-----------
|
|
|
|
- [LiteDFM](https://github.com/bilalq/lite-dfm)
|
|
- [VimRoom](http://projects.mikewest.org/vimroom/)
|
|
|
|
Pros.
|
|
-----
|
|
|
|
1. Works well with splits. Doesn't mess up with the current window arrangement
|
|
1. Works well with popular statusline plugins
|
|
1. Prevents accessing the empty windows around the central buffer
|
|
1. Can be closed with any of `:q[uit]`, `:clo[se]`, `:tabc[lose]`, `:bd[elete]`,
|
|
or `:Goyo`
|
|
1. Can dynamically change the width of the window
|
|
1. Adjusts its colors when color scheme is changed
|
|
1. Realigns the window when the terminal (or window) is resized or when the size
|
|
of the font is changed
|
|
1. Correctly hides colorcolumns and Emojis in statusline
|
|
1. Highly customizable with callbacks
|
|
|
|
License
|
|
-------
|
|
|
|
MIT
|
|
|