README.md in compass-normalize-1.3 vs README.md in compass-normalize-1.4
- old
+ new
@@ -3,24 +3,26 @@
This simple plugin for [Compass](http://compass-style.org/) enables you to use [normalize.css](http://necolas.github.com/normalize.css/) in your stylesheets without having to download it.
## Installation
+It is highly encouraged to install from the [RubyGems build](http://rubygems.org/gems/compass-normalize) which can be found [here](http://rubygems.org/gems/compass-normalize).
+
From the command line:
```
-$ (sudo) gem install compass-normalize
+$ gem install compass-normalize
```
You can also install the gem from your local fork:
```
$ git clone git://github.com/ksmandersen/compass-normalize.git
$ rake build
$ rake install
```
-
+
## Normalize Versions
Normalize has two versions, a modern Normalize for Firefox 4+, Chrome, Safari 5+, Opera, and Internet Explorer 8+, and a legacy Normalize with support for all legacy versions of those browsers.
## Usage
@@ -48,50 +50,37 @@
```scss
@import 'normalize/html5';
@import 'normalize/base';
@import 'normalize/links';
@import 'normalize/typography';
+@import 'normalize/lists'; // Only for legacy suport (see below).
@import 'normalize/embeds';
@import 'normalize/figures';
@import 'normalize/forms';
@import 'normalize/tables';
```
### Legacy Normalize
-When creating a new project with compass:
+This plugin has been re-written to use compass's native cross-browser variables to determine compatability. http://compass-style.org/reference/compass/support/
+You can still create a legacy project using the following:
+
```
$ compass create <my_project> -r compass-normalize --using compass-normalize/legacy
```
-If using an existing project, edit your config.rb and add this line:
-
-```ruby
-require 'compass-normalize'
-```
-
-To use the normalize plugin, just import and include normalize:
-
+But to just import normalize and include legacy portions of the code, set the necissary legacy-support variables to true:
```scss
-@import normalize-legacy;
+$legacy-support-for-ie6: true;
+$legacy-support-for-ie7: true;
+$legacy-support-for-ie8: true;
+$legacy-support-for-mozilla: true;
+@import normalize;
```
+You can also import any part that you want, just like the code for modern normalize.
-You can also just import parts you need:
-
-```scss
-@import 'normalize-legacy/html5';
-@import 'normalize-legacy/base';
-@import 'normalize-legacy/links';
-@import 'normalize-legacy/typography';
-@import 'normalize-legacy/lists';
-@import 'normalize-legacy/embeds';
-@import 'normalize-legacy/figures';
-@import 'normalize-legacy/forms';
-@import 'normalize-legacy/tables';
-```
-
## Acknowledgements
-Many thanks to [Frederic Hemberger](https://github.com/fhemberger/) and [Sam Richard](https://github.com/snugug) who contributed greatly to this project.
+Many thanks to [Frederic Hemberger](https://github.com/fhemberger/), [Sam Richard](https://github.com/snugug) and [Ian Carrico](https://github.com/ChinggizKhan) who contributed greatly to this project.
## License
This is free and unencumbered software released into the public domain.
Anyone is free to copy, modify, publish, use, compile, sell, or
\ No newline at end of file