JIe
2bb7059579
Some checks failed
Detach Plugins / check (FlyGrep.vim) (push) Has been cancelled
Detach Plugins / check (GitHub.vim) (push) Has been cancelled
Detach Plugins / check (JavaUnit.vim) (push) Has been cancelled
Detach Plugins / check (SourceCounter.vim) (push) Has been cancelled
Detach Plugins / check (cpicker.nvim) (push) Has been cancelled
Detach Plugins / check (dein-ui.vim) (push) Has been cancelled
Detach Plugins / check (git.vim) (push) Has been cancelled
Detach Plugins / check (iedit.vim) (push) Has been cancelled
Detach Plugins / check (scrollbar.vim) (push) Has been cancelled
Detach Plugins / check (vim-chat) (push) Has been cancelled
Detach Plugins / check (vim-cheat) (push) Has been cancelled
Detach Plugins / check (vim-todo) (push) Has been cancelled
Detach Plugins / check (xmake.vim) (push) Has been cancelled
test / Linux (nvim, nightly) (push) Has been cancelled
test / Linux (nvim, v0.3.8) (push) Has been cancelled
test / Linux (nvim, v0.4.0) (push) Has been cancelled
test / Linux (nvim, v0.4.2) (push) Has been cancelled
test / Linux (nvim, v0.4.3) (push) Has been cancelled
test / Linux (nvim, v0.4.4) (push) Has been cancelled
test / Linux (nvim, v0.5.0) (push) Has been cancelled
test / Linux (nvim, v0.5.1) (push) Has been cancelled
test / Linux (nvim, v0.6.0) (push) Has been cancelled
test / Linux (nvim, v0.6.1) (push) Has been cancelled
test / Linux (nvim, v0.7.0) (push) Has been cancelled
test / Linux (nvim, v0.7.2) (push) Has been cancelled
test / Linux (nvim, v0.8.0) (push) Has been cancelled
test / Linux (nvim, v0.8.1) (push) Has been cancelled
test / Linux (nvim, v0.8.2) (push) Has been cancelled
test / Linux (nvim, v0.8.3) (push) Has been cancelled
test / Linux (nvim, v0.9.0) (push) Has been cancelled
test / Linux (nvim, v0.9.1) (push) Has been cancelled
test / Linux (true, vim, v7.4.052) (push) Has been cancelled
test / Linux (true, vim, v7.4.1689) (push) Has been cancelled
test / Linux (true, vim, v7.4.629) (push) Has been cancelled
test / Linux (true, vim, v8.0.0027) (push) Has been cancelled
test / Linux (true, vim, v8.0.0183) (push) Has been cancelled
test / Linux (vim, nightly) (push) Has been cancelled
test / Linux (vim, v8.0.0184) (push) Has been cancelled
test / Linux (vim, v8.0.1453) (push) Has been cancelled
test / Linux (vim, v8.1.2269) (push) Has been cancelled
test / Linux (vim, v8.2.2434) (push) Has been cancelled
test / Linux (vim, v8.2.3995) (push) Has been cancelled
test / Windows (nvim, nightly) (push) Has been cancelled
test / Windows (nvim, v0.3.8) (push) Has been cancelled
test / Windows (nvim, v0.4.2) (push) Has been cancelled
test / Windows (nvim, v0.4.3) (push) Has been cancelled
test / Windows (nvim, v0.4.4) (push) Has been cancelled
test / Windows (nvim, v0.5.0) (push) Has been cancelled
test / Windows (nvim, v0.5.1) (push) Has been cancelled
test / Windows (nvim, v0.6.0) (push) Has been cancelled
test / Windows (nvim, v0.6.1) (push) Has been cancelled
test / Windows (nvim, v0.7.0) (push) Has been cancelled
test / Windows (nvim, v0.7.2) (push) Has been cancelled
test / Windows (nvim, v0.8.0) (push) Has been cancelled
test / Windows (nvim, v0.8.1) (push) Has been cancelled
test / Windows (nvim, v0.8.2) (push) Has been cancelled
test / Windows (nvim, v0.8.3) (push) Has been cancelled
test / Windows (nvim, v0.9.0) (push) Has been cancelled
test / Windows (nvim, v0.9.1) (push) Has been cancelled
test / Windows (vim, nightly) (push) Has been cancelled
test / Windows (vim, v7.4.1185) (push) Has been cancelled
test / Windows (vim, v7.4.1689) (push) Has been cancelled
test / Windows (vim, v8.0.0027) (push) Has been cancelled
test / Windows (vim, v8.0.1453) (push) Has been cancelled
test / Windows (vim, v8.1.2269) (push) Has been cancelled
test / Windows (vim, v8.2.2434) (push) Has been cancelled
test / Windows (vim, v8.2.3995) (push) Has been cancelled
docker / docker (push) Has been cancelled
mirror / check (coding) (push) Has been cancelled
mirror / check (gitee) (push) Has been cancelled
mirror / check (gitlab) (push) Has been cancelled
92 lines
2.2 KiB
Markdown
92 lines
2.2 KiB
Markdown
# surround.vim
|
|
|
|
Surround.vim is all about "surroundings": parentheses, brackets, quotes,
|
|
XML tags, and more. The plugin provides mappings to easily delete,
|
|
change and add such surroundings in pairs.
|
|
|
|
It's easiest to explain with examples. Press `cs"'` inside
|
|
|
|
"Hello world!"
|
|
|
|
to change it to
|
|
|
|
'Hello world!'
|
|
|
|
Now press `cs'<q>` to change it to
|
|
|
|
<q>Hello world!</q>
|
|
|
|
To go full circle, press `cst"` to get
|
|
|
|
"Hello world!"
|
|
|
|
To remove the delimiters entirely, press `ds"`.
|
|
|
|
Hello world!
|
|
|
|
Now with the cursor on "Hello", press `ysiw]` (`iw` is a text object).
|
|
|
|
[Hello] world!
|
|
|
|
Let's make that braces and add some space (use `}` instead of `{` for no
|
|
space): `cs]{`
|
|
|
|
{ Hello } world!
|
|
|
|
Now wrap the entire line in parentheses with `yssb` or `yss)`.
|
|
|
|
({ Hello } world!)
|
|
|
|
Revert to the original text: `ds{ds)`
|
|
|
|
Hello world!
|
|
|
|
Emphasize hello: `ysiw<em>`
|
|
|
|
<em>Hello</em> world!
|
|
|
|
Finally, let's try out visual mode. Press a capital V (for linewise
|
|
visual mode) followed by `S<p class="important">`.
|
|
|
|
<p class="important">
|
|
<em>Hello</em> world!
|
|
</p>
|
|
|
|
This plugin is very powerful for HTML and XML editing, a niche which
|
|
currently seems underfilled in Vim land. (As opposed to HTML/XML
|
|
*inserting*, for which many plugins are available). Adding, changing,
|
|
and removing pairs of tags simultaneously is a breeze.
|
|
|
|
The `.` command will work with `ds`, `cs`, and `yss` if you install
|
|
[repeat.vim](https://github.com/tpope/vim-repeat).
|
|
|
|
## Installation
|
|
|
|
Install using your favorite package manager, or use Vim's built-in package
|
|
support:
|
|
|
|
mkdir -p ~/.vim/pack/tpope/start
|
|
cd ~/.vim/pack/tpope/start
|
|
git clone https://tpope.io/vim/surround.git
|
|
vim -u NONE -c "helptags surround/doc" -c q
|
|
|
|
## Contributing
|
|
|
|
See the contribution guidelines for
|
|
[pathogen.vim](https://github.com/tpope/vim-pathogen#readme).
|
|
|
|
## Self-Promotion
|
|
|
|
Like surround.vim? Star the repository on
|
|
[GitHub](https://github.com/tpope/vim-surround) and vote for it on
|
|
[vim.org](https://www.vim.org/scripts/script.php?script_id=1697).
|
|
|
|
Love surround.vim? Follow [tpope](http://tpo.pe/) on
|
|
[GitHub](https://github.com/tpope) and
|
|
[Twitter](http://twitter.com/tpope).
|
|
|
|
## License
|
|
|
|
Copyright (c) Tim Pope. Distributed under the same terms as Vim itself.
|
|
See `:help license`.
|