+++ /dev/null
-[PostCSS]: https://github.com/postcss/postcss
-[PostCSS-SCSS]: https://github.com/postcss/postcss-scss
-[LESS]: http://lesless.org
-[Autoprefixer]: https://github.com/postcss/autoprefixer
-[Stylelint]: http://stylelint.io/
-
-# PostCSS LESS Syntax [](https://travis-ci.org/shellscape/postcss-less) [](https://www.npmjs.com/package/postcss-less)
-
-[PostCSS] Syntax for parsing [LESS]
-
-<img align="right" width="95" height="95"
- title="Philosopher's stone, logo of PostCSS"
- src="http://postcss.github.io/postcss/logo.svg">
-
-Please note: poscss-less is not a LESS compiler. For compiling LESS, please use
-the official toolset for LESS.
-
-## Getting Started
-
-First thing's first, install the module:
-
-```
-npm install postcss-less --save-dev
-```
-
-## LESS Transformations
-
-The most common use of `postcss-less` is for applying PostCSS transformations
-directly to LESS source. eg. ia theme written in LESS which uses [Autoprefixer]
-to add appropriate vendor prefixes.
-
-```js
-const syntax = require('postcss-less');
-postcss(plugins)
- .process(lessText, { syntax: syntax })
- .then(function (result) {
- result.content // LESS with transformations
-});
-```
-
-## Inline Comments
-
-Parsing of single-line comments in CSS is also supported.
-
-```less
-:root {
- // Main theme color
- --color: red;
-}
-```
-
-Note that you don't need a custom stringifier to handle the output; the default
-stringifier will automatically convert single line comments into block comments.
-If you need to support inline comments, please use a [custom PostCSSLess stringifier](#stringifier).
-
-## Rule Node
-
-[PostCSS Rule Node](https://github.com/postcss/postcss/blob/master/docs/api.md#rule-node)
-
-### rule.empty
-
-Determines whether or not a rule contains declarations.
-
-_Note: Previously `ruleWithoutBody`. This is a breaking change from v0.16.0 to v1.0.0._
-
-```js
-import postCssLess from 'postcss-less';
-const less = `
- .class2 {
- &:extend(.class1);
- .mixin-name(@param1, @param2);
- }
-`;
-const root = postCssLess.parse(less);
-
-root.first.nodes[0].empty // => true for &:extend
-root.first.nodes[1].empty // => true for calling of mixin
-```
-
-### rule.extend
-
-Determines whether or not a rule is [nested](http://lesscss.org/features/#extend-feature-extend-inside-ruleset).
-
-_Note: Previously `extendRule`. This is a breaking change from v0.16.0 to v1.0.0._
-
-```js
-import postCssLess from 'postcss-less';
-const less = `
- .class2 {
- &:extend(.class1);
- }
-`;
-const root = postCssLess.parse(less);
-
-root.first.nodes[0].extend // => true
-```
-
-### rule.important
-
-Determines whether or not a rule is marked as [important](http://lesscss.org/features/#mixins-feature-the-important-keyword).
-
-_Note: This is a breaking change from v0.16.0 to v1.0.0._
-
-```js
-import postCssLess from 'postcss-less';
-const less = `
- .class {
- .mixin !important;
- }
-`;
-const root = postCssLess.parse(less);
-
-root.first.nodes[0].important // => true
-root.first.nodes[0].selector // => '.mixin'
-```
-
-### rule.mixin
-
-Determines whether or not a rule is a [mixin](http://lesscss.org/features/#mixins-feature).
-
-```js
-import postCssLess from 'postcss-less';
-const less = `
- .class2 {
- .mixin-name;
- }
-`;
-const root = postCssLess.parse(less);
-
-root.first.nodes[0].mixin // => true
-```
-
-### rule.nodes
-
-An `Array` of child nodes.
-
-**Note** that `nodes` is `undefined` for rules that don't contain declarations.
-
-```js
-import postCssLess from 'postcss-less';
-const less = `
- .class2 {
- &:extend(.class1);
- .mixin-name(@param1, @param2);
- }
-`;
-const root = postCssLess.parse(less);
-
-root.first.nodes[0].nodes // => undefined for &:extend
-root.first.nodes[1].nodes // => undefined for mixin
-```
-
-## Comment Node
-
-[PostCSS Comment Node](https://github.com/postcss/postcss/blob/master/docs/api.md#comment-node)
-
-### comment.inline
-
-Determines whether or not a comment is inline.
-
-```js
-import postCssLess from 'postcss-less';
-
-const root = postCssLess.parse('// Hello world');
-
-root.first.inline // => true
-```
-
-### comment.block
-
-Determines whether or not a comment is a block comment.
-
-```js
-import postCssLess from 'postcss-less';
-
-const root = postCssLess.parse('/* Hello world */');
-
-root.first.block // => true
-```
-
-### comment.raws.begin
-
-Precending characters of a comment node. eg. `//` or `/*`.
-
-### comment.raws.content
-
-Raw content of the comment.
-
-```js
-import postCssLess from 'postcss-less';
-
-const root = postCssLess.parse('// Hello world');
-
-root.first.raws.content // => '// Hello world'
-```
-
-## Stringifying
-
-To process LESS code without PostCSS transformations, custom stringifier
-should be provided.
-
-```js
-import postcss from 'postcss';
-import postcssLess from 'postcss-less';
-import stringify from 'postcss-less/less-stringify';
-
-const lessCode = `
- // Non-css comment
-
- .container {
- .mixin-1();
- .mixin-2;
- .mixin-3 (@width: 100px) {
- width: @width;
- }
- }
-
- .rotation(@deg:5deg){
- .transform(rotate(@deg));
- }
-`;
-
-postcss()
- .process(less, {
- syntax: postcssLess,
- stringifier: stringify
- })
- .then((result) => {
- console.log(result.content); // this will be value of `lessCode` without changing comments or mixins
-});
-```
-
-## Use Cases
-
-* Lint LESS code with 3rd-party plugins.
-* Apply PostCSS transformations (such as [Autoprefixer](https://github.com/postcss/autoprefixer)) directly to the LESS source code
-
-## Contribution
-
-Please, check our guidelines: [CONTRIBUTING.md](./CONTRIBUTING.md)
-
-## Attribution
-
-This module is based on the [postcss-scss](https://github.com/postcss/postcss-scss) library.
-
-[](https://www.npmjs.com/package/postcss-less)
-[](https://www.npmjs.com/package/postcss-less)
-[](https://github.com/keithamus/eslint-config-strict)
projects / dotfiles / .git / blobdiff