120 lines
2.7 KiB
Markdown
120 lines
2.7 KiB
Markdown
# vim-javascript
|
||
|
||
JavaScript bundle for vim, this bundle provides syntax highlighting and
|
||
improved indentation.
|
||
|
||
|
||
## Installation
|
||
|
||
### Install with [Vundle](https://github.com/gmarik/vundle)
|
||
|
||
Add to vimrc:
|
||
|
||
Plugin 'pangloss/vim-javascript'
|
||
|
||
And install it:
|
||
|
||
:so ~/.vimrc
|
||
:PluginInstall
|
||
|
||
### Install with [vim-plug](https://github.com/junegunn/vim-plug)
|
||
|
||
Add to vimrc:
|
||
|
||
Plug 'pangloss/vim-javascript'
|
||
|
||
And install it:
|
||
|
||
:so ~/.vimrc
|
||
:PlugInstall
|
||
|
||
### Install with [pathogen](https://github.com/tpope/vim-pathogen)
|
||
|
||
git clone https://github.com/pangloss/vim-javascript.git ~/.vim/bundle/vim-javascript
|
||
|
||
|
||
## Configuration Variables
|
||
|
||
The following variables control certain syntax highlighting plugins. You can
|
||
add them to your `.vimrc` to enable their features.
|
||
|
||
-----------------
|
||
|
||
```
|
||
let g:javascript_plugin_jsdoc = 1
|
||
```
|
||
|
||
Enables syntax highlighting for [JSDocs](http://usejsdoc.org/).
|
||
|
||
Default Value: 0
|
||
|
||
-----------------
|
||
|
||
```
|
||
let g:javascript_plugin_ngdoc = 1
|
||
```
|
||
|
||
Enables some additional syntax highlighting for NGDocs. Requires JSDoc plugin
|
||
to be enabled as well.
|
||
|
||
Default Value: 0
|
||
|
||
-----------------
|
||
|
||
```
|
||
let g:javascript_plugin_flow = 1
|
||
```
|
||
|
||
Enables syntax highlighting for [Flow](https://flowtype.org/).
|
||
|
||
Default Value: 0
|
||
|
||
-----------------
|
||
|
||
```
|
||
set foldmethod=syntax
|
||
```
|
||
|
||
Enables code folding based on our syntax file.
|
||
|
||
Please note this can have a dramatic effect on performance and because it is a
|
||
global vim option, we do not set it ourselves.
|
||
|
||
|
||
## Concealing Characters
|
||
|
||
You can customize concealing characters by defining one or more of the following
|
||
variables:
|
||
|
||
let g:javascript_conceal_function = "ƒ"
|
||
let g:javascript_conceal_null = "ø"
|
||
let g:javascript_conceal_this = "@"
|
||
let g:javascript_conceal_return = "⇚"
|
||
let g:javascript_conceal_undefined = "¿"
|
||
let g:javascript_conceal_NaN = "ℕ"
|
||
let g:javascript_conceal_prototype = "¶"
|
||
let g:javascript_conceal_static = "•"
|
||
let g:javascript_conceal_super = "Ω"
|
||
let g:javascript_conceal_arrow_function = "⇒"
|
||
|
||
|
||
## Contributing
|
||
|
||
This project uses the [git
|
||
flow](http://nvie.com/posts/a-successful-git-branching-model/) model for
|
||
development. There's [a handy git module for git
|
||
flow](//github.com/nvie/gitflow). If you'd like to be added as a contributor,
|
||
the price of admission is 1 pull request. Please follow the general code style
|
||
guides (read the code) and in your pull request explain the reason for the
|
||
proposed change and how it is valuable.
|
||
|
||
|
||
## Bug Reports
|
||
|
||
Report a bug on [GitHub Issues](https://github.com/pangloss/vim-javascript/issues).
|
||
|
||
|
||
## License
|
||
|
||
Distributed under the same terms as Vim itself. See `:help license`.
|