Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Styleguide engine
Ruby CSS
branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
assets
spec
views
.gitignore
Gemfile
Gemfile.lock
README.md
Rakefile
app.rb
config.example.yml

README.md

Styleguide engine

It provides a living styleguide automatically generated from KSS documentation. The engine can be used as a stand alone CLI, or mounted on a Rails app.

How to

  1. Create a config.yml based on config.example.yml
  2. bundle exec ruby app.rb
  3. Go to localhost:4567
  4. Work on your sass files, add some KSS doc and see the result in the styleguide

Scenarios

Static assets

Point on a directory of css/sass files, without any dependency.

Compass

ie : @import 'compass'

Problems : compass assets helpers will use the styleguide config

Compass + Compass plugin

ie : Susy

Sprocket inside a rails app

  • rails sprocket helpers

TODO

  • Better manage external assets for each scenario
  • Compile static css to avoid the dual compass config problem ?

https://github.com/sstephenson/sprockets https://gist.github.com/datenimperator/3668587 https://github.com/rkh/sinatra-compass https://github.com/adamstac/sinatra-bootstrap https://github.com/petebrowne/sprockets-sass http://recipes.sinatrarb.com/p/asset_management/sinatra_assetpack http://railscoder.com/setting-up-sinatra-to-use-slim-sass-and-coffeescript/

Something went wrong with that request. Please try again.