Hakim El Hattab e618eda4e1 theming docs | 12 years ago | |
---|---|---|
.. | ||
source | 12 years ago | |
template | 12 years ago | |
README.md | 12 years ago | |
beige.css | 12 years ago | |
default.css | 12 years ago | |
night.css | 12 years ago | |
serif.css | 12 years ago | |
simple.css | 12 years ago | |
sky.css | 12 years ago |
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
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.