Adding details to GitHub Pages deployment docs regarding relative URLs.

Fixes #1291.
Update the S3 deployment documentation

This is just #1294 on the appropriate branch.
Update history to reflect merge of #1290 and 1294
Update troubleshooting.md for Mac OSX native gem install issue
Merge pull request #1296 from jannypie/master

Troubleshooting tip for Mac OSX Mountain Lion
Update history to reflect merge of #1296.
Be (mostly) anal-retentive about line columns. :corn: :stuck_out_tongue: