Hakim El Hattab e618eda4e1 theming docs 11 years ago
..
source be4c55cd65 add night theme 11 years ago
template 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago
README.md e618eda4e1 theming docs 11 years ago
beige.css 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago
default.css 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago
night.css 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago
serif.css 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago
simple.css 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago
sky.css 519ee26809 remove left/right margin from images, tweak pdf print styles 11 years ago

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:

  1. Include /css/theme/template/mixins.scss
    Shared utility functions.

  2. 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.

  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.

  4. Include /css/theme/template/theme.scss
    The template theme file which will generate final CSS output based on the currently defined variables.