online-identities

History

Hakim El Hattab e618eda4e1 theming docs		2013-01-08 19:05:20 -05:00
..
source	add night theme	2012-11-10 19:49:44 -05:00
template	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00
beige.css	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00
default.css	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00
night.css	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00
README.md	theming docs	2013-01-08 19:05:20 -05:00
serif.css	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00
simple.css	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00
sky.css	remove left/right margin from images, tweak pdf print styles	2012-11-27 09:23:40 -05:00

README.md

Dependencies

Themes are written using Sass to keep things modular and reduce the need for repeated selectors across files. Find out how to install Sass here http://sass-lang.com/, once Sass is installed run the follwing command to start monitoring the source files for changes.

sass --watch css/theme/source/:css/theme --style expanded

Creating a Theme

To create your own theme, start by duplicating any .scss file in /css/theme/source. Each theme does four things in the following order:

Include /css/theme/template/mixins.scss
Shared utility functions.
Include /css/theme/template/settings.scss
Declares a set of custom variables that the template file (step 4) expects. Can be overridden in step 3.
Override
This is where you override the default theme. Either by specifying variables (see settings.scss for reference) or by adding full selectors with hardcoded styles.
Include /css/theme/template/theme.scss
The template theme file which will generate final CSS output based on the currently defined variables.