hugo: Update contribution guidelines

Refactor the contribution guidelines in the README and CONTRIBUTING
files.

Simplify the contribution guide in the README and move most of the
complex stuff into CONTRIBUTING.

Add an explicit commit message guidelines section to CONTRIBUTING.  Keep
all of the guidelines from Chris Beams except for the 72 character line
limit (we don't follow that, nor does the Go team).  Add three new
guidelines: package prefix in subject, references in body, and
encouragement of message body in general.

Add a new section to CONTRIBUTING on using Git Remotes.

commands: Specify os port generic errors

Closes #2217

commands: Fix charsets in mimetypes

Fixes #2218

Fix shortcode in markdown headers

This issue was introduced as a fix to shortcode not working in RST.

One could argue that Blackfriday and friends should handle `#` in titles, but that will be a discussion
for another day.

The new placeholder pattern should be RST safe and work with titles.

And now with a test so this doesn't break again.

Fixes #2192
Fixes #2209
Closes #2210

docs: Add upbeat.it to the showcase

docs: Add mayan-edms to the showcase

Unexport ShouldBuild and AssertShouldBuild

hugolib: futureStats plural

hugolib: Handle unpecified date for IsFuture and IsExpired

hugolib: Add expiredStats to build feedback

hugolib: Bug fix futureStats

hugolib: Refactor page.ShouldBuild and table driven test

docs: Add ExpiryDate to the list of variables

docs: Example of how to use Order by ExpiryDate

docs: Add instructions on buildExpired in build configurations

docs: Add expirydate to front-matter doc

commands: Add listExpiredCmd for expired pages

commands: Add buildExpired flag

hugolib: Add GroupByExpireDate function

hugolib: Add sort ByExpiryDate function

hugelib: Add expiredCount as a Site variable

hugolib: Support an expiration date

Fix Emojfy for certain text patterns

Fixes #2198

Change hugo to Hugo in help text

Update the alias generated HTML files to conform to the W3C HTML spec

- W3C recommends that there be a [whitespace character][1] between the
`;` and the `url=` portions.

- W3C also recommends that there be a [title][2] child in the `head`
element

[1]: https://www.w3.org/TR/html-markup/meta.http-equiv.refresh.html
[2]: https://www.w3.org/TR/html-markup/head.html

Closes #1933

Remove unneeded casts in page.getParam

Closes #2186

Fix urlesc import url in Dockerfile

docs: Add jamescampbell.us to the showcase

Bump version to 0.17-DEV

Update release-notes.md

bump 0.16 to the correct date and add meta generator note.

Get Dockerfile up-to-date

Add Hugo generator tag to home page if not present

Fixes #2182

Update release-notes.md

docs. Add the guranteed exit -1 on eror to Hugo 0.16 rel notes

It is a minor thing, but  BIG thing for many, including myself.

Some polish and addends to 0.16 release notes

Pull the shootouts about 0.16 into the intro section

Remove HugoVersionSuffix "-DEV" prior to 0.16 release

update release notes for 0.16 release

Handle errors during rereading properly

Without this fix, any error during rereading would cause Hugo to hang.
Fixes #2168
Closes #2179

Ignore __jb_tmp___ files created by IntelliJ

Annotate temp files that Hugo ignores

docs: Grammar fix in overview/quickstart.md

docs: Add Digital Ocean articles to press section

docs: Add c't magazine article to press section

docs: Document UniqueID page variable

docs: Add an example of how to use .PrevInSection

It's not a common knowledge what the "pointer" is so let's
add an example of how to use .PrevInSection

docs: Add note about live reload script injection

Answers common question in docs.
https://discuss.gohugo.io/t/livereload-only-works-on-the-homepage/1006/4

docs: Fix minor typo in overview/quickstart.md

docs: Add novelist.xyz to the showcase

docs: Fix typo / readability in extras/menu.md

docs: Add stefano.chodino.uk to the showcase gallery.

docs: Add klingt.net to the showcase gallery

docs: Clarify that watch is enabled by default

docs: Fix git clone for hugo_theme_robust in quickstart guide

docs: Improve description for .Hugo.Generator

Fix broken template test

Don't add any space around Emojis

Remove kr/pretty dependency

Fixes #2124
See https://github.com/kr/text/issues/6

docs: Document relativeURLs

Fixes #1342

Ignore Byword temp files

Fixes #2126

Add non-string support in markdownify

docs: Fix typo in overview/configuration.md

docs: Fix typo in templates/content.md

docs: Fix links in the documentation

A couple of internal links use `#toc_4` to attempt to locate a document
element within another document page. In both of these instances, there
is no element on the linked to pages with the id `#toc_4`. This commit
updates those links with the document elements which were the original
intended links, meaning these links now take you directly to the
intended element.

Signed-off-by: mattjmcnaughton <mattjmcnaughton@gmail.com>

docs: Add 2626.info to the showcase

tpl: Add intersect operator to where function

Returns true if a given field value that is a slice / array of strings, integers or floats contains elements in common with the matching value. It follows the same rules as the intersect function.

Closes #1945

docs: Add appernetic blog to showcase

commands: Sett mime type for CSS in Hugo server

Fixes #2104

helpers: Use net/url for URL parsing in AbsURL

Fixes #2112

Export "detectFrontMatter" to fix caddy-hugo

Closes #2108

docs: Add aydos.com to the showcase

Update release-notes.md

docs: More on release notes

docs: Order by Lastmod in release notes

docs: Order by Lastmod

Add ByLastmod page sort

docs: Add notion of exiting the themes folder in quickstart

docs: Grammar fixes in overview/quickstart.md

docs: Update showcase screenshot of yulinling.net

docs: Add some more fixes to release notes

docs: Move image-width fix to style.css

docs: Move Algolia styling into style.css

Make alias redirect output URL's relative

Closes #2093

docs: Fix findRE typo

docs: Fix some typos in release notes

doc: Get feature list of 0.16 release notes up to date

:books: Add ENV support to release notes

Update import path of fsnotify

Rename "gopkg.in/fsnotify.v1" to "github.com/fsnotify/fsnotify"
per upstream recommendation.

See https://github.com/fsnotify/fsnotify/issues/108 for rationale.

docs: Add some doc about ENV config

See #2090

commands: Support config from ENV

So

```bash
env HUGO_TITLE="Some Title" hugo server
```

Will change the `title`.

Fixes #2090

docs: Fix typo in tutorials/how-to-contribute-to-hugo.md

Add some schemaless BaseURL tests

See #2085

docs: Fix grammar in templates/partials.md

Noticed this sentence seemingly missing a word or two.

docs: Add tutorialonfly.com to the showcase

docs: Fix lastmod date for chipsncookies in showcase

docs: Add barricade.io to the showcase

docs: sa.muel.be has moved to chipsncookies.com in showcase

Improve build labels in README

tpl: Do not write to cache when ignoring cache

Fixes #2067
Closes #2069

Chomp Unicode BOM if present

Useful if using or sharing files with users that use editors that
append a unicode byte order marker header (like Windows notepad).

This will still assume files are UTF-8 encoded.

Closes #2075