KSS Rails provides a Rails 3 engine for you to mount onto your existing Rails 3 application that will automatically parse your stylesheets that live within
app/assets/stylesheets and give you a styleguide visible at whichever URL you choose.
Install the gem:
gem install kss-rails
Add it to the development group within the
Gemfile and re-bundle:
group :development do gem 'kss-rails' end
Run the install generator which will copy over some initial templates for you to base your styleguide definitions off of. There may be some extra changes to the layouts that you need to do, but that is dependent on how crazy your application is.
rails generate kss:install
The install generator will have already appended the route for KSS Rails for you at the '/kss' URL, but if you'd like to change that you can within your routes file.
Example::Application.routes.draw do root :to => 'home#index' mount Kss::Engine => '/kss' if Rails.env.development? end
That's it, restart your app and visit
http://yoururl/kss (or whichever URL you choose).
Please visit the KSS repo for further documentation and helpful tips.
But if you're looking to add more layout styles or updating the templates, you can create your own copy within your application at any of the paths within the app folder.
All credit goes to Kyle Neath for creating the KSS gem and hopefully this will allow people to create styleguides for every site they work on with little to no additional effort.
Note on Patches/Pull Requests
- Fork the project.
- Make your feature addition or bug fix.
- Commit, do not mess with Rakefile, version, or history. (if you want to have your own version, that is fine but bump version in a commit by itself in another branch so I can ignore when I pull)
- Send me a pull request. Bonus points for topic branches.
Copyright © 2011 Garrett Bjerkhoel. See MIT-LICENSE for details.