Add option to pass css file to the default template

[MoOx]

It would be great to have a option to pass a additional css to actually get the styles in the styleguide without having to duplicate default template.

[VinSpee]

I think the thought here is that if you are using custom css, you will probably need custom markup.

[MoOx]

How do you want to have a living styleguide, without styles themselves ?!
And if you want to use default template, you can't... Or I miss something.

[VinSpee]

I see what you're saying now. I was misunderstanding.

[kud]

Please, namespace your own css @VinSpee in order not to override the css styleguide itself. ;)

Do something like dss-MyClass.

[MoOx]

@kud about namespace #13

[kud]

YOU, ABOUT NAMESPACE.

[darcyclarke]

@MoOx you are correct. "Sandboxing" the examples, with a reference to your generated stylesheet, seems to be the best way forward. The best way to sandbox, I can think of, is to use iframes and have those HTML documents link to your generated stylesheet (thus, separating the DSS Styleguide CSS and your project's CSS).

To do this we'll need to:

• Allow setting a path, in the grunt config, to where your project's generated CSS lives
• Generate HTML files for each example markup in some kind of sub folder (example: docs/markup)
• Reference the project's generated CSS file in those generated HTML files
• Use iframes instead of straight HTML markup in the default template

If you want to take a stab at this. That would be awesome.

[MoOx]

Using BEM to scope everything seems a better idea for me.
The good point of not using iframe is that defaut html tags styles will fit the styles used from the actual CSS.
Don't you think ?

iframe seems overkill to me.

[VinSpee]

I'm of the mind that you should not really need any style guide-specific CSS - you should be using the very styles you're outlining.

On Wed, Nov 6, 2013 at 3:48 PM, Maxime Thirouin notifications@github.com
wrote:

Using BEM to scope everything seems a better idea for me.
The good point of not using iframe is that defaut html tags styles will fit the styles used from the actual CSS.
Don't you think ?

iframe seems overkill to me.

Reply to this email directly or view it on GitHub:
#15 (comment)

[darcyclarke]

I think the separation of concerns is important. Many times you create documentation that lives on it's own in it's own context. If you have your documentation's CSS mixed in with your project's CSS you're eventually going to run into issues of specificity (in my mind). But the library and templates are simple enough for you to change to your specific circumstance.

If you want to use your generated CSS file and not some specific styleguide CSS all you have to do is update the template (template/index.handlebars).

I think, eventually, iframes will be used to generate the examples.

[MoOx]

Closing due to inactivity.