reveal-ck 0.1.3 → 0.1.4

checksums.yaml

@@ -1,15 +1,15 @@
 ---
 !binary "U0hBMQ==":
   metadata.gz: !binary |-
-    MWI3OTAwYjcxYTZlODc0NTI3NWQxNzU3OGJhMzlhMTdmZmZjYmVkYQ==
+    ZDU1YTM4NTM5MWM4Y2U0NmFlN2ZiYTBiNmQ5NWQ0ZTc1OThkYTNiMg==
   data.tar.gz: !binary |-
-    ZDdhNDAyYWM1ODk2OWU5OTU3MWUyNDU1MjU3N2ZiYTQyOTI1M2I0Ng==
+    MTExYzMwYWIzZTdiMDAwMDExNTg4MjNmNDE5ZTRjYjI4YTBkNDgwOA==
 !binary "U0hBNTEy":
   metadata.gz: !binary |-
-    ZGZkOGUxZTM3MTg4M2M5MWM5MTk2NDJmZmJkNThiZTVhNGEyODBkMTRmZDUw
-    ZjY1YzVkNTUwMGUyOTM5NGQzNTM4MWI1ZGNkNzVmZjYzYjVlYjM0ZDU5YTNi
-    NDUyYWU0NWQyMWJmYjhmZWNjNDA2NjYwMmY5OGVkODYxNmMyY2E=
+    ZjU3MDUxN2QyMWExN2IyZGUwZWI1ODFhYTYyYzYwZDE3ODM5MjExOGJlMmVi
+    NjRlNmU3M2YzYWIzMGIyM2JlNzJiODcxZDFiMTlkYmE5ZTdhODMxNjE2ZDk2
+    NGU2NGIxZjY0ZGVhYWVlZjdhOTFkMTNmNTVlYTAzODAyMTU1YjQ=
   data.tar.gz: !binary |-
-    M2ZkOTIwM2UxNGNkMjBlNmUyYTFiOWVmYTM1NWI2NTUyMmU3ZDIzNWVkZDA2
-    NGIyOWQ0YWRjZWNiOTM0ZGQ1ZTU0MDQxNzgwZDA0OGI5NzgyZmI1YmZkOTE3
-    MDQ2N2RmYWRjYTBkYTBjNGZkMTRmMjI5OWRjZWIwMjUzMjBlMWE=
+    MWEwMWJlNTMyNWVhMWVkNDI0OGRiNTI5YzcwOWExODZjZWQ3N2VhYWI2NTZj
+    MzljMGQwMjNiMjc2ZDJhMjIwMTU1OTcyM2VmZWRmZDlhMjUwM2RiMGZiNjgz
+    MWYyNTM1ZThlOTRkNzhiODNhZGYzNTNkODIyZDk5N2FhNjgzMzk=

data/README.md

@@ -1,6 +1,6 @@
-# reveal-ck: a [reveal.js](http://lab.hakim.se/reveal-js/) construction kit
+# reveal-ck: a [reveal.js][reveal-js] construction kit
 
-[![Build Status](https://travis-ci.org/jedcn/reveal-ck.png)](https://travis-ci.org/jedcn/reveal-ck)
+[![Build Status][travis-reveal-ck-badge]](https://travis-ci.org/jedcn/reveal-ck)
 
 ## Overview
 
@@ -8,80 +8,20 @@ This project is the home of a gem named `reveal-ck` that lets you
 quickly author [reveal.js](http://lab.hakim.se/reveal-js/)
 presentations.
 
-The gem provides an executable of the same name, `reveal-ck`, that can
-take a single file as input and generate a set of slides from it.
-
-Here's a starter repository that contains everything you need to get
-going with reveal-ck: https://github.com/jedcn/reveal-ck-template in
-less than 5 minutes.
+Here's a
+[high level description of what reveal-ck is about][jedcn-reveal-ck]
+and how to get up and running with it.
 
 The hope is that you will be able to leverage all of the power,
 beauty, and functionality that comes from reveal.js while focusing
 entirely on the actual content and ideas you are trying to get across.
 
-As with all [reveal.js](http://lab.hakim.se/reveal-js/) presentations,
-you can show these to other people on an iPhone, iPad, or present them
-in your browser.
-
-### What You Provide
-
-You provide:
-
-* A file containing your slide content in HAML (`slides.haml`)
-
-* (optional) If you have any images that are not already on the web,
-  you can save these into a directory named `images` and the contents
-  will be bundled up into your generated slides. This will allow you
-  to relatively reference the images.
-
-## Getting Started
-
-At present, we assume you've got a functional Ruby 1.9.x environment
-up and running one way or another and bundler.
-
-If that's the case, try the following:
-
-```
-$ git clone git@github.com:jedcn/reveal-ck-template.git
-Cloning into 'reveal-ck-template'...
-remote: Counting objects: 12, done.
-remote: Compressing objects: 100% (7/7), done.
-remote: Total 12 (delta 2), reused 12 (delta 2)
-Receiving objects: 100% (12/12), done.
-Resolving deltas: 100% (2/2), done.
-$ cd reveal-ck-template
-$ bundle
-Fetching gem metadata from https://rubygems.org/......
-Installing rake (10.0.4)
-Installing gli (2.5.6)
-Installing tilt (1.3.6)
-Installing haml (4.0.1)
-Installing reveal-ck (0.1.1)
-Using bundler (1.2.3)
-Your bundle is complete! Use `bundle show [gemname]` to see where a bundled gem is installed.
-$ reveal-ck generate
-$ open slides/index.html
-```
-
-If all has gone well, you should now have a `slides/` directory and if
-you open up `slides/index.html` in a browser, you should see a
-reveal.js presentation that was generated from the `slides.haml`
-
-## Authoring Slides
-
-Now that you are assured of basic functionality, start making changes
-and customizing `slides.haml`. Once you've made a change you'd like to
-see, re-run `reveal-ck generate` and then re-open (or refresh)
-`slides/index.html`
-
-[reveal.js](http://lab.hakim.se/reveal-js/) has a great
-[live demo](http://lab.hakim.se/reveal-js/), and if you take a look at
-the source in the demo, you can quickly see the HTML and CSS that has
-good support by default when placed into your `slides.haml`.
+To get started, take a look at
+[this project that's got everything you need][github-jedcn-reveal-ck-template].
 
 ## Why not just clone reveal.js?
 
-Or why not use http://www.rvl.io/ which offers a WYSIWYG experience?
+Or why not use http://slid.es/ which offers a WYSIWYG experience?
 
 You can! For sure.
 
@@ -96,71 +36,26 @@ The thought behind this project to help you focus on what *you* want
 to say.
 
 For me, focusing becomes easier and my thoughts clearer when I reduce
-the list of slides to a single file (```slides.haml```). It only
-contains the slide content I am presenting and there's minimal markup.
-
-HAML isn't the most readable thing (say, compared to markdown), but it
-is decent, and sharing or reviewing something like ```slides.haml```
-is easier than reviewing the final presentation:
+the list of slides to a single file (`slides.slim` or
+`slides.haml`). It only contains the slide content I am presenting and
+there's minimal markup.
 
 * If you look at the presentation in a browser, you can't scan all of
-  the slides at once. You need to visit them. If you're looking at
-  ```slides.haml``` you can quickly scan through 30+ slides.
+  the slides at once. You need to visit them. If you're looking at a
+  single file, you can quickly scan through 30+ slides.
 
 * If you look at the html behind the presentation (say, view source),
-  there's a bunch of stuff that makes the magic happen: styles,
-  javascript, etc.
-
-Finally, if you track your slides in a system like git, you can get
-meaningful diffs between versions of ```slides.haml```. This is
-slightly easier than if you track the generated presentation.
-
-In the end, the presentation framework,
-[reveal.js](http://lab.hakim.se/reveal-js/), can make things pretty,
-but only you can make a presentation that is worthwhile.
-
-[talk-learning-with-tools-source]: https://github.com/jedcn/talk-learning-with-tools
-[talk-learning-with-tools-result]: http://www.jednorthridge.com/talks/learning-with-tools
-
-## Development
-
-If you want to make changes to reveal-ck, you should first try the
-following:
-
-```
-git submodule init
-git submodule update
-rake
-```
-
-The gem, reveal-ck, relies on having a copy of reveal.js (the original
-JavaScript based project) via a git submodule.
-
-The commands above get things online and verify basic functionality.
-
-### Testing
-
-The testing strategy blends rspec and cucumber. There's not much going
-on here (at a code level) so RSpec is straight forward. The
-executable, reveal-ck, is verified as a command line tool with Aruba.
-
-As you might expect, `rake spec` runs specs, `rake cucumber` runs
-features, and `rake` runs both `spec` and `cucumber`.
-
-### Travis
-
-This project is setup within Travis. Here is the
-[project page](https://travis-ci.org/jedcn/reveal-ck).
+  there's a bunch of stuff that is about making the magic happen:
+  styles, javascript, etc, and that distracts from your content.
 
-### Updating the embedded reveal.js
+* If you track your slides in a system like git, you can get
+  meaningful diffs between versions of a single file. This is slightly
+  easier than if you track the generated presentation.
 
-If you've got things checked out, and submodules inited, then you can
-updated the embedded reveal.js as follows:
+In the end, [reveal.js][reveal-js], can make things pretty, but only
+you can make a presentation that is worthwhile.
 
-* cd into reveal.js
-* Run a `git fetch` and then merge/rebase/reset as is appropriate
-* Run tests
-* If the tests don't pass, you likely need to update how the
-  FileSplicer is invoked in the SliderBuilder. It's got hard-coded
-  begin/end line numbers for where the default reveal.js slides are
-  found. This commit is a good example of such a change: b29b050.
+[jedcn-reveal-ck]: http://jedcn.com/posts/reveal-ck
+[github-jedcn-reveal-ck-template]: http://github.com/jedcn/reveal-ck-template
+[reveal-js]: http://lab.hakim.se/reveal-js
+[travis-reveal-ck-badge]: https://travis-ci.org/jedcn/reveal-ck.png

data/bin/reveal-ck

@@ -21,7 +21,8 @@ command :generate do |c|
 
     output_dir = 'slides'
 
-    slides_haml = 'slides.haml'
+    slides_file = 'slides.haml' if File.exists? 'slides.haml'
+    slides_file = 'slides.slim' if File.exists? 'slides.slim'
 
     config = RevealCK::Config.new config_file: 'config.toml'
 
@@ -29,7 +30,7 @@ command :generate do |c|
                                                   revealjs_files: revealjs_files,
                                                   image_files: image_files,
                                                   output_dir: output_dir,
-                                                  slides_haml: slides_haml,
+                                                  slides_file: slides_file,
                                                   config: config
                                                 })
     builder.build!

data/lib/reveal-ck.rb

@@ -3,7 +3,7 @@ require_relative 'reveal-ck/config'
 require_relative 'reveal-ck/file_string_replacer'
 require_relative 'reveal-ck/file_slicer'
 require_relative 'reveal-ck/file_splicer'
-require_relative 'reveal-ck/haml_processor'
+require_relative 'reveal-ck/template_processor'
 require_relative 'reveal-ck/build_task'
 require_relative 'reveal-ck/builder'
 require_relative 'reveal-ck/slide_builder'

data/lib/reveal-ck/presentation_builder.rb

@@ -7,12 +7,12 @@ module RevealCK
   #
   class PresentationBuilder < Builder
 
-    attr_reader :revealjs_files, :image_files, :slides_haml, :config
+    attr_reader :revealjs_files, :image_files, :slides_file, :config
     attr_reader :tasks
 
     def initialize(args)
       @revealjs_files, @image_files = args[:revealjs_files], args[:image_files]
-      @slides_haml = args[:slides_haml]
+      @slides_file = args[:slides_file]
       @output_dir = args[:output_dir]
       @config = args[:config]
     end
@@ -36,10 +36,10 @@ module RevealCK
                  FileUtils.mkdir_p output_dir, verbose: false
                }
 
-      add_task "Transforming #{slides_haml} into #{output_dir('slides_html')}'}",
+      add_task "Transforming #{slides_file} into #{output_dir('slides_html')}'}",
                lambda {
-                 processor = HamlProcessor.open slides_haml
-                 File.open(output_dir('slides.html'), 'w') { |f| f << processor.html }
+                 processor = TemplateProcessor.open slides_file
+                 File.open(output_dir('slides.html'), 'w') { |f| f << processor.output }
                }
 
       add_task "Bundling up the revealjs stuff into #{output_dir}/",

data/lib/reveal-ck/template_processor.rb

@@ -0,0 +1,29 @@
+#
+# Setup Slim
+require 'slim'
+::Slim::Engine.set_default_options pretty: true
+
+module RevealCK
+  class TemplateProcessor
+
+    require 'tilt'
+
+    def initialize(file)
+      @template = Tilt.new file
+    end
+
+    def output(scope={}, locals = {})
+      @template.render scope, locals
+    end
+
+    def self.open(path)
+      file = if File.exists? path
+               path
+             else
+               File.expand_path(File.join(Dir.pwd, path))
+             end
+      TemplateProcessor.new file
+    end
+
+  end
+end

data/lib/reveal-ck/version.rb

@@ -1,3 +1,3 @@
 module RevealCK
-  VERSION = '0.1.3'
+  VERSION = '0.1.4'
 end

data/reveal.js/Gruntfile.js

@@ -17,7 +17,7 @@ module.exports = function(grunt) {
 
 		// Tests will be added soon
 		qunit: {
-			files: [ 'test/**/*.html' ]
+			files: [ 'test/*.html' ]
 		},
 
 		uglify: {
@@ -109,6 +109,7 @@ module.exports = function(grunt) {
 	});
 
 	// Dependencies
+	grunt.loadNpmTasks( 'grunt-contrib-qunit' );
 	grunt.loadNpmTasks( 'grunt-contrib-jshint' );
 	grunt.loadNpmTasks( 'grunt-contrib-cssmin' );
 	grunt.loadNpmTasks( 'grunt-contrib-uglify' );
@@ -118,7 +119,7 @@ module.exports = function(grunt) {
 	grunt.loadNpmTasks( 'grunt-zip' );
 
 	// Default task
-	grunt.registerTask( 'default', [ 'jshint', 'cssmin', 'uglify' ] );
+	grunt.registerTask( 'default', [ 'jshint', 'cssmin', 'uglify', 'qunit' ] );
 
 	// Theme task
 	grunt.registerTask( 'themes', [ 'sass' ] );
@@ -129,4 +130,7 @@ module.exports = function(grunt) {
 	// Serve presentation locally
 	grunt.registerTask( 'serve', [ 'connect', 'watch' ] );
 
+	// Run tests
+	grunt.registerTask( 'test', [ 'jshint', 'qunit' ] );
+
 };

data/reveal.js/README.md

@@ -52,10 +52,10 @@ This is based on [data-markdown](https://gist.github.com/1343518) from [Paul Iri
 
 #### External Markdown
 
-You can write your content as a separate file and have reveal.js load it at runtime. Note the separator arguments which determine how slides are delimited in the external file.
+You can write your content as a separate file and have reveal.js load it at runtime. Note the separator arguments which determine how slides are delimited in the external file. The ```data-charset``` attribute is optional and specifies which charset to use when loading the external file.
 
 ```html
-<section data-markdown="example.md" data-separator="^\n\n\n" data-vertical="^\n\n"></section>
+<section data-markdown="example.md" data-separator="^\n\n\n" data-vertical="^\n\n" data-notes="^Note:" data-charset="iso-8859-15"></section>
 ```
 
 ### Configuration
@@ -100,9 +100,6 @@ Reveal.initialize({
 	// Enable slide navigation via mouse wheel
 	mouseWheel: false,
 
-	// Apply a 3D roll to links on hover
-	rollingLinks: true,
-
 	// Transition style
 	transition: 'default', // default/cube/page/concave/zoom/linear/fade/none
 
@@ -110,7 +107,7 @@ Reveal.initialize({
 	transitionSpeed: 'default', // default/fast/slow
 
 	// Transition style for full page backgrounds
-	backgroundTransition: 'default' // default/linear
+	backgroundTransition: 'default' // default/linear/none
 
 });
 ```
@@ -153,7 +150,10 @@ Reveal.initialize({
 		{ src: 'plugin/notes/notes.js', async: true, condition: function() { return !!document.body.classList; } },
 
 		// Remote control your reveal.js presentation using a touch device
-		{ src: 'plugin/remotes/remotes.js', async: true, condition: function() { return !!document.body.classList; } }
+		{ src: 'plugin/remotes/remotes.js', async: true, condition: function() { return !!document.body.classList; } },
+
+		// MathJax
+		{ src: 'plugin/math/math.js', async: true }
 	]
 });
 ```
@@ -370,6 +370,8 @@ The display order of fragments can be controlled using the ```data-fragment-inde
 
 When a slide fragment is either shown or hidden reveal.js will dispatch an event.
 
+Some libraries, like MathJax (see #505), get confused by the initially hidden fragment elements. Often times this can be fixed by calling their update or render function from this callback.
+
 ```javascript
 Reveal.addEventListener( 'fragmentshown', function( event ) {
 	// event.fragment = the fragment DOM element
@@ -398,7 +400,7 @@ By default, Reveal is configured with [highlight.js](http://softwaremaniacs.org/
 
 ### Overview mode
 
-Press "Esc" key to toggle the overview mode on and off. While you're in this mode, you can still navigate between slides,
+Press "Esc" or "o" keys to toggle the overview mode on and off. While you're in this mode, you can still navigate between slides,
 as if you were at 1,000 feet above your presentation. The overview mode comes with a few API hooks:
 
 ```javascript
@@ -414,7 +416,7 @@ Just press »F« on your keyboard to show your presentation in fullscreen mode.
 
 
 ### Embedded media
-Embedded HTML5 `<video>`/`<audio>` and YouTube iframes are automatically paused when your navigate away from a slide. This can be disabled by decorating your element with a `data-ignore` attribute.
+Embedded HTML5 `<video>`/`<audio>` and YouTube iframes are automatically paused when you navigate away from a slide. This can be disabled by decorating your element with a `data-ignore` attribute.
 
 Add `data-autoplay` to your media element if you want it to automatically start playing when the slide is shown:
 
@@ -423,6 +425,21 @@ Add `data-autoplay` to your media element if you want it to automatically start
 ```
 
 
+### Stretching elements
+Sometimes it's desirable to have an element, like an image or video, stretch to consume as much space as possible within a given slide. This can be done by adding the ```.stretch``` class to an element as seen below:
+
+```html
+<section>
+	<h2>This video will use up the remaining space on the slide</h2>
+    <video class="stretch" src="http://clips.vorwaerts-gmbh.de/big_buck_bunny.mp4"></video>
+</section>
+```
+
+Limitations:
+- Only direct descendants of a slide section can be stretched
+- Only one descendant per slide section can be stretched
+
+
 ## PDF Export
 
 Presentations can be exported to PDF via a special print stylesheet. This feature requires that you use [Google Chrome](http://google.com/chrome).
@@ -461,7 +478,7 @@ If you want to add a theme of your own see the instructions here: [/css/theme/RE
 
 reveal.js comes with a speaker notes plugin which can be used to present per-slide notes in a separate browser window. The notes window also gives you a preview of the next upcoming slide so it may be helpful even if you haven't written any notes. Press the 's' key on your keyboard to open the notes window.
 
-By default notes are written using standard HTML, see below, but you can add a ```data-markdown``` attribute to the ```<aside>``` to write them using Markdown.
+Notes are defined by appending an ```<aside>``` element to a slide as seen below. You can add the ```data-markdown``` attribute to the aside element if you prefer writing notes using Markdown.
 
 ```html
 <section>
@@ -473,6 +490,20 @@ By default notes are written using standard HTML, see below, but you can add a `
 </section>
 ```
 
+If you're using the external Markdown plugin, you can add notes with the help of a special delimiter:
+
+```html
+<section data-markdown="example.md" data-separator="^\n\n\n" data-vertical="^\n\n" data-notes="^Note:"></section>
+
+# Title
+## Sub-title
+
+Here is some content...
+
+Note:
+This will only display in the notes window.
+```
+
 ## Server Side Speaker Notes
 
 In some cases it can be desirable to run notes on a separate device from the one you're presenting on. The Node.js-based notes plugin lets you do this using the same note definitions as its client side counterpart. Include the required scripts by adding the following dependencies:
@@ -520,23 +551,24 @@ You can then access your master presentation at ```http://localhost:1947```
 Example configuration:
 ```javascript
 Reveal.initialize({
-	// other options
+	// other options...
 
 	multiplex: {
-		// Example values. Generate your own.
+		// Example values. To generate your own, see the socket.io server instructions.
 		secret: '13652805320794272084', // Obtained from the socket.io server. Gives this (the master) control of the presentation
 		id: '1ea875674b17ca76', // Obtained from socket.io server
 		url: 'revealjs.jit.su:80' // Location of socket.io server
 	},
 
-	// Optional libraries used to extend on reveal.js
+	// Don't forget to add the dependencies
 	dependencies: [
-		// other deps
 		{ src: '//cdnjs.cloudflare.com/ajax/libs/socket.io/0.9.10/socket.io.min.js', async: true },
 		{ src: 'plugin/multiplex/master.js', async: true },
 
 		// and if you want speaker notes
 		{ src: 'plugin/notes-server/client.js', async: true }
+
+		// other dependencies...
 	]
 });
 ```
@@ -547,20 +579,21 @@ Served from a publicly accessible static file server. Examples include: GitHub P
 Example configuration:
 ```javascript
 Reveal.initialize({
-	// other options
+	// other options...
 
 	multiplex: {
-		// Example values. Generate your own.
+		// Example values. To generate your own, see the socket.io server instructions.
 		secret: null, // null so the clients do not have control of the master presentation
 		id: '1ea875674b17ca76', // id, obtained from socket.io server
 		url: 'revealjs.jit.su:80' // Location of socket.io server
 	},
 
-	// Optional libraries used to extend on reveal.js
+	// Don't forget to add the dependencies
 	dependencies: [
-		// other deps
 		{ src: '//cdnjs.cloudflare.com/ajax/libs/socket.io/0.9.10/socket.io.min.js', async: true },
 		{ src: 'plugin/multiplex/client.js', async: true }
+
+		// other dependencies...
 	]
 });
 ```
@@ -584,20 +617,21 @@ The socket.io server can play the role of static file server for your client pre
 Example configuration:
 ```javascript
 Reveal.initialize({
-	// other options
+	// other options...
 
 	multiplex: {
-		// Example values. Generate your own.
+		// Example values. To generate your own, see the socket.io server instructions.
 		secret: null, // null so the clients do not have control of the master presentation
 		id: '1ea875674b17ca76', // id, obtained from socket.io server
 		url: 'example.com:80' // Location of your socket.io server
 	},
 
-	// Optional libraries used to extend on reveal.js
+	// Don't forget to add the dependencies
 	dependencies: [
-		// other deps
 		{ src: '//cdnjs.cloudflare.com/ajax/libs/socket.io/0.9.10/socket.io.min.js', async: true },
 		{ src: 'plugin/multiplex/client.js', async: true }
+
+		// other dependencies...
 	]
 ```
 
@@ -606,28 +640,102 @@ It can also play the role of static file server for your master presentation and
 Example configuration:
 ```javascript
 Reveal.initialize({
-	// other options
+	// other options...
 
 	multiplex: {
-		// Example values. Generate your own.
+		// Example values. To generate your own, see the socket.io server instructions.
 		secret: '13652805320794272084', // Obtained from the socket.io server. Gives this (the master) control of the presentation
 		id: '1ea875674b17ca76', // Obtained from socket.io server
 		url: 'example.com:80' // Location of your socket.io server
 	},
 
-	// Optional libraries used to extend on reveal.js
+	// Don't forget to add the dependencies
 	dependencies: [
-		// other deps
 		{ src: '//cdnjs.cloudflare.com/ajax/libs/socket.io/0.9.10/socket.io.min.js', async: true },
 		{ src: 'plugin/multiplex/master.js', async: true },
 		{ src: 'plugin/multiplex/client.js', async: true }
+
+		// other dependencies...
 	]
 });
 ```
 
+## Leap Motion
+The Leap Motion plugin lets you utilize your [Leap Motion](https://www.leapmotion.com/) device to control basic navigation of your presentation. The gestures currently supported are:
+
+##### 1 to 2 fingers
+Pointer &mdash; Point to anything on screen. Move your finger past the device to expand the pointer.
+
+##### 1 hand + 3 or more fingers (left/right/up/down)
+Navigate through your slides. See config options to invert movements.
+
+##### 2 hands upwards
+Toggle the overview mode. Do it a second time to exit the overview.
+
+#### Config Options
+You can edit the following options:
+
+| Property          | Default           | Description
+| ----------------- |:-----------------:| :-------------
+| autoCenter        | true              | Center the pointer based on where you put your finger into the leap motions detection field.
+| gestureDelay      | 500               | How long to delay between gestures in milliseconds.
+| naturalSwipe      | true              | Swipe as though you were touching a touch screen. Set to false to invert.
+| pointerColor      | #00aaff           | The color of the pointer.
+| pointerOpacity    | 0.7               | The opacity of the pointer.
+| pointerSize       | 15                | The minimum height and width of the pointer.
+| pointerTolerance  | 120               | Bigger = slower pointer.
+
+
+Example configuration:
+```js
+Reveal.initialize({
+
+	// other options...
+
+	leap: {
+		naturalSwipe   : false,    // Invert swipe gestures
+		pointerOpacity : 0.5,      // Set pointer opacity to 0.5
+		pointerColor   : '#d80000' // Red pointer
+	},
+
+	dependencies: [
+		{ src: 'plugin/leap/leap.js', async: true }
+	]
+
+});
+```
+
+## MathJax
+
+If you want to display math equations in your presentation you can easily do so by including this plugin. The plugin is a very thin wrapper around the [MathJax](http://www.mathjax.org/) library. To use it you'll need to include it as a reveal.js dependency, [find our more about dependencies here](#dependencies).
+
+The plugin defaults to using [LaTeX](http://en.wikipedia.org/wiki/LaTeX) but that can be adjusted through the ```math``` configuration object. Note that MathJax is loaded from a remote server. If you want to use it offline you'll need to download a copy of the library and adjust the ```mathjax``` configuration value. 
+
+Below is an example of how the plugin can be configured. If you don't intend to change these values you do not need to include the ```math``` config object at all.
+
+```js
+Reveal.initialize({
+
+	// other options ...
+
+	math: {
+		mathjax: 'http://cdn.mathjax.org/mathjax/latest/MathJax.js',
+		config: 'TeX-AMS_HTML-full'  // See http://docs.mathjax.org/en/latest/config-files.html
+	},
+	
+	dependencies: [
+		{ src: 'plugin/math/math.js', async: true }
+	]
+
+});
+```
+
+Read MathJax's documentation if you need [HTTPS delivery](http://docs.mathjax.org/en/latest/start.html#secure-access-to-the-cdn) or serving of [specific versions](http://docs.mathjax.org/en/latest/configuration.html#loading-mathjax-from-the-cdn) for stability.
+
+
 ## Installation
 
-The **basic setup** is for authoring presentations only. The **full setup** gives you access to all reveal.js features as well as the development tasks needed to make changes to the source.
+The **basic setup** is for authoring presentations only. The **full setup** gives you access to all reveal.js features and plugins such as speaker notes as well as the development tasks needed to make changes to the source.
 
 ### Basic setup
 
@@ -648,22 +756,22 @@ Some reveal.js features, like external markdown, require that presentations run
 
 2. Install [Grunt](http://gruntjs.com/getting-started#installing-the-cli)
 
-4. Clone the reveal.js repository  
+4. Clone the reveal.js repository
 ```
 $ git clone git@github.com:hakimel/reveal.js.git
 ```
 
-5. Navigate to the reveal.js folder 
+5. Navigate to the reveal.js folder
 ```
 $ cd reveal.js
 ```
 
-6. Install dependencies  
+6. Install dependencies
 ```
 $ npm install
 ```
 
-7. Serve the presentation and monitor source files for changes  
+7. Serve the presentation and monitor source files for changes
 ```
 $ grunt serve
 ```