.gitignore added
[dotfiles/.git] / .config / coc / extensions / node_modules / coc-prettier / node_modules / stylelint / lib / rules / font-family-no-duplicate-names / README.md
diff --git a/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/font-family-no-duplicate-names/README.md b/.config/coc/extensions/node_modules/coc-prettier/node_modules/stylelint/lib/rules/font-family-no-duplicate-names/README.md
new file mode 100644 (file)
index 0000000..d9afa94
--- /dev/null
@@ -0,0 +1,68 @@
+# font-family-no-duplicate-names
+
+Disallow duplicate font family names.
+
+```css
+a { font-family: serif, serif; }
+/**              ↑      ↑
+ * These font family names */
+```
+
+This rule checks the `font` and `font-family` properties.
+
+This rule ignores `$sass`, `@less`, and `var(--custom-property)` variable syntaxes.
+
+**Caveat:** This rule will stumble on *unquoted* multi-word font names and *unquoted* font names containing escape sequences. Wrap these font names in quotation marks, and everything should be fine.
+
+## Options
+
+### `true`
+
+The following patterns are considered violations:
+
+```css
+a { font-family: 'Times', Times, serif; }
+```
+
+```css
+a { font: 1em "Arial", 'Arial', sans-serif; }
+```
+
+```css
+a { font: normal 14px/32px -apple-system, BlinkMacSystemFont, sans-serif, sans-serif; }
+```
+
+The following patterns are *not* considered violations:
+
+```css
+a { font-family: Times, serif; }
+```
+
+```css
+a { font: 1em "Arial", "sans-serif", sans-serif; }
+```
+
+```css
+a { font: normal 14px/32px -apple-system, BlinkMacSystemFont, sans-serif; }
+```
+
+## Optional secondary options
+
+### `ignoreFontFamilyNames: ["/regex/", "string"]`
+
+Given:
+
+```js
+["/^My Font /", "monospace"]
+```
+
+The following patterns are *not* considered violations:
+
+```css
+font-family: monospace, monospace
+```
+
+```css
+font-family: "My Font Family", "My Font Family", monospace
+```
+