Fix localhost link and add Events overview. Fix #4 and #5

overview/Events.md

@@ -0,0 +1,74 @@
+---
+title: Events
+layout: doc
+---
+
+Bonsai supports a number of events.
+
+To bind an event listener to a Bonsai object use the mixin'd [EventEmitter](/EventEmitter.html) methods:
+
+<!--runnable-->
+{% highlight javascript %}
+new Circle(50, 50, 30).addTo(stage)
+  .fill('red')
+  .on('pointermove', function(e) {
+    this.fill('random');
+  });
+{% endhighlight %}
+
+## Pointer Events
+
+Bonsai's DisplayObjects support the following pointer events:
+
+ * `pointerup`: fires on a single-finger touchend event or a mouseup event.
+ * `pointerdown`: fires on a single-finger touchstart event or a mousedown event.
+ * `pointermove`: fires on a single-finger touchmove event or a mousemove event.
+ * `click`: fires on a single-finder touchstart-touchend cycle (no mediating touchmove) or a click event.
+ * `doubleclick`: fires on a dblclick event.
+ * `drag`: fires on subsequent pointermove events after a pointerdown event.
+
+To support multiple touches (i.e. multiple fingers at once) on touch devices, you can use:
+
+ * `multi:pointerup`
+ * `multi:pointerdown`
+ * `multi:pointermove`
+ * `multi:drag`
+
+All pointer events will include the following properties in the passed Event object which is passed to your event handlers:
+
+ * `x`or `stageX`: X coordinate of the pointer event within the stage
+ * `y`or `stageY`: X coordinate of the pointer event within the stage
+ * `clientX`: X coordinate of the pointer event within the parent window
+ * `clientY`: Y coordinate of the pointer event within the parent window
+
+## Key Events
+
+The stage object supports key events:
+
+ * `key`: (analogous to `keypress` in the DOM)
+ * `keydown`
+ * `keyup`
+
+All key events will include the following properties in the passed Event object which is passed to your event handlers:
+
+ * `event.keyCode`
+ * `event.ctrlKey`
+ * `event.altKey`
+ * `event.metaKey`
+ * `event.shiftKey`
+
+E.g.
+
+{% highlight javascript %}
+stage.on('key', function(e) {
+  console.log('Key event: ' + e.keyCode);
+});
+{% endhighlight %}
+
+## Meta Events
+
+DisplayObjects emit the following meta events:
+
+ * `removedFromStage`
+ * `addedToStage`
+