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

Ensure that BaseUrl used in `hugo server` ends with `/`

Fixes #793, #799

Fix issue with nested shortcodes

Fixes #797

Replace `if` with `with` in embedded rss.xml

... resulting in a slightly more compact template.

Add ".swx" suffix to file watcher's ignore list

When a user uses Vim to open a file, it briefly creates a
".filename.md.swx" file which needlessly triggers a website rebuild.

According to a comment in Vim's src/memline.c:

    /*
     * on MS-DOS compatible filesystems (e.g. messydos) file.doc.swp
     * and file.doc are the same file. To guess if this problem is
     * present try if file.doc.swx exists. If it does, we set
     * buf->b_shortname and try file_doc.swp (dots replaced by
     * underscores for this file), and try again. If it doesn't we
     * assume that "file.doc.swp" already exists.
     */

Disable shortcode processing for html files

May be enabled later, but then it will have to do the complete "shortcode dance".

See ##674

First take on release notes for 0.13

Add an alias to the old URL of github-pages-blog.md

Rename github_pages_blog.md to github-pages-blog.md

[Docs] More random revision and copyediting

General revisions to (hopefully) make the documentation
easier to understand and more comprehensive.

Revise "Strange EOF error" troubleshooting page to say that
a fix is in place for the upcoming Hugo v0.13.

Also add more external links, and cute icons from Font Awesome.

Fixed error in tutorial, added site variable docs

While following the github pages tutorial I found some issues. These are
the commands I ran that worked.

Added site variables to the docs from the code.

Tutorial: Automated deployments

Also fixed the next/prev for the tutorials

Trivial fixes to get RSS 2.0 feeds to validate.

RSS 2.0 requires the email be listed in `<author>`,
and `UTC` as a timezone is not accepted, but `UT` or `GMT` are.

See #789 for more information.  Thanks to @snej for the report!

[Docs] Remove references to "ATOM" feeds

Thanks to @snej for reporting!

Fixes #790

Correct typo in hugolib/path_separators_windows_test.go

Correct spelling of two test files: seperators → separators

Fix "hugo new" EOF error with an archetype file without the final EOL

This rewrites `extractFrontMatterDelims` function to make it work with
an archetype file without the final EOL and adds more detailed error
messages and comments.

It also removes `matches` and `matches_quick` functions which aren't
called anywhere.

note in archetype.md to alert that ending carriage return may be nessary to avoid EOF errors.

Some more random copyediting of Hugo docs

 - Change "livereload" and "live reload" to "LiveReload";
 - Add a `$ ` prompt before example command lines
   (not exhaustive, work in progress);
 - Remove unnecessary whitespace from partials;
 - Revise the blackfriday options table in overview/configuration.md
   to make it narrower.
 - Manually set the language for highlight.js where appropriate
 - Rename "404" to "Custom 404 page", and remove incorrect reference
   to "homepage"
 - Credit the author of tutorials/github_pages_blog.md
   (Similar notes are necessary for other contributed pages where
    "I" am not spf13 to avoid reader confusion.)
 - Add CSS for `kbd` and `table` etc. to css/style.css;
 - etc.

Moved a test regarding a content.go function to a new test file content_test.go.
Added some tests for general helpers, especially as a way to document the expected behavior,
and as a warm-up welcome contribution.

Do not exit server watch on error

Before this commit any error (typically a YAML typing error in front matter) would exit server on rebuild when running `hugo server -w`.

This is very annoying as it doesn't give you any chance to fix the typo other than doing a manual restart.

This commit fixes that by just logging these errors when these rebuilds happen when changes are detected.

Fixes #781

[Docs] New Troubleshooting section

With two entries of frequently encountered or obscured troubles so far:

- "Categories with accented characters" Unicode NFC/NFD mismatch
   on Mac OS X (See #739)
- `hugo new` aborts with cryptic EOF error (See #776)

Google Custom Search: Open link in _parent

Add basic Google Custom Search to Hugo docs

Fixes #753

Fix `echoParam` template function to accept string key name

This changes `echoParam` template function behavior to accept not only
an array or a slice and its index pair but also a map and its key pair.

This also changes the function that float and uint values are treated as
a valid result type of it.

Fix #771

Rename to plainIdAnchors

Add Blackfriday: documentIDAnchor documentation

Group both options under Blackfriday: documentIDAnchor

Add config options: disable footnote anchor prefix and header ID suffix
New config options:

* DisableFootnoteAnchorPrefix - bool - default: false
* DisableHeaderIDSuffix - bool - default: false

Add config file example to variables.md

Add a config file example for setting .Site.Params to variables.md. This addresses my confusion in [issue #766](https://github.com/spf13/hugo/issues/766).

Update configuration.md

Update configuration.md to show setting variables for .Site.Params in TOML config file

Add example code to Summaries

I was initially confused about how to use summaries. The only example code I found in the docs was on the page for list nodes, but that uses `Render "summary"`, which is for views, not an article summary. I thought a little example here might clarify the issue for future users.

use fsnotify 0.9.3

This contains a few fixes (v0.9.1 through v0.9.3) but the same API and few internal changes.

https://github.com/go-fsnotify/fsnotify/blob/master/CHANGELOG.md#v093--2014-12-31

A good first step before switching to v1.

Add in-section Next/Prev content pointers

Conflicts:
docs/content/meta/release-notes.md
docs/content/templates/variables.md

Add ERROR logging on invalid date and publishdate

Having correct dates is important in Hugo. Previously date parsing errors were swallowed, leading to confusing results.

This commit adds ERROR logging when date or publishdate in front matter cannot be parsed into a time.Time.

Add operator argument to `where` template function

It allows to use `where` template function like SQL `where` clause.
For example,

    {{ range where .Data.Pages "Type" "!=" "post" }}
        {{ .Content }}
    {{ end }}

Now these operators are implemented:

    =, ==, eq, !=, <>, ne, >=, ge, >, gt, <=, le, <, lt, in, not in

It also fixes `TestWhere` more readable

Implement `apply`.

- apply seq fn args…

Add a chomp function.

- Mostly useful in pipelines.

Initialize funcMap in an init function.

Hygiene: Reduce copy-pasted code.

always use http scheme for localhost

fixes #758

Merge pull request #762 from bjornerik/fix/revert-revert-menutest

Revert "Temporarily disable failing menu test"

Revert "Temporarily disable failing menu test"

This reverts commit e4a22255ccb818f8b55a20f56ddcfda869db250f.

Bumping Travis to test go 1.3 & 1.4

Fix EOF

Add www.thehome.dk to showcase

Refactor tpl codes

- Use indirect function instead of the same code copies
- Fix missing arguments of some test codes

Make 'where' template function accepts dot chaining key argument

'where' template function used to accept only each element's struct
field name, method name and map key name as its second argument. This
extends it to accept dot chaining key like 'Params.foo.bar' as the
argument. It evaluates sub elements of each array elements and checks it
matches the third argument value.

Typical use case would be for filtering Pages by user defined front
matter value. For example, to filter pages which have 'Params.foo.bar'
and its value is 'baz', it is used like

    {{ range where .Data.Pages "Params.foo.bar" "baz" }}
        {{ .Content }}
    {{ end }}

It ignores all leading and trailing dots so it can also be used with
".Params.foo.bar"

[Docs] Mention support for the Ace HTML Template Engine

Docs copyediting: Add more external URLs; add backticks, etc.

[Docs] Go 1.4+ required for building on Windows

See Issue #688 for more information.

Add anchor ref to Blackfriday doc

Fix a crash for ref page#anchor.

- Remove an improperly shadowed variable.
- Fixes #741.

Merge pull request #742 from bjornerik/doc/blackfriday

Add doc for Blackfriday configuration

Add ability to canonify URLs in rendered XML output.

Wrap comments helpers package to fit 80-column width

Add an initial space after `//` where appropriate.
Minor copyediting.

Add doc for Blackfriday configuration

See #686

Add configurable support for angled quotes

The flag `HTML_SMARTYPANTS_ANGLED_QUOTES` was added to Blackfriday on Black Friday. This configures rendering of double quotes as angled left and right quotes (&laquo;
&raquo;).

Typical use cases would be either or, or combined, but never in the same
document. As an example would be a person from Norway; he has a blog in both
English and Norwegian (his native tongue); he would then configure Blackfriday
to use angled quotes for the Norwegian section, but keep them as reqular
double quotes for the English.

This commit adds configuration support for this new flag, configuration that can be set in the site configuration, but overridden in page front matter.

Fixes #605

Fix unicode menu URLs

Menu urls like /categories/новости-проекта would turn into /categories/d0bdd0bed0b2d0bed181d182d0b8-d0bfd180d0bed0b5d0bad182d0b0, which is illegal, while the directory under the categories/ is created with the original name. It results in 404 not found error.

This commit fixes that by make sure that SanitizeUrl() is called last.

Fixes #719

Temporarily disable failing menu test

Revise README.md: buildDate expects timezone; copyediting

Since commit 3a8c12418a97230df714488e522f44ce8af685c5 dated 2014-12-09,
commands.buildDate expects `date +%FT%T%z` rather than `date +%FT%T`.
Update README.md accordingly.

Also did a little copyediting.

Typo fix: "simple" → "simply" in templates/views.md

Thanks to @paulsullivan for catching that typo!

Minor copyediting, no new content added.

Fix long descriptions of `benchmark` and `serve` commands

Remove noisy Println in test

Added delimit & sort template functions, tests and docs

Added AuthorList, Author, AuthorSocial, SiteSocial, Image and Video structs
Added Page.Author(s) functions
Added schema, opengraph, twitter_cards, google_news metadata templates
Added "" template

Documentation for `ref` and `relref`.

- Rejigged the weight of the extras/ content for the new crossreferences
  page.
- Used the new {{</*…*/>}} format for documenting highlighting and to
  prevent a warning about the missing `fig` shortcode.

Provide (relative) reference funcs & shortcodes.

-   `.Ref` and `.RelRef` take a reference (the logical filename for a
    page, including extension and/or a document fragment ID) and return
    a permalink (or relative permalink) to the referenced document.

    -   If the reference is a page name (such as `about.md`), the page
        will be discovered and the permalink will be returned: `/about/`
    -   If the reference is a page name with a fragment (such as
        `about.md#who`), the page will be discovered and used to add the
        `page.UniqueID()` to the resulting fragment and permalink:
        `/about/#who:deadbeef`.
    -   If the reference is a fragment and `.*Ref` has been called from
        a `Node` or `SiteInfo`, it will be returned as is: `#who`.
    -   If the reference is a fragment and `.*Ref` has been called from
        a `Page`, it will be returned with the page’s unique ID:
        `#who:deadbeef`.

-   `.*Ref` can be called from either `Node`, `SiteInfo` (e.g.,
    `Node.Site`), `Page` objects, or `ShortcodeWithPage` objects in
    templates.

-   `.*Ref` cannot be used in content, so two shortcodes have been
    created to provide the functionality to content: `ref` and `relref`.
    These are intended to be used within markup, like `[Who]({{% ref
    about.md#who %}})` or `<a href="{{% ref about.md#who %}}">Who</a>`.

-   There are also `ref` and `relref` template functions (used to create
    the shortcodes) that expect a `Page` or `Node` object and the
    reference string (e.g., `{{ relref . "about.md" }}` or `{{
    "about.md" | ref . }}`). It actually looks for `.*Ref` as defined on
    `Node` or `Page` objects.

-   Shortcode handling had to use a *differently unique* wrapper in
    `createShortcodePlaceholder` because of the way that the `ref` and
    `relref` are intended to be used in content.

Commented helpers package

Use current working dir as WorkingDir instead of hugo executable's dir