From dc25da80f50cad472dc25f2a7659bb8c99c097cb Mon Sep 17 00:00:00 2001 From: ai Date: Fri, 21 Jun 2024 22:24:35 +0000 Subject: [PATCH] =?UTF-8?q?Deploying=20to=20gh-pages=20from=20@=20postcss/?= =?UTF-8?q?postcss.org@9a79e3c609af145b9ec80c22715b11122da0e398=20?= =?UTF-8?q?=F0=9F=9A=80?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/postcss-plugin-guidelines.html | 2 +- docs/postcss-plugins.html | 14 +++++++------- 2 files changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/postcss-plugin-guidelines.html b/docs/postcss-plugin-guidelines.html index 50175fb..d905553 100644 --- a/docs/postcss-plugin-guidelines.html +++ b/docs/postcss-plugin-guidelines.html @@ -8,7 +8,7 @@ without the user necessarily knowing that it is powered by PostCSS — for example, RTLCSS and Autoprefixer.

1.2. Do one thing, and do it well

Do not create multitool plugins. Several small, one-purpose plugins bundled into a plugin pack is usually a better solution.

For example, postcss-preset-env contains many small plugins, -one for each W3C specification. And cssnano contains a separate plugin +one for each W3C specification. And cssnano contains a separate plugin for each of its optimization.

1.3. Do not use mixins

Preprocessors libraries like Compass provide an API with mixins.

PostCSS plugins are different. A plugin cannot be just a set of mixins for postcss-mixins.

To achieve your goal, consider transforming valid CSS or using custom at-rules and custom properties.

1.4. Keep postcss to peerDependencies

AST can be broken because of different postcss version in different plugins. diff --git a/docs/postcss-plugins.html b/docs/postcss-plugins.html index c2ac3e5..2304f27 100644 --- a/docs/postcss-plugins.html +++ b/docs/postcss-plugins.html @@ -18,7 +18,7 @@ and helpers to use as @util rules.

  • atcss contains plugins that transform your CSS according to special annotation comments.
    • -
  • cssnano contains plugins that optimize CSS size for use in production.
    • +
  • cssnano contains plugins that optimize CSS size for use in production.
  • oldie contains plugins that transform your CSS for older Internet Explorer compatibility.
  • rucksack contains plugins to speed up CSS development @@ -257,12 +257,12 @@
  • postcss-resemble-image provides a gradient fallback for an image that loosely resembles the original.
  • postcss-resolve-urls resolves relative urls referenced in url()s
    • -
  • postcss-responsive-images adds stylesheets for making +
  • postcss-responsive-images adds stylesheets for making your images responsive.
  • postcss-sprites generates CSS sprites from stylesheets.
  • postcss-svg insert inline SVG to CSS and allows to manage it colors.
  • postcss-svg-fallback converts SVG in your CSS to PNG files for IE 8.
    • -
  • postcss-svgo processes inline SVG through SVGO.
    • +
  • postcss-svgo processes inline SVG through SVGO.
  • postcss-unicode-characters makes it easier to write unicode-range descriptors.
  • postcss-url rebases or inlines url()s.
    • @@ -304,11 +304,11 @@
  • postcss-remove-root removes all instances of :root from a stylesheet.
  • postcss-single-charset ensures that there is one and only one @charset rule at the top of file.
    • -
  • postcss-zindex rebases positive z-index values.
    • +
  • postcss-zindex rebases positive z-index values.
  • postcss-unprefix Unprefixes vendor prefixes in legacy CSS.
  • css-byebye removes the CSS rules that you don’t want.
  • css-mqpacker joins matching CSS media queries into a single statement.
    • -
  • stylehacks removes CSS hacks based on browser support.
    • +
  • stylehacks removes CSS hacks based on browser support.
  • postcss-mq-optimize removes invalid media queries or its expressions.
  • postcss-uncss removes unused CSS from your stylesheets.
  • postcss-html-filter filters out CSS that does not apply to the HTML @@ -317,7 +317,7 @@
  • postcss-deep-scopable unified deep scoped style for Vue.js.
  • postcss-deadcss helps to find dead CSS in stylesheets.
  • postcss-variable-compress minifies css variables and saves you space.
    • -

    See also plugins in modular minifier cssnano.

    Shortcuts

    See also plugins in modular minifier cssnano.

    Shortcuts

    Reporters