SC5 / sc5-styleguide

Styleguide generator is a handy little tool that helps you generate good looking styleguides from stylesheets using KSS notation
http://styleguide.sc5.io/
MIT License
1.26k stars 168 forks source link

Using Bootstrap instead of Bourbon as Base CSS #621

Open milkshoes opened 9 years ago

milkshoes commented 9 years ago

We use Bootstrap Sass currently in our project and in order to get all of our styleguide elements to display EXACTLY the same as our application this would mean we need to have as much in common or the exact same in the styleguide as the app itself.

So my question is, what would you recommend as the best build modification in order to replace all the Bourbon / Bourbon-Neat styles with Bootstrap?

I was at first thinking of changing the property in the File: styleguide_config.json from:

From:

"includePaths": [ "node_modules/node-bourbon/assets/stylesheets", "node_modules/node-neat/assets/stylesheets" ]

To:

"includePaths": [ "lib/app/sass/components/bootstrap-sass-official/assets/stylesheets/" ]

But maybe there's an easier or alternative way I can use your styleguide and still view my Styles that sit on top of Bootstrap Sass?

I have also considered modifying import paths in the app.scss file. Maybe this is a more straight forward approach? I'm not sure. I am really looking for best recommended technique and caveats.

File: /lib/app/sass/app.scss

From:

@import 'bourbon'; @import 'neat';

To:

$icon-font-path: "lib/app/sass/components/bootstrap-sass-official/assets/fonts/bootstrap/"; @import "lib/app/sass/components/bootstrap-sass-official/assets/stylesheets/bootstrap";

basically if you had to view your style on top of Bootstrap instead of Bourbon in this SC5 Styleguide generator how would you go about doing this?

Very sincerely, thank you for your time and patience!

milkshoes commented 9 years ago

I can't seem to get a Sass version of Bootstrap working at all so far in your SC5 styleguide. I have been trying to use 'bootstrap-sass-official'.

milkshoes commented 9 years ago

Any help with this is greatly appreciated. We must be able to have a Bootstrap base in our style-guide explorer with working glyphicons to actually use this.

milkshoes commented 9 years ago

i've even tried to add the cdn version to the index.html template generated and for some strange reason the links aren't even being added to the demo-output directory either.

nilsnh commented 9 years ago

Heyo. I'm just exploring whether or not to use this project. But from the generated styleguide app.css I see that all the existing markup is namespaced with .sg in front. That would avoid any collisions with bootstrap-sass i believe.

danmv commented 8 years ago

+1