README.markdown · quick-source/vim-surround

# 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`

Hello world!

Finally, let's try out visual mode. Press a capital V (for linewise
visual mode) followed by `S`.

Hello world!

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

quick-source/vim-surround

简介

发行版

贡献者

近期动态

quick-source/vim-surround .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

quick-source/vim-surround