compass-rails 1.1.0.pre → 1.1.0

data/README.md

@@ -29,6 +29,8 @@ And then execute:
 
     $ bundle
 
+## Optional
+
 To set up your project with starter stylesheets and a configuration
 file:
 
@@ -40,21 +42,28 @@ If using a compass-based framework (like [susy](http://susy.oddbird.net/) or [bl
 
 Note that the `compass init` step is optional if you have a project running Rails 3.0 or greater.
 
-## Upgrading existing rails projects using Compass to CompassRails
+## Usage
 
-First and foremost, follow the installation instructions above.
+Change your `application.css` to `application.css.scss` or `application.css.sass` and use `@import` to your hearts content. Ex:
 
-CompassRails uses the rails convention for stylesheet locations even in
-older versions of rails that do not use the assets pipeline.
-If you have your stylesheets already in `app/stylesheets`, you have two choices:
+```scss
+@import "project/mixins";
+@import "project/base";
 
-1. Move your stylesheets to `app/assets/stylesheets`.
-2. Configure your project to look in the **legacy location** of
-   `app/stylesheets` by setting `config.compass.sass_dir =
-   "app/stylesheets"` in your rails configuration or by setting
-   `sass_dir = "app/stylesheets"` in your compass configuration file.
+```
 
-## Configuration
+*or*
+
+Use `application.css` to require files that use compass features. Ex:
+```css
+/*
+ *= require styleguide_full_of_compass_stuff
+ */
+```
+
+*Don't* use `*= require something` within your SCSS or SASS files. You're gonna have a bad time.
+
+### Configuration
 
 If you have a compass configuration file (recommended) then you can
 use the [Compass configuration 
@@ -64,12 +73,17 @@ files, then you should understand that the compass configuration
 options explained there will be methods and properties on the `config.compass`
 configuration object exposed to rails within any configuration block.
 
-## Usage
+### Notes On Sprockets Directives
+
+Sprockets, used by the rails asset pipeline, provides directives for
+doing things like requiring. These **must not** be used with Sass files.
+Instead use the sass `@import` directive. In rails projects, the
+`@import` directive is configured to work with sprockets via `sass-rails`. For more information on importing in rails 3.1 or greater see the [Sass-Rails README](https://github.com/rails/sass-rails/blob/master/README.md)
 
 ### Developing with Rails-based Compilation
 
 By default, your sass files in `app/assets/stylesheets` will be
-automatically compiled by the the [`Sass::Plugin`](http://sass-lang.com/docs/yardoc/Sass/Plugin.html) or the [Rails asset
+automatically compiled by the [`Sass::Plugin`](http://sass-lang.com/docs/yardoc/Sass/Plugin.html) or the [Rails asset
 pipeline](http://guides.rubyonrails.org/asset_pipeline.html) depending on the version of rails that you use.
 
 When using this approach you will need to reload your webpage in order
@@ -95,11 +109,7 @@ end
 To return to using the Rails-based compilation mode, simply delete
 the compiled stylesheets and remove any configuration changes.
 
-### Compiling for Production
-
-If using the Rails asset pipeline run:
-
-    $ rake assets:precompile
+### Compiling for Production without Asset Pipeline
 
 If not using the asset pipeline run:
 
@@ -111,10 +121,7 @@ stylesheets.
 
 ### Installing Compass extensions
 
-Step 1: If the extension is a rubygem, Add it to your Gemfile in the
-`:assets` group and run the `bundle` command to install it.
-If the extension is a zip file, unzip it into the
-`vendor/plugins/compass_extensions` directory of your project.
+Step 1: Add it to your Gemfile in the `:assets` group and run the `bundle` command to install it.
 
 Step 2: Install the extension's assets: `bundle exec compass install 
 <extension/template>`
@@ -142,18 +149,9 @@ config.compass.require "susy"
 
 to your application.rb configuration file.
 
-
-### Notes On Sprockets Directives
-
-Sprockets, used by the rails asset pipeline, provides directives for
-doing things like requiring. These **must not** be used with Sass files.
-Instead use the sass `@import` directive. In rails projects, the
-`@import` directive is configured to work with sprockets via `sass-rails`. For more information on importing in rails 3.1 or greater see the [Sass-Rails README](https://github.com/rails/sass-rails/blob/master/README.markdown)
-
 ## Rails 3.1 Caveats
 
-There was a bug in rails 3.1.0 -- please make sure you are running 3.1.1
-at the earliest for this version of rails.
+compass-rails requires Rails 3.1.1 and greater. Also, Rails 3.1 is out of support so consider upgrading.
 
 ## Rails 3.0 Caveats
 
@@ -170,6 +168,22 @@ to this:
 Bundler.require(:default, :assets, Rails.env) if defined?(Bundler)
 ```
 
+ Also, Rails 3.0 is out of support so consider upgrading.
+
+## Upgrading Rails 3.0 and older projects to compass-rails
+
+First and foremost, follow the installation instructions above.
+
+CompassRails uses the rails convention for stylesheet locations even in
+older versions of rails that do not use the assets pipeline.
+If you have your stylesheets already in `app/stylesheets`, you have two choices:
+
+1. Move your stylesheets to `app/assets/stylesheets`.
+2. Configure your project to look in the **legacy location** of
+   `app/stylesheets` by setting `config.compass.sass_dir =
+   "app/stylesheets"` in your rails configuration or by setting
+   `sass_dir = "app/stylesheets"` in your compass configuration file.
+
 ## Contributing
 
 1. Fork it

data/lib/compass-rails/version.rb

@@ -1,5 +1,5 @@
 module CompassRails
   unless defined?(::CompassRails::VERSION)
-    VERSION = "1.1.0.pre"
+    VERSION = "1.1.0"
   end
 end

metadata

@@ -1,8 +1,8 @@
 --- !ruby/object:Gem::Specification
 name: compass-rails
 version: !ruby/object:Gem::Version
-  prerelease: 6
-  version: 1.1.0.pre
+  prerelease: 
+  version: 1.1.0
 platform: ruby
 authors:
 - Scott Davis
@@ -10,7 +10,7 @@ authors:
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2013-12-04 00:00:00.000000000 Z
+date: 2013-12-05 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   version_requirements: !ruby/object:Gem::Requirement
@@ -103,9 +103,9 @@ required_ruby_version: !ruby/object:Gem::Requirement
   none: false
 required_rubygems_version: !ruby/object:Gem::Requirement
   requirements:
-  - - ! '>'
+  - - ! '>='
     - !ruby/object:Gem::Version
-      version: 1.3.1
+      version: '0'
   none: false
 requirements: []
 rubyforge_project: