Working with SASS and CSS

Installing

Omeka S's CSS is generated using Sass, Compass, and Susy. These are all Ruby gems installed with the gem command:

gem install sass
gem install compass
gem install susy

Editing the Styles

Do not edit the files in the css directory manually! They are automatically generated and your changes will be overwritten.

The base directory for the styles and other assets is application/Omeka/asset. The SCSS sourcefiles themselves are in the sass subdirectory, while the generated CSS appears in css. Other static assets like Javascript and local web fonts live in the assets directory also.

When you edit the SCSS sources, you need to compile them into actual CSS for the styles to be updated and applied. There are two main ways of doing this, both are commands run from the application/Omeka/asset directory.

To compile the styles a single time, after making a change:

compass compile

Alternatively, you can have Compass continually run and check for changes to the SCSS and recompile automatically:

compass watch