Edit

stylelint

Supported Version	Language	Runtime	Website
8.3.0+ (default to 12.0.1)	CSS and flavors (e.g. Sass)	Node.js 12.14.0	https://stylelint.io

Getting Started

To start using stylelint, enable it in your repository settings.

If you want to use a version except for the Sider default version or use some plugins or shareable configurations, install it into your repository as follows:

$ npm install stylelint --save-dev

$ npm install stylelint-config-standard --save-dev

Sider supports styelint plugins and configurations that are provided as npm packages.

If you need more customization, use the standard stylelint configuration files. For example, use .stylelintrc.yaml to customize rules, and .stylelintignore to ignore files and directories.

Default Configuration

If you have no custom configuration, Sider uses the latest version of stylelint-config-recommended.

extends: "stylelint-config-recommended"

Also, Sider ignores *.min.css files by default.

Configuration via sider.yml

Here is an example for stylelint:

linter:
  stylelint:
    npm_install: false
    config: my_stylelintrc.yaml
    syntax: sugarss
    ignore-path: .gitignore
    ignore-disables: true
    report-needless-disables: true
    quiet: true
    glob: "**/*.{css,scss}"

You can use the following options to fine-tune stylelint to your project.

Name	Type	Default	Description
root_dir	string	-	A root directory.
npm_install	boolean, string	-	A behavior of npm installation.
config	string	-	--config option of stylelint.
syntax	string	-	--syntax option of stylelint.
ignore-path	string	-	--ignore-path option of stylelint.
ignore-disables	boolean	false	--ignore-disables option of stylelint.
report-needless-disables	boolean	false	--report-needless-disables option of stylelint.
quiet	boolean	false	--quiet option of stylelint.
glob	string	**/*.{css,less,sass,scss,sss}	A glob pattern to analyze.

config

This option allows you to specify a configuration file except for the stylelint default file (e.g. .stylelintrc.json).

syntax

This option allows you to control the non-standard syntaxes (e.g. css-in-js). In contrast, stylelint will automatically infer the standard syntaxes.

ignore-path

This option allows you to exclude files from analysis. By default stylelint uses a .stylelintignore file, but if you want to use another file, set this option. For more details, see the stylelint documentation.

ignore-disables

This option allows you to ignore all disable comments, i.e. /* stylelint-disable block-no-empty */.

report-needless-disables

This option allows you to control whether stylelint-disable comments are reported or not.

quiet

This option allows you to ignore warnings and only report errors.

glob

This option allows you to specify the files or directories to analyze.