Contents

# Rails Sass Images [![Build Status](https://travis-ci.org/ai/rails-sass-images.svg)](https://travis-ci.org/ai/rails-sass-images)

Sass functions and mixins to inline images and get images size:

```sass
.icon
  +image-size("icon.png")
  background: inline("icon.png")

.icon-wrap
  width: image-width("icon.png") + 6px
  height: image-height("icon.png")
```

with HiDPI (Retina) support:

```sass
.icon
  +hidpi-inline("icon.png")

.background
  +hidpi-image("big-image.jpg")
```

and fonts support:

```sass
@font-face
  font-family: "MyFont"
  src: inline("my.woff") format('woff')
```

<a href="https://evilmartians.com/?utm_source=rails-sass-images">
<img src="https://evilmartians.com/badges/sponsored-by-evil-martians.svg" alt="Sponsored by Evil Martians" width="236" height="54">
</a>

## Features

Instead of Compass, Rails Sass Images has:

* HiDPI (Retina) support.
* Full Assets Pipeline support.
* Useful shortcuts.
* More file types support.
* Smaller and cleaner code.

If you still need Compass for CSS 3 prefixes,
see [Autoprefixer](https://github.com/ai/autoprefixer).

## Usage

### Ruby on Rails

Add gem to your Rails `Gemfile`:

```ruby
gem "rails-sass-images"
```

and import mixins in your `application.sass`:

```sass
@import "rails-sass-images"
```

### Sprockets

You can use Rails Sass Images with plain Ruby application with Sprockets.
Just install in to Sprockets environment:

```ruby
require 'rails-sass-images'

RailsSassImages.install(sprockets_env)
```

and import mixins in your Sass files:

```sass
@import "rails-sass-images"
```

### Other

You can use Rails Sass Images without Sprockets. Just set dir to load assets:

```ruby
require 'rails-sass-images'

RailsSassImages.load_from = './images/'
```

By default, load dir will be current dir `.`.

Version data entries

6 entries across 6 versions & 1 rubygems

Version	Path
rails-sass-images-2.0.0	README.md
rails-sass-images-1.0.3	README.md
rails-sass-images-1.0.2	README.md
rails-sass-images-1.0.1	README.md
rails-sass-images-1.0.0	README.md
rails-sass-images-0.6	README.md