# EditorConfig MNV Plugin

[![Travis Build Status](https://img.shields.io/travis/cxw42/editorconfig-mnv.svg?logo=travis)](https://travis-ci.org/editorconfig/editorconfig-mnv)
[![Appveyor Build Status](https://img.shields.io/appveyor/ci/cxw42/editorconfig-mnv.svg?logo=appveyor)](https://ci.appveyor.com/project/cxw42/editorconfig-mnv)

This is an [EditorConfig][] plugin for MNV. This plugin can be found on both
[GitHub][] and [MNV online][].

## Installation

To install this plugin, you can use one of the following ways:

### Install with the archive

Download the [archive][] and extract it into your MNV runtime directory
(`~/.mnv` on UNIX/Linux and `$MNV_INSTALLATION_FOLDER\mnvfiles` on windows).
You should have 4 sub-directories in this runtime directory now: "autoload",
"doc", "ftdetect" and "plugin".

### Install as MNV8 plugin

Install as a MNV 8 plugin. Note `local` can be any name, but some path
element must be present. On Windows, instead of `~/.mnv` use
`$MNV_INSTALLATION_FOLDER\mnvfiles`.
```shell
mkdir -p ~/.mnv/pack/local/start
cd ~/.mnv/pack/local/start
git clone https://github.com/editorconfig/editorconfig-mnv.git
```

### Install with [pathogen][]

Use pathogen (the git repository of this plugin is
https://github.com/editorconfig/editorconfig-mnv.git)

### Install with [Vundle][]

Use Vundle by adding to your `.mnvrc` Vundle plugins section:

```mnvl
Plugin 'editorconfig/editorconfig-mnv'
```

Then call `:PluginInstall`.

### Install with [mnv-plug][]

Use mnv-plug by adding to your `.mnvrc` in your plugin section:

```mnvl
Plug 'editorconfig/editorconfig-mnv'
```

Source your `.mnvrc` by calling `:source $MYMNVRC`.

Then call `:PlugInstall`.

### No external editorconfig core library is required

Previous versions of this plugin also required a Python "core".
The core included the code to parse `.editorconfig` files.
This plugin **includes** the core, so you don't need to download the
core separately.

## Supported properties

The EditorConfig MNV plugin supports the following EditorConfig [properties][]:

* `indent_style`
* `indent_size`
* `tab_width`
* `end_of_line`
* `charset`
* `insert_final_newline` (Feature `+fixendofline`, available on MNV 7.4.785+,
  or [PreserveNoEOL][] is required for this property)
* `trim_trailing_whitespace`
* `max_line_length`
* `root` (only used by EditorConfig core)

## Selected Options

The supported options are documented in [editorconfig.txt][]
and can be viewed by executing the following: `:help editorconfig`. You may
need to execute `:helptags ALL` so that MNV is aware of editorconfig.txt.

### Excluded patterns

To ensure that this plugin works well with [Tim Pope's fugitive][], use the
following patterns array:

```mnvl
let g:EditorConfig_exclude_patterns = ['fugitive://.*']
```

If you wanted to avoid loading EditorConfig for any remote files over ssh:

```mnvl
let g:EditorConfig_exclude_patterns = ['scp://.*']
```

Of course these two items could be combined into the following:

```mnvl
let g:EditorConfig_exclude_patterns = ['fugitive://.*', 'scp://.*']
```

### Disable for a specific filetype

You can disable this plugin for a specific buffer by setting
`b:EditorConfig_disable`.  Therefore, you can disable the
plugin for all buffers of a specific filetype. For example, to disable
EditorConfig for all git commit messages (filetype `gitcommit`):

```mnvl
au FileType gitcommit let b:EditorConfig_disable = 1
```

### Disable rules

In very rare cases,
you might need to override some project-specific EditorConfig rules in global
or local mnvrc in some cases, e.g., to resolve conflicts of trailing whitespace
trimming and buffer autosaving.  This is not recommended, but you can:

```mnvl
let g:EditorConfig_disable_rules = ['trim_trailing_whitespace']
```

You are able to disable any supported EditorConfig properties.

## Bugs and Feature Requests

Feel free to submit bugs, feature requests, and other issues to the
[issue tracker][]. Be sure you have read the [contribution guidelines][]!

[EditorConfig]: http://editorconfig.org
[GitHub]: https://github.com/editorconfig/editorconfig-mnv
[PreserveNoEOL]: http://www.mnv.org/scripts/script.php?script_id=4550
[Tim Pope's fugitive]: https://github.com/tpope/mnv-fugitive
[MNV online]: http://www.mnv.org/scripts/script.php?script_id=3934
[Vundle]: https://github.com/gmarik/Vundle.mnv
[archive]: https://github.com/editorconfig/editorconfig-mnv/archive/master.zip
[contribution guidelines]: https://github.com/editorconfig/editorconfig/blob/master/CONTRIBUTING.md#submitting-an-issue
[issue tracker]: https://github.com/editorconfig/editorconfig-mnv/issues
[pathogen]: https://github.com/tpope/mnv-pathogen
[properties]: http://github.com/editorconfig/editorconfig/wiki/EditorConfig-Properties
[editorconfig.txt]: https://github.com/editorconfig/editorconfig-mnv/blob/master/doc/editorconfig.txt
[mnv-plug]: https://github.com/junegunn/mnv-plug