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