Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse files

Bump version 1.0

  • Loading branch information...
commit 0f285a43c09f2f4edbef4652e0fa56fede5a1838 1 parent 3c3cce7
@ericam authored
View
114 CHANGELOG.mkdn
@@ -1,78 +1,84 @@
Susy Changelog
==============
-v1.0 [UNRELEASED]
------------------
+v1.0 [Aug 14, 2012]
+-------------------
This release is loaded with new features, but don't let that fool you. Susy
just became shockingly simple to use. See the [website][site] for details.
-Note that the gem name has changed from `compass-susy-plugin` to `susy`.
+The gem name has changed from `compass-susy-plugin` to `susy`.
+First uninstall the old gem, then install the new one.
+If you have both gems installed, you will get errors.
[site]: http://susy.oddbird.net/
-New Features:
+Semantics:
-* `omega` can now be set directly through the `columns` mixin for much
- more compact output.
-* Create responsive grid break-points using `at-breakpoint` and `layout`.
-* `container` mixin now accepts one or more grids/breakpoints as a shortcut.
-* All mixins respect your `$legacy-support-for-ie` settings.
-* The `space` function can be used anywhere you need column+gutter math.
-* `push`, `pull`, `pre`, `post`, and `squish` add margin left/right shortcuts.
-* The `nth-omega` mixin can be used to set omega on any nth-child, nth-of-type,
- first, last, or only element - using pseudo-class selectors.
-* `remove-omega` and `remove-nth-omega` will remove the omega-specific styles
- from an element, returning it to the regular grid flow.
-* `$container-width` and `$container-style` settings will override the width
- and type (magic, fluid, fixed, static, etc) of your grid container.
-* `$breakpoint-media-output`, `$breakpoint-ie-output`, and `$breakpoint-raw-output`
- allow you to turn on and off the different outputs from `at-breakpoint`.
- This is useful when you have IE-overrides living in a file of their own.
-* Unit tests live in the `/test/` directory.
-* Apply the `border-box-sizing` mixin at the root of your document
- to set the border-box model on all elements (universal selector),
- and Susy will make all the necessary grid adjustments.
-* Change the grid settings for a block of code using the `with-grid-settings` mixin.
-
-Changed API:
-
-* `$total-cols` => `$total-columns`
-* `$col-width` => `$column-width`
-* `$side-gutter-width` => `$grid-padding`
-* `@include un-column` & `@include reset-column` => `@include reset-columns`
-* `@include columns($columns, $context, $from)` => `@include span-columns($columns, $context, $padding, $from)`
+We re-arranged the code
+in order to make the syntax simpler and more consistent:
-Removed:
+* `$total-cols` is now `$total-columns`.
+* `$col-width` is now `$column-width`.
+* `$side-gutter-width` is now `$grid-padding`
+ and gets applied directly to the grid container.
+* `un-column` & `reset-column` mixins have merged into `reset-columns`.
+* `columns` has been renamed `span-columns` to resolve the conflict with CSS3 columns.
+ See other improvements to span-columns below.
-* `@include alpha` is no longer needed.
-* `@include omega` no longer accepts the `$context` argument.
-* `@include full` can be replaced by a simple `clear: both;` when needed.
-* `side-gutter()` is no longer needed. Use `$grid-padding` instead.
+We also removed several bothersome requirements:
-Other:
+* The `alpha` mixin is no longer needed. Ever.
+* The `omega` no longer takes a `$context` argument.
+* `full` has been removed entirely.
+ Elements will be full-width by default.
+ You can add `clear: both;` back in as needed.
+* `side-gutter()` is no longer needed.
+ You can use the `$grid-padding` setting directly.
-* Fix bug in susy-background-grid for fluid sites.
-* Fix minor bug with repeated 'display' properties.
-* Lower Compass dependency to 0.12.2
-* Add Sass dependency at 3.2.0
+Upgrade:
-### Upgrade:
+That's all you need in order to upgrade from Susy 0.9.
-1. Uninstall `compass-susy-plugin` and install `susy` in it's place.
-2. Find and replace the 5 simple "Changed API's" listed above.
-3. Remove the `$context` argument from all `omega` mixins.
-4. Remove any mention of `alpha` and `full` in your code.
- * Replace `full` with `clear: both;` where necessary.
-5. Remove any mention of `side-gutter()`.
- * This may require some refactoring, depending on your uses.
-6. [Optional] Any time 'columns' and 'omega' are declared in the same block,
- they can now be joined together. `@include columns(3); @include omega();`
- can become `@include columns(3 omega)`.
+1. Uninstall and re-install the gem.
+2. Find and replace the semantic changes listed above.
You're done! Stop worrying about all that "nested vs. root" bullshit,
and start playing with the new toys!
+If you use the `$from` directional arguments
+directly in the `span-columns` mixin,
+there may be one more change to make.
+See below:
+
+New Features:
+
+* `span-columns` supports new features:
+ - "omega" can be applied directly through the `$columns` argument.
+ - Internal padding can be added through the `$padding` argument.
+ - This pushes the `$from` argument from third position into fourth.
+* `at-breakpoint` allows you to change layouts at media breakpoints.
+* `container` accepts multiple media-layout combinations as a shortcut.
+* `layout` allows you to use a different layout at any time.
+* `with-grid-settings` allows you to change any or all grid settings.
+* `set-container-width` does what it says, without the other container code.
+* `$breakpoint-media-output`, `$breakpoint-ie-output`, and `$breakpoint-raw-output`
+ settings help manage the different outputs from `at-breakpoint`
+ when you have IE-overrides living in a file of their own.
+* `border-box-sizing` will apply the popular `* { box-sizing: border-box }`
+ universal box-model fix, as well as changing the Susy `$border-box-model` setting for you,
+ so Susy knows to adjust some math.
+* The `space()` function can be used anywhere you need column+gutter math.
+* `push`, `pull`, `pre`, `post`, and `squish` mixins help manage margins.
+* use the `nth-omega` mixin to set omega on any nth-child, nth-of-type,
+ first, last, or only element.
+* `remove-omega` and `remove-nth-omega` will remove
+ the omega-specific styles from an element.
+* `$container-width` will override the width of your container
+ with any arbitrary length.
+* `$container-style` will override the type of grid container
+ (magic, fluid, fixed, static, etc) to use.
+
v0.9 [Apr 25 2011]
------------------
View
2  VERSION
@@ -1 +1 @@
-1.0.rc.4
+1.0
View
4 docs/Gemfile
@@ -2,8 +2,8 @@ source "http://rubygems.org"
gem "middleman", "~> 3.0.0"
gem "sass", "~> 3.2.0"
-gem "compass", "~> 0.12.2"
-gem "susy", "~> 1.0.rc.4"
+gem "compass", "~> 0.13.0.alpha.0"
+gem "susy", "~> 1.0"
gem "modular-scale", "~> 1.0.2"
gem "redcarpet"
View
18 docs/Gemfile.lock
@@ -9,7 +9,7 @@ GIT
GEM
remote: http://rubygems.org/
specs:
- activesupport (3.2.6)
+ activesupport (3.2.8)
i18n (~> 0.6)
multi_json (~> 1.0)
blankslate (2.1.2.4)
@@ -18,15 +18,15 @@ GEM
coffee-script-source
execjs
coffee-script-source (1.3.3)
- compass (0.12.2)
+ compass (0.13.alpha.0)
chunky_png (~> 1.2)
fssm (>= 0.2.7)
- sass (~> 3.1)
+ sass (~> 3.2.0.alpha.93)
execjs (1.4.0)
multi_json (~> 1.0)
ffi (1.0.11)
fssm (0.2.9)
- haml (3.1.6)
+ haml (3.1.7)
hike (1.2.1)
http_router (0.10.2)
rack (>= 1.0.0)
@@ -111,13 +111,13 @@ GEM
sprockets-sass (0.8.0)
sprockets (~> 2.0)
tilt (~> 1.1)
- susy (1.0.rc.4)
+ susy (1.0)
compass (>= 0.12.2)
- sass (>= 3.2.0.alpha.247)
+ sass (>= 3.2.0)
syntax (1.0.0)
thor (0.15.4)
tilt (1.3.3)
- uglifier (1.2.6)
+ uglifier (1.2.7)
execjs (>= 0.3.0)
multi_json (~> 1.3)
url_mount (0.2.1)
@@ -127,11 +127,11 @@ PLATFORMS
ruby
DEPENDENCIES
- compass (~> 0.12.2)
+ compass (~> 0.13.0.alpha.0)
middleman (~> 3.0.0)
modular-scale (~> 1.0.2)
pygments.rb
rack-codehighlighter!
redcarpet
sass (~> 3.2.0)
- susy (~> 1.0.rc.4)
+ susy (~> 1.0)
View
4 docs/source/guides/getting-started.html.md
@@ -2,7 +2,7 @@
title: Getting Started
class: guide
side_content: >
- <p class="version">Version <span>1.0.rc.4</span></p>
+ <p class="version">Version <span>1.0</span></p>
<h2><a href="#start-install">Installation</a></h2>
<ul>
<li><a href="#start-compass">Compass</a></li>
@@ -282,7 +282,7 @@ Add Susy to your ``Gemfile``
([more info on Gemfiles](http://gembundler.com/gemfile.html)):
:::ruby
- gem "susy", "~> 1.0.rc.4"
+ gem "susy", "~> 1.0"
And finally run your bundle:
View
2  docs/source/guides/reference.html.md
@@ -2,7 +2,7 @@
title: Reference
class: guide
side_content: >
- <p class="version">Version <span>1.0.rc.4</span></p>
+ <p class="version">Version <span>1.0</span></p>
<h2><a href="#ref-basic">Basic Usage</a></h2>
<h3><a href="#ref-basic-settings">Basic Settings</a></h3>
<ul>
View
4 docs/source/guides/upgrade-1-0.html.md
@@ -1,7 +1,7 @@
---
title: Upgrade to Susy 1.0
side_content: >
- <p class="version">Version <span>1.0.rc.4</span></p>
+ <p class="version">Version <span>1.0</span></p>
<h2>Upgrading from 0.9</h2>
<ul>
<li><a href="#ref-gem">the gem</a></li>
@@ -164,7 +164,7 @@ For such-and-such media, use such-and-such layout.
You can also apply `layout` to use an arbitrary layout,
or `with-grid-settings` to change any grid settings.
-You can also add breakpoint media-layouts directly to your `container`as a shortcut,
+You can also add breakpoint media-layouts directly to your `container` as a shortcut,
or use `set-container-width` inside breakpoints
to adjust the container to it's new context
without the repetative output from multiple applications of `container`.
View
20 docs/source/index.html.md
@@ -20,26 +20,14 @@
<section class="info">
<div class="v1-0">
<h2>
- <a href="https://rubygems.org/gems/susy">Version 1.0<i>.rc.4</i></a>
+ <a href="https://rubygems.org/gems/susy">Version 1.0</a>
</h2>
<div class="highlight">
- <pre>gem install susy --pre</pre>
+ <pre>gem install susy</pre>
</div>
<ul>
- <li><a href="https://github.com/ericam/susy/blob/master/CHANGELOG.mkdn">What's changed</a></li>
- <li><a href="https://github.com/ericam/susy/blob/master/CHANGELOG.mkdn#upgrade">Upgrade</a></li>
- </ul>
- </div>
- <div class="v0-9">
- <h2>
- <a href="https://rubygems.org/gems/compass-susy-plugin">Version 0.9</a> (deprecated)
- </h2>
- <div class="highlight">
- <pre>gem install compass-susy-plugin</pre>
- </div>
- <ul>
- <li><a href="https://gist.github.com/1163918">Reference</a></li>
- <li><a href="https://gist.github.com/1163463">Tutorial</a></li>
+ <li><a href="https://github.com/ericam/susy/blob/master/CHANGELOG.mkdn">What's Changed</a></li>
+ <li><a href="/guides/upgrade-1-0/">Upgrade Instructions</a></li>
</ul>
</div>
</section>
View
5 docs/source/stylesheets/_modules/_intro.scss
@@ -47,11 +47,6 @@
list-style: circle;
padding-left: rhythm(1);
}
- i {
- @include opacity(.75);
- color: $susy-bodycopy;
- font-weight: normal;
- }
}
.v1-0 {
View
4 susy.gemspec
@@ -2,11 +2,11 @@
Gem::Specification.new do |s|
s.name = %q{susy}
- s.version = "1.0.rc.4"
+ s.version = "1.0"
s.required_rubygems_version = Gem::Requirement.new(">= 1.2") if s.respond_to? :required_rubygems_version=
s.authors = ["Eric Meyer"]
- s.date = %q{2012-08-02}
+ s.date = %q{2012-08-14}
s.description = %q{Susy grids are fluid on the inside, ready to respond at any moment, but contained in the candy shell of your choice, so they respond how and when and where you want them to. We don't design your site or dictate your markup, we just do the math and get out of your way.}
s.email = %q{eric@oddbird.net}
s.extra_rdoc_files = ["CHANGELOG.mkdn", "LICENSE.txt", "README.md", "lib/susy.rb"]
Please sign in to comment.
Something went wrong with that request. Please try again.