Andrew Tomaka
f3d18656b2
Install reveal.js presentation framework using bower: bower install reveal.js --save Setup an initial slide show with a title page and resources page to conclude. It seems like the bower_components directory does not belong in the repository, but I am not familar with practices using the tool so it can be included for now.
25 lines
1.7 KiB
Markdown
25 lines
1.7 KiB
Markdown
## 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: https://github.com/hakimel/reveal.js#full-setup
|
|
|
|
You also need to install Ruby and then Sass (with `gem install sass`).
|
|
|
|
## Creating a Theme
|
|
|
|
To create your own theme, start by duplicating any ```.scss``` file in [/css/theme/source](https://github.com/hakimel/reveal.js/blob/master/css/theme/source) and adding it to the compilation list in the [Gruntfile](https://github.com/hakimel/reveal.js/blob/master/Gruntfile.js).
|
|
|
|
Each theme file does four things in the following order:
|
|
|
|
1. **Include [/css/theme/template/mixins.scss](https://github.com/hakimel/reveal.js/blob/master/css/theme/template/mixins.scss)**
|
|
Shared utility functions.
|
|
|
|
2. **Include [/css/theme/template/settings.scss](https://github.com/hakimel/reveal.js/blob/master/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](https://github.com/hakimel/reveal.js/blob/master/css/theme/template/settings.scss) for reference) or by adding full selectors with hardcoded styles.
|
|
|
|
4. **Include [/css/theme/template/theme.scss](https://github.com/hakimel/reveal.js/blob/master/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 themes` to compile the Sass file to CSS and you are ready to use your new theme.
|