vim-polyglot/README.md

138 lines
8.7 KiB
Markdown
Raw Normal View History

# vim-polyglot [![Build Status][travis-img-url]][travis-url]
[travis-img-url]: https://travis-ci.org/sheerun/vim-polyglot.svg
2013-09-14 14:43:34 -04:00
[travis-url]: https://travis-ci.org/sheerun/vim-polyglot
2013-09-13 08:06:28 -04:00
2013-09-13 08:08:50 -04:00
A collection of language packs for Vim.
2013-09-13 08:06:28 -04:00
2014-05-14 06:06:27 -04:00
> One to rule them all, one to find them, one to bring them all and in the darkness bind them.
2013-09-13 09:01:21 -04:00
2015-06-11 11:02:51 -04:00
- It **won't affect your startup time**, as scripts are loaded only on demand\*.
2015-12-06 09:35:27 -05:00
- It **installs and updates 70+ times faster** than 70+ packages it consist of.
2014-04-14 19:33:45 -04:00
- Solid syntax and indentation support. Only the best language packs.
- All unnecessary files are ignored (like enormous documentation from php support).
- No support for esoteric languages, only most popular ones (modern too, like `slim`).
2014-04-14 20:16:31 -04:00
- Each build is tested by automated vimrunner script on CI. See `spec` directory.
2013-09-13 08:06:28 -04:00
2013-09-16 11:02:09 -04:00
\*To be completely honest, concatenated `ftdetect` script takes around `3ms` to load.
2013-09-13 08:06:28 -04:00
## Installation
2015-11-24 09:08:46 -05:00
1. Install [Pathogen](https://github.com/tpope/vim-pathogen), [Vundle](https://github.com/VundleVim/Vundle.vim), [NeoBundle](https://github.com/Shougo/neobundle.vim), or [Plug](https://github.com/junegunn/vim-plug) package manager for Vim.
2013-09-13 08:06:28 -04:00
2. Use this repository as submodule or package.
2013-09-13 08:24:18 -04:00
Optionally download one of the [releases](https://github.com/sheerun/vim-polyglot/releases) and unpack it directly under `~/.vim` directory.
2013-09-13 08:06:28 -04:00
## Language packs
2015-12-17 04:48:07 -05:00
- [ansible](https://github.com/pearofducks/ansible-vim) (syntax, indent, ftplugin, ftdetect)
2014-03-16 09:52:12 -04:00
- [arduino](https://github.com/sudar/vim-arduino-syntax) (syntax, indent, ftdetect)
2016-01-22 03:08:00 -05:00
- [blade](https://github.com/jwalton512/vim-blade) (syntax, indent, ftplugin, ftdetect)
- [c++11](https://github.com/octol/vim-cpp-enhanced-highlight) (syntax)
2015-12-06 05:31:38 -05:00
- [c/c++](https://github.com/vim-jp/vim-cpp) (syntax)
2015-10-24 06:06:19 -04:00
- [cjsx](https://github.com/mtscout6/vim-cjsx) (ftdetect, syntax, ftplugin)
- [clojure](https://github.com/guns/vim-clojure-static) (syntax, indent, autoload, ftplugin, ftdetect)
- [coffee-script](https://github.com/kchmck/vim-coffee-script) (syntax, indent, compiler, autoload, ftplugin, ftdetect)
2016-05-02 04:44:59 -04:00
- [cryptol](https://github.com/victoredwardocallaghan/cryptol.vim) (syntax, compiler, ftplugin, ftdetect)
2016-05-02 04:49:45 -04:00
- [crystal](https://github.com/rhysd/vim-crystal) (syntax, indent, autoload, ftplugin, ftdetect)
2015-12-28 08:58:35 -05:00
- [cql](https://github.com/elubow/cql-vim) (syntax, ftdetect)
2014-08-12 19:07:14 -04:00
- [css](https://github.com/JulesWang/css.vim) (syntax)
- [cucumber](https://github.com/tpope/vim-cucumber) (syntax, indent, compiler, ftplugin, ftdetect)
2015-12-17 04:44:58 -05:00
- [dart](https://github.com/dart-lang/dart-vim-plugin) (syntax, indent, autoload, ftplugin, ftdetect)
2013-09-26 06:48:01 -04:00
- [dockerfile](https://github.com/honza/dockerfile.vim) (syntax, ftdetect)
- [elixir](https://github.com/elixir-lang/vim-elixir) (syntax, indent, compiler, ftplugin, ftdetect)
2015-12-31 12:27:37 -05:00
- [elm](https://github.com/lambdatoast/elm.vim) (syntax, indent, autoload, ftplugin, ftdetect)
2014-04-14 19:33:45 -04:00
- [emberscript](https://github.com/heartsentwined/vim-ember-script) (syntax, indent, ftplugin, ftdetect)
2014-08-12 19:07:14 -04:00
- [emblem](https://github.com/heartsentwined/vim-emblem) (syntax, indent, ftplugin, ftdetect)
- [erlang](https://github.com/vim-erlang/vim-erlang-runtime) (syntax, indent, ftdetect)
2016-05-02 04:46:45 -04:00
- [fish](https://github.com/dag/vim-fish) (syntax, indent, compiler, autoload, ftplugin, ftdetect)
- [git](https://github.com/tpope/vim-git) (syntax, indent, ftplugin, ftdetect)
- [glsl](https://github.com/tikhomirov/vim-glsl) (syntax, indent, ftdetect)
- [go](https://github.com/fatih/vim-go) (syntax, compiler, indent, ftdetect)
2015-10-10 11:17:57 -04:00
- [groovy](https://github.com/vim-scripts/groovy.vim) (syntax)
- [haml](https://github.com/tpope/vim-haml) (syntax, indent, compiler, ftplugin, ftdetect)
2015-12-06 05:31:38 -05:00
- [handlebars](https://github.com/mustache/vim-mustache-handlebars) (syntax, indent, ftplugin, ftdetect)
- [haskell](https://github.com/neovimhaskell/haskell-vim) (syntax, indent, ftplugin, ftdetect)
2014-06-08 07:22:29 -04:00
- [haxe](https://github.com/yaymukund/vim-haxe) (syntax, ftdetect)
- [html5](https://github.com/othree/html5.vim) (syntax, indent, autoload, ftplugin)
- [jade](https://github.com/digitaltoad/vim-jade) (syntax, indent, ftplugin, ftdetect)
2014-04-14 19:33:45 -04:00
- [jasmine](https://github.com/glanotte/vim-jasmine) (syntax, ftdetect)
2015-07-19 12:57:00 -04:00
- [javascript](https://github.com/sheerun/yajs.vim) (syntax, indent)
2015-06-11 11:02:51 -04:00
- [json](https://github.com/sheerun/vim-json) (syntax, indent, ftdetect)
- [jst](https://github.com/briancollins/vim-jst) (syntax, indent, ftdetect)
2015-12-06 05:31:38 -05:00
- [jsx](https://github.com/mxw/vim-jsx) (ftdetect, after)
2015-10-24 06:06:19 -04:00
- [julia](https://github.com/dcjones/julia-minimalist-vim) (syntax, indent, ftdetect)
- [kotlin](https://github.com/udalov/kotlin-vim) (syntax, indent, ftdetect)
- [latex](https://github.com/LaTeX-Box-Team/LaTeX-Box) (syntax, indent, ftplugin)
- [less](https://github.com/groenewege/vim-less) (syntax, indent, ftplugin, ftdetect)
2014-06-08 13:38:42 -04:00
- [liquid](https://github.com/tpope/vim-liquid) (syntax, indent, ftplugin, ftdetect)
- [markdown](https://github.com/tpope/vim-markdown) (syntax, ftplugin, ftdetect)
- [nginx](https://github.com/nginx/nginx) (syntax, indent, ftdetect)
2016-01-22 03:12:18 -05:00
- [nim](https://github.com/zah/nim.vim) (syntax, compiler, indent, ftdetect)
2015-12-17 04:47:00 -05:00
- [nix](https://github.com/spwhitt/vim-nix) (syntax, ftplugin, ftdetect)
- [objc](https://github.com/b4winckler/vim-objc) (ftplugin, syntax, indent)
- [ocaml](https://github.com/jrk/vim-ocaml) (syntax, indent, ftplugin)
- [octave](https://github.com/vim-scripts/octave.vim--) (syntax)
2014-03-16 09:52:12 -04:00
- [opencl](https://github.com/petRUShka/vim-opencl) (syntax, indent, ftplugin, ftdetect)
- [perl](https://github.com/vim-perl/vim-perl) (syntax, indent, ftplugin, ftdetect)
2016-05-02 04:52:01 -04:00
- [pgsql](https://github.com/exu/pgsql.vim) (syntax, ftdetect)
- [php](https://github.com/StanAngeloff/php.vim) (syntax)
2016-05-02 04:50:59 -04:00
- [plantuml](https://github.com/aklt/plantuml-syntax) (syntax, ftplugin, ftdetect)
2014-12-11 17:16:49 -05:00
- [powershell](https://github.com/Persistent13/vim-ps1) (syntax, indent, ftplugin, ftdetect)
2013-09-14 05:36:13 -04:00
- [protobuf](https://github.com/uarun/vim-protobuf) (syntax, ftdetect)
- [puppet](https://github.com/voxpupuli/vim-puppet) (syntax, indent, ftplugin, ftdetect)
2016-05-02 05:35:06 -04:00
- [purescript](https://github.com/raichoo/purescript-vim) (syntax, indent, ftdetect)
2014-04-14 19:33:45 -04:00
- [python](https://github.com/mitsuhiko/vim-python-combined) (syntax, indent)
2015-10-10 11:25:38 -04:00
- [qml](https://github.com/peterhoeg/vim-qml) (syntax, indent, ftplugin, ftdetect)
2015-10-24 06:06:19 -04:00
- [r-lang](https://github.com/vim-scripts/R.vim) (syntax, ftplugin)
2015-12-31 12:27:37 -05:00
- [ragel](https://github.com/jneen/ragel.vim) (syntax)
2013-09-26 06:45:26 -04:00
- [rspec](https://github.com/sheerun/rspec.vim) (syntax, ftdetect)
- [ruby](https://github.com/vim-ruby/vim-ruby) (syntax, indent, compiler, autoload, ftplugin, ftdetect)
2015-11-20 09:47:50 -05:00
- [rust](https://github.com/rust-lang/rust.vim) (syntax, indent, compiler, autoload, ftplugin, ftdetect)
- [sbt](https://github.com/derekwyatt/vim-sbt) (syntax, ftdetect)
2015-06-11 11:02:51 -04:00
- [scala](https://github.com/derekwyatt/vim-scala) (syntax, indent, compiler, ftplugin, ftdetect)
- [slim](https://github.com/slim-template/vim-slim) (syntax, indent, ftdetect)
2015-07-18 17:00:08 -04:00
- [solidity](https://github.com/ethereum/vim-solidity) (syntax, indent, ftdetect)
- [stylus](https://github.com/wavded/vim-stylus) (syntax, indent, ftplugin, ftdetect)
2015-12-05 20:05:04 -05:00
- [swift](https://github.com/keith/swift.vim) (syntax, indent, ftplugin, ftdetect)
2015-10-24 06:06:19 -04:00
- [systemd](https://github.com/kurayama/systemd-vim-syntax) (syntax, ftdetect)
- [textile](https://github.com/timcharper/textile.vim) (syntax, ftplugin, ftdetect)
2015-10-24 06:06:19 -04:00
- [thrift](https://github.com/solarnz/thrift.vim) (syntax, ftdetect)
- [tmux](https://github.com/tejr/vim-tmux) (syntax, ftdetect)
2015-12-06 05:31:38 -05:00
- [tomdoc](https://github.com/wellbredgrapefruit/tomdoc.vim) (syntax)
2014-12-22 16:01:38 -05:00
- [toml](https://github.com/cespare/vim-toml) (syntax, ftplugin, ftdetect)
2016-01-28 12:14:32 -05:00
- [twig](https://github.com/evidens/vim-twig) (syntax, ftplugin)
2015-10-24 06:06:19 -04:00
- [typescript](https://github.com/leafgarland/typescript-vim) (syntax, indent, compiler, ftplugin, ftdetect)
2014-12-22 16:01:38 -05:00
- [vala](https://github.com/tkztmk/vim-vala) (syntax, indent, ftdetect)
2015-10-24 06:06:19 -04:00
- [vbnet](https://github.com/vim-scripts/vbnet.vim) (syntax)
2015-12-06 05:34:19 -05:00
- [vcl](https://github.com/smerrill/vcl-vim-plugin) (syntax, ftdetect)
2014-12-22 16:01:38 -05:00
- [vm](https://github.com/lepture/vim-velocity) (syntax, indent, ftdetect)
2015-10-24 06:06:19 -04:00
- [xls](https://github.com/vim-scripts/XSLT-syntax) (syntax)
2015-12-31 12:34:53 -05:00
- [yaml](https://github.com/stephpy/vim-yaml) (syntax, ftplugin)
2015-10-24 06:06:19 -04:00
- [yard](https://github.com/sheerun/vim-yardoc) (syntax)
2013-09-13 08:06:28 -04:00
## Disabling a language pack
Individual language packs can be disabled by setting `g:polyglot_disabled`.
```viml
" ~/.vimrc
let g:polyglot_disabled = ['css']
```
Note that disabiling languages won't make in general your vim startup any faster / slower (only for specific file type). Vim-polyglot is selection of language plugins that are loaded only on demand.
2015-07-18 17:55:47 -04:00
## Updating
You can either wait for new patch release with updates or run the `./build` script by yourself.
2013-09-13 08:06:28 -04:00
## Contributing
Language packs are periodically updated using automated `build` script.
Feel free to add your language, and send pull-request.
## License
See linked repositories for detailed license information.