https://github.com/vhyza/sass-rails-source-maps

DEPRECATED: Rails gem for generating sass source maps
https://github.com/vhyza/sass-rails-source-maps

deprecated ruby

Last synced: 2 months ago
JSON representation

DEPRECATED: Rails gem for generating sass source maps

• Host: GitHub
• URL: https://github.com/vhyza/sass-rails-source-maps
• Owner: vhyza
• License: mit
• Archived: true
• Created: 2013-09-17T22:48:57.000Z (over 11 years ago)
• Default Branch: master
• Last Pushed: 2016-11-25T15:05:26.000Z (about 8 years ago)
• Last Synced: 2024-03-14T15:49:05.672Z (11 months ago)
• Topics: deprecated, ruby
• Language: Ruby
• Homepage:
• Size: 22.5 KB
• Stars: 86
• Watchers: 4
• Forks: 21
• Open Issues: 5
• Metadata Files:
  • Readme: README.markdown
  • License: LICENSE.txt

Awesome Lists containing this project

README

        
# DEPRECATED: Sass Rails Source Maps

## This gem is not under active developement

As an alternative, you can try to use [sassc-rails with inline source maps support](https://github.com/sass/sassc-rails#inline-source-maps).

---

__NOTE__: This gem requires `sass-rails` version `5.0.0`

This gem allows you to see your Rails 4 `.scss` source files in Google Chrome inspector, which can be useful for debugging.

`debug_info` option available in stable [sass](http://sass-lang.com/) gem is no longer working in Google Chrome, because Chrome now supports Source Map [v3](https://docs.google.com/document/d/1U1RGAehQwRypUTovF1KRlpiOFze0b-_2gc6fAH0KY0k) only.

## Installation

Source Maps are supported by `sass` gem in version `3.3` and higher. Unfortunately, `sass-rails`, the `rails` dependency, freezes `sass` gem to version `~> 3.2.0`. To use this gem, you need to follow these steps:

* Add `sass-rails-source-maps` to your application's Gemfile :

````ruby

group :development do

  gem 'sass-rails-source-maps'

end

````

This branch depends on `sass-rails` version `5.0.0` which has more relaxed dependency for `sass` gem. So to avoid version conflict you need to:

* Unfreeze `sass-rails` gem in your Gemfile (delete version for `sass-rails`)

For example, in new `Rails 4.1.5` application change line

    gem 'sass-rails', '~> 4.0.3'

to

    gem 'sass-rails'

in your `Gemfile`.

* And then execute:

````

bundle update sass-rails

````

* After that, run:

````

rake assets:clobber

````

to make Rails regenerate assets. After assets regeneration, `assets/source_maps` containing `sass` source maps is created in `public` directory.

## Usage

If everything works fine, you should see something like this ![screenshot](https://dl.dropboxusercontent.com/u/21012539/screenshots/screenshot.png)

Enabling source maps may vary in different Chrome versions. For more info please see [Working with CSS Preprocessors](https://developer.chrome.com/devtools/docs/css-preprocessors#toc-enabling-css-source-maps).

## Notes

* This gem is not intended for production usage.

* This gem is Rails 4.x compatible only

## Contributing

1. Fork it

2. Create your feature branch (`git checkout -b my-new-feature`)

3. Commit your changes (`git commit -am 'Add some feature'`)

4. Push to the branch (`git push origin my-new-feature`)

5. Create new Pull Request