Prepare for splitting up Getting Started docs
Split Getting Started docs into separate sections

The "Getting Started" docs became overly long and unwieldy over time.
This splits it into separate sections, including:

* Quickstart
* Installation
* Writing content
* Publish your site
If PATH is undefined, Pelican uses PWD as content
Merge pull request #1345 from justinmayer/docs34

Split "Getting Started" docs into separate sections
move {ARTICLE,PAGE}_DIR -> {ARTICLE,PAGE}_PATHS

Instead of one path a list can be given. This is due to popular request.
Should help people not wanting to use Pelican for blogging.
Maintain backward compatibility though.
Thanks to @ingwinlu for pointing out the change in StaticGenerator.
Fix #1344 move PLUGIN_PATH -> PLUGIN_PATHS

Pelican uses *_PATHS names for settings that represent a list of paths.
Add {PAGE,ARTICLE}_PATHS to {ARTICLE,PAGE}_EXCLUDES automatically

This makes it easier for someone to change PAGE_PATHS without the
need to change ARTICLE_EXCLUDES accordingly.
Fix RstReader authors metadata processing

The reader would return a list of authors already, but
METADATA_PROCESSORS['authors'] expects a string.
Added a test case for this (only the HTMLReader had it).
Docs update for *_{previous|next}_page variables
Merge pull request #1362 from avaris/neighbor_pages_docs

Doc update for *_{previous|next}_page variables
catch arbitrary exceptions during cache unpickling

It is hard to forsee what could be raised.
Require six version 1.4.0 or later.

six.moves.urllib.parse is available since version 1.4.0.

Signed-off-by: OGINO Masanori <masanori.ogino@gmail.com>
Use six.moves.urllib.

Signed-off-by: OGINO Masanori <masanori.ogino@gmail.com>
Remove AsciiDocReader from core. Fixes #1355
Merge pull request #1370 from omasanori/six-version

Require six version 1.4.0 or later.
[coveralls] Exclude tests from coverage
Merge pull request #1376 from avaris/remove_asciidoc

Remove AsciiDocReader from core. Fixes #1355
Merge pull request #1322 from smartass101/get_files_multiple_paths

move {ARTICLE,PAGE}_DIR -> {ARTICLE,PAGE}_PATHS and correlate with {ARTICLE,PAGE}_EXCLUDES
Fix #1198, enable custom locale in template rendering, fixes links

reverts getpelican/pelican@ddcccfeaa952d2e1e24ceac94e5d66c73b57c01b

If one used a locale that made use of unicode characters (like fr_FR.UTF-8)
the files on disk would be in correct locale while links would be to C.

Uses a SafeDatetime class that works with unicode format strigns
by using custom strftime to prevent ascii decoding errors with Python2.

Also added unicode decoding for the calendar module to fix period
archives.
Fix test errors on OSX

On OSX, if LC_TIME and LC_CTYPE differs the output of strftime is not properly decoded
in Python 3. This makes sure that the 'utils.DateFormatter' and the related Jinja filter
'strftime' set the same value for LC_TIME and LC_CTYPE while formatting.

Also, '%a' is removed from DEFAULT_DATE_FORMAT in 'custom_locale' tests. OSX and *nix have
different conversions for '%a' ('Jeu' vs 'jeu.') and there is not a feasible way to handle
the difference for tests.