pure/README.md

126 lines
3.4 KiB
Markdown
Raw Normal View History

2013-05-16 17:01:32 +00:00
Pure
====
2013-05-20 17:23:59 +00:00
2013-05-22 18:17:43 +00:00
[![Pure](http://f.cl.ly/items/2y0M0E2Q3a2H0z1N1Y19/pure-banner.png)][Pure]
2013-05-20 17:23:59 +00:00
A set of small, responsive CSS modules that you can use in every web project.
2013-05-22 12:06:01 +00:00
[http://purecss.io/][Pure]
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
**Use From the CDN:**
2013-05-20 17:25:26 +00:00
```html
<link rel="stylesheet" href="http://yui.yahooapis.com/pure/0.0.2/pure-min.css">
```
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
[Pure]: http://purecss.io/
Features
--------
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
Pure is meant to be a starting point for every website or web app. We take care
of all the CSS work that every site needs, without making it look cookie-cutter:
2013-05-20 17:23:59 +00:00
* A responsive grid that can be customized to your needs.
2013-05-22 12:06:01 +00:00
* A solid base built on [Normalize.css][] to fix cross-browser compatibility
issues.
* Consistently styled buttons that work with `<a>` and `<button>` elements.
2013-05-22 12:06:01 +00:00
* Styles for vertical and horizontal menus, including support for dropdown
menus.
* Useful form alignments that look great on all screen sizes.
* Various common table styles.
* An extremely minimalist look that is super-easy to customize.
* Responsive by default, with a non-responsive option.
2013-05-22 12:06:01 +00:00
* Easy one-click customization with the [Skin Builder][]
* Extremely small file size: **4.8KB minified + gzip**
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
[Normalize.css]: http://necolas.github.io/normalize.css/
[Skin Builder]: http://yui.github.io/skinbuilder/?mode=pure
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
Get Started
-----------
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
To get started using Pure, go to the [Pure CSS website][Pure]. The website has
extensive documentation and examples necessary to get you started using Pure.
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
You can include the Pure CSS file in your project by fetching it from Yahoo's
CDN:
2013-05-20 17:23:59 +00:00
2013-05-20 17:25:26 +00:00
```html
<link rel="stylesheet" href="http://yui.yahooapis.com/pure/0.0.2/pure-min.css">
```
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
Build From Source
-----------------
Optionally, you can build Pure from its source on Github. To do this, you'll
need to have NodeJS and npm installed. We use Grunt to build Pure.
2013-05-20 17:23:59 +00:00
```shell
$ git clone git@github.com:yui/pure.git
$ cd pure
$ npm install
$ grunt
2013-05-20 17:23:59 +00:00
```
2013-05-22 12:06:01 +00:00
Now, all Pure CSS files should be built into the `pure/build/` directory. All
files that are in this build directory are also available on the CDN. The naming
conventions of the files in the `build/` directory follow these rules:
2013-05-22 12:06:01 +00:00
* `[module]-nr.css`: Rollup of `[module]-core.css` + `[module].css` +
`[module]-[feature].css` from the `src/[module]/` dir. This is the
non-responsive version of a module.
2013-05-22 12:06:01 +00:00
* `[module].css`: Rollup of `[module]-nr.css` + `[module]-r.css` from the
`build/` dir. This is the responsive version of a module.
2013-05-22 12:06:01 +00:00
* `*-min.css`: A minified file version of the files of the same name.
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
* `pure-min.css`: A rollup of all `[module]-min.css` files in the `build/` dir.
This is a responsive roll-up of everything.
2013-05-22 12:06:01 +00:00
* `pure-nr-min.css`: A Rollup of all modules without @media queries. This is a
non-responsive roll-up of everything.
2013-05-20 17:23:59 +00:00
2013-05-22 12:06:01 +00:00
### Building Specific Modules
2013-05-20 17:23:59 +00:00
You can build a specific module by passing in its name into Grunt:
```shell
$ grunt grids
2013-05-20 17:23:59 +00:00
```
2013-05-22 12:06:01 +00:00
Contributions and Code Standards
--------------------------------
Feel free to file bugs and submit pull requests on Github! When submitting a
pull request, please checkout a new feature branch, and submit your pull request
from it. Please do not submit pull requests from your `master` branch.
2013-05-20 17:23:59 +00:00
### Versioning
Pure adheres to [Semantic Versioning 2.0](http://semver.org/).
2013-05-22 12:06:01 +00:00
License
-------
2013-05-20 17:23:59 +00:00
This software is free to use under the Yahoo! Inc. BSD license.
2013-05-22 12:06:01 +00:00
See the [LICENSE file][] for license text and copyright information.
[LICENSE file]: https://github.com/yui/pure/blob/master/LICENSE.md