Actualizacion maquina principal
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / postcss-scss / README.md
diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/postcss-scss/README.md b/.config/coc/extensions/node_modules/coc-prettier/node_modules/postcss-scss/README.md
new file mode 100644 (file)
index 0000000..66a865e
--- /dev/null
@@ -0,0 +1,89 @@
+# PostCSS SCSS Syntax [![Build Status][ci-img]][ci]
+
+<img align="right" width="95" height="95"
+     title="Philosopher’s stone, logo of PostCSS"
+     src="http://postcss.github.io/postcss/logo.svg">
+
+A [SCSS] parser for [PostCSS].
+
+**This module does not compile SCSS.** It simply parses mixins as custom
+at-rules & variables as properties, so that PostCSS plugins can then transform
+SCSS source code alongside CSS.
+
+[PostCSS]: https://github.com/postcss/postcss
+[ci-img]:  https://img.shields.io/travis/postcss/postcss-scss.svg
+[SCSS]:    http://sass-lang.com/
+[ci]:      https://travis-ci.org/postcss/postcss-scss
+
+<a href="https://evilmartians.com/?utm_source=postcss">
+<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54">
+</a>
+
+
+## Install
+
+```sh
+npm --save install postcss-scss
+```
+
+or (if you use [Yarn](https://yarnpkg.com/))
+
+```sh
+yarn add --dev postcss-scss
+```
+
+
+## Usage
+
+There are two ways to use this parser:
+
+### 1. SCSS Transformations
+
+The main use case of this plugin is to apply PostCSS transformations directly
+to SCSS source code.
+
+For example, you can lint SCSS source with [Stylelint]
+and linter will automatically fix issues in the source.
+
+```js
+// postcss.config.js
+module.exports = {
+  syntax: 'postcss-scss',
+  plugins: {
+    …
+  }
+}
+```
+
+[Stylelint]:    http://stylelint.io/
+
+
+### 2. Inline Comments for PostCSS
+
+Also you can use this parser just to add `//` single-line comment
+to your PostCSS project (without any Sass):
+
+```scss
+:root {
+    // Main theme color
+    --color: red;
+}
+```
+
+Note that you don’t need a special stringifier to handle the output; the default
+one will automatically convert single line comments into block comments.
+
+```js
+// postcss.config.js
+module.exports = {
+  parser: 'postcss-scss',
+  plugins: {
+    …
+  }
+}
+```
+
+If you want Sass behaviour with removing inline comments, you can use
+[postcss-strip-inline-comments] plugin.
+
+[postcss-strip-inline-comments]: https://github.com/mummybot/postcss-strip-inline-comments