Docs: Explain why to use Compass

[iBobik]

I just want to use Bootsrap in Jekyll. Why I need to care about Compass? Do I really need it? Why?

May be good to explaint it in README.

[cvrebert]

@twbs/sass Thoughts?

[glebm]

For the previous versions Compass was necessary because out of the box Sass lacks functions for referencing compiled files correctly, and we needed these for glyphicon font files.

Compass is no longer necessary, so let's add another section to Readme, which is a plain ruby install.

[jonchay]

Any updates on updating the documentation with a section for just plain ruby install? I'm using Jekyll as well and would like to compliment it with this gem. Thanks!

[syahmiibrahim]

Any update about the documentation? I'm also using Jekyll and when I want to try the latest beta version, I got an error File to import not found or unreadable: bootstrap.

I'm using bootstrap-sass before and everything works like charm.

[glebm]

Do you have a GitHub repo somewhere with a reproduction?

[syahmiibrahim]

@glebm currently no. I just start using Jekyll recently for my personal project.

I'm using Jekyll-assets together with gem 'bootstrap-sass';.

This is what my main.css.scss look like:

@import '_sass/variables';
@import '_sass/scaffolding';
@import 'bootstrap-sprockets';
@import 'bootstrap';
@import 'font-awesome-sprockets';
@import 'font-awesome';

Everything works when I run jekyll serve.

However, when I try to use the latest beta version, I got this error when I try to run Jekyll Serve

 Incremental build: disabled. Enable with --incremental
      Generating...
   Error in _assets/css/main.scss:7 File to import not found or unreadable: bootstrap.
Load paths:
  /Users/MacBookPro/.rvm/gems/ruby-2.3.0/gems/font-awesome-sass-4.7.0/assets/stylesheets
  /Users/MacBookPro/.rvm/gems/ruby-2.3.0/gems/font-awesome-sass-4.7.0/assets/fonts

I commented out the @import 'bootstrap-sprockets. It seems that Jekyll does not found the bootstrap path. Any help?

[wanderlux]

I was having the same problem and could make this gem work with Jekyll. I more or less followed the steps in the docs:

• add bootstrap, jquery and sprockets-rails to the Gemfile
• run bundle install

Importing Bootstrap styles step is a bit different:

• create assets/main.scss importing _bootstrap.scss in Jekyll's root folder.

---
---
// Custom bootstrap variables must be set or imported *before* bootstrap.
@import "_bootstrap.scss";

and also:

• import the gem's scss files to Jekyll's _sass directory. Find them running bundle show bootstrap, then copy the content from assets/stylesheets to said folder.

I think that was it. I do not know if it is the best way but it is working for now.