.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / stylelint / lib / rules / indentation / README.md
diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/indentation/README.md b/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/indentation/README.md
new file mode 100644 (file)
index 0000000..2532578
--- /dev/null
@@ -0,0 +1,296 @@
+# indentation
+
+Specify indentation.
+
+```css
+   |@media print {
+   |  a {
+   | ↑  background-position: top left,
+   | ↑ ↑  top right;
+   | ↑}↑ ↑
+   |}↑ ↑ ↑
+/**  ↑ ↑ ↑
+ * The indentation at these three points */
+```
+
+The `--fix` option on the [command line](../../../docs/user-guide/cli.md#autofixing-errors) can automatically fix all of the problems reported by this rule.
+
+## Options
+
+`int|"tab"`, where `int` is the number of spaces
+
+### `2`
+
+Always indent at-rules, rules, comments, declarations, inside parentheses and multi-line values by 2 spaces.
+
+The following patterns are considered violations:
+
+```css
+@media print {
+a {
+background-position: top left,
+top right;
+}
+}
+```
+
+```css
+@media print {
+a {
+  background-position: top left,
+    top right;
+  }
+}
+```
+
+```css
+@media print {
+  a {
+    background-position: top left,
+    top right;
+  }
+}
+```
+
+```css
+@media print {
+  a,
+    b {
+    background-position: top left,
+      top right;
+  }
+}
+```
+
+```css
+a {
+/* blergh */
+  color: pink;
+}
+  /* blergh */
+```
+
+```css
+@media print,
+(-webkit-min-device-pixel-ratio: 1.25),
+(min-resolution: 120dpi) {}
+```
+
+```css
+a {
+  color: rgb(
+  255,
+  255,
+  255
+  );
+  top: 0;
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+@media print {
+  a {
+    background-position: top left,
+      top right;
+  }
+}
+```
+
+```css
+@media print {
+  a,
+  b {
+    background-position: top left,
+      top right;
+  }
+}
+```
+
+```css
+a {
+  /* blergh */
+  color: pink;
+}
+/* blergh */
+```
+
+```css
+@media print,
+  (-webkit-min-device-pixel-ratio: 1.25),
+  (min-resolution: 120dpi) {}
+```
+
+```css
+a {
+  color: rgb(
+    255,
+    255,
+    255
+  );
+  top: 0;
+}
+```
+
+## Optional secondary options
+
+### `indentInsideParens: "twice"|"once-at-root-twice-in-block"`
+
+By default, *one extra* indentation (of your specified type) is expected after newlines inside parentheses, and the closing parenthesis is expected to have no extra indentation.
+
+If you would like to change the quantity of extra indentation inside parentheses, use this option.
+
+`"twice"` means you expect two extra indentations (of your specified type) after newlines inside parentheses, and expect the closing parenthesis to have one extra indentation. For example:
+
+```css
+a {
+  color: rgb(
+      255,
+      255,
+      255
+    );
+  top: 0;
+}
+```
+
+`"once-at-root-twice-in-block"` means two things: You want the behavior of `"once"`, as documented above, when the parenthetical expression is part of a node that is an immediate descendent of the root — i.e. not inside a block. And you want the behavior of `"twice"`, as documented above, when the parenthetical expression is part of a node that is inside a block. For example, with a SCSS map:
+
+```scss
+$foo: (
+  bar: 1,
+  baz: 2
+);
+
+a {
+  color: rgb(
+      255,
+      255,
+      255
+    );
+  top: 0;
+}
+```
+
+### `indentClosingBrace: true|false`
+
+If `true`, the closing brace of a block (rule or at-rule) will be expected at the same indentation level as the block's inner nodes.
+
+For example, with `indentClosingBrace: true`.
+
+The following patterns are considered violations:
+
+```css
+a {
+  color: pink;
+}
+```
+
+```css
+@media print {
+  a {
+    color: pink;
+  }
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+  color: pink;
+  }
+```
+
+```css
+@media print {
+  a {
+    color: pink;
+    }
+  }
+```
+
+### `except: ["block", "param", "value"]`
+
+Do *not* indent for these things.
+
+For example, with `2`.
+
+The following patterns are considered violations:
+
+```css
+@media print,
+  (-webkit-min-device-pixel-ratio: 1.25),
+  (min-resolution: 120dpi) {
+  a {
+    background-position: top left,
+      top right;
+  }
+}
+```
+
+The following patterns are *not* considered violations:
+
+```css
+@media print,
+(-webkit-min-device-pixel-ratio: 1.25),
+(min-resolution: 120dpi) {
+a {
+background-position: top left,
+top right;
+}
+}
+```
+
+### `ignore: ["inside-parens", "param", "value"]`
+
+#### `"inside-parens"`
+
+Ignore the indentation inside parentheses.
+
+For example, with `2`.
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+  color: rgb(
+255,
+  255,
+    255
+  );
+  top: 0;
+}
+```
+
+#### `"param"`
+
+Ignore the indentation of at-rule params.
+
+For example, with `2`.
+
+The following patterns are *not* considered violations:
+
+```css
+@media print,
+  (-webkit-min-device-pixel-ratio: 1.25),
+    (min-resolution: 120dpi) {
+}
+```
+
+#### `"value"`
+
+Ignore the indentation of values.
+
+For example, with `2`.
+
+The following patterns are *not* considered violations:
+
+```css
+a {
+  background-position: top left,
+top right,
+  bottom left,
+    bottom right;
+}
+```