Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/csscomb/csscomb.js
CSS coding style formatter
https://github.com/csscomb/csscomb.js
csscomb
Last synced: about 2 months ago
JSON representation
CSS coding style formatter
- Host: GitHub
- URL: https://github.com/csscomb/csscomb.js
- Owner: csscomb
- License: mit
- Created: 2013-07-31T05:52:35.000Z (about 11 years ago)
- Default Branch: dev
- Last Pushed: 2023-01-03T18:24:31.000Z (over 1 year ago)
- Last Synced: 2024-06-26T02:31:37.557Z (3 months ago)
- Topics: csscomb
- Language: JavaScript
- Homepage: http://csscomb.com/
- Size: 1.11 MB
- Stars: 3,280
- Watchers: 74
- Forks: 460
- Open Issues: 107
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
Awesome Lists containing this project
- awesome-linters - csscomb - CSS tool that beautifies (Linters / CSS)
README
# CSScomb [](http://csscomb.com/)
[](http://travis-ci.org/csscomb/csscomb.js)
[](http://badge.fury.io/js/csscomb)
[](https://david-dm.org/csscomb/csscomb.js)
[](https://david-dm.org/csscomb/csscomb.js#info=devDependencies)
CSScomb is a coding style formatter for CSS.
You can easily write your own [configuration](doc/configuration.md) to make
your style sheets beautiful and consistent.
The main feature is [sorting properties](doc/options.md#sort-order) in a specific order.
It was inspired by [@miripiruni](https://github.com/miripiruni)'s
[PHP-based tool](https://github.com/csscomb/csscomb) of the same name.
This is the new JavaScript version, based on the powerful CSS parser
[Gonzales PE](https://github.com/tonyganch/gonzales-pe).
## 1. Install
Global installation (for use as a command-line tool):
```bash
npm install csscomb -g
```
Local installation (for use as a command-line tool within current directory):
```bash
npm install csscomb
```
To install as a project dependency (the package will appear in your dependencies):
```bash
npm install csscomb --save
```
To install as a dev dependency (the package will appear in your devDependencies):
```bash
npm install csscomb --save-dev
```
## 2. [Configure](doc/configuration.md)
There are a number of ways to configure CSScomb:
- Use one of [predefined configs](config)
- Put `.csscomb.json` file in the project root.
- Set path to config's file
- Use `*.css` file as a template
## 3. Use
### [Command Line](doc/usage-cli.md)
```bash
csscomb assets/css
```
### [Node.js module](doc/usage-node.md)
```js
var Comb = require('csscomb');
var comb = new Comb('zen');
comb.processPath('assets/css');
```
## 4. Contribute
This project is actively mantained. But anyone and everyone is welcome to contribute.
Please take a moment to review the [guidelines for contributing](CONTRIBUTING.md).
Also you can become a maintainer. To do that please ping
[@tonyganch](https://github.com/tonyganch).
## Authors
[@mishanga](https://github.com/mishanga),
[@tonyganch](https://github.com/tonyganch)
Thanks for assistance and contributions:
[@miripiruni](https://github.com/miripiruni),
[@anton-rudeshko](https://github.com/anton-rudeshko),
[@cvrebert](https://github.com/cvrebert),
[@filtercake](https://github.com/filtercake),
[@ignovak](https://github.com/ignovak),
[@kizu](https://github.com/kizu),
[@lefoy](https://github.com/lefoy),
[@L0stSoul](https://github.com/L0stSoul),
[@mishaberezin](https://github.com/mishaberezin),
[@puzankov](https://github.com/puzankov),
[@schneyra](https://github.com/schneyra),
[@thejameskyle](https://github.com/thejameskyle),
[@vecmezoni](https://github.com/vecmezoni)
## License
This software is released under the terms of the
[MIT license](https://github.com/csscomb/csscomb.js/blob/master/LICENSE).
## Other projects
* https://github.com/senchalabs/cssbeautify
* https://github.com/css/gonzales
* https://github.com/tonyganch/gonzales-pe
* https://github.com/css/csso
* https://github.com/nzakas/parser-lib