chriseppstein/compass-colors

Color Tools and Theme Support for Compass and Sass

Compass Colors

This compass extension provides support for working with colors in Sass and generating color themes for use on your website.

Installing

sudo gem install compass-colors

To install a theme into your existing compass project, add the following to your compass configuration file:

require 'compass-colors'

Then run this command:

compass install colors/<Theme Name>

Where <Theme Name> is one of: basic, complementary, triadic, split_complement, analogous

The _theme.sass partial can then be imported into your stylesheets and the color constants can be used.

@import theme.sass    

Supported Color Themes

With all of these themes, you must pick a base color and the theme takes it from there:

• Basic/Monochromatic (basic)
• Complementary (complementary)
• Triadic (triadic)
• Split Complementary (split_complement)
• Analogous (analogous)

Sass Functions Provided

• lighten(color, percentage) - Create a color lighter by the percent amount provided.
• darken(color, percentage) - Create a color darker by the percent amount provided.
• saturate(color, percentage) - Increase the saturation of a color by the percent amount provided.
• desaturate(color, percentage) - Decrease the saturation of a color by the percent amount provided.
• hue(color) - Extract the hue from the color in degrees (0-360). Suitable to be passed as the first argument of hsl.
• saturation(color) - Extract the saturation from the color in percent (0-100). Suitable to be passed as the second argument of hsl.
• luminosity(color) - Extract the luminosity from the color in percent (0-100). Suitable to be passed as the third argument of hsl.
• mix(color1, color2, percentage) - Create a new color by mixing two colors together. Percentage (0-100) is optional, and indicates how much of color2 should be mixed into color1.
• grayscale(color) - Create a gray color by mapping the color provided to the grayscale.
• adjust_hue(color, degrees) - Add the number of degrees provided to the hue of the color keeping luminosity and saturation constant. Degrees can be negative.
• complement(color) - Returns the compliment of the color provided.

compass-colors's Issues

Themes are outdated

After following commit http://github.com/chriseppstein/compass-colors/commit/6142c97a78ad58eb29868339859fe2356eb59aeb, themes need to be updated so every call to darken/lighten is replaced by darken_percent/lighten_percent.

install typo in readme

sudo gem install chriseppstein-compass-colors

should be (if i'm not wrong)

gem install compass-colors

Cannot access theme colors variables

Im probably doing something wrong. I can call the theme base_color but everything else does nothing. I've created the theme and included the file as described here. Am i missing something?

Could not find gem

When add this line to Gemfile:

gem 'chriseppstein-compass-colors'
or
gem 'chriseppstein-compass-colors', :git => "git://github.com/chriseppstein/compass-colors.git"

And launch "bundle install" i have this issue :
Could not find gem 'chriseppstein-compass-colors (>= 0)' in any of the gem sources listed in your Gemfile.
or
Could not find gem 'chriseppstein-compass-colors (>= 0)' in git://github.com/chriseppstein/compass-colors.git (at master).
Source does not contain any versions of 'chriseppstein-compass-colors (>= 0)'

install doc

i had to use

gem install chriseppstein-compass-colors --source=http://gems.github.com/

to get the gem