Comparing version 5.0.0-beta.6 to 5.0.0-beta.7
@@ -8,4 +8,35 @@ # Change Log | ||
[Unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.6...HEAD | ||
Nothing at the moment. | ||
[Unreleased]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.7...HEAD | ||
## [5.0.0-beta.7] - 2016-11-03 | ||
### Added | ||
- Added `white-space: nowrap;` to the `hide-visually` mixin so that content | ||
renders on one line and is correctly pronounced by screen readers. | ||
### Changed | ||
- Removed the default values from the `$position` and `$coordinates` arguments | ||
for the `position` mixin. | ||
- Updated `contrast-switch` to calculate contrast based on the WCAG 2.0 | ||
specification. Please note that it is an approximation and we cannot guarantee | ||
full compliance, though all of our manual testing passed. | ||
- Renamed the `$coordinates` argument in the `position` mixin | ||
to `$box-edge-values`. | ||
- Updated `$font-stack-system` to include Avenir Next, Avenir, Lucida | ||
Grande, Helvetica, Noto, Franklin Gothic Medium, Century Gothic, and | ||
Liberation Sans. This follows [system-fonts] by Adam Morse. | ||
- The `word-break` property was removed from the `word-wrap` mixin and | ||
is no longer output. | ||
- Renamed the `word-wrap` mixin to `overflow-wrap` to align with the | ||
name change in the [CSS spec]. | ||
[system-fonts]: https://github.com/mrmrs/css-system-fonts | ||
[CSS spec]: https://drafts.csswg.org/css-text-3/#propdef-overflow-wrap | ||
[5.0.0-beta.7]: https://github.com/thoughtbot/bourbon/compare/v5.0.0.beta.6...v5.0.0.beta.7 | ||
## [5.0.0-beta.6] - 2016-06-06 | ||
@@ -12,0 +43,0 @@ |
@@ -9,3 +9,3 @@ { | ||
}, | ||
"description": "A simple and lightweight mixin library for Sass.", | ||
"description": "A lightweight Sass tool set.", | ||
"eyeglass": { | ||
@@ -33,3 +33,3 @@ "needs": "*", | ||
}, | ||
"version": "5.0.0-beta.6" | ||
"version": "5.0.0-beta.7" | ||
} |
155
README.md
@@ -1,29 +0,48 @@ | ||
[![Bourbon](http://images.thoughtbot.com/bourbon/bourbon-logo.svg)](http://bourbon.io) | ||
[<img src="https://images.thoughtbot.com/bourbon/bourbon-logo.svg" width="200" alt="Bourbon logo">][Bourbon] | ||
[![GitHub release](https://img.shields.io/github/release/thoughtbot/bourbon.svg)](https://github.com/thoughtbot/bourbon/releases) | ||
[![CircleCI branch](https://img.shields.io/circleci/project/thoughtbot/bourbon/master.svg)](https://circleci.com/gh/thoughtbot/bourbon/tree/master) | ||
## A Lightweight Sass Tool Set | ||
## A simple and lightweight mixin library for Sass. | ||
[Bourbon] is a library of [Sass] mixins and functions that are designed to make | ||
you a more efficient style sheet author. | ||
Bourbon is a library of pure Sass mixins that are designed to be simple and easy to use. No configuration required. The mixins aim to be as vanilla as possible, meaning they should be as close to the original CSS syntax as possible. | ||
It is… | ||
The mixins contain vendor specific prefixes for all CSS3 properties for support amongst modern browsers. The prefixes also ensure graceful degradation for older browsers that support only CSS3 prefixed properties. Bourbon uses SCSS syntax. | ||
- Dependency-free: Bourbon is pure Sass. | ||
- Human-readable: We aim for clarity over brevity. | ||
- Lightweight: Zero output post-install and has no visual opinion. | ||
- **[Documentation](http://bourbon.io/docs)** | ||
- **[Changelog](https://github.com/thoughtbot/bourbon/releases)** | ||
- **[Issues & Bugs](https://github.com/thoughtbot/bourbon/issues)** | ||
The current version is **4.2.7**. The `master` branch on GitHub is version | ||
5.0.0-beta.7. | ||
Follow the [@bourbonsass](https://twitter.com/bourbonsass) Twitter account | ||
for updates. | ||
[Bourbon]: http://bourbon.io | ||
[Sass]: http://sass-lang.com | ||
### Helpful Links | ||
- [Documentation](http://bourbon.io/docs/latest/) | ||
- [Change log](CHANGELOG.md) | ||
- [Twitter](https://twitter.com/bourbonsass) | ||
## Table of Contents | ||
- [Requirements](#requirements) | ||
- [Installation](#installation) | ||
- [Command Line Interface](#command-line-interface) | ||
- [Browser Support](#browser-support) | ||
- [The Bourbon Family](#the-bourbon-family) | ||
- [Contributing](#contributing) | ||
- [License](#license) | ||
- [About](#about) | ||
## Requirements | ||
- [Sass](https://github.com/sass/sass) 3.4+ or [LibSass](https://github.com/sass/libsass) 3.3+ | ||
- [Sass] 3.4+ or [LibSass] 3.3+ | ||
[Sass]: https://github.com/sass/sass | ||
[LibSass]: https://github.com/sass/libsass | ||
## Installation | ||
For command line help, visit our wiki page on Bourbon’s [command line interface](https://github.com/thoughtbot/bourbon/wiki/Command-Line-Interface). | ||
1. Install the Bourbon gem using the [RubyGems] package manager: | ||
1. Install the Bourbon gem using the [RubyGems](https://rubygems.org) package manager: | ||
```bash | ||
@@ -33,3 +52,3 @@ gem install bourbon | ||
Alternatively, you can install Bourbon with [Bower](http://bower.io). | ||
Alternatively, you can install Bourbon with [Bower]. | ||
@@ -42,3 +61,4 @@ 1. Install the Bourbon library into the current directory: | ||
**Pro Tip:** You can target installation into a specific directory using the `path` flag: | ||
**Pro Tip:** You can target installation into a specific directory using the | ||
`path` flag: | ||
@@ -55,10 +75,15 @@ ```bash | ||
It’s not recommended to add or modify the Bourbon files so that you can update them easily. | ||
It’s not recommended that you modify Bourbon’s files directly as it will make | ||
updating to future versions difficult, by overwriting your custom changes or | ||
causing merge conflicts. | ||
## Installation for Ruby on Rails 4.2+ | ||
[RubyGems]: https://rubygems.org | ||
[Bower]: http://bower.io | ||
### Installation for Ruby on Rails 4.2+ | ||
1. Add Bourbon to your Gemfile: | ||
```ruby | ||
gem 'bourbon' | ||
gem "bourbon" | ||
``` | ||
@@ -78,5 +103,8 @@ | ||
1. Delete _all_ Sprockets directives in `application.scss` (`require`, `require_tree` and `require_self`) and use Sass’s native `@import` instead. ([why?](http://pivotallabs.com/structure-your-sass-files-with-import)) | ||
1. Delete _all_ Sprockets directives in `application.scss` (`require`, | ||
`require_tree` and `require_self`) and use Sass’s native `@import` instead | ||
([why?][sass-import]). | ||
1. Import Bourbon at the beginning of `application.scss`. All additional stylesheets should be imported below Bourbon: | ||
1. Import Bourbon at the beginning of `application.scss`. Any project styles | ||
that utilize Bourbon’s features must be imported after Bourbon. | ||
@@ -89,5 +117,5 @@ ```scss | ||
[Help! I’m getting an undefined mixin error.](https://github.com/thoughtbot/bourbon/wiki/Rails-Help-%5C-Undefined-mixin) | ||
[sass-import]: http://pivotallabs.com/structure-your-sass-files-with-import | ||
## Installing with npm and using a Node-based asset pipeline | ||
### Installing with npm and using a Node-based asset pipeline | ||
@@ -100,3 +128,7 @@ 1. Add Bourbon as a dependency: | ||
1. If you’re using [Eyeglass](http://eyeglass.rocks), skip to Step 3. Otherwise, you’ll need to add Bourbon to your node-sass `includePaths` option. `require("bourbon").includePaths` is an array of directories that you should pass to node-sass. How you do this depends on how node-sass is integrated into your project. | ||
1. If you’re using [eyeglass], skip to Step 3. Otherwise, | ||
you’ll need to add Bourbon to your node-sass `includePaths` option. | ||
`require("bourbon").includePaths` is an array of directories that you should | ||
pass to node-sass. How you do this depends on how node-sass is integrated into | ||
your project. | ||
@@ -109,4 +141,6 @@ 1. Import Bourbon into your Sass files: | ||
## Installing older versions of Bourbon | ||
[eyeglass]: http://eyeglass.rocks | ||
### Installing older versions of Bourbon | ||
1. Uninstall any Bourbon gem versions you already have: | ||
@@ -118,3 +152,4 @@ | ||
1. Reinstall the Bourbon gem, using the `-v` flag to specify the version you need: | ||
1. Reinstall the Bourbon gem, using the `-v` flag to specify the version | ||
you need: | ||
@@ -125,21 +160,49 @@ ```bash | ||
1. Follow the [instructions above](#installation) to install Bourbon into your project. | ||
1. Follow the [instructions above](#installation) to install Bourbon into | ||
your project. | ||
## Browser support | ||
## Command Line Interface | ||
- Chrome 26+ | ||
- Firefox 29+ | ||
- Internet Explorer 9+ | ||
- Opera 15+ | ||
- Safari 6.1+ | ||
```bash | ||
bourbon [options] | ||
``` | ||
## The Bourbon family | ||
### Options | ||
- [Bourbon](https://github.com/thoughtbot/bourbon): A simple and lightweight mixin library for Sass | ||
- [Neat](https://github.com/thoughtbot/neat): A lightweight semantic grid framework for Sass and Bourbon | ||
- [Bitters](https://github.com/thoughtbot/bitters): Scaffold styles, variables and structure for Bourbon projects | ||
- [Refills](https://github.com/thoughtbot/refills): Prepackaged patterns and components built with Bourbon, Neat and Bitters | ||
| Option | Description | | ||
| :---------------- | :------------------------ | | ||
| `-h`, `--help` | Show help | | ||
| `-v`, `--version` | Show the version number | | ||
| `--path` | Specify a custom path | | ||
| `--force` | Force install (overwrite) | | ||
Also check out [Proteus](https://github.com/thoughtbot/proteus), a collection of useful starter kits to help you prototype faster. Each kit comes with Bourbon, Neat and Bitters out-of-the-box. | ||
### Commands | ||
| Command | Description | | ||
| :---------------- | :---------------------------------------------------- | | ||
| `bourbon install` | Install Bourbon into the current directory | | ||
| `bourbon update` | Overwrite and update Bourbon in the current directory | | ||
| `bourbon help` | Show help | | ||
## Browser Support | ||
Bourbon supports Internet Explorer 11+ and the latest versions of Chrome, | ||
Firefox, Safari, and Edge. | ||
## The Bourbon Family | ||
Bourbon is part of a larger, modular family of Sass utilities: | ||
- [Bourbon](https://github.com/thoughtbot/bourbon): A lightweight Sass tool set | ||
- [Neat](https://github.com/thoughtbot/neat): A lightweight semantic grid | ||
framework for Sass and Bourbon | ||
- [Bitters](https://github.com/thoughtbot/bitters): Scaffold styles, variables | ||
and structure for Bourbon projects | ||
- [Refills](https://github.com/thoughtbot/refills): Prepackaged patterns and | ||
components built with Bourbon, Neat and Bitters | ||
Be sure to also check out [Proteus](https://github.com/thoughtbot/proteus), a | ||
collection of useful starter kits to help you prototype faster. Each kit comes | ||
with Bourbon, Neat and Bitters out-of-the-box. | ||
## Contributing | ||
@@ -154,3 +217,4 @@ | ||
Bourbon is copyright © 2011 [thoughtbot, inc.][thoughtbot] It is free software, and may be redistributed under the terms specified in the [license]. | ||
Bourbon is copyright © 2011 [thoughtbot, inc.][thoughtbot] It is free software, | ||
and may be redistributed under the terms specified in the [license]. | ||
@@ -161,7 +225,10 @@ [license]: LICENSE.md | ||
Bourbon is maintained by Tyson Gach and the thoughtbot design team. It is funded by [thoughtbot, inc.][thoughtbot] and the names and logos for thoughtbot are trademarks of thoughtbot, inc. | ||
Bourbon is maintained by Tyson Gach and the thoughtbot design team. It is funded | ||
by [thoughtbot, inc.][thoughtbot] and the names and logos for thoughtbot are | ||
trademarks of thoughtbot, inc. | ||
[<img src="http://thoughtbot.github.io/images/signature.svg" width="250" alt="thoughtbot logo">][thoughtbot] | ||
[<img src="http://presskit.thoughtbot.com/images/signature.svg" width="250" alt="thoughtbot logo">][thoughtbot] | ||
We love open-source software! See [our other projects][community] or [hire us][hire] to design, develop, and grow your product. | ||
We love open-source software! See [our other projects][community] or | ||
[hire us][hire] to design, develop, and grow your product. | ||
@@ -168,0 +235,0 @@ [thoughtbot]: https://thoughtbot.com?utm_source=github |
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
Sorry, the diff of this file is not supported yet
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
License Policy Violation
LicenseThis package is not allowed per your license policy. Review the package's license to ensure compliance.
Found 1 instance in 1 package
72004
57
227