Code Monkey home page Code Monkey logo

normalize-scss's Introduction

Latest downloadable version

The latest release of _normalize.scss for Sass 3.3 and Compass 1.0 is: 3.0.0-alpha.2+normalize.3.0.0. It combines normalize.css v3.0.0 and normalize v1.1.3.

The latest release of _normalize.scss for Sass 3.2 and Compass 0.12 is: 2.2.0+normalize.2.1.3. It combines normalize.css v2.1.3 and normalize v1.1.3.

The Compass port of normalize.css

This project is the Sass/Compass version of Normalize.css, a collection of HTML element and attribute rulesets to normalize styles across all browsers. This port aims to use the best partials from Compass to make Normalize even easier to integrate with your website. To learn about why Normalize.css is so amazing, skip to the "normalize.css" section below.

This Sass/Compass port currently utilizes:

  • Legacy IE support variables
  • CSS3 Box Sizing mixin
  • Vertical Rhythm mixins

In addition, Normalize.css has 2 major versions: version 2 (without legacy browser support) and version 1 (with support for IE 6/7, etc.) This Compass port combines the two versions into one file so that you can easily toggle between the two versions using Compass' $legacy-support-for-ie7 variable.

Did a client wait until the last minute to mention their CEO uses IE 7? Simply set $legacy-support-for-ie7 to true and recompile your Sass files.

normalize.css v3

Normalize.css is a customisable CSS file that makes browsers render all elements more consistently and in line with modern standards.

The project relies on researching the differences between default browser styles in order to precisely target only the styles that need or benefit from normalizing.

View the test file

Install

Install using one of the following methods:

Download from the project page.

Install with Bower: bower install --save normalize.scss (or to install the latest pre-release version: bower install --save normalize.scss#3.0.0-alpha.2+normalize.3.0.0)

Install with Component(1): component install JohnAlbin/normalize-scss

Install with Ruby Gem: sudo gem install normalize-scss (or to install the latest pre-release version: sudo gem install --pre normalize-scss)

What does it do?

  • Preserves useful defaults, unlike many CSS resets.
  • Normalizes styles for a wide range of elements.
  • Corrects bugs and common browser inconsistencies.
  • Improves usability with subtle improvements.
  • Explains what code does using detailed comments.

How to use it

No other styles should come before Normalize.css.

For more information about how to use it, see the About normalize.css article.

To use the Compass port of Normalize, simply copy the _normalize.scss file to your sass directory and follow the article's suggestions:

  • Approach 1: use _normalize.scss as a starting point for your own project's base Sass, customising the values to match the design's requirements. (The best approach, IMO.)
  • Approach 2: include _normalize.scss untouched and build upon it, overriding the defaults later in your Sass if necessary.

Browser support

  • Google Chrome (latest)
  • Mozilla Firefox (latest)
  • Mozilla Firefox 4
  • Opera (latest)
  • Apple Safari 6+
  • Internet Explorer 8+
  • Internet Explorer 6-7 (when $legacy-support-for-ie7 or $legacy-support-for-ie6 is set to true)

Normalize.css v1 provides legacy browser support (IE 6+, Safari 4+), but is no longer actively developed.

Contributing

Please read Necolas' contributing guidelines.

Updates to most CSS rules should be reported to Necolas' upstream Normalize.css project. Updates to the Sass should be reported in the Normalize-scss project.

Acknowledgements

Normalize.css is a project by Nicolas Gallagher, co-created with Jonathan Neal.

This Sass/Compass port is a project by John Albin Wilkins.

Other ports of Normalize.css

For the record, there are several other Sass or Compass ports as well. Including:

Some of the above projects convert normalize into Sass mixins. That makes it impossible to add Normalize using Approach 1 (by copying the file into your website and customizing/overriding for your needs.)

Build Status

normalize-scss's People

Contributors

necolas avatar johnalbin avatar jonathantneal avatar dawidkkruczek avatar austinwi avatar limeblast avatar calvein avatar grayghostvisuals avatar drublic avatar mathiasbynens avatar wilddeer avatar rdela avatar seutje avatar tj avatar tjvantoll avatar

Watchers

Pankesh Bamotra avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.