README.md in sassc-embedded-1.68.2 vs README.md in sassc-embedded-1.68.3

- old
+ new

@@ -7,60 +7,21 @@ This library shims [`sassc`](https://github.com/sass/sassc-ruby) with the [`sass-embedded`](https://github.com/ntkme/sass-embedded-host-ruby) implementation. It has been tested with: +- [`bootstrap`](https://github.com/twbs/bootstrap-rubygem) - [`sassc`](https://github.com/sass/sassc-ruby) - [`sassc-rails`](https://github.com/sass/sassc-rails) - [`sprockets`](https://github.com/rails/sprockets) - [`sprockets-rails`](https://github.com/rails/sprockets-rails) -## Uninstall `sassc` +## Install -Execute: - -``` sh -bundle remove sassc -``` - -Or uninstall it yourself as: - -``` sh -gem uninstall sassc -``` - -**If your application has a transitive dependency on `sassc` that cannot be removed, you can use any of the following workarounds.** - -### Workaround One - Add this line to your application's Gemfile: ``` ruby -gem 'sassc', github: 'sass/sassc-ruby', ref: 'refs/pull/233/head' -``` - -And then execute: - -``` sh -bundle -``` - -The fork of `sassc` at https://github.com/sass/sassc-ruby/pull/233 will load the shim automatically when `require 'sassc'` is invoked, meaning no other code changes needed in your application. - -### Workaround Two - -Add this line to your application's code: - -``` ruby -require 'sassc-embedded' -``` - -## Install `sassc-embedded` - -Add this line to your application's Gemfile: - -``` ruby gem 'sassc-embedded' ``` And then execute: @@ -93,5 +54,47 @@ 2. Option `:precision` is ignored. 3. Option `:line_comments` is ignored. See [the dart-sass documentation](https://github.com/sass/dart-sass#behavioral-differences-from-ruby-sass) for other differences. + +## Troubleshooting + +### The original `sassc` gem is still being used instead of `sassc-embedded` + +When launching an application via `bundle exec`, it puts `sassc-embedded` at higher priority than `sassc` in `$LOAD_PATH`. You can verify the order of `$LOAD_PATH` with the following command: + +``` ruby +bundle exec ruby -e 'puts $LOAD_PATH' +``` + +If you see `sassc` has higher priority than `sassc-embedded`, try remove `sassc`: + +``` +bundle remove sassc +``` + +If your application has a transitive dependency on `sassc` that cannot be removed, you can use one of the following workarounds. + +#### Workaround One + +Add this line to your application's Gemfile: + +``` ruby +gem 'sassc', github: 'sass/sassc-ruby', ref: 'refs/pull/233/head' +``` + +And then execute: + +``` sh +bundle +``` + +The fork of `sassc` at https://github.com/sass/sassc-ruby/pull/233 will load the shim whenever `require 'sassc'` is invoked, meaning no other code changes needed in your application. + +#### Workaround Two + +Add this line to your application's code: + +``` ruby +require 'sassc-embedded' +```