vim-autoformat/README.markdown

38 lines
1.2 KiB
Markdown
Raw Normal View History

2012-09-30 16:09:46 -04:00
vim-autoformat
==============
2012-12-01 15:34:44 -05:00
This vim plugin provides bindings for external code-formatting programs.
If you have installed a supported formatprogram correctly, it will integrate with vim automatically.
2012-12-01 13:03:23 -05:00
How to install (Vundle)
-----------------------
Put this in your .vimrc
```vim
Bundle "Chiel92/vim-autoformat"
```
2012-12-02 09:12:04 -05:00
How to use
----------
To be able to use automatic code formatting, you have to install an external program that can format code of the programming language you are using.
If you have done that, you can format visually selected code with ```gq```.
For more info type ```:help gq```.
You can also format the whole buffer by calling the function ```g:Autoformat()```.
For convenience it is recommended that you assign a key for this, like so:
```vim
noremap <F7> :call g:Autoformat()<CR><CR>
```
2012-12-01 15:34:44 -05:00
Supported formatprograms
------------------------
* einars/jsbeautify for javascript (has to be installed as a pathogen-compatible plugin)
* autopep8 for python (must be globally available)
If you find yourself in need of support for another formatprogram, simply add a configuration file in the folder ```ftplugin```.
You can take the existing ones as an example.
Oh, and be sure to send me a patch. :)