[Docs] Complete the transition from "indexes" to "taxonomies" (almost)

Also mention `.Site.Indexes` → `.Site.Taxonomies` as well as
the upcoming `.Site.Recent` → `.Site.Pages` transitions.

[Docs] Copyediting

 * Add meta author, description and generator tags
 * Add Hugo version beside the logo and in the footer
 * Suggest the user to run `go get -u -v` to update dependencies
 * Requires Go 1.3+ rather than Go 1.1+
 * Improve rendering/formatting in some places
 * Add trailing slash to URLs where appropriate
 * GitHub redirects all http requests to https, update accordingly

[Docs] Use OptiPNG to shrink PNG images losslessly

So they load slightly faster.  :-)

Some housekeeping of the Showcase and Press pages

Add .mailmap to get a more correct author log

ignore root path, no need strip traling slash

Version uses binary name instead of hugo

On Windows the binary name is hugo.exe and running hugo version results in
this error:
    GetFileAttributesEx D:\Dev\Go\gopath\bin\hugo: The system cannot find the file specified.

This fixes that error and allows the binary name to be something other
than hugo on any OS.

Added three videos to documentation.

Created shortcode for YouTube videos and made the videos responsive in the
stylesheet.

Use runtime.GOOS to identify Windows specific path tests

[doc] Improve paginator doc

Replace assert.Equal(true/false) with assert.True/False

Do not panic on permission denied

Replace panic with FATAL logging and graceful shutdown.

Fixes #837

Split Windows and Unix specific path tests

Temporarily comment out breaking Windows test case

Introduce FilepathPathBridge

This commit introduces the new interface FilepathPathBridge to remove some code that differs only in their use of either the path or filepath package.

Add more tests to helper

Improve pagination testing

* Add missing pagination test cases
* Remove some unreachable code paths
* Fix some corner cases

Linkify release notes

Set detault for Paginate to 10

10 is a better default than 0, since no paginator pages will be created unles referenced by a `.Paginator`.

See #750

Add documentation for pagination

See #750

Add Bootstrap-compatible pagination.html

See #750

Add pagination to release notes

Add pagination support for home page, sections and taxonomies

Two new configuration properties, `Paginate` (default `0`) and `PaginatePath` (default `page`) are added.

Setting `paginate` to a positive value will split the list pages for the home page, sections and taxonomies into chunks of size of the `paginate` property.

A `.Paginator` is provided to help building a pager menu.

There are two ways to configure a `.Paginator`:

1. The simplest way is just to call `.Paginator.Pages` from a template. It will contain the pages for "that page" (`.Data.Pages` will (like today) contain all the pages).
2. Select a sub-set of the pages with the available template functions and pass the slice to `.Paginate` : `{{ range (.Paginate (where .Data.Pages "Type" "post")).Pages }}`

**NOTE:** For a given Node, it's one of the options above. It's perfectly legitimate to iterate over the same pager more than once, but it's static and cannot change.

The `.Paginator` contains enough information to build a full-blown paginator interface.

The pages are built on the form (note: BLANK means no value, i.e. home page):

```
[SECTION/TAXONOMY/BLANK]/index.html
[SECTION/TAXONOMY/BLANK]/page/1/index.html => redirect to  [SECTION/TAXONOMY/BLANK]/index.html
[SECTION/TAXONOMY/BLANK]/page/2/index.html
....
```

Fixes #96

Add site-wide/per-page [blackfriday] `extensions` option

Wrong URL for Github Pages

Move s.prepUrl() before prepending BaseUrl.

When we have an absolute menu url specified in the config file
(e.g., `menu: { main: { name: "News", url: "/news" } }`),
its menu entry is generated by prefixing it with the BaseUrl.
The result is then run through prepUrl(), which uses helpers.Urlize to
convert urls such as 'My First Link' to 'my-first-link'.

The behaviour is backwards: we do not want to run helpers.Urlize on the
BaseUrl, only on the absolute component. Currently, a BaseUrl such as
'http://my.edu/ENG101' will be converted to 'http://my.edu/eng101',
resulting in broken links in all of my menus.

This commit switches the URL prep and BaseUrl prepending actions around. I
would argue that these URLs shouldn't be run through prepUrl anyway
because the site developer has specified them explicitly in a config file
and might be surprised for, e.g., URLs to change case, but that's another
commit for another time.

Correct wercker URL

Fix inverse notation

Make Blackfriday smart fractions to really default to `true`

Fix my own bug in Pull Request #829,
commit eb686352b1785844778e1cba8c69b85079e3044f

Add site-wide/per-page [blackfriday] `fractions` option

Make Blackfriday's `HTML_SMARTYPANTS_FRACTIONS` option
user-configurable.  Defaults to `true` as before.  See
discussions at:

http://discuss.gohugo.io/t/any-way-to-disable-smart-fractions/328

Thanks to @bjornerik and @spf13 for laying the groundwork
making it easy to expose Blackfriday's underlying configurable
options.

Fix for page.GetParam() for JSON and TOML maps

Setting per-page Blackfriday angledQuotes did not work
with TOML or JSON front matter, but it does work with YAML.

It turns out that page.Params("blackfriday") returns
type map[interface{}]interface{} for YAML, but
type map[string]interface{} for JSON and TOML.

This patch updates page.GetParam() to catch the latter,
with an error message if page.GetParam() does not recognize
a type.  A test is also added.

Upgrade from gopkg.in/yaml.v1 to gopkg.in/yaml.v2

Handle empty front matter in archetype.

If an archetype has deliberately empty front matter (e.g., to suppress
generation of the 'draft' field or to force a particular front matter type
instead of the default TOML), we should handle it gracefully rather than
panic ("assignment to entry in nil map").

[Docs]: Add new press/blog coverage about Hugo

Fix RelPermalink() and Urls in menus vs canonifyUrls

canonifyUrls=true, RelPermalink and baseUrl with sub-path did not work.

This fixes that by adding a check for canonifyUrl=trues=true in RelPermalink().

So given

- baseUrl "http://somehost.com/sub/"
- the path "some-path/file.html"

For canonifyUrls=false RelPermalink() returns "/sub/some-path/file.html"
For canonifyUrls=true RelPermalink() returns "/some-path/file.html"

In the last case, the Url will be made absolute and clickable in a later step.

This commit also makes the menu urls defined in site config releative. To make them work with canonifying of urls, the context root is prepended if canonifying is turned off.

Fixes #519
Fixes #711

[Docs] Document the new (temp?) default of `canonifyurls = false`

Also add a **Caveat** on http://gohugo.io/tutorials/github-pages-blog/
warning the reader that a `canonifyurls = true` must be added
for Spencer's old example files to work.

Fixes #802

Revert "Try to fix mysterious test failures on Travis"

This reverts commit 71fe85df9b7193f790fbb5e3af415b176fdb6a4f.

See https://github.com/PuerkitoBio/purell/pull/5
for the cause of the mysterious `go test -v ./...` failure.

Try to fix mysterious test failures on Travis

Add menu tests for pages with both Yaml and Toml front matter

See #817

Revert "Quick-and-dirty way to print details of template errors"

This reverts commit 42b33102cf619e08c6b6a49a50a0995e8f14773f.

Add dateFormat to release notes

Add dateFormat template function

This is the implementation of the proposal at #235 and
http://discuss.gohugo.io/t/parsing-dates-in-templates/603/3

Protect the innerShortCodeCache by a RW lock

Cache the page's rendering context flags

This map can potentially be used many times for a given page, and altough the cost of re-creating the map should be minimal, caching it is simple -- and could save some GC and CPU cycles.

Register rstHandler to restore experimental reST support

(Experimental) reStructuredText support was working in v0.12,
but was no longer handled after some refactoring in v0.13-DEV.
That experimental support is now restored.

Furthermore, check for both rst2html and rst2html.py in the PATH,
and execute whichever is found.

See #472 for more information.

Make ref and relref respect plainIdAnchors

Fixes #813

fix outdated MathJax CDN URL

The rackspace address has been retired, see http://www.mathjax.org/changes-to-the-mathjax-cdn/

[Docs] Use of `$.` to access global context from anywhere

See #804, http://discuss.gohugo.io/t/templates-multiple-parameters/600/3
and http://stackoverflow.com/questions/16734503/access-out-of-loop-value-inside-golang-templates-loop
for related discussions.

[Docs] Recommend the use of backticks for IE conditionals

Special thanks to @tatsushid and @bjornerik for the insight!

Fixes #778.

Fix string comparison for .Truncated page variable

Instead of `strings.TrimSpace()`, use `strings.Join(strings.Fields(s), " ")`
to collapse all whitespaces into single spaces, in order to match the
behaviour of helpers.TruncateWordsToWholeSentence(),
in order to detect non-truncated content correctly.

[Docs] Correct description of "Read More" links in Summaries

Also revise some paragraphs for succinctness.

Fixes #788

Fix two errors in two internal templates

 * template: _internal/_default/opengraph.html:39: unexpected EOF
 * template: _internal/_default/schema.html:15: unexpected {{end}}

Also change the DateTime inside these templates to ISO 8601 format,
and skip <meta itemprop="datePublished"> if `publishdate` is not set.

Perhaps it would be a good idea to expose `func (Time) IsZero`
to our templates?  :-)

Add missing assertion to trim-test

fix --uglyUrls params

Minor polish in path/url

Add more tests to general helper

Add tests for IsSet

Add test binaries to .gitignore

Refactor TestGt to also include Lt, Ge, Le, Eq and Ne

[Docs] Add a note about the plan to switch to Apache License

Add tests for Apply

Add inline doc for Apply

Rename ignoreDotFile to isDotFile (which is what it is)

Replace regexp based Chomp with builtin TrimRight

Add tests for Replace

Add tests for Trim

Add test coverage files to .gitignore

Add tests for Chomp

Quick-and-dirty way to print details of template errors

See Issue #316.

[Docs] Incorporate some great ideas by @mohae into the `safeUrl` docs

E.g. how `#ZgotomlZ` is used to "defang" the URL

Add `safeUrl`; disable `safeHtmlAttr`; rename `safeCSS` to `safeCss`

- Add `safeUrl` template function (Fixes #347)
- Add TestSafeUrl() fashioned after @tatsushid great examples
- Disable `safeHtmlAttr` pending further discussions on its other
  use cases because `safeUrl` is a cleaner solution to #347.
  (There are also `safeJs` and `safeJsStr` that we could implement
  if there are legitimate demands for them.)
- Rename `safeCSS` to `safeCss` (to follow the convention of `safeHtml`)
- Add/expand documentation on `safeHtml`, `safeCss` and `safeUrl`

Add SafeHtmlAttr, SafeCSS template function

This allows a template user to keep a safe HTML attribute or CSS string
as is in a template.

This is implementation of @anthonyfok great insight

Fix #784, #347

Revert "[Docs] Use <dl> for definition lists of variables"

This reverts commit 5d6dfe81b8c78d86fad677b4ba452b7bcf52aed9.

The extra styling in docs/static/css/style.css has been retained.

[Docs] New testimonials and press coverage

Found on @spf13's Twitter.  :-)

Prevent the testimonial dates from wrapping.

Also fix a few minor problems to get the home page
to validate as proper HTML5.

[Docs] Limit `.fa { display: inline }` within #main-content

Otherwise the items in the side menu won't line up.
Sorry about this oversight in my recent commit.

[Docs] Add FreeBSD logo beside the FreeBSD name

Extracted from https://www.freebsd.org/logo/logo-simple.svg
for temporary use until a future Font Awesome release adds
the `fa-freebsd` glyph (github/FortAwesome/Font-Awesome#1116)  :-)

Make .fa `display: inline` to prevent unwanted line-wrapping

Also make the menu item "Issue & Help" line up with the others.

Merge branch 'master' of github.com:spf13/hugo

Make RSS dates valid

See #789

[Docs] Use <dl> for definition lists of variables

Hopefully making them more semantic and easier to read,
though it is raw HTML so it is slightly more work to maintain.

Also made minor revisions to some of the variable descriptions
to be more informative, e.g. `:monthname` in permalinks use
full English names ("January" etc.)

Fix the Hugo.Generator tag so it can be used

Fix broken doc section

Use an init() method to create the HugoInfo instance

See #570

Update release notes with the new Hugo var

Make sure there are only one HugoInfo instance

See #570

Merge branch 'master' of github.com:spf13/hugo

Fix HugoInfo init

See #570

Added top level .Hugo variable with version, commit and generator information + docs
Added Version, CommitHash and BuildDate to hugolib/hugo.go and used it in build
Removed commitHash and buildDate from commands/version.go and used hugolib vars
Removed getDateFormat function from commands/version.go

Conflicts:
README.md
docs/content/templates/variables.md

[Docs] Minor revisions to future v0.13 Release Note

And a tiny bit of copyediting here and there.

[Docs] New "Troubleshooting Overview" page

Somewhat cheesy at the moment.
Pull requests to improve the page are very welcome!

Add trim and replace to release notes

Make all the params to Replace an interface{}

Rewrite first argument to interface{}

Add trim and replace template functions

Change CR+LF to LF on gohugo.io front page, saving 286 bytes

Also change mode 100755 to 100644.

Update gohugo.io front page for 2015; add @popthestack's testimony :-)

[Docs] More copyediting

* Add link to https://travis-ci.org/spf13/hugo
* Correct heading levels in docs/content/community/mailing-list.md
* Mention RFC 3339 as the `date` format set by `hugo new`
* Mention that `hugo new` does not add `draft = true` when the user
  provides an archetype
* List short examples of TOML and YAML side by side
* Compact the Math template functions into a table
* Put some notes into a blockquote

[Docs] Adjust sidebar menu width and capitalization

Make the sidebar menu slightly wider so the arrow
does not get pushed to the next line.

Also remove `text-transform: capitalize;` so we can have,
e.g., "Table of Contents" rather than "Table Of Contents".

Missing . on footer partials

Update TestFixUrl() to expect BaseUrl to have trailing `/`

See #793, #799

Merge pull request #798 from bjornerik/fix/nestedshortcodes

Fix issue with nested shortcodes