Dependencies #

Themes are written using Sass to keep things modular and reduce the need for repeated selectors across files. Make sure that you have the reveal.js development environment including the Grunt dependencies installed before proceding:

Creating a Theme #

To create your own theme, start by duplicating any .scss file in /css/theme/source and adding it to the compilation list in the Gruntfile.

Each theme file 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 any selectors and styles you please.

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

When you are done, run grunt css-themes to compile the Sass file to CSS and you are ready to use your new theme.