This is the starting point of documenting Hyde using Sphinx. This
provides several benefits:

1. Code and documentation live together, so it's easier to track and
enforce that there exists documentation for new or changing code.

2. This lets us get Hyde on Read The Docs.

3. We can use things like `autoclass` where appropriate to pull
documentation directly from source code without reinventing the wheel.

I've tried to replicate what currently exists on hyde.github.io. The
first pass of this effort is concerned with parity, and we can continue
to improve from there on. Steps:

1. Convert all existing documentation on hyde.github.io to Sphinx. This
is covered by this commit and should be considered "in review".

2. Open issues for core parts of Hyde that are missing documentation.

3. Close these issues individually. This is a great opportunity for
community members wishing to get involved to contribute.

4. Require significant changes in code to be accompanied by updated /
new documentation the same way we would require tests.

While these steps are in progress, the following should also be done:

1. Deprecate the docs at hyde.github.io, linking users to Read The Docs.

2. Replace the content currently hosted at hyde.github.io with a new
brochure site showing off some of Hyde's uses and linking to other
interesting content (e.g. a list of themes, links to sites powered by
Hyde, etc.).

References #188, #209, and quite a few other issues.

@lakshmivyas, @llonchj: please review. This is a starting point for
Sphinx docs, and the PR is labelled as a work in progress, but I have no
specific threshold for it being "done". Once we're all satisfied with
the first pass, I'll set up RTD, and we can start filing issues for
specific areas lacking docs.

- Update changelog
- Relax dependency version requirements
- Update readme
- Read setup.py requirements from requirements text files

- Fix tests that were failing because of misconfigured
  template path
- Fix formatting issues identified by flake8

*   Bugfix: Fix smartypants to 1.7.x to avoid the breaking
    changes in 1.8.  (Issue #229)
*   Bugfix: Upgrade Jinja to 2.7.1 - this fixes
    mitsuhiko/jinja2#243.

-   BREAKING:  While this change will correct the weird encoding
    behavior, this also changes the way `xxx_url` macros work.
-   Do not encode the url bases (`base_url`, `media_url`). Only
    the path component needs to be encoded.

-   Ensure that subfolders for `layout_root`, `content_root`,
        `media_root` and `deploy_root` works reliably
        on windows. Use `fully_expanded_path` for all path components.

- Also, fixed `raise_exceptions` commandline parameter handling.

*   Better exception handling. (Issue #204)
    -   Hyde now propagates exceptions
    -   Hyde does not raise exceptions by default. `-x` flag is required
        for raising exceptions on error.
    -   Traceback is available in the `verbose` mode
*   Upgraded to commando 0.3.4
*   Upgraded to Jinja 2.7

- Add LICENSE, AUTHORS.rst, CHANGELOG.rst and README.rst to MANIFEST.in.
- Add "Hyde contributors" to copyright.

- Fix expected files in uglify tests
- Use proper configuration for copyright retention

*   Bugfix: Use `clearfix` class in `listing.j2`. (Issue #156)
*   Bugfix: Use `relative_path` instead of url in `macros.j2`.
    (Issue #180)

- Upgrade and fix versions for dependencies
- Use the typogrify package on pypi
- Fix tests that break because of the upgrades
- Bump version

-   `include_file_patterns` property accepts globs to filter by file name.
 -   `include_paths` accepts paths relative to content.
 -   `begin_node` and `node_complete` honor `include_paths`
 -   `begin_text_resource`, `text_resource_complete`, `begin_binary_resource`
      and `binary_resource_complete` honor both.

* Ignores .hg, .svn, .git by default
* Additional nodes can be ignored by adding to site.config.ignore