https://github.com/tadatuta/borschik-tech-postcss

https://github.com/tadatuta/borschik-tech-postcss

Last synced: 10 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/tadatuta/borschik-tech-postcss
• Owner: tadatuta
• License: mit
• Created: 2015-03-14T15:38:51.000Z (over 9 years ago)
• Default Branch: master
• Last Pushed: 2015-03-14T15:39:19.000Z (over 9 years ago)
• Last Synced: 2024-10-23T20:52:53.517Z (22 days ago)
• Language: JavaScript
• Size: 85 KB
• Stars: 0
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
borschik-tech-postcss

======================

Tech module for [borschik](http://github.com/bem/borschik) which processes the css files like

standard borschik `css` tech with additional source map generation feature. So after processing

your `css` file with `@import` directives you will get new `css` with the imports expanded and a

source map file which describes mapping between the tokens positions in generated file and its

sources.

All processing is done using [postcss](https://github.com/postcss/postcss). Imports are expanded

using [postcss-import](https://github.com/postcss/postcss-import) plugin. CSS minimization is done

using [csswring](https://github.com/hail2u/node-csswring) plugin.

Usage

-----

First you should install `borschik` and this module into your project and save it into `package.json`

    npm install borschik borschik-tech-postcss --save

Then you could run `borschik`

    ./node_modules/.bin/borschik --tech postcss -i your.css -o your.min.css

    

Source map generation is enabled by default. In the case above it will be written to your.min.css.map.

When output is a stream (stdout) the source map will be embedded into css content as a comment pragma.

For example:

```

//# sourceMappingURL=data:application/json;base64, ...

```

    

**Options**

You can disable source map generation using `sourceMap` tech option. For example:

```

./node_modules/.bin/borschik --tech postcss -i your.css -o your.min.css --tech-options '{"sourceMap": false}'

```

You can force to embed source map into file by specifying the `inlineMap` tech option. For example:

```

./node_modules/.bin/borschik --tech postcss -i your.css -o your.min.css --tech-options '{"inlineMap": true}'

```

License

-------

See [MIT](LICENSE) LICENSE.