hugolib: apply some Hugolint rules

author: fix doc

helpers: apply some Golint rules

Apply some more Golint suggestions

Fix some Go Lint errors

Fix errors reported by Go Vet

Prevent 404.html from prettifying into 404/index.html

Restore @realchaseadams's commit 348e123
"Force `UglyUrls` option to force `404.html` file name"
which got lost after some refactoring (commit 8db3c0b).

Remove the equivalent "force `UglyUrls`" code for `sitemap.xml`
because the refactored code now calls `renderAndWriteXML()`
which uses `WriteDestFile()` which does not prettify a filename.

Fixes #939

Avoid panic when pagination on 0 pages

Fixes #948

Apply gofmt -s

Add benchmark for the shortcode lexer

Update github-pages-blog.md

change `hugo serve` to `hugo server`

Tidying the Readme a bit more

Using a smaller Header Image

Fixing image in readme

Restructure top of Readme.md

Merge pull request #944 from gitter-badger/gitter-badge

Add a Gitter chat badge to README.md

Added Gitter badge

Update Readme.md with additional contribution guides

Allow the same shortcode to  be used with or without inline content

Fixes #934

Improve error message on missing shortcode inner content

Fixes #933

Keep trailing slash when baseUrl contains a sub path

Before this commit, .Site.BaseUrl ended up as:

http://mysite.com/ => http://mysite.com/
http://mysite.com/sub/ => http://mysite.com/sub

Now it becomes:

http://mysite.com/ => http://mysite.com/
http://mysite.com/sub/ => http://mysite.com/sub/

Fixed #931

Allow hyphens in shortcode name

Fixes #929

Use osext on GitHub

Fixes #922

[Docs] NetBSD and ARM pre-built binaries are already provided

See https://github.com/spf13/hugo/releases

What a pleasant surprise indeed!
How come I have never noticed them before?

And even `.deb` files are provided!  How amazing!

Bumping to version "v0.14-DEV"

Updating the final release notes for v0.13

[Docs] Clarify the switch to `canonifyurls = false` as default

Quote from @spf13: "I also think it's the better default
and should continue to be the case going forward."

Also mention the use of `hugo config` to check the current value
of `canonifyurls`, thanks to suggestion by @bep.

Fixes #802

Update README.md and overview/installing.md

- Clarify that Hugo may be built wherever Go is available;
- Add links to Git, Mercurial and Go;
- Unlist Bazaar: No libraries that Hugo depends on use it any more;
- Suggest the user to simply run `make` to build `hugo`
  to get `hugo version` to display the commit hash.

Avoid race condition in target list init

As reported by Go's race detector.

See #917

Avoid race condition in isInnerShortcode

As reported by Go's race detector.

See #917

Add trailing file separator to temp dir

Make sure that the file separator is added to the temp dir in all cases.

This prevents cache temp files being written to the root temp folder.

Fixes #910

Use $.Paginator in template

Since there will only be one paginator per page, this can get rid of some scoping confusion.

Return unmodified content if panic in LiveReloadInject

Add revocer in LiveReloadInject

The panic cannot be reproduced, but add this as protection.

Fixes #911

Suppress errors for symbolic links witch point to a file.

add note that running with watch doesn't produce a site suitable for deployment

Add information to highlighting with Payments

Conflicts:
docs/content/extras/highlighting.md

Adapt to relative path bug fix in purell

Temporary workaround for the bug fix and resulting
behavioral change in purell.NormalizeURLString():
a leading '/' was inadvertently to relative links,
but no longer, see #878.

I think the real solution is to allow Hugo to
make relative URL with relative path,
e.g. "../../post/hello-again/", as wished by users
in issues #157, #622, etc., without forcing
relative URLs to begin with '/'.
Once the fixes are in, let's remove this kludge
and restore SanitizeUrl() to the way it was.

Fixes #878

Moved futured getSQL topic to another branch

getJson and getCsv documentation proof reading by @msjulias

Update Dynamic Content docs

Update doc

Add getSQL idea

Initial doc file: Dynamic Content

Fix bug where running hugo without options causes to create
$TMPDIR/hugo_cache/ directory.

GetJson and GetCsv have now variadic URL parts so that you can submit pre or post parts of an URL. The parts will be joined to the final URL.

Add --ignoreCache CLI flag with description "Ignores the
cache directory for reading but still writes to it" as @spf13
suggested.

Adding getJson and getCsv to funcMap

Fix bug on windows where the backslash got removed in func MakePath()

Merge to stay up to date with current dev
Feature: GetJson and GetJson in short codes or other layout files.
For more details please see: http://cyrillschumacher.com/2014/12/21/dynamic-pages-with-gohugo.io/

Quote strings in `hugo config` output

Also, use ` = ` to separate keys and values
if metaformatdata is "toml".

Revert "Expansion of unit tests for utils/utils.go"

Rationale: Test failing on Windows with errors like this:

    utils_test.go:177: Error: Could not remove file "f".
    Error: remove C:\Users\appveyor\AppData\Local\Temp\utils_test_747965610:
    The process cannot access the file because it is being used by another
    process.

This reverts commit 6b28e38cea0dec3e3f045ab8ec833608b91a946f.

Sorry for my premature merge of Pull Request #818.

Fix canonifyurl vs schemaless links

And looks even faster:

Compared to previous attempt:

benchmark              old ns/op     new ns/op     delta
BenchmarkAbsUrl        30902         27206         -11.96%
BenchmarkXmlAbsUrl     15389         14216         -7.62%

benchmark              old allocs     new allocs     delta
BenchmarkAbsUrl        33             28             -15.15%
BenchmarkXmlAbsUrl     16             14             -12.50%

benchmark              old bytes     new bytes     delta
BenchmarkAbsUrl        4167          3504          -15.91%
BenchmarkXmlAbsUrl     2057          2048          -0.44%

Compared to before I started all of this:

benchmark              old ns/op     new ns/op     delta
BenchmarkAbsUrl        36219         27206         -24.88%
BenchmarkXmlAbsUrl     23903         14216         -40.53%

benchmark              old allocs     new allocs     delta
BenchmarkAbsUrl        60             28             -53.33%
BenchmarkXmlAbsUrl     30             14             -53.33%

benchmark              old bytes     new bytes     delta
BenchmarkAbsUrl        5842          3504          -40.02%
BenchmarkXmlAbsUrl     3754          2048          -45.44%

Fixes #816

Expansion of unit tests for utils/utils.go

This commit expands the test coverage for the utils/utils.go module.

The utils module uses the 'github.com/spf13/jwalterweatherman' (aka jww)
package for logging. The tests take the approach of examining the log
file that is produced by this module to verify correct behaviour. This
avoids refactoring the utils module.

The log file messages written by the jww module are of the form:
<log level>: yyyy/mm/dd <string|error message>

The checkLogFile function checks each of these parts in turn except for
the date string, which is currently ignored. The final part of the log
file format can either be a single error message, or a series of
strings followed by an error message. Both the error message and the
series of strings can be empty strings.

The log file is checked using a combination of the regex package,
along with the bufio scanner type. Each test logs to its own temporary
log file. This is achieved with standard test setup and teardown
functions.

One consequence of these tests is that StopOnErr has been refactored
into call a new unexported function doStopOnErr which contains the bulk
of the original logic. This allows the same testing approach to be used
with StopOnErr as with CheckErr and cutUsageMessage, rather than look at
the exit status code of the test itself.

An unfortunate side effect of this is that the author of the tests must
now know if a log file is expected or not. If doStopOnErr determines
that an empty error message would be written to the log file then
nothing is written. In the context of the tests this means that the log
file created by the test would have no contents. Consequently there
would be nothing for the test to examine. This situation is indicated by
the boolean flag logFileExoected in the testData struct, and processed
by the logFileIsExpectedAndValid function.

Although not ideal this was deemed a reasonable compromise.

[Docs] Minor copyediting of highlighting.md

Also add `apt-get` command for installing Pygments.

Add information to highlighting with Pygments

List of variables

Some variables are currently not documented and others are explained
across the document. So, I tried to pull an overview from the source.
Pls double check. I am not 100% sure, what the purpose of some variables
is or whether they are only relevant for previous versions. Thanks

Fixed a typo

Make "Indexes" the alias and "Taxonomies" the canonical name

... rather than the other way around.
Discovered thanks to the new `hugo config` command.

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

README.me: Add linefeed that got lost in the last commit

[Docs] Add pointers to roadmap; new tweet and article

Improve abs url replacement speed

This commit replaces the multuple `bytes.Containts` and `bytes.Replace` with a custom replacer that does one pass through the document and exploits the fact that there are two common prefixes we search for, `src=` and `href=`.

This is both faster and consumes less memory. There may be even better algos to use here, but we must leave some room for improvements for future versions.

This should also make it possible to solve #816.

```
benchmark              old ns/op     new ns/op     delta
BenchmarkAbsUrl        25795         22597         -12.40%
BenchmarkXmlAbsUrl     17187         11166         -35.03%

benchmark              old allocs     new allocs     delta
BenchmarkAbsUrl        60             33             -45.00%
BenchmarkXmlAbsUrl     30             16             -46.67%

benchmark              old bytes     new bytes     delta
BenchmarkAbsUrl        5844          4167          -28.70%
BenchmarkXmlAbsUrl     3754          2069          -44.89%
```

Fixes #894

Add benchmark for AbsUrlInXml

And a general test cleanup in /transform.

See #894

Another link in the same page

Fixed invalid link to partials

Update docs so that `figure` includes the `class` parameter.

Add 'config' command to list site configuration

Fixes #871

Put back static theme conditional

[commands/new.go] Update theme.toml etc.

- Add copyright years and author to the top of the file

- Write the current year from time.Now() to LICENSE.md

- Correct comment regarding `os.MkdirAll(p, 0777)`

- In createConfig(), split the `map[string]string` definition into
  multiple lines to facilitate future expansion.  Also add a trailing
  slash to sample "baseurl" definition.

- Update theme.toml template to match that listed at
  https://github.com/spf13/hugoThemes/blob/master/README.md#themetoml

  See #883 for an equivalent `struct` implementation

Remove nohup.out committed by accident

Doc Data Files: Add section about themes and expanded the example a bit

Remove now superfluous conditional

Fix broken data dir test

Temporarily disable broken test

Add data files support in themes

If duplicate keys, the main data dir wins.

Fixes #892

Change "ctrl+c" to "Ctrl+C"

Fix typo: GetJson -> GetCsv

Add showcase entry for consequently.org

Consequently.org is a personal site for an academic, with a blog, list
of publications, classes and talks, all managed by hugo.

Make # survice Url cleaning

To enable anchors in Urls.

Fixes #888

Update release notes for v0.13

Avoid converting summary to []byte and back to string

Fix alias for data files doc

Add docs for Data Files

Fixes #887

Better error message for data-file parsing errors

DataDir: Minor polish and add missing tests

Also, now logs an ERROR on duplicate keys, instead of returning an error and make sure sub-folders take presedence in data dir.

Reads data files inside data/ and makes data available in .Site.Data

Fixes #476.

Conflicts:
hugolib/site.go

[Docs] Say which directory to clone the hugoThemes

On http://gohugo.io/overview/quickstart/, explicitly state
that hugoThemes is to be cloned from within the working directory,
like it is stated on http://gohugo.io/themes/installing/.

Fixes #886

parser.FormatSanitize() MetaDataFormat for date too

So that the date would come out correctly with
variations like `MetaDataFormat = "YAML"` in addition to
the normally expected `MetaDataFormat = "yaml"`.

Fixes #865.

Use buffer pool in StripHTML

Allocates less memory:

benchmark              old ns/op     new ns/op     delta
BenchmarkStripHTML     6572          6695          +1.87%

benchmark              old allocs     new allocs     delta
BenchmarkStripHTML     5              4              -20.00%

benchmark              old bytes     new bytes     delta
BenchmarkStripHTML     848           737           -13.09%

Compared to 0.12:

benchmark              old ns/op     new ns/op     delta
BenchmarkStripHTML     10210         6695          -34.43%

benchmark              old allocs     new allocs     delta
BenchmarkStripHTML     6              4              -33.33%

benchmark              old bytes     new bytes     delta
BenchmarkStripHTML     1456          737           -49.38%

Log ERROR on missing baseurl

Fixes #877

Add benchmark test for StripHTML

go test -test.run=NONE -bench=".*" -test.benchmem=true ./helpers

Old vs new impl (string.Replace vs string.Replacer):

benchmark              old ns/op     new ns/op     delta
BenchmarkStripHTML     10210         6572          -35.63%

benchmark              old allocs     new allocs     delta
BenchmarkStripHTML     6              5              -16.67%

benchmark              old bytes     new bytes     delta
BenchmarkStripHTML     1456          848           -41.76%

Fix Truncate

TruncateWordsToWholeSentence knows if the summary is truncated, so let "him" decide.

Fixes #880

Replace 4 strings.Replace with 1 strings.Replacer

Consumes less memory, slightly faster.

Add memprofile to pprof benchmark

Avoid calling strings.Fields multiple times with same content

This should be a relief for big sites.

Build PageMenus only once

Tighten README for the sloppy reader

Tighten README for the sloppy reader

Tighten README for the sloppy reader

Fixing heads

tigheten markdown

tighten markdown

tighten markdown

tinker with headings

tinker with wording

fixing period spacing

moving the any dir stuff into the feature section

tweak overview

tweak overview

fixed option too

fix break:

Avoid panic on unknown markup

Fixes #863

Scratch doc: Use the special $ variable to prevent confusion