re-commenting code since its on github

Also changed the layout of the demo file to have the image list not be
so damn ugly. the idea is still the exact same, theres just a more
performant html way of showing it. includes changes to the CSS file to
reflect new image list html.
Lots of style changes to the theme itself, and sprucing up the demo
descriptions.