Add a smarty filter for smartypants processing.

Contains a workaround for a single backticks bug:

https://github.com/vmg/redcarpet/pull/201
Add some filters documentation, including smarty.
Minor example tweak.
Merge pull request #28 from aprescott/smarty-filter

Add a smarty filter for smartypants processing