stylus/README.md

66 lines
3.9 KiB
Markdown
Raw Normal View History

Stylus is a fork of Stylish for Chrome, also compatible with Firefox as a WebExtension
2013-01-15 02:26:30 +00:00
## Highlights
* In addition to the userstyles.org site, styles with customizable parameters can also be installed from .user.css or .user.styl URLs (see [Usercss format wiki](https://github.com/openstyles/stylus/wiki/Usercss)).
* Site styles can be discovered and previewed in the popup using inline search with screenshot thumbnails.
* A backup feature which is compatible with other userstyles managers.
* Configurable automatic update function for installed styles.
* Customizable UI, optional layouts, and tweaks.
* Two different optional code validators with user-configurable rules: CSSLint and Stylelint.
* Both validators use Web Worker API to run in a separate background thread inside the editor tab without blocking your interaction with the code.
* CSSLint is heavily modified compared to the effectively frozen original one and supports various CSS3 features as well as CSS4 Color and CSS Grid syntax.
2014-10-03 20:48:42 +00:00
## Releases
1. [Chrome Web Store](https://chrome.google.com/webstore/detail/stylus/clngdbkpkpeebahjckkjfobafhncgmne) (or [beta](https://chrome.google.com/webstore/detail/stylus-beta/apmmpaebfobifelkijhaljbmpcgbjbdo))
2. [Firefox add-ons](https://addons.mozilla.org/firefox/addon/styl-us/) (or [beta](https://addons.mozilla.org/en-US/firefox/addon/styl-us/versions/beta))
3. [Opera add-ons](https://addons.opera.com/extensions/details/stylus/)
2017-03-16 15:01:03 +00:00
## Screenshots
2017-03-16 15:01:03 +00:00
![Style manager](https://user-images.githubusercontent.com/1310400/34453460-214eaa5c-ed67-11e7-843b-d8960b71db6e.png)
![Style editor](https://user-images.githubusercontent.com/1310400/34453648-a78bf1a8-ed6a-11e7-9afe-9651a85321aa.png)
![Popup config for usercss](https://user-images.githubusercontent.com/1310400/34453462-218a589a-ed67-11e7-9040-7d0469eeadc3.png)
![Popup inline search](https://user-images.githubusercontent.com/1310400/34453463-21a44368-ed67-11e7-93b2-e1c8f5aac868.png)
![Style manager config for usercss](https://user-images.githubusercontent.com/1310400/34453464-21bdaf9c-ed67-11e7-8517-62d2f02e1918.png)
![Options](https://user-images.githubusercontent.com/1310400/34453461-216aee4c-ed67-11e7-92db-ea21c1da5826.png)
2017-03-16 15:01:03 +00:00
2014-10-03 20:48:42 +00:00
## Help
2017-11-20 20:08:14 +00:00
[![Discord][chat-image]][chat-link]
2017-03-16 15:01:03 +00:00
See the [help docs](http://userstyles.org/help/stylish_chrome) or [ask in userstyles.org forum](https://forum.userstyles.org). For Stylus specific questions and suggestions please use [review section](http://add0n.com/stylus.html#reviews) of the FAQs page.
2014-10-03 20:48:42 +00:00
2017-11-20 20:08:14 +00:00
[chat-image]: https://img.shields.io/discord/379521691774353408.svg
[chat-link]: https://discordapp.com/widget?id=379521691774353408
2014-10-03 20:48:42 +00:00
## Contributing
The source is hosted on [GitHub](https://github.com/openstyles/stylus) and pull requests are welcome.
2017-03-10 08:51:25 +00:00
You can help us translate the extension on [Transifex](https://www.transifex.com/github-7/Stylus). When `messages.json` file is ready to be merged, please open a new bug report in [stylus/issues](https://github.com/openstyles/stylus/issues).
See our [contributing](./.github/CONTRIBUTING.md) page for more details.
2017-03-16 15:01:03 +00:00
2014-10-03 20:48:42 +00:00
## License
2013-01-15 02:26:30 +00:00
For copyright status of the "codemirror" directory, see [codemirror/LICENSE](https://github.com/openstyles/stylus/blob/master/src/vendor/codemirror/LICENSE). Everything else is:
2013-01-15 02:26:30 +00:00
2014-10-03 20:48:42 +00:00
Copyright (C) 2005-2014 Jason Barnabe <jason.barnabe@gmail.com>
2013-01-15 02:26:30 +00:00
2017-02-05 22:27:04 +00:00
Copyright (C) 2017 Stylus Team
2013-01-15 02:26:30 +00:00
This program is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or
(at your option) any later version.
This program is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program. If not, see <http://www.gnu.org/licenses/>.