Adds additional syntax highlighting and fixes indentation for Ansible's dialect of YAML.
Allows the use of the K key in normal mode to search the ansible docs for the keyword underneath the current cursor position.
Ansible YAML files are detected based on the presence of a modeline or a structure following Ansible's Playbook Best Practices. For details, see the Detection section below.
Using Vundle
-
Add the following to your
.vimrc
where other bundles are located:Bundle 'chase/vim-ansible-yaml'
-
Run from command line:
$ vim +BundleInstall
Using pathogen
-
Check out the repository into your bundle path:
$ cd ~/.vim/bundle $ git clone git://github.com/chase/vim-ansible-yaml.git
-
Install the help file. (Repeat this step if you get an updated version.) From inside vim,
:Helptags
-
Check out the repository and copy the following to
.vim/
directory or any other run time path, keeping their directory structure intact:doc/ansible.txt ftdetect/ansible.vim syntax/ansible.vim syntax/include/jinja.vim syntax/include/yaml.vim indent/ansible.vim
-
Install the help file. From inside vim,
:helptags ~/.vim/doc
.
You can tell vim to recognize a file as Ansible by adding a modeline near the top or bottom of the file:
# vim:ft=ansible:
A file is recognized as an Ansible YAML file, and its filetype is set to ansible
, if
- The extensions is
.yml
- AND one of the following conditions holds:
- The file is somewhere under a directory named
roles
. - The file is in the same directory as a directory (or file) named
group_vars
,host_vars
, orroles
.
So far, there is only one option. Others may be added later.
If you define
let g:ansible_options = {'ignore_blank_lines': 0}
in your vimrc file, then the indent function will remove all indent after a blank line. The default behavior is to ignore blank lines when calculating the indent of the current line. This is helpful if your style is to insert blank lines, as in
tasks:
- name: Say hello.
command: echo Hello, world.
- name: Say good night, Dick.
command: echo Good night, Dick.
If g:ansible_options
is not defined, or if the ignore_blank_lines
key is not present, or the value is not 0
, then the indent function uses the default behavior.
A huge thanks to Igor Vergeichik and Nikolai Weibull for their work on the YAML syntax that this bundle uses.
Also, thank you, Armin Ronacher, for the
simple and effective Jinja syntax file.