merge upstream
new HTMLReader
include html comments properly in reader
Merge branch 'master' of git://github.com/ametaireau/pelican
git merge master
re-import htmlparser
re-import cgi. properly turn utils.open into a context manager
fix failing test with new open context manager
handle escaped chars in html properly
properly write out charref's
change 'markdown' to HTML in the comments
Merge branch 'master' of git://github.com/ametaireau/pelican
Merge branch 'master' into htmlparser
add documentation for html reader
fix grammar
Docs update of the pelican core install depedencies
PyPI links for pelican depedencies
Update webassets plugin to allow user to pass configuration settings to Webassets through their settings file. Also removed language about DEBUG not compiling CSS since as of at least webassets 0.8 this is no longer an issue.
contents: Add rich comparisons to URLWrapper for easy sorting

There have been earlier attempts to sort categories and authors
[1,2,3], but they either sorted based on the object id [3], or only
sorted the main author and categories list.

This patch uses rich comparisons (keyed off URLWrapper.name, but
easily adjustable in subclasses) to make the objects sortable without
specifying a key for each sort.  For example, now

  {% for tag, articles in tags|sort %}

works as expected in a Jinja template.

The functools.total_ordering decorator fills in the missing rich
comparisons [4,5].

[1]: 877d454c8fa979343d4881a00977d9ac8786f178
[2]: 7f36e0ed20745c73886d96d4af303b0d858b8a53
[3]: d0ec18f4dbd623c55bdf4928ee7c363f699ef696
[4]: http://docs.python.org/2/library/functools.html#functools.total_ordering
[5]: http://docs.python.org/3/library/functools.html#functools.total_ordering
docs/themes.rst: Document URLWrapper sorting for use in Jinja templates