diff --git a/README.md b/README.md index 71954f230..c24cf8785 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,7 @@ -# normalize.css - Normalize Logo + width="160" height="160" align="left"> +# normalize.css > A modern alternative to CSS resets @@ -10,23 +9,23 @@ [![changelog][changelog-image]][changelog-url] [![gitter][gitter-image]][gitter-url] +--- -**NPM** - -```sh -npm install --save normalize.css -``` +## Setting Up -**CDN** +* CDN available [here](https://yarnpkg.com/en/package/normalize.css) -See https://yarnpkg.com/en/package/normalize.css +* Download normalize.css [here](https://necolas.github.io/normalize.css/latest/normalize.css) -**Download** +* Using npm: -See https://necolas.github.io/normalize.css/latest/normalize.css +```sh +npm install --save normalize.css +``` +--- -## What does it do? +## What Does It Do? * Preserves useful defaults, unlike many CSS resets. * Normalizes styles for a wide range of elements. @@ -34,8 +33,9 @@ See https://necolas.github.io/normalize.css/latest/normalize.css * Improves usability with subtle modifications. * Explains what code does using detailed comments. +--- -## Browser support +## Browser Support * Chrome * Edge @@ -44,41 +44,42 @@ See https://necolas.github.io/normalize.css/latest/normalize.css * Safari 8+ * Opera +--- -## Extended details and known issues +## Extended Details and Known Issues -Additional detail and explanation of the esoteric parts of normalize.css. +Additional detail and explanation of the esoteric parts of normalize.css: -#### `pre, code, kbd, samp` +### `pre, code, kbd, samp` -The `font-family: monospace, monospace` hack fixes the inheritance and scaling +* The `font-family: monospace, monospace` hack fixes the inheritance and scaling of font-size for preformatted text. The duplication of `monospace` is -intentional. [Source](https://en.wikipedia.org/wiki/User:Davidgothberg/Test59). +intentional [(Source)](https://en.wikipedia.org/wiki/User:Davidgothberg/Test59). -#### `sub, sup` +### `sub, sup` -Normally, using `sub` or `sup` affects the line-box height of text in all -browsers. [Source](https://gist.github.com/413930). +* Normally, using `sub` or `sup` affects the line-box height of text in all +browsers [(Source)](https://gist.github.com/413930). -#### `select` +### `select` -By default, Chrome on OS X and Safari on OS X allow very limited styling of +* By default, Chrome on OS X and Safari on OS X allow very limited styling of `select`, unless a border property is set. The default font weight on `optgroup` elements cannot safely be changed in Chrome on OSX and Safari on OS X. -#### `[type="checkbox"]` +### `[type="checkbox"]` -It is recommended that you do not style checkbox and radio inputs as Firefox's +* It is recommended that you do not style checkbox and radio inputs as Firefox's implementation does not respect box-sizing, padding, or width. -#### `[type="number"]` +### `[type="number"]` -Certain font size values applied to number inputs cause the cursor style of the +* Certain font size values applied to number inputs cause the cursor style of the decrement button to change from `default` to `text`. -#### `[type="search"]` +### `[type="search"]` -The search input is not fully stylable by default. In Chrome and Safari on +* The search input is not fully stylable by default. In Chrome and Safari on OSX/iOS you can't control `font`, `padding`, `border`, or `background`. In Chrome and Safari on Windows you can't control `border` properly. It will apply `border-width` but will only show a border color (which cannot be controlled)