mirror of
https://github.com/VSCodeVim/Vim.git
synced 2024-09-20 00:27:41 +03:00
Merge pull request #80 from VSCodeVim/update-readme
readme: update more detailed contributing info
This commit is contained in:
commit
9db9fa3bde
56
README.md
56
README.md
@ -1,18 +1,20 @@
|
|||||||
[![Build Status](https://travis-ci.org/VSCodeVim/Vim.svg?branch=master)](https://travis-ci.org/VSCodeVim/Vim) [![Build status](https://ci.appveyor.com/api/projects/status/0t6ljij7g5h0ddx8?svg=true)](https://ci.appveyor.com/project/guillermooo/vim) [![Slack Status](http://slackin.westus.cloudapp.azure.com/badge.svg)](http://slackin.westus.cloudapp.azure.com)
|
|
||||||
|
|
||||||
# Vim
|
# Vim
|
||||||
|
|
||||||
Vim emulation for Visual Studio Code.
|
[![Build Status](https://travis-ci.org/VSCodeVim/Vim.svg?branch=master)](https://travis-ci.org/VSCodeVim/Vim) [![Build status](https://ci.appveyor.com/api/projects/status/0t6ljij7g5h0ddx8?svg=true)](https://ci.appveyor.com/project/guillermooo/vim) [![Slack Status](http://slackin.westus.cloudapp.azure.com/badge.svg)](http://slackin.westus.cloudapp.azure.com)
|
||||||
|
|
||||||
|
Vim (aka. VSCodeVim) is a [Visual Studio Code](https://code.visualstudio.com/) extension that enabling the use of the Vim keybinding experience within Visual Studio Code.
|
||||||
|
|
||||||
![Screenshot](images/screen.png)
|
![Screenshot](images/screen.png)
|
||||||
|
|
||||||
## Installation
|
## Install
|
||||||
|
|
||||||
1. Install [Visual Studio Code](https://code.visualstudio.com/)
|
1. Within Visual Studio Code, open the command palette (`Ctrl-Shift-P` / `Cmd-Shift-P`)
|
||||||
2. Open the command palette (`Ctrl-Shift-P` or `Cmd-Shift-P`) select `Install Extension` and search for **vim**. Alternatively, run `ext install vim`
|
2. Select `Install Extension` and search for 'vim' *or* run `ext install vim`
|
||||||
|
|
||||||
## Project Status
|
## Project Status
|
||||||
|
|
||||||
|
See our [release notes](https://github.com/VSCodeVim/Vim/releases) for full details.
|
||||||
|
|
||||||
### Completed
|
### Completed
|
||||||
|
|
||||||
* Modes:
|
* Modes:
|
||||||
@ -29,34 +31,34 @@ Vim emulation for Visual Studio Code.
|
|||||||
* Editing: `u`, `ctrl+r`
|
* Editing: `u`, `ctrl+r`
|
||||||
* File Operations: `:q`, `:w`
|
* File Operations: `:q`, `:w`
|
||||||
|
|
||||||
### Planned
|
## Contributing
|
||||||
|
|
||||||
In no particular order:
|
|
||||||
|
|
||||||
* Search: `/`
|
|
||||||
* Support Macros
|
|
||||||
* Buffers
|
|
||||||
* Neovim Integration
|
|
||||||
|
|
||||||
## Contributions
|
|
||||||
|
|
||||||
Contributions are extremely welcomed!
|
Contributions are extremely welcomed!
|
||||||
Take a look at [Extension API](https://code.visualstudio.com/docs/extensionAPI/overview) on how to get started and our current [issues](https://github.com/VSCodeVim/Vim/issues) to see what we are working on next.
|
Take a look at [Extension API](https://code.visualstudio.com/docs/extensionAPI/overview) on how to get started and our current [issues](https://github.com/VSCodeVim/Vim/issues) to see what we are working on next.
|
||||||
|
|
||||||
### Getting started
|
### Developing
|
||||||
|
|
||||||
1. Install [Visual Studio Code](https://code.visualstudio.com/).
|
1. Install prerequisites:
|
||||||
2. Install [Node.js](https://nodejs.org/) with version > 4.0.0.
|
* latest [Visual Studio Code](https://code.visualstudio.com/)
|
||||||
3. Fork the repo.
|
* [Node.js](https://nodejs.org/) v4.0.0 or higher
|
||||||
4. `npm install`
|
2. Fork and clone the repo, then
|
||||||
5. `gulp init`
|
|
||||||
* This step will install type definitions (using [tsd](http://definitelytyped.org/tsd/)).
|
```
|
||||||
6. Create a topic branch.
|
$ npm install
|
||||||
7. Ensure tests pass:
|
$ npm install -g gulp
|
||||||
|
$ gulp init
|
||||||
|
```
|
||||||
|
|
||||||
|
3. Open the folder in VS Code
|
||||||
|
|
||||||
|
#### Submitting a PR
|
||||||
|
|
||||||
|
You've made some changes, and you are ready to submit a PR? Please make sure:
|
||||||
|
|
||||||
|
1. Tests pass:
|
||||||
* `gulp`: run tslint and tests
|
* `gulp`: run tslint and tests
|
||||||
* [Launch tests within VS Code](https://code.visualstudio.com/docs/extensions/testing-extensions)
|
* [Launch tests within VS Code](https://code.visualstudio.com/docs/extensions/testing-extensions)
|
||||||
8. Squash your commits.
|
2. Commits are squashed
|
||||||
9. Submit your PR.
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
Loading…
Reference in New Issue
Block a user