mirror of
https://github.com/dense-analysis/ale.git
synced 2025-12-06 04:34:25 +08:00
400857d758
1. Add ale.setup and ale.setup.buffer for pure Lua configuration. 2. Update many global settings to use Booleans instead of numbers to make types easiert to work with in Lua. 3. Radically reformat documentation and fix errors to make documentation more usable for Neovim users.
82 lines
2.9 KiB
Plaintext
82 lines
2.9 KiB
Plaintext
===============================================================================
|
|
ALE OpenApi Integration *ale-openapi-options*
|
|
|
|
|
|
===============================================================================
|
|
ibm_validator *ale-openapi-ibm-validator*
|
|
|
|
Website: https://github.com/IBM/openapi-validator
|
|
|
|
|
|
-------------------------------------------------------------------------------
|
|
Installation
|
|
|
|
Install ibm-openapi-validator either globally or locally: >
|
|
|
|
npm install ibm-openapi-validator -g # global
|
|
npm install ibm-openapi-validator # local
|
|
<
|
|
|
|
-------------------------------------------------------------------------------
|
|
Configuration
|
|
|
|
OpenAPI files can be written in YAML or JSON so in order for ALE plugins to
|
|
work with these files we must set the buffer |filetype| to either |openapi.yaml|
|
|
or |openapi.json| respectively. This causes ALE to lint the file with linters
|
|
configured for openapi and yaml files or openapi and json files respectively.
|
|
|
|
For example setting filetype to |openapi.yaml| on a buffer and the following
|
|
|g:ale_linters| configuration will enable linting of openapi files using both
|
|
|ibm_validator| and |yamlint|:
|
|
|
|
>
|
|
let g:ale_linters = {
|
|
\ 'yaml': ['yamllint'],
|
|
\ 'openapi': ['ibm_validator']
|
|
\}
|
|
<
|
|
|
|
The following plugin will detect openapi files automatically and set the
|
|
filetype to |openapi.yaml| or |openapi.json|:
|
|
|
|
https://github.com/hsanson/vim-openapi
|
|
|
|
|
|
-------------------------------------------------------------------------------
|
|
Options
|
|
*ale-options.openapi_ibm_validator_executable*
|
|
*g:ale_openapi_ibm_validator_executable*
|
|
*b:ale_openapi_ibm_validator_executable*
|
|
openapi_ibm_validator_executable
|
|
g:ale_openapi_ibm_validator_executable
|
|
Type: |String|
|
|
Default: `'lint-openapi'`
|
|
|
|
This variable can be set to change the path to lint-openapi.
|
|
|
|
*ale-options.openapi_ibm_validator_options*
|
|
*g:ale_openapi_ibm_validator_options*
|
|
*b:ale_openapi_ibm_validator_options*
|
|
openapi_ibm_validator_options
|
|
g:ale_openapi_ibm_validator_options
|
|
Type: |String|
|
|
Default: `''`
|
|
|
|
This variable can be set to pass additional options to lint-openapi.
|
|
|
|
|
|
===============================================================================
|
|
prettier *ale-openapi-prettier*
|
|
|
|
See |ale-javascript-prettier| for information about the available options.
|
|
|
|
|
|
===============================================================================
|
|
yamllint *ale-openapi-yamllint*
|
|
|
|
See |ale-yaml-yamllint| for information about the available options.
|
|
|
|
|
|
===============================================================================
|
|
vim:tw=78:ts=2:sts=2:sw=2:ft=help:norl:
|