fis3-postprocessor-postcss - npm Package Compare versions

Comparing version 0.1.0 to 0.1.1

index.js

@@ -66,2 +66,4 @@ /**
       content += mapGuide.replace('{url}', url);
+    } else if (mapObj) {
+      derived[0].setContent(ret.map.toString('utf8'));
     }
@@ -68,0 +70,0 @@ }

package.json

 {
   "name": "fis3-postprocessor-postcss",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "fis3 postcss",
@@ -8,3 +8,3 @@ "main": "index.js",
     "test": "mocha tests",
-    "publish": "npm publish --registry https://registry.npmjs.com/",
+    "pub": "npm publish --registry https://registry.npmjs.com/",
     "commitmsg": "validate-commit-msg",
@@ -11,0 +11,0 @@ "precommit": "npm t"

README.md

@@ -1,1 +0,64 @@
-# fis3-postprocessor-postcss
+fis3-postprocessor-postcss
+==========================
+
+fis3 的 [postcss](https://github.com/postcss/postcss) 插件。
+内置 [autoprefixer](https://github.com/postcss/autoprefixer) 。
+
+## 使用
+### 安装
+
+```
+npm i fis3-postprocessor-postcss -g
+```
+
+### 配置
+```js
+fis.match('*.css', {
+  postprocessor: fis.plugin('postcss')
+});
+
+// 如果你的项目中有 scss
+
+fis.match('*.scss', {
+  rExt: 'css',
+  parser: fis.plugin('node-sass', {
+    sourceMap: true
+  })
+});
+
+// 非下划线开头的才 autoprefixer
+fis.match(/.*\/[a-zA-Z0-9]+\.scss$/, {
+  postprocessor: fis.plugin('postcss')
+});
+```
+
+### 参数
+```js
+{
+  plugins: [], // 其他插件
+  sourceMap: true, // 是否生成 source map
+  sourceMapRelative: false // 指向 source map 的路径是否是相对路径
+}
+```
+
+## 单测
+```
+npm t
+```
+
+## 其他 postcss 插件
+
+```
+var cssnext = require('postcss-cssnext');
+fis.match('*.css', {
+  postprocessor: fis.plugin('postcss', {
+    plugins: [cssnext] // 内置的 autoperfixer 会被覆盖掉，当然 cssnext 自带 autoprefixer
+  });
+});
+```
+
+## FAQ
+* Q: postprocessor.postcss: No element indexed by 5
+使用 `sass` 并且全程启用 `sourceMap` 的时候，有时会抛出这个错误。
+请检查 `sass` 的 `import` 是否太过混乱，这个错误通常是因为 sourceMap 计算源文件的行列时遇到不合乎逻辑的各种奇怪文件依赖引起。
+

No alert changes

Improved metrics

Lines of code

57

increased by3.64%

Number of lines in readme file

65

increased by3150%

Worsened metrics

Total package byte prevSize

5317

decreased by-91.88%

Number of package files

5

decreased by-68.75%

No dependency changes