docs: Improve Traversing Local Files

Make paginate settings configurable per language

Fixes #2449

Do not add lang prefix in URL when set in frontmatter

Fixes #2450

Lazy calculate  WordCount, ReadingTime and FuzzyWordCount

This avoids having to execute these expensive operations for sites not using these values.

This commit sums up a set of wordcounting and autosummary related performance improvements.

The effect of these kind of depends on what features your site use, but a benchmark from 4 Hugo sites in the wild shows promise:

```
benchmark           old ns/op       new ns/op       delta
BenchmarkHugo-4     21293005843     20032857342     -5.92%

benchmark           old allocs     new allocs     delta
BenchmarkHugo-4     65290922       65186032       -0.16%

benchmark           old bytes      new bytes      delta
BenchmarkHugo-4     9771213416     9681866464     -0.91%
```

Closes #2378

Improve TotalWords counter func

It is obviously more efficient when we do not care about the actual words.

```
BenchmarkTotalWords-4            100000         18795 ns/op           0 B/op           0 allocs/op
BenchmarkTotalWordsOld-4          30000         46751 ns/op        6400 B/op           1 allocs/op
```

Avoid splitting words for summary

For people using autogenerated summaries, this is one of the hot spots in the memory department.

We don't need to split al the content into words to do proper summary truncation.

This is obviously more effective:

```
BenchmarkTestTruncateWordsToWholeSentence-4            300000          4720 ns/op           0 B/op           0 allocs/op
BenchmarkTestTruncateWordsToWholeSentenceOld-4         100000         17699 ns/op        3072 B/op           3 allocs/op
```

helpers: Improve the language prefix logic

See #2444

helpers: Avoid adding language prefix if already present

Fixes #2444

commands: Improve error messages in convert

See #2440

tpl: Make the *langURL funcs tace interface{}

Fixes #2447

commands: Report errors in convert

Fixes #2440

Fix broken convert command

Fixes #2437

Add Language.LanguageName

Fixes #2435

Support site menu per language

Fixes #2434

commands: Fix typos

tpl: Extend where to iterate over maps

Fixes #2028

tpl: Fix typos in tests

Closes #2370

hugolib: Fix typos in tests

Replace some leftover os.Stat with hugofs.Source

Fix reload dir matching in theme

Fixes #2430

Handle symlink change event

Hugo 0.16 announced support for symbolic links for the root folders, /content, /static etc., but this got broken pretty fast.

The main problem this commit tries to solve is the matching of file change events to "what changed".

An example:

ContentDir: /mysites/site/content where /mysites/site/content is a symlink to /mycontent

/mycontent:

/mypost1.md
/post/mypost2.md

* A change to mypost1.md (on OS X) will trigger a file change event with name "/mycontent/mypost1.md"
* A change to mypost2.md gives event with name "/mysites/site/content/mypost2.md"

The first change will not trigger a correct update of Hugo before this commit. This commit fixes this by doing a two-step check:

1. Check if "/mysites/site/content/mypost2.md" is within /mysites/site/content
2. Check if  "/mysites/site/content/mypost2.md" is within the real path that /mysites/site/content points to

Fixes #2265
Closes #2273

docs: Remove JPEG as format for showcase thumbnails

docs: Add davidyat.es to the showcase

parser: Use strings.Contains instead of strings.Index

Closes #2400

parser: Simplify err conditions

commands: Delete useless conversion

commands: Simplify err condition

commands: Delete unused newUserErrorF

Fixe target path location check in jekyll import command

Prevent panic on empty authorlist

Remove redundant field in sort helper struct

The pair struct used by sortSeq() had two key fields, where only one
is really needed.

tpl: Make it more clear on  missing language string

Redirect to root when DefaultContentLanguageInSubdir = false

Fixes #2422

Fix paginator counter on x86-32

Atomic operations with 64 bit values must be aligned for 64-bit on x86-32.

According to the spec:

"The first word in a global variable or in an allocated struct or slice can be relied upon to be 64-bit aligned."

The above wasn't enough for the `paginationPageCount` on `SiteInfo`, maybe due to how `SiteInfo` is embedded.

This commit adds a 4 byte padding before the `uint64` that creates the correct alignment.

Fixes #2415

Add TODO list support for Blackfriday

* Add CSS class to TODO list and list items
* Add a flag to turn task list support off

Fixes #2269

Fix shortcode vs pygments

This is the nth attempt to fix an issue by changing the placeholder token pattern, but
now we actually have tests for all the historic trouble cases.

Fixes #2223

Fix pagination page counter on 32 bit

Updates #2415

Reset the i18n func map on reload

Also improve the error message on missing resource bundles.

docs: Fix typos in multilingual section

Add missing read lock in getNodes

Bump Travis to Go 1.7.1

tpl: Fix echoParam

Fixes #2406

Make it the DEV version

Fix go vet 1.7 issues

Updates #2309

Add a global Reset func

So we can do some benchmarking.

Make sure the 404 node has .Data.Pages

Updates #2309

Fix site reset for benchmarks etc.

Updates #2309

Fix multilingual reload when shortcode changes

This commit also refines the partial rebuild logic, to make sure we do not do more work than needed.

Updates #2309

Set lang template globals for each site when render shortcodes

We should get rid of these globals, but that is another month.

Small adjustment to SiteInfo init

After a visual inspection to make (pretty) sure it is correct re multiple languages.

Updates #2309

docs: Fix spelling: HasTranslations > IsTranslated

Create a copy of the section node for RSS

So the Permalink gets correct when listing translations.

I have also checked the other relevant places to make sure we do not overwrite node values we need later.

Pointers can be tricky, but lesson learned is: A copy is cheap.

Updates #2309

Fix Data in multisites

Updates #2309

docs: Get the variable and funcs re multilingual up-to-date

Add JSON config to the multilanguage testing

Updates #2309

Fix YAML loading of multilingual config

And some other minor fixes from code review.

Updates #2309

Add data tests

Updates #2309

Add temp MULTILINGUAL version suffix to this branch

For people having trouble building this.

Now `hugo version` should print something like:

```
Hugo Static Site Generator v0.17-MULTILINGUAL BuildDate: 2016-08-10T08:20:36+02:00
```

Create a Node map to get proper node translations

In a multi-language setup, before this commit the Node's Translations() method
would return some "dummy nodes" that would point to the correct page (Permalink),
but would not be the same as the node it points to -- it would not have the translated
title etc.

The node creation is, however, so mingled with rendering, whihc is too early to have any global state,
so the nodes has to be split in a prepare and a render phase. This commits does that with as small
a change as possible. This implementation is a temp solution until we fix #2297.

Updates #2309

doc: Fix TOML vs YAML in multilang section

Updates ##2309

Handle error in config loading

See #2309

Add IsTranslated to Node and Page

Makes the templates simpler.

See #2309

Remove unused Multilingual Viper default

See #2312

Improve i18n string handling

* Fall back to default language on missing translation file
* Add a i18n-warnings build flag
* If that flag is set, print a parseable and greppable string on missing translation strings

See #2303

Render main content language in root by default

Fixes #2312

Add parent as owner to Site

And pull up common member vars like Tmpl and Multilinguage.

Or: the final multilingual TODO-fixes.

See #2309

Make the check command work in multilingual mode

Or: some more multilingual TODO-fixes.

See #2309

Make sure drafts etc. are not processed

See #2309

Multilingual TODO-fixes, take 1

See #2309

Fix some corner cases in revised summary handling

And clean up the test.

See #2309

Fix livereload in multilingual mode

See #2309

Fix the shortcode ref tests

See #2309

Improve language handling in URLs

The current "rendering language" is needed outside of Site. This commit moves the Language type to the helpers package, and then used to get correct correct language configuration in the markdownify template func.
This commit also adds two new template funcs: relLangURL and absLangURL.

See #2309

Make it possible to configure Blackfroday per language

See #2309

Make it possible to add a language in server mode

See #2309

cmd: Load config from the common config loader in hugolib

See #2309

Get the list commands up to multi-site level

This commit also unexports some Site methods, making it clear what the external build API really is.

See #2312

Make taxonomies configurable per language

See #2312

Make the config loading testable

This is needed to verify  #2309, but it closes a big hole in Hugo's automated tests.

The loading of the config is now moved to `hugolib` and the same default settings are now used
in production and tests.

As Viper now uses Afero as its filesystem, we now can write fairly complete integration tests with ease.

See #2309

Add sitemap index for multilingual sites

See #2309

Redirect to main language from root

See #2312
See #2309

Rework the multilingual docs

And in the same go adjusted some minor parts of the language API:

Add LanguagePrefix alias to Node and rename the Multilingual config section to Languages.

See #2309

Render the shortcodes as late as possible

This is needed to make shortcode users happy with the new multilanguage support,
but it will also solve many other related posts about "stuff not available in the shortcode".

We will have to revisit this re the handler chain at some point, but that will be easier
now as the integration test story has improved so much.

As part of this commit, the site-building tests in page_test.go is refreshed, they now
tests for all the rendering engines (when available), and all of them now uses the
same code-path as used in production.

Fixes #1229
Fixes #2323
Fixes ##1076

Optimize the multilanguage build process

Work In Progress!

This commit makes a rework of the build and rebuild process to better suit a multi-site setup.

This also includes a complete overhaul of the site tests. Previous these were a messy mix that
were testing just small parts of the build chain, some of it testing code-paths not even used in
"real life". Now all tests that depends on a built site follows the same and real production code path.

See #2309
Closes #2211
Closes #477
Closes #1744

Move the Build* methods to HugoSites

See #2309

Move HugoSites to hugolib

It will get more involved in the build process in a minute.

See #2309

Add Translations and AllTranslations to Node

This commit also consolidates URLs on Node vs Page, so now .Permalink should be interoperable.

Note that this implementations should be fairly short-livded, waiting for #2297, but the API should be stable.

Rework the i18n template func handling

Setting the language to use when loading the language bundles just doesn't work.
The template system is unfortanetely a global, and the last languate processed won ...

Introduce HugoSites type

And a Hugo global variable which contains the site under build.

This is really needed to get some level of control of the "multiple languages" in play.

There are still work related to this scattered around, but that will come.

With this commit, the multilingual feature is starting to work.

Reset translation slice on rebuild

Also add all translations, including the current, to the slice. We filter later.

Rename MainSites to Sites

Having many *main* sites doesn't make much sense.

Add Translations and AllTranslations methods to Page

Will revisit Node later.

Add proper Language and Languages types

Add multilingual support in Hugo

Implements:
* support to render:
  * content/post/whatever.en.md to /en/2015/12/22/whatever/index.html
  * content/post/whatever.fr.md to /fr/2015/12/22/whatever/index.html
* gets enabled when `Multilingual:` is specified in config.
* support having language switchers in templates, that know
  where the translated page is (with .Page.Translations)
  (when you're on /en/about/, you can have a "Francais" link pointing to
   /fr/a-propos/)
  * all translations are in the `.Page.Translations` map, including the current one.
* easily tweak themes to support Multilingual mode
* renders in a single swift, no need for two config files.

Adds a couple of variables useful for multilingual sites

Adds documentation (content/multilingual.md)

Added language prefixing for all URL generation/permalinking see in the
code base.

Implements i18n. Leverages the great github.com/nicksnyder/go-i18n lib.. thanks Nick.
* Adds "i18n" and "T" template functions..

docs: Fix typo in Quickstart guide

To publish a post, draft status should be changed to `false`.

docs: Add open.cinegy.com to the showcase

docs: Add Vim/Emacs plugin to tools section

docs: Clarify first level URL generation

docs: Improve Quickstart guide

Fixes #2331.

docs: Clarify Creating a New Theme