Merge commit 'ba45da9d03056447e4873de13d4e0f8d658a769b' - hugo - [fork] hugo port for 9front
 (HTM) git clone git@git.drkhsh.at/hugo.git
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) Submodules
 (DIR) README
 (DIR) LICENSE
       ---
 (DIR) commit c0370e0ee3f12efe5f82b219f56b5c71f04f2329
 (DIR) parent 5c3b2103688475b2cb824f372d2131e39581a3ab
 (HTM) Author: Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>
       Date:   Thu, 21 Sep 2017 19:05:40 +0200
       
       Merge commit 'ba45da9d03056447e4873de13d4e0f8d658a769b'
       
       Diffstat:
         M docs/archetypes/default.md          |       2 +-
         M docs/config.toml                    |      16 +++++++++++++++-
         M docs/content/about/_index.md        |       2 +-
         M docs/content/about/benefits.md      |       2 +-
         M docs/content/about/license.md       |       2 +-
         M docs/content/about/roadmap.md       |       4 ++--
         M docs/content/commands/_index.md     |       2 +-
         M docs/content/content-management/_i… |       2 +-
         M docs/content/content-management/ar… |       6 +++---
         M docs/content/content-management/au… |       2 +-
         M docs/content/content-management/co… |       2 +-
         M docs/content/content-management/cr… |       2 +-
         M docs/content/content-management/fo… |       2 +-
         M docs/content/content-management/fr… |       4 +++-
         M docs/content/content-management/me… |       2 +-
         M docs/content/content-management/mu… |       2 +-
         M docs/content/content-management/or… |       4 +++-
         M docs/content/content-management/re… |       6 +++++-
         M docs/content/content-management/se… |       2 +-
         M docs/content/content-management/sh… |       4 +++-
         M docs/content/content-management/su… |       2 +-
         M docs/content/content-management/ta… |       4 ++--
         M docs/content/content-management/to… |       2 +-
         M docs/content/content-management/ty… |       2 +-
         M docs/content/content-management/ur… |       2 +-
         M docs/content/contribute/_index.md   |       2 +-
         M docs/content/contribute/developmen… |       2 +-
         M docs/content/contribute/documentat… |       2 +-
         M docs/content/contribute/themes.md   |       2 +-
         M docs/content/functions/GetPage.md   |       2 +-
         M docs/content/functions/NumFmt.md    |       2 +-
         M docs/content/functions/_index.md    |       2 +-
         M docs/content/functions/abslangurl.… |       2 +-
         M docs/content/functions/absurl.md    |       2 +-
         M docs/content/functions/adddate.md   |       2 +-
         M docs/content/functions/after.md     |       2 +-
         M docs/content/functions/apply.md     |       2 +-
         M docs/content/functions/base64.md    |       2 +-
         M docs/content/functions/chomp.md     |       2 +-
         M docs/content/functions/countrunes.… |       2 +-
         M docs/content/functions/countwords.… |       2 +-
         M docs/content/functions/dateformat.… |       2 +-
         M docs/content/functions/default.md   |       2 +-
         M docs/content/functions/delimit.md   |       4 ++--
         M docs/content/functions/dict.md      |       2 +-
         M docs/content/functions/echoparam.md |       2 +-
         M docs/content/functions/emojify.md   |       2 +-
         M docs/content/functions/eq.md        |       2 +-
         M docs/content/functions/findRe.md    |       2 +-
         M docs/content/functions/first.md     |       2 +-
         M docs/content/functions/format.md    |       2 +-
         M docs/content/functions/ge.md        |       2 +-
         M docs/content/functions/get.md       |       2 +-
         M docs/content/functions/getenv.md    |       2 +-
         M docs/content/functions/gt.md        |       2 +-
         M docs/content/functions/hasPrefix.md |       2 +-
         M docs/content/functions/haschildren… |       2 +-
         M docs/content/functions/hasmenucurr… |       2 +-
         M docs/content/functions/highlight.md |       2 +-
         M docs/content/functions/htmlEscape.… |       2 +-
         M docs/content/functions/htmlUnescap… |       2 +-
         M docs/content/functions/humanize.md  |       2 +-
         M docs/content/functions/i18n.md      |       2 +-
         M docs/content/functions/imageConfig… |       2 +-
         M docs/content/functions/in.md        |       2 +-
         M docs/content/functions/index-funct… |       4 ++--
         M docs/content/functions/int.md       |       2 +-
         M docs/content/functions/intersect.md |       2 +-
         M docs/content/functions/ismenucurre… |       2 +-
         M docs/content/functions/isset.md     |       2 +-
         M docs/content/functions/jsonify.md   |       2 +-
         M docs/content/functions/last.md      |       2 +-
         M docs/content/functions/le.md        |       2 +-
         M docs/content/functions/len.md       |       2 +-
         M docs/content/functions/lower.md     |       2 +-
         M docs/content/functions/lt.md        |       2 +-
         M docs/content/functions/markdownify… |       2 +-
         M docs/content/functions/math.md      |       2 +-
         M docs/content/functions/md5.md       |       2 +-
         M docs/content/functions/ne.md        |       2 +-
         M docs/content/functions/now.md       |       2 +-
         M docs/content/functions/param.md     |       2 +-
         M docs/content/functions/partialCach… |       2 +-
         M docs/content/functions/plainify.md  |       2 +-
         M docs/content/functions/pluralize.md |       2 +-
         M docs/content/functions/printf.md    |       2 +-
         M docs/content/functions/querify.md   |       2 +-
         M docs/content/functions/range.md     |       2 +-
         M docs/content/functions/readdir.md   |       2 +-
         M docs/content/functions/readfile.md  |       2 +-
         M docs/content/functions/ref.md       |       2 +-
         M docs/content/functions/relLangURL.… |       2 +-
         M docs/content/functions/relref.md    |       2 +-
         M docs/content/functions/relurl.md    |       2 +-
         M docs/content/functions/render.md    |       2 +-
         M docs/content/functions/replace.md   |       2 +-
         M docs/content/functions/replacere.md |       2 +-
         M docs/content/functions/safeCSS.md   |       2 +-
         M docs/content/functions/safeHTML.md  |       2 +-
         M docs/content/functions/safeHTMLAtt… |       2 +-
         M docs/content/functions/safeJS.md    |       2 +-
         M docs/content/functions/safeURL.md   |       2 +-
         M docs/content/functions/scratch.md   |       2 +-
         M docs/content/functions/seq.md       |       2 +-
         M docs/content/functions/sha.md       |       2 +-
         M docs/content/functions/shuffle.md   |       2 +-
         M docs/content/functions/singularize… |       2 +-
         M docs/content/functions/slice.md     |       2 +-
         M docs/content/functions/slicestr.md  |       2 +-
         M docs/content/functions/sort.md      |       4 ++--
         M docs/content/functions/split.md     |       2 +-
         M docs/content/functions/string.md    |       2 +-
         M docs/content/functions/substr.md    |       2 +-
         M docs/content/functions/time.md      |       2 +-
         M docs/content/functions/title.md     |       2 +-
         M docs/content/functions/trim.md      |       2 +-
         M docs/content/functions/truncate.md  |       2 +-
         M docs/content/functions/union.md     |       2 +-
         M docs/content/functions/uniq.md      |       2 +-
         M docs/content/functions/unix.md      |       2 +-
         M docs/content/functions/upper.md     |       2 +-
         M docs/content/functions/urlize.md    |       2 +-
         M docs/content/functions/where.md     |       2 +-
         M docs/content/functions/with.md      |       2 +-
         M docs/content/getting-started/_inde… |       2 +-
         M docs/content/getting-started/confi… |       2 +-
         M docs/content/getting-started/direc… |       4 +++-
         M docs/content/getting-started/insta… |       6 +++++-
         M docs/content/getting-started/quick… |       2 +-
         M docs/content/getting-started/usage… |       2 +-
         M docs/content/hosting-and-deploymen… |       2 +-
         M docs/content/hosting-and-deploymen… |       2 +-
         M docs/content/hosting-and-deploymen… |       2 +-
         M docs/content/hosting-and-deploymen… |       6 +++---
         M docs/content/hosting-and-deploymen… |       2 +-
         M docs/content/hosting-and-deploymen… |       2 +-
         M docs/content/hosting-and-deploymen… |       2 +-
         M docs/content/hosting-and-deploymen… |       2 +-
         A docs/content/hosting-and-deploymen… |      90 +++++++++++++++++++++++++++++++
         M docs/content/hosting-and-deploymen… |       2 +-
         A docs/content/news/0.27-relnotes.md  |      95 ++++++++++++++++++++++++++++++
         A docs/content/news/0.27.1-relnotes.… |      21 +++++++++++++++++++++
         M docs/content/news/http2-server-pus… |       2 +-
         M docs/content/templates/404.md       |       2 +-
         M docs/content/templates/_index.md    |       2 +-
         M docs/content/templates/alternative… |       2 +-
         M docs/content/templates/base.md      |       4 +++-
         M docs/content/templates/data-templa… |       4 +++-
         M docs/content/templates/files.md     |       2 +-
         M docs/content/templates/homepage.md  |       4 +++-
         M docs/content/templates/internal.md  |       2 +-
         M docs/content/templates/introductio… |       4 +++-
         M docs/content/templates/lists.md     |       4 +++-
         M docs/content/templates/lookup-orde… |       2 +-
         M docs/content/templates/menu-templa… |       2 +-
         M docs/content/templates/ordering-an… |       2 +-
         M docs/content/templates/output-form… |       2 +-
         M docs/content/templates/pagination.… |       2 +-
         M docs/content/templates/partials.md  |       4 +++-
         M docs/content/templates/robots.md    |       2 +-
         M docs/content/templates/rss.md       |       2 +-
         M docs/content/templates/section-tem… |       4 +++-
         M docs/content/templates/shortcode-t… |       6 ++++--
         M docs/content/templates/single-page… |       4 +++-
         M docs/content/templates/sitemap-tem… |       2 +-
         M docs/content/templates/taxonomy-te… |       2 +-
         M docs/content/templates/template-de… |       2 +-
         M docs/content/templates/views.md     |       2 +-
         M docs/content/themes/_index.md       |       2 +-
         M docs/content/themes/creating.md     |       2 +-
         M docs/content/themes/customizing.md  |       2 +-
         M docs/content/themes/installing-and… |       4 +++-
         M docs/content/tools/_index.md        |       2 +-
         M docs/content/tools/editors.md       |       2 +-
         M docs/content/tools/frontends.md     |       2 +-
         M docs/content/tools/migrations.md    |       2 +-
         M docs/content/tools/other.md         |       2 +-
         M docs/content/tools/search.md        |       2 +-
         M docs/content/tools/starter-kits.md  |       2 +-
         M docs/content/tools/syntax-highligh… |       6 +++---
         M docs/content/troubleshooting/accen… |       2 +-
         M docs/content/troubleshooting/build… |       2 +-
         M docs/content/troubleshooting/eof-e… |       2 +-
         M docs/content/variables/_index.md    |       2 +-
         M docs/content/variables/files.md     |       2 +-
         M docs/content/variables/git.md       |       2 +-
         M docs/content/variables/hugo.md      |       2 +-
         M docs/content/variables/menus.md     |       2 +-
         M docs/content/variables/page.md      |       2 +-
         M docs/content/variables/shortcodes.… |       2 +-
         M docs/content/variables/site.md      |       2 +-
         M docs/content/variables/sitemap.md   |       2 +-
         M docs/content/variables/taxonomy.md  |       2 +-
         M docs/netlify.toml                   |       6 +++---
         A docs/static/images/blog/hugo-27-po… |       0 
         A docs/static/images/blog/hugo-bug-p… |       0 
         A docs/static/images/hosting-and-dep… |       0 
         A docs/static/images/hosting-and-dep… |       0 
         A docs/static/images/hosting-and-dep… |       0 
         M docs/themes/gohugoioTheme/layouts/… |       1 +
         A docs/themes/gohugoioTheme/layouts/… |      10 ++++++++++
       
       201 files changed, 472 insertions(+), 205 deletions(-)
       ---
 (DIR) diff --git a/docs/archetypes/default.md b/docs/archetypes/default.md
       @@ -3,7 +3,7 @@ title: "{{ replace .TranslationBaseName "-" " " | title }}"
        date: {{ .Date }}
        description: ""
        categories: []
       -#tags: []
       +keywords: []
        slug: ""
        aliases: []
        toc: false
 (DIR) diff --git a/docs/config.toml b/docs/config.toml
       @@ -45,6 +45,20 @@ baseName = "_headers"
        isPlainText = true
        notAlternative = true
        
       +[related]
       +
       +threshold = 80
       +includeNewer = true
       +toLower = false
       +
       +[[related.indices]]
       +name = "keywords"
       +weight = 100
       +[[related.indices]]
       +name  = "date"
       +weight = 10
       +pattern = "2006"
       +
        [social]
        twitter = "GoHugoIO"
        
       @@ -52,7 +66,7 @@ twitter = "GoHugoIO"
        [params]
          description = "The world’s fastest framework for building websites"
          ## Used for views in rendered HTML (i.e., rather than using the .Hugo variable)
       -  release = "0.27-DEV"
       +  release = "0.28-DEV"
          ## Setting this to true will add a "noindex" to *EVERY* page on the site
          removefromexternalsearch = false
          ## Gh repo for site footer (include trailing slash)
 (DIR) diff --git a/docs/content/about/_index.md b/docs/content/about/_index.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: []
       -#tags: []
       +keywords: []
        menu:
          docs:
            parent: "about"
 (DIR) diff --git a/docs/content/about/benefits.md b/docs/content/about/benefits.md
       @@ -5,7 +5,7 @@ description: Improved performance, security and ease of use are just a few of th
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [ssg,static,performance,security]
       +keywords: [ssg,static,performance,security]
        menu:
          docs:
            parent: "about"
 (DIR) diff --git a/docs/content/about/license.md b/docs/content/about/license.md
       @@ -6,7 +6,7 @@ date: 2016-02-01
        publishdate: 2016-02-01
        lastmod: 2016-03-02
        categories: ["about hugo"]
       -#tags: ["License","apache"]
       +keywords: ["License","apache"]
        menu:
          docs:
            parent: "about"
 (DIR) diff --git a/docs/content/about/roadmap.md b/docs/content/about/roadmap.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [about hugo]
       -#tags: [about,contribute,roadmap]
       +keywords: [about,contribute,roadmap]
        menu:
          docs:
            parent: "about"
       @@ -42,7 +42,7 @@ Feel free to [contribute to Hugo's development][devcontribute], [improve Hugo's 
        [doccontribute]: /contribute/documentation/
        [hosting and deployment]: /hosting-and-deployment/
        [migrate]: /tools/migrations/
       -[milestones]: https://github.com/gohugoio/hugo/milestone/14
       +[milestones]: https://github.com/gohugoio/hugo/milestones/
        [newissue]: https://github.com/gohugoio/hugo/issues/
        [related forum thread]: https://discourse.gohugo.io/t/web-based-editor/155
        [themes]: /themes/
 (DIR) diff --git a/docs/content/commands/_index.md b/docs/content/commands/_index.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [commands]
       -#tags: [cli,command line]
       +keywords: [cli,command line]
        menu:
          docs:
            parent: "commands"
 (DIR) diff --git a/docs/content/content-management/_index.md b/docs/content/content-management/_index.md
       @@ -9,7 +9,7 @@ menu:
          docs:
            parent: "content-management"
            weight: 1
       -#tags: [source, organization]
       +keywords: [source, organization]
        categories: [content management]
        weight: 01        #rem
        draft: false
 (DIR) diff --git a/docs/content/content-management/archetypes.md b/docs/content/content-management/archetypes.md
       @@ -5,7 +5,7 @@ description: Archetypes allow you to create new instances of content types and s
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [archetypes,generators,metadata,front matter]
       +keywords: [archetypes,generators,metadata,front matter]
        categories: ["content management"]
        menu:
          docs:
       @@ -29,7 +29,7 @@ See above
        
        **Archetypes** are content files in the [archetypes directory][] of your project that contain preconfigured [front matter][] for your website's [content types][]. Archetypes facilitate consistent metadata across your website content and allow content authors to quickly generate instances of a content type via the `hugo new` command.
        
       -{{< youtube S3Tj3UcTFz8 >}}
       +{{< youtube bcme8AzVh6o >}}
        
        The `hugo new` generator for archetypes assumes your working directory is the content folder at the root of your project. Hugo is able to infer the appropriate archetype by assuming the content type from the content section passed to the CLI command:
        
       @@ -94,7 +94,7 @@ Default archetypes are convenient if your content's front matter stays consisten
        
        ### Create the Default Archetype
        
       -When you create a new Hugo project using `hugo new site`, you'll notice that Hugo has already scaffolded a file at `archetypes/default.md`. 
       +When you create a new Hugo project using `hugo new site`, you'll notice that Hugo has already scaffolded a file at `archetypes/default.md`.
        
        The following examples are from a site that's using `tags` and `categories` as [taxonomies][]. If we assume that all content files will require these two key-values, we can create a `default.md` archetype that *extends* Hugo's base archetype. In this example, we are including "golang" and "hugo" as tags and "web development" as a category.
        
 (DIR) diff --git a/docs/content/content-management/authors.md b/docs/content/content-management/authors.md
       @@ -5,7 +5,7 @@ description:
        date: 2016-08-22
        publishdate: 2017-03-12
        lastmod: 2017-03-12
       -#tags: [authors]
       +keywords: [authors]
        categories: ["content management"]
        menu:
          docs:
 (DIR) diff --git a/docs/content/content-management/comments.md b/docs/content/content-management/comments.md
       @@ -5,7 +5,7 @@ description: Hugo ships with an internal Disqus template, but this isn't the onl
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-09
       -#tags: [sections,content,organization]
       +keywords: [sections,content,organization]
        categories: [project organization, fundamentals]
        menu:
          docs:
 (DIR) diff --git a/docs/content/content-management/cross-references.md b/docs/content/content-management/cross-references.md
       @@ -5,7 +5,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-31
        categories: [content management]
       -#tags: ["cross references","references", "anchors", "urls"]
       +keywords: ["cross references","references", "anchors", "urls"]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/formats.md b/docs/content/content-management/formats.md
       @@ -6,7 +6,7 @@ date: 2017-01-10
        publishdate: 2017-01-10
        lastmod: 2017-04-06
        categories: [content management]
       -#tags: [markdown,asciidoc,mmark,content format]
       +keywords: [markdown,asciidoc,mmark,content format]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/front-matter.md b/docs/content/content-management/front-matter.md
       @@ -6,7 +6,7 @@ date: 2017-01-09
        publishdate: 2017-01-09
        lastmod: 2017-02-24
        categories: [content management]
       -#tags: ["front matter", "yaml", "toml", "json", "metadata", "archetypes"]
       +keywords: ["front matter", "yaml", "toml", "json", "metadata", "archetypes"]
        menu:
          docs:
            parent: "content-management"
       @@ -19,6 +19,8 @@ toc: true
        
        **Front matter** allows you to keep metadata attached to an instance of a [content type][]---i.e., embedded inside a content file---and is one of the many features that gives Hugo its strength.
        
       +{{< youtube Yh2xKRJGff4 >}}
       +
        ## Front Matter Formats
        
        Hugo supports three formats for front matter, each with their own identifying tokens.
 (DIR) diff --git a/docs/content/content-management/menus.md b/docs/content/content-management/menus.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-31
        categories: [content management]
       -#tags: [menus]
       +keywords: [menus]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/content-management/multilingual.md b/docs/content/content-management/multilingual.md
       @@ -6,7 +6,7 @@ date: 2017-01-10
        publishdate: 2017-01-10
        lastmod: 2017-01-10
        categories: [content management]
       -#tags: [multilingual,i18n, internationalization]
       +keywords: [multilingual,i18n, internationalization]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/organization.md b/docs/content/content-management/organization.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [content management,fundamentals]
       -#tags: [sections,content,organization]
       +keywords: [sections,content,organization]
        menu:
          docs:
            parent: "content-management"
       @@ -24,6 +24,8 @@ This section is not updated with the new nested sections support in Hugo 0.24, s
        See above
        {{% /todo %}}
        
       +{{< youtube 0GZxidrlaRM >}}
       +
        ## Organization of Content Source
        
        In Hugo, your content should be organized in a manner that reflects the rendered website.
 (DIR) diff --git a/docs/content/content-management/related.md b/docs/content/content-management/related.md
       @@ -3,7 +3,7 @@ title: Related Content
        description: List related content in "See Also" sections.
        date: 2017-09-05
        categories: [content management]
       -#tags: [content]
       +keywords: [content]
        menu:
          docs:
            parent: "content-management"
       @@ -57,6 +57,10 @@ type PageGenealogist interface {
        ## Configure Related Content
        Hugo provides a sensible default configuration of Related Content, but you can fine-tune this in your configuration, on the global or language level if needed.
        
       +{{% note %}}
       +If you add a `related` config section, you need to add a complete configuration. It is not possible to just set, say, `includeNewer` and use the rest  from the Hugo defaults.
       +{{% /note %}}
       +
        Below is a sample `config.toml` section:
        
        ```
 (DIR) diff --git a/docs/content/content-management/sections.md b/docs/content/content-management/sections.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [content management]
       -#tags: [lists,sections,content types,organization]
       +keywords: [lists,sections,content types,organization]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/shortcodes.md b/docs/content/content-management/shortcodes.md
       @@ -12,7 +12,7 @@ menu:
            weight: 35
        weight: 35        #rem
        categories: [content management]
       -#tags: [markdown,content,shortcodes]
       +keywords: [markdown,content,shortcodes]
        draft: false
        aliases: [/extras/shortcodes/]
        toc: true
       @@ -30,6 +30,8 @@ In addition to cleaner Markdown, shortcodes can be updated any time to reflect n
        
        ## Use Shortcodes
        
       +{{< youtube 2xkNJL4gJ9E >}}
       +
        In your content files, a shortcode can be called by calling `{{%/* shortcodename parameters */%}}`. Shortcode parameters are space delimited, and parameters with internal spaces can be quoted.
        
        The first word in the shortcode declaration is always the name of the shortcode. Parameters follow the name. Depending upon how the shortcode is defined, the parameters may be named, positional, or both, although you can't mix parameter types in a single call. The format for named parameters models that of HTML with the format `name="value"`.
 (DIR) diff --git a/docs/content/content-management/summaries.md b/docs/content/content-management/summaries.md
       @@ -6,7 +6,7 @@ date: 2017-01-10
        publishdate: 2017-01-10
        lastmod: 2017-01-10
        categories: [content management]
       -#tags: [summaries,abstracts,read more]
       +keywords: [summaries,abstracts,read more]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/taxonomies.md b/docs/content/content-management/taxonomies.md
       @@ -5,7 +5,7 @@ description: Hugo includes support for user-defined taxonomies to help you  demo
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [taxonomies,metadata,front matter,terms]
       +keywords: [taxonomies,metadata,front matter,terms]
        categories: [content management]
        menu:
          docs:
       @@ -32,7 +32,7 @@ Term
        Value
        : a piece of content assigned to a term
        
       -{{< youtube "-np9GX6cL38" >}}
       +{{< youtube pCPCQgqC8RA >}}
        
        ## Example Taxonomy: Movie Website
        
 (DIR) diff --git a/docs/content/content-management/toc.md b/docs/content/content-management/toc.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [content management]
       -#tags: [table of contents, toc]
       +keywords: [table of contents, toc]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/types.md b/docs/content/content-management/types.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [content management]
       -#tags: [lists,sections,content types,types,organization]
       +keywords: [lists,sections,content types,types,organization]
        menu:
          docs:
            parent: "content-management"
 (DIR) diff --git a/docs/content/content-management/urls.md b/docs/content/content-management/urls.md
       @@ -5,7 +5,7 @@ description: Hugo supports permalinks, aliases, link canonicalization, and multi
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-09
       -#tags: [aliases,redirects,permalinks,urls]
       +keywords: [aliases,redirects,permalinks,urls]
        categories: [content management]
        menu:
          docs:
 (DIR) diff --git a/docs/content/contribute/_index.md b/docs/content/contribute/_index.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [contribute]
       -#tags: []
       +keywords: []
        menu:
          docs:
            parent: "contribute"
 (DIR) diff --git a/docs/content/contribute/development.md b/docs/content/contribute/development.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [contribute]
       -#tags: [dev,open source]
       +keywords: [dev,open source]
        authors: [digitalcraftsman]
        menu:
          docs:
 (DIR) diff --git a/docs/content/contribute/documentation.md b/docs/content/contribute/documentation.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [contribute]
       -#tags: [docs,documentation,community, contribute]
       +keywords: [docs,documentation,community, contribute]
        menu:
          docs:
            parent: "contribute"
 (DIR) diff --git a/docs/content/contribute/themes.md b/docs/content/contribute/themes.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-27
        categories: [contribute]
       -#tags: [contribute,themes,design]
       +keywords: [contribute,themes,design]
        authors: [digitalcraftsman]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/GetPage.md b/docs/content/functions/GetPage.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [sections,lists,indexes]
       +keywords: [sections,lists,indexes]
        signature: [".GetPage TYPE PATH"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/NumFmt.md b/docs/content/functions/NumFmt.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-08-21
        categories: [functions]
       -#tags: [numbers]
       +keywords: [numbers]
        menu:
          docs:
            parent: "functions"
 (DIR) diff --git a/docs/content/functions/_index.md b/docs/content/functions/_index.md
       @@ -6,7 +6,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: []
       +keywords: []
        menu:
          docs:
            parent: "functions"
 (DIR) diff --git a/docs/content/functions/abslangurl.md b/docs/content/functions/abslangurl.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [multilingual,i18n,urls]
       +keywords: [multilingual,i18n,urls]
        signature: ["absLangURL INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/absurl.md b/docs/content/functions/absurl.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [urls]
       +keywords: [urls]
        signature: ["absURL INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/adddate.md b/docs/content/functions/adddate.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [dates,time]
       +keywords: [dates,time]
        signature: [".AddDate YEARS MONTHS DAYS"]
        workson: [times]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/after.md b/docs/content/functions/after.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [iteration]
       +keywords: [iteration]
        signature: ["after INDEX COLLECTION"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/apply.md b/docs/content/functions/apply.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [advanced]
       +keywords: [advanced]
        signature: ["apply COLLETION FUNCTION [PARAM...]"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/base64.md b/docs/content/functions/base64.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        relatedfuncs: []
        signature: ["base64Decode INPUT", "base64Encode INPUT"]
        workson: []
 (DIR) diff --git a/docs/content/functions/chomp.md b/docs/content/functions/chomp.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [trim]
       +keywords: [trim]
        signature: ["chomp INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/countrunes.md b/docs/content/functions/countrunes.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [counting, word count]
       +keywords: [counting, word count]
        signature: ["countrunes INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/countwords.md b/docs/content/functions/countwords.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [counting, word count]
       +keywords: [counting, word count]
        signature: ["countwords INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/dateformat.md b/docs/content/functions/dateformat.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [dates,time,strings]
       +keywords: [dates,time,strings]
        signature: ["dateFormat LAYOUT INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/default.md b/docs/content/functions/default.md
       @@ -6,7 +6,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [defaults]
       +keywords: [defaults]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/delimit.md b/docs/content/functions/delimit.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [iteration]
       +keywords: [iteration]
        toc: false
        signature: ["delimit COLLECTION DELIMIT LAST"]
        workson: [lists,taxonomies,terms]
       @@ -36,7 +36,7 @@ The examples of `delimit` that follow all use the same front matter:
        {{< code file="delimit-example-front-matter.toml" nocopy="true" >}}
        +++
        title: I love Delimit
       -#tags: [ "tag1", "tag2", "tag3" ]
       +keywords: [ "tag1", "tag2", "tag3" ]
        +++
        {{< /code >}}
        
 (DIR) diff --git a/docs/content/functions/dict.md b/docs/content/functions/dict.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [dictionary]
       +keywords: [dictionary]
        signature: ["dict KEY VALUE [KEY VALUE]..."]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/echoparam.md b/docs/content/functions/echoparam.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["echoParam DICTIONARY KEY"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/emojify.md b/docs/content/functions/emojify.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings,emojis]
       +keywords: [strings,emojis]
        signature: ["emojify INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/eq.md b/docs/content/functions/eq.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [operators,logic]
       +keywords: [operators,logic]
        signature: ["eq ARG1 ARG2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/findRe.md b/docs/content/functions/findRe.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [regex]
       +keywords: [regex]
        signature: ["findRE PATTERN INPUT [LIMIT]"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/first.md b/docs/content/functions/first.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [iteration]
       +keywords: [iteration]
        signature: ["first LIMIT COLLECTION"]
        workson: [lists,taxonomies,terms,groups]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/format.md b/docs/content/functions/format.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [dates,time]
       +keywords: [dates,time]
        signature: [".Format FORMAT"]
        workson: [times]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/ge.md b/docs/content/functions/ge.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [operators,logic]
       +keywords: [operators,logic]
        signature: ["ge ARG1 ARG2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/get.md b/docs/content/functions/get.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [shortcodes]
       +keywords: [shortcodes]
        signature: ["Get INDEX", "Get KEY"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/getenv.md b/docs/content/functions/getenv.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["getenv VARIABLE"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/gt.md b/docs/content/functions/gt.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [operators,logic]
       +keywords: [operators,logic]
        signature: ["gt ARG1 ARG2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/hasPrefix.md b/docs/content/functions/hasPrefix.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["hasPrefix STRING PREFIX"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/haschildren.md b/docs/content/functions/haschildren.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [menus]
       +keywords: [menus]
        toc:
        signature: ["HasChildren"]
        workson: [menus]
 (DIR) diff --git a/docs/content/functions/hasmenucurrent.md b/docs/content/functions/hasmenucurrent.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [menus]
       +keywords: [menus]
        signature: ["HasMenuCurrent"]
        workson: [menus]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/highlight.md b/docs/content/functions/highlight.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [highlighting,pygments,code blocks,syntax]
       +keywords: [highlighting,pygments,code blocks,syntax]
        signature: ["highlight INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/htmlEscape.md b/docs/content/functions/htmlEscape.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings, html]
       +keywords: [strings, html]
        signature: ["htmlEscape INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/htmlUnescape.md b/docs/content/functions/htmlUnescape.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["htmlUnescape INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/humanize.md b/docs/content/functions/humanize.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings,casing]
       +keywords: [strings,casing]
        signature: ["humanize INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/i18n.md b/docs/content/functions/i18n.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [internationalization,i18n,multilingual]
       +keywords: [internationalization,i18n,multilingual]
        signature: ["i18n KEY", "T KEY"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/imageConfig.md b/docs/content/functions/imageConfig.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [images]
       +keywords: [images]
        signature: ["imageConfig PATH"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/in.md b/docs/content/functions/in.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["in SET ITEM"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/index-function.md b/docs/content/functions/index-function.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["index COLLECTION INDEX", "index COLLECTION KEY"]
        workson: []
        hugoversion:
       @@ -71,7 +71,7 @@ This is where the `index` function is needed. `index` takes 2 parameters in this
        The variable for `.Params.location` is a string and can therefore replace `oslo` in the example above:
        
        ```
       -{{ index .Site.Data.authors .Params.author }}
       +{{ index .Site.Data.locations .Params.location }}
        => map[website:https://www.oslo.kommune.no pop_city:658390 pop_metro:1717900]
        ```
        
 (DIR) diff --git a/docs/content/functions/int.md b/docs/content/functions/int.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings,integers]
       +keywords: [strings,integers]
        signature: ["int INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/intersect.md b/docs/content/functions/intersect.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["intersect SET1 SET2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/ismenucurrent.md b/docs/content/functions/ismenucurrent.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [menus]
       +keywords: [menus]
        signature: ["IsMenuCurrent"]
        workson: [menus]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/isset.md b/docs/content/functions/isset.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["isset COLLECTION INDEX", "isset COLLECTION KEY"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/jsonify.md b/docs/content/functions/jsonify.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings,json]
       +keywords: [strings,json]
        signature: ["jsonify INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/last.md b/docs/content/functions/last.md
       @@ -6,7 +6,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: []
       +keywords: []
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/le.md b/docs/content/functions/le.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [operators,logic]
       +keywords: [operators,logic]
        signature: ["le ARG1 ARG2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/len.md b/docs/content/functions/len.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-04-18
        categories: [functions]
       -#tags: []
       +keywords: []
        signature: ["len INPUT"]
        workson: [lists,taxonomies,terms]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/lower.md b/docs/content/functions/lower.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings,casing]
       +keywords: [strings,casing]
        signature: ["lower INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/lt.md b/docs/content/functions/lt.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [operators,logic]
       +keywords: [operators,logic]
        signature: ["lt ARG1 ARG2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/markdownify.md b/docs/content/functions/markdownify.md
       @@ -6,7 +6,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [markdown,content]
       +keywords: [markdown,content]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/math.md b/docs/content/functions/math.md
       @@ -5,7 +5,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [math, operators]
       +keywords: [math, operators]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/md5.md b/docs/content/functions/md5.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["md5 INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/ne.md b/docs/content/functions/ne.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [operators,logic]
       +keywords: [operators,logic]
        signature: ["ne ARG1 ARG2"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/now.md b/docs/content/functions/now.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [dates,time]
       +keywords: [dates,time]
        signature: ["now"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/param.md b/docs/content/functions/param.md
       @@ -5,7 +5,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-04-30
       -#tags: ["front matter"]
       +keywords: ["front matter"]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/partialCached.md b/docs/content/functions/partialCached.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["partialCached LAYOUT INPUT [VARIANT...]"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/plainify.md b/docs/content/functions/plainify.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["plainify INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/pluralize.md b/docs/content/functions/pluralize.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["pluralize INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/printf.md b/docs/content/functions/printf.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["printf FORMAT INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/querify.md b/docs/content/functions/querify.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [urls]
       +keywords: [urls]
        godocref:
        signature: ["querify KEY VALUE [KEY VALUE]..."]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/range.md b/docs/content/functions/range.md
       @@ -10,7 +10,7 @@ categories: [functions,fundamentals]
        menu:
          docs:
            parent: "functions"
       -#tags: [iteration]
       +keywords: [iteration]
        signature: ["range COLLECTION"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/readdir.md b/docs/content/functions/readdir.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [files]
       +keywords: [files]
        signature: ["readDir PATH"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/readfile.md b/docs/content/functions/readfile.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [files]
       +keywords: [files]
        signature: ["readFile PATH"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/ref.md b/docs/content/functions/ref.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [cross references, anchors]
       +keywords: [cross references, anchors]
        signature: ["ref PAGE CONTENT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/relLangURL.md b/docs/content/functions/relLangURL.md
       @@ -5,7 +5,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [multilingual,i18n,urls]
       +keywords: [multilingual,i18n,urls]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/relref.md b/docs/content/functions/relref.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [cross references, anchors]
       +keywords: [cross references, anchors]
        signature: ["relref PAGE CONTENT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/relurl.md b/docs/content/functions/relurl.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [urls]
       +keywords: [urls]
        signature: ["relURL INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/render.md b/docs/content/functions/render.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [views]
       +keywords: [views]
        signature: ["render LAYOUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/replace.md b/docs/content/functions/replace.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["replace INPUT OLD NEW"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/replacere.md b/docs/content/functions/replacere.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [regex]
       +keywords: [regex]
        signature: ["replaceRE PATTERN REPLACEMENT INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/safeCSS.md b/docs/content/functions/safeCSS.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [style,css,strings]
       +keywords: [style,css,strings]
        signature: ["safeCSS INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/safeHTML.md b/docs/content/functions/safeHTML.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["safeHTML INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/safeHTMLAttr.md b/docs/content/functions/safeHTMLAttr.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["safeHTMLAttr INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/safeJS.md b/docs/content/functions/safeJS.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["safeJS INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/safeURL.md b/docs/content/functions/safeURL.md
       @@ -5,7 +5,7 @@ godocref: https://golang.org/pkg/html/template/#HTMLEscape
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [strings,urls]
       +keywords: [strings,urls]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/scratch.md b/docs/content/functions/scratch.md
       @@ -5,7 +5,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [iteration]
       +keywords: [iteration]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/seq.md b/docs/content/functions/seq.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: []
       +keywords: []
        signature: ["seq LAST", "seq FIRST LAST", "seq FIRST INCREMENT LAST"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/sha.md b/docs/content/functions/sha.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [sha,checksum]
       +keywords: [sha,checksum]
        signature: ["sha1 INPUT", "sha256 INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/shuffle.md b/docs/content/functions/shuffle.md
       @@ -6,7 +6,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-04-30
       -#tags: [ordering]
       +keywords: [ordering]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/singularize.md b/docs/content/functions/singularize.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings,singular]
       +keywords: [strings,singular]
        signature: ["singularize INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/slice.md b/docs/content/functions/slice.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [slice, array, interface]
       +keywords: [slice, array, interface]
        signature: ["slice ITEM..."]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/slicestr.md b/docs/content/functions/slicestr.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["slicestr STRING START [END]"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/sort.md b/docs/content/functions/sort.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [ordering,sorting,lists]
       +keywords: [ordering,sorting,lists]
        signature: []
        workson: [lists,taxonomies,terms,groups]
        hugoversion:
       @@ -23,7 +23,7 @@ A sorted array of map values will be returned with the keys eliminated. There ar
        
        ```
        +++
       -#tags: [ "tag3", "tag1", "tag2" ]
       +keywords: [ "tag3", "tag1", "tag2" ]
        +++
        
        // Site config
 (DIR) diff --git a/docs/content/functions/split.md b/docs/content/functions/split.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["split STRING DELIM"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/string.md b/docs/content/functions/string.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["string INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/substr.md b/docs/content/functions/substr.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        aliases: []
        signature: ["substr STRING START [LENGTH]"]
        workson: []
 (DIR) diff --git a/docs/content/functions/time.md b/docs/content/functions/time.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [dates,time]
       +keywords: [dates,time]
        signature: ["time INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/title.md b/docs/content/functions/title.md
       @@ -10,7 +10,7 @@ categories: [functions,fundamentals]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["title INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/trim.md b/docs/content/functions/trim.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["trim INPUT CUTSET"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/truncate.md b/docs/content/functions/truncate.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [strings]
       +keywords: [strings]
        signature: ["truncate SIZE INPUT", "truncate SIZE ELLIPSIS INPUT"]
        workson: []
        hugoversion: 19
 (DIR) diff --git a/docs/content/functions/union.md b/docs/content/functions/union.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [filtering,lists]
       +keywords: [filtering,lists]
        signature: ["union SET1 SET2"]
        workson: []
        hugoversion: 0.20
 (DIR) diff --git a/docs/content/functions/uniq.md b/docs/content/functions/uniq.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [multilingual,i18n,urls]
       +keywords: [multilingual,i18n,urls]
        signature: ["uniq SET"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/functions/unix.md b/docs/content/functions/unix.md
       @@ -6,7 +6,7 @@ godocref: https://golang.org/search?q=Unix#Functions
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [dates,time]
       +keywords: [dates,time]
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/upper.md b/docs/content/functions/upper.md
       @@ -6,7 +6,7 @@ godocref:
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: []
       +keywords: []
        categories: [functions]
        menu:
          docs:
 (DIR) diff --git a/docs/content/functions/urlize.md b/docs/content/functions/urlize.md
       @@ -9,7 +9,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [urls,strings]
       +keywords: [urls,strings]
        godocref:
        signature: ["urlize INPUT"]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/where.md b/docs/content/functions/where.md
       @@ -10,7 +10,7 @@ categories: [functions]
        menu:
          docs:
            parent: "functions"
       -#tags: [filtering]
       +keywords: [filtering]
        signature: ["where COLLECTION KEY [OPERATOR] MATCH"]
        workson: [lists,taxonomies,terms,groups]
        hugoversion:
 (DIR) diff --git a/docs/content/functions/with.md b/docs/content/functions/with.md
       @@ -10,7 +10,7 @@ categories: [functions,fundamentals]
        menu:
          docs:
            parent: "functions"
       -#tags: [conditionals]
       +keywords: [conditionals]
        signature: ["with INPUT"]
        workson: []
        hugoversion:
 (DIR) diff --git a/docs/content/getting-started/_index.md b/docs/content/getting-started/_index.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [getting started]
       -#tags: [usage,docs]
       +keywords: [usage,docs]
        menu:
          docs:
            parent: "getting-started"
 (DIR) diff --git a/docs/content/getting-started/configuration.md b/docs/content/getting-started/configuration.md
       @@ -6,7 +6,7 @@ date: 2013-07-01
        publishdate: 2017-01-02
        lastmod: 2017-03-05
        categories: [getting started,fundamentals]
       -#tags: [configuration,toml,yaml,json]
       +keywords: [configuration,toml,yaml,json]
        menu:
          docs:
            parent: "getting-started"
 (DIR) diff --git a/docs/content/getting-started/directory-structure.md b/docs/content/getting-started/directory-structure.md
       @@ -6,7 +6,7 @@ date: 2017-01-02
        publishdate: 2017-02-01
        lastmod: 2017-03-09
        categories: [getting started,fundamentals]
       -#tags: [source, organization, directories]
       +keywords: [source, organization, directories]
        menu:
          docs:
            parent: "getting-started"
       @@ -20,6 +20,8 @@ toc: true
        
        ## New Site Scaffolding
        
       +{{< youtube sB0HLHjgQ7E >}}
       +
        Running the `hugo new site` generator from the command line will create a directory structure with the following elements:
        
        ```
 (DIR) diff --git a/docs/content/getting-started/installing.md b/docs/content/getting-started/installing.md
       @@ -7,7 +7,7 @@ publishdate: 2016-11-01
        lastmod: 2017-02-20
        categories: [getting started,fundamentals]
        authors: ["Michael Henderson"]
       -#tags: [install,pc,windows,linux,macos,binary,tarball]
       +keywords: [install,pc,windows,linux,macos,binary,tarball]
        menu:
          docs:
            parent: "getting-started"
       @@ -121,6 +121,8 @@ Since building from source is appealing to more seasoned command line users, thi
        
        ### Install Hugo with Brew
        
       +{{< youtube WvhCGlLcrF8 >}}
       +
        #### Step 1: Install `brew` if you haven't already
        
        Go to the `brew` website, <https://brew.sh/>, and follow the directions there. The most important step is the installation from the command line:
       @@ -299,6 +301,8 @@ Then place the `hugo` executable somewhere in your `$PATH`. You're now ready to 
        
        The following aims to be a complete guide to installing Hugo on your Windows PC.
        
       +{{< youtube G7umPCU-8xc >}}
       +
        ### Assumptions
        
        1. You will use `C:\Hugo\Sites` as the starting point for your new project.
 (DIR) diff --git a/docs/content/getting-started/quick-start.md b/docs/content/getting-started/quick-start.md
       @@ -5,7 +5,7 @@ description: Create a Hugo site using the beautiful Ananke theme.
        date: 2013-07-01
        publishdate: 2013-07-01
        categories: [getting started]
       -#tags: [quick start,usage]
       +keywords: [quick start,usage]
        authors: [Shekhar Gulati, Ryan Watters]
        menu:
          docs:
 (DIR) diff --git a/docs/content/getting-started/usage.md b/docs/content/getting-started/usage.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [getting started]
       -#tags: [usage,livereload,command line,flags]
       +keywords: [usage,livereload,command line,flags]
        menu:
          docs:
            parent: "getting-started"
 (DIR) diff --git a/docs/content/hosting-and-deployment/_index.md b/docs/content/hosting-and-deployment/_index.md
       @@ -6,7 +6,7 @@ date: 2016-11-01
        publishdate: 2016-11-01
        lastmod: 2016-11-01
        categories: [hosting and deployment]
       -#tags: []
       +keywords: []
        menu:
          docs:
            parent: "hosting-and-deployment"
 (DIR) diff --git a/docs/content/hosting-and-deployment/deployment-with-nanobox.md b/docs/content/hosting-and-deployment/deployment-with-nanobox.md
       @@ -6,7 +6,7 @@ date: 2017-08-24
        publishdate: 2017-08-24
        lastmod: 2017-08-24
        categories: [hosting and deployment]
       -#tags: [nanobox,deployment,hosting,aws,digitalocean,azure,google,linode]
       +keywords: [nanobox,deployment,hosting,aws,digitalocean,azure,google,linode]
        authors: [Steve Domino]
        menu:
          docs:
 (DIR) diff --git a/docs/content/hosting-and-deployment/deployment-with-rsync.md b/docs/content/hosting-and-deployment/deployment-with-rsync.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [hosting and deployment]
       -#tags: [rsync,deployment]
       +keywords: [rsync,deployment]
        authors: [Adrien Poupin]
        menu:
          docs:
 (DIR) diff --git a/docs/content/hosting-and-deployment/deployment-with-wercker.md b/docs/content/hosting-and-deployment/deployment-with-wercker.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [hosting and deployment]
       -#tags: [wercker,deployment,github,git]
       +keywords: [wercker,deployment,github,git]
        authors: [Arjen Schwarz, Samuel Debruyn]
        menu:
          docs:
       @@ -136,13 +136,13 @@ To sign up for a free Wercker account, go to <https://wercker.com> and click the
        
        ![][3]
        
       -### Registe for Wercker with Your GitHub Account
       +### Register for Wercker with Your GitHub Account
        
        Sign up for Wercker using your GitHub credentials. If you don't have a GitHub account, or don't want to use it for your account, you have the option to register with a username and password as well. However, the second half of this guide---devoted to hosting your website on GitHub pages---will no longer be of interest to you.
        
        ![][4]
        
       -### Connecte GitHub or Bitbucket
       +### Connect GitHub or Bitbucket
        
        After you are registered, you will need to link your GitHub or Bitbucket account to Wercker. You can link your account by navigating to your profile settings and then selecting "Git connections."
        
 (DIR) diff --git a/docs/content/hosting-and-deployment/hosting-on-bitbucket.md b/docs/content/hosting-and-deployment/hosting-on-bitbucket.md
       @@ -6,7 +6,7 @@ date: 2017-02-04
        publishdate: 2017-02-04
        lastmod: 2017-02-04
        categories: [hosting and deployment]
       -#tags: [hosting,bitbucket,deployment,aerobatic]
       +keywords: [hosting,bitbucket,deployment,aerobatic]
        authors: [Jason Gowans]
        menu:
          docs:
 (DIR) diff --git a/docs/content/hosting-and-deployment/hosting-on-firebase.md b/docs/content/hosting-and-deployment/hosting-on-firebase.md
       @@ -6,7 +6,7 @@ date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-15
        categories: [hosting and deployment]
       -#tags: [hosting,firebase]
       +keywords: [hosting,firebase]
        authors: [Michel Racic]
        menu:
          docs:
 (DIR) diff --git a/docs/content/hosting-and-deployment/hosting-on-github.md b/docs/content/hosting-and-deployment/hosting-on-github.md
       @@ -6,7 +6,7 @@ date: 2014-03-21
        publishdate: 2014-03-21
        lastmod: 2017-03-30
        categories: [hosting and deployment]
       -#tags: [github,git,deployment,hosting]
       +keywords: [github,git,deployment,hosting]
        authors: [Spencer Lyon, Gunnar Morling]
        menu:
          docs:
 (DIR) diff --git a/docs/content/hosting-and-deployment/hosting-on-gitlab.md b/docs/content/hosting-and-deployment/hosting-on-gitlab.md
       @@ -6,7 +6,7 @@ date: 2016-06-23
        publishdate: 2016-06-23
        lastmod: 2016-06-23
        categories: [hosting and deployment]
       -#tags: [hosting,deployment,git,gitlab]
       +keywords: [hosting,deployment,git,gitlab]
        authors: [Riku-Pekka Silvola]
        menu:
          docs:
 (DIR) diff --git a/docs/content/hosting-and-deployment/hosting-on-keycdn.md b/docs/content/hosting-and-deployment/hosting-on-keycdn.md
       @@ -0,0 +1,90 @@
       +---
       +title: "Hosting on KeyCDN"
       +date: 2017-09-12
       +description: "Accelerate your Hugo site globally with a KeyCDN integration. This tutorial shows you how to setup your static site as a GitLab page behind a KeyCDN pull zone."
       +categories: [hosting and deployment]
       +keywords: [keycdn,hosting,deployment,cdn]
       +slug: ""
       +aliases: []
       +toc: false
       +draft: false
       +---
       +
       +[KeyCDN](https://www.keycdn.com/) provides a multitude of features to help accelerate and secure your Hugo site globally including Brotli compression, Let's Encrypt support, Origin Shield, and more.
       +
       +## Assumptions
       +
       +- You already have a Hugo page configured
       +- You have a GitLab account
       +- You have a KeyCDN account
       +
       +## Create a KeyCDN Pull Zone
       +
       +The first step will be to login to your KeyCDN account and create a new zone. Name this whatever you like and select the [Pull Zone](https://www.keycdn.com/support/create-a-pull-zone/) option. As for the the origin URL, your site will be running on [GitLab Pages](https://docs.gitlab.com/ee/user/project/pages/getting_started_part_one.html) with a URL of `https://youruser.gitlab.io/reponame/`. Use this as the Origin URL. 
       +
       +![Screenshot of KeyCDN's pull zone creation page](/images/hosting-and-deployment/hosting-on-keycdn/keycdn-pull-zone.png) 
       +
       +While the origin location doesn’t exist yet, you will need to use your new Zone URL address (or [Zonealias](https://www.keycdn.com/support/create-a-zonealias/)) in the `.gitlab-ci.yml` file that will be uploaded to your GitLab project. 
       +
       +Ensure that you use your Zone URL or Zonealias as the `BASEURL` variable in the example below. This will be the user-visible website address.
       +
       +## Configure Your .gitlab-ci.yml File
       +
       +Your `.gitlab-ci.yml` file should look similar to the example below. Be sure to modify any variables that are specific to your setup.
       +
       +```
       +image: alpine:latest
       +
       +variables:
       +    BASEURL: "https://cipull-7bb7.kxcdn.com/"
       +    HUGO_VERSION: "0.26"
       +    HUGO_CHECKSUM: "67e4ba5ec2a02c8164b6846e30a17cc765b0165a5b183d5e480149baf54e1a50"
       +    KEYCDN_ZONE_ID: "75544"
       +
       +before_script:
       +    - apk update
       +    - apk add curl
       +
       +pages:
       +    stage: deploy
       +    script:
       +    - apk add git
       +    - git submodule update --init
       +    - curl -sSL https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_${HUGO_VERSION}_Linux-64bit.tar.gz -o /tmp/hugo.tar.gz
       +    - echo "${HUGO_CHECKSUM}  /tmp/hugo.tar.gz" | sha256sum -c
       +    - tar xf /tmp/hugo.tar.gz hugo -C /tmp/ && cp /tmp/hugo /usr/bin
       +    - hugo --baseURL ${BASEURL}
       +    - curl "https://api.keycdn.com/zones/purge/${KEYCDN_ZONE_ID}.json" -u "${KEYCDN_API_KEY}:"
       +    artifacts:
       +    paths:
       +    - public
       +    only:
       +    - master
       +
       +```
       +Using this integration method,  you will have to specify the Zone ID and your [KeyCDN API](https://www.keycdn.com/api) key as secret variables. To do this, navigate to the top-left menu bar in GitLab and select Projects. Then, select your project and click on the Settings page. Finally, select Pipelines from the sub-menu and scroll down to the Secret Variable section. 
       +
       +The Secret Variable for your Zone ID should look similar to:
       +
       +![Screenshot of setting the Zone ID secret variable](/images/hosting-and-deployment/hosting-on-keycdn/secret-zone-id.png)
       +
       +While the Secret Variable for your API Key will look similar to:
       +
       +![Screenshot of setting the API Key secret variable](/images/hosting-and-deployment/hosting-on-keycdn/secret-api-key.png)
       +
       +The Zone ID and API key are used to purge your zone – it’s not strictly needed but otherwise, the CDN might deliver older versions of your assets for quite a while.
       +
       +## Push Your Changes to GitLab
       +
       +Now it’s time to push the newly created repository to GitLab:
       +
       +```
       +git remote add origin git@gitlab.com:youruser/ciexample.git
       +git push -u origin master
       +```
       +
       +You can watch the progress and CI job output in your Gitlab project under “Pipelines”. 
       +
       +After verifying your CI job ran without issues, first check that your GitLab page shows up under `https://youruser.gitlab.io/reponame/` (it might look broken depending on your browser settings as all links point to your KeyCDN zone – don’t worry about that) and then by heading to whatever Zonealias / Zone URL you defined.
       +
       +To learn more about Hugo hosting options with KeyCDN, check out the complete [Hugo hosting with KeyCDN integration guide](https://www.keycdn.com/support/hugo-hosting/).
 (DIR) diff --git a/docs/content/hosting-and-deployment/hosting-on-netlify.md b/docs/content/hosting-and-deployment/hosting-on-netlify.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-11
        categories: [hosting and deployment]
       -#tags: [netlify,hosting,deployment]
       +keywords: [netlify,hosting,deployment]
        authors: [Ryan Watters, Seth MacLeod]
        menu:
          docs:
 (DIR) diff --git a/docs/content/news/0.27-relnotes.md b/docs/content/news/0.27-relnotes.md
       @@ -0,0 +1,95 @@
       +
       +---
       +date: 2017-09-11
       +title: "Hugo 0.27: Fast and Flexible Related Content!"
       +description: "Makes it easy to add \"See Also\" sections etc. to your site."
       +categories: ["Releases"]
       +images:
       +- images/blog/hugo-27-poster.png
       +---
       +
       +        
       +Hugo `0.27`comes with fast and flexible **Related Content** ([3b4f17bb](https://github.com/gohugoio/hugo/commit/3b4f17bbc9ff789faa581ac278ad109d1ac5b816) [@bep](https://github.com/bep) [#98](https://github.com/gohugoio/hugo/issues/98)). To add this to your site, put something like this in your single page template:
       +
       +```html
       +{{ $related := .Site.RegularPages.Related . | first 5 }}
       +{{ with $related }}
       +<h3>See Also</h3>
       +<ul>
       +        {{ range . }}
       +        <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
       +        {{ end }}
       +</ul>
       +{{ end }}
       +```
       +
       +The above translates to _list the five regular pages mostly related to the current page_. See the [Related Content Documentation](https://gohugo.io/content-management/related/) for details and configuration options.
       +
       +This release represents **37 contributions by 9 contributors** to the main Hugo code base.
       +
       +[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@yihui](https://github.com/yihui), and [@oneleaftea](https://github.com/oneleaftea) for their ongoing contributions.
       +
       +And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
       +
       +Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs), 
       +which has received **44 contributions by 30 contributors**. A special thanks to [@bep](https://github.com/bep), [@sdomino](https://github.com/sdomino), [@gotgenes](https://github.com/gotgenes), and [@digitalcraftsman](https://github.com/digitalcraftsman) for their work on the documentation site.
       +
       +
       +Hugo now has:
       +
       +* 19464+ [stars](https://github.com/gohugoio/hugo/stargazers)
       +* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
       +* 178+ [themes](http://themes.gohugo.io/)
       +
       +## Notes
       +
       +* We now only strip p tag in `markdownify` if there is only one paragraph. This allows blocks of paragraphs to be "markdownified" [33ae10b6](https://github.com/gohugoio/hugo/commit/33ae10b6ade67cd9618970121d7de5fd2ce7d781) [@bep](https://github.com/bep) [#3040](https://github.com/gohugoio/hugo/issues/3040)
       +
       +## Enhancements
       +
       +### Templates
       +
       +* Add `time.Duration` and `time.ParseDuration` template funcs [f4bf2141](https://github.com/gohugoio/hugo/commit/f4bf214137ebd24a0d12f16d3a98d9038e6eabd3) [@bep](https://github.com/bep) [#3828](https://github.com/gohugoio/hugo/issues/3828)
       +* Add `cond` (ternary) template func [0462c96a](https://github.com/gohugoio/hugo/commit/0462c96a5a9da3e8adc78d96acd39575a8b46c40) [@bep](https://github.com/bep) [#3860](https://github.com/gohugoio/hugo/issues/3860)
       +* Prepare for template metrics [d000cf60](https://github.com/gohugoio/hugo/commit/d000cf605091c6999b72d6c632752289bc680223) [@bep](https://github.com/bep) 
       +* Add `strings.TrimLeft` and `TrimRight` [7674ad73](https://github.com/gohugoio/hugo/commit/7674ad73825c61eecc4003475fe0577f225fe579) [@moorereason](https://github.com/moorereason) 
       +* compare, hugolib, tpl: Add `Eqer` interface [08f48b91](https://github.com/gohugoio/hugo/commit/08f48b91d68d3002b887ddf737456ff0cc4e786d) [@bep](https://github.com/bep) [#3807](https://github.com/gohugoio/hugo/issues/3807)
       +* Only strip p tag in `markdownify` if only one paragraph [33ae10b6](https://github.com/gohugoio/hugo/commit/33ae10b6ade67cd9618970121d7de5fd2ce7d781) [@bep](https://github.com/bep) [#3040](https://github.com/gohugoio/hugo/issues/3040)
       +* Cleanup `strings.TrimPrefix` and `TrimSuffix` [29a2da05](https://github.com/gohugoio/hugo/commit/29a2da0593b081cdd61b93c6328af2c9ea4eb20f) [@moorereason](https://github.com/moorereason) 
       +
       +### Output
       +
       +* Improve the base template (aka `baseof.html`) identification [0019ce00](https://github.com/gohugoio/hugo/commit/0019ce002449d671a20a69406da37b10977f9493) [@bep](https://github.com/bep) 
       +
       +### Core
       +
       +* Implement "related content" [3b4f17bb](https://github.com/gohugoio/hugo/commit/3b4f17bbc9ff789faa581ac278ad109d1ac5b816) [@bep](https://github.com/bep) [#98](https://github.com/gohugoio/hugo/issues/98)
       +* Add `Page.Equals` [f0f49ed9](https://github.com/gohugoio/hugo/commit/f0f49ed9b0c9b4545a45c95d56340fcbf4aafbef) [@bep](https://github.com/bep) 
       +* Rewrite `replaceDivider` to reduce memory allocation [71ae9b45](https://github.com/gohugoio/hugo/commit/71ae9b4533083be185c5314c9c5b273cc3bd07bd) [@bep](https://github.com/bep) 
       +
       +
       +### Other
       +
       +* Set up Hugo release flow on `CircleCI` [d2249c50](https://github.com/gohugoio/hugo/commit/d2249c50991ba7b00b092aca6e315ca1a4de75a1) [@bep](https://github.com/bep) [#3779](https://github.com/gohugoio/hugo/issues/3779)
       +* Maintain the scroll position if possible [7231d5a8](https://github.com/gohugoio/hugo/commit/7231d5a829f8d97336a2120afde1260db6ee6541) [@yihui](https://github.com/yihui) [#3824](https://github.com/gohugoio/hugo/issues/3824)
       +* Add an `iFrame` title to the `YouTube` shortcode [919bc921](https://github.com/gohugoio/hugo/commit/919bc9210a69c801c7304c0b529df93d1dca27aa) [@nraboy](https://github.com/nraboy) 
       +* Remove the theme submodule from /docs [ea2cc26b](https://github.com/gohugoio/hugo/commit/ea2cc26b390476f1c605405604f8c92afd09b6ee) [@bep](https://github.com/bep) [#3791](https://github.com/gohugoio/hugo/issues/3791)
       +* Add support for multiple config files via `--config a.toml,b.toml,c.toml` [0f9f73cc](https://github.com/gohugoio/hugo/commit/0f9f73cce5c3f1f05be20bcf1d23b2332623d7f9) [@jgielstra](https://github.com/jgielstra) 
       +* Render task list item inside `label` for correct accessibility [c8257f8b](https://github.com/gohugoio/hugo/commit/c8257f8b726478ca70dc8984cdcc17b31e4bdc0c) [@danieka](https://github.com/danieka) [#3303](https://github.com/gohugoio/hugo/issues/3303)
       +* Normalize `UniqueID` between Windows & Linux [0abdeeef](https://github.com/gohugoio/hugo/commit/0abdeeef6740a3cbba0db95374853d040f2022b8) [@Shywim](https://github.com/Shywim) 
       +
       +
       +## Fixes
       +
       +### Output
       +
       +* Fix taxonomy term base template lookup [f88fe312](https://github.com/gohugoio/hugo/commit/f88fe312cb35f7de1615c095edd2f898303dd23b) [@bep](https://github.com/bep) [#3856](https://github.com/gohugoio/hugo/issues/3856)
       +* Fix `published` front matter handling [202510fd](https://github.com/gohugoio/hugo/commit/202510fdc92d52a20baeaa7edb1091f6882bd95f) [@bep](https://github.com/bep) [#3867](https://github.com/gohugoio/hugo/issues/3867)
       +
       +
       +
       +
       +
       +
       +
       +
 (DIR) diff --git a/docs/content/news/0.27.1-relnotes.md b/docs/content/news/0.27.1-relnotes.md
       @@ -0,0 +1,21 @@
       +
       +---
       +date: 2017-09-13
       +title: "0.27.1: One bugfix"
       +description: "Hugo 0.27.1 fixes an issue introduced in Go 1.9 with HTML escaping of shortcodes in multi output sites."
       +categories: ["Releases"]
       +images:
       +- images/blog/hugo-bug-poster.png
       +---
       +
       +        
       +
       +This fixes a regression introduced in [Go 1.9](https://github.com/golang/go/issues/21844) which lead to HTML in shortcodes in multi output Hugo sites being wrongly escaped in some cases.
       +
       +* Fix escaped HTML Go 1.9 multioutput issue (#3880) [2d613dd9](https://github.com/gohugoio/hugo/commit/2d613dd905bb8eeb8af57e30ddd749a0f04fbd3c) [@bep](https://github.com/bep) [#3876](https://github.com/gohugoio/hugo/issues/3876)
       +
       +* Bump to Go 1.9 in the Snap build [642ba6ca](https://github.com/gohugoio/hugo/commit/642ba6cab24c558b16378178fe829cbc45845424) [@bep](https://github.com/bep) 
       +
       +
       +
       +
 (DIR) diff --git a/docs/content/news/http2-server-push-in-hugo.md b/docs/content/news/http2-server-push-in-hugo.md
       @@ -4,7 +4,7 @@ date: 2017-07-24T18:36:00+02:00
        description: >
            As every page in Hugo can be output to multiple formats, it is easy to create Netlify's _redirects and _headers files on the fly.
        categories: [blog]
       -#tags: []
       +keywords: []
        slug: "http2-server-push-in-hugo"
        aliases: []
        author: bep
 (DIR) diff --git a/docs/content/templates/404.md b/docs/content/templates/404.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-31
        categories: [templates]
       -#tags: [404, page not found]
       +keywords: [404, page not found]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/_index.md b/docs/content/templates/_index.md
       @@ -11,7 +11,7 @@ menu:
            weight: 01
        weight: 01        #rem
        categories: [templates]
       -#tags: []
       +keywords: []
        draft: false
        aliases: [/templates/overview/,/templates/content]
        toc: false
 (DIR) diff --git a/docs/content/templates/alternatives.md b/docs/content/templates/alternatives.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-20
        categories: [templates]
       -#tags: [amber,ace,templating languages]
       +keywords: [amber,ace,templating languages]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/base.md b/docs/content/templates/base.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates,fundamentals]
       -#tags: [blocks,base]
       +keywords: [blocks,base]
        menu:
          docs:
            parent: "templates"
       @@ -21,6 +21,8 @@ toc: true
        
        The `block` keyword allows you to define the outer shell of your pages' one or more master template(s) and then fill in or override portions as necessary.
        
       +{{< youtube QVOMCYitLEc >}}
       +
        ## Base Template Lookup Order
        
        The [lookup order][lookup] for base templates is as follows:
 (DIR) diff --git a/docs/content/templates/data-templates.md b/docs/content/templates/data-templates.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-03-12
        categories: [templates]
       -#tags: [data,dynamic,csv,json,toml,yaml]
       +keywords: [data,dynamic,csv,json,toml,yaml]
        menu:
          docs:
            parent: "templates"
       @@ -22,6 +22,8 @@ toc: true
        
        Hugo supports loading data from YAML, JSON, and TOML files located in the `data` directory in the root of your Hugo project.
        
       +{{< youtube FyPgSuwIMWQ >}}
       +
        ## The Data Folder
        
        The `data` folder is where you can store additional data for Hugo to use when generating your site. Data files aren't used to generate standalone pages; rather, they're meant to be supplemental to content files. This feature can extend the content in case your front matter fields grow out of control. Or perhaps you want to show a larger dataset in a template (see example below). In both cases, it's a good idea to outsource the data in their own files.
 (DIR) diff --git a/docs/content/templates/files.md b/docs/content/templates/files.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [files,directories]
       +keywords: [files,directories]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/homepage.md b/docs/content/templates/homepage.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [homepage]
       +keywords: [homepage]
        menu:
          docs:
            parent: "templates"
       @@ -24,6 +24,8 @@ Homepage is a `Page` and therefore has all the [page variables][pagevars] and [s
        The homepage template is the *only* required template for building a site and therefore useful when bootstrapping a new site and template. It is also the only required template if you are developing a single-page website.
        {{% /note %}}
        
       +{{< youtube ut1xtRZ1QOA >}}
       +
        ## Homepage Template Lookup Order
        
        The [lookup order][lookup] for the homepage template is as follows:
 (DIR) diff --git a/docs/content/templates/internal.md b/docs/content/templates/internal.md
       @@ -6,7 +6,7 @@ date: 2017-03-06
        publishdate: 2017-03-06
        lastmod: 2017-03-06
        categories: [templates]
       -#tags: [internal, analytics,]
       +keywords: [internal, analytics,]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/introduction.md b/docs/content/templates/introduction.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-25
        categories: [templates,fundamentals]
       -#tags: [go]
       +keywords: [go]
        menu:
          docs:
            parent: "templates"
       @@ -25,6 +25,8 @@ The following is only a primer on Go templates. For an in-depth look into Go tem
        
        Go templates provide an extremely simple template language that adheres to the belief that only the most basic of logic belongs in the template or view layer.
        
       +{{< youtube gnJbPO-GFIw >}}
       +
        ## Basic Syntax
        
        Golang templates are HTML files with the addition of [variables][variables] and [functions][functions]. Golang template variables and functions are accessible within `{{ }}`.
 (DIR) diff --git a/docs/content/templates/lists.md b/docs/content/templates/lists.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [lists,sections,rss,taxonomies,terms]
       +keywords: [lists,sections,rss,taxonomies,terms]
        menu:
          docs:
            parent: "templates"
       @@ -20,6 +20,8 @@ toc: true
        
        ## What is a List Page Template?
        
       +{{< youtube 8b2YTSMdMps >}}
       +
        A list page template is a template used to render multiple pieces of content in a single HTML page. The exception to this rule is the homepage, which is still a list but has its own [dedicated template][homepage].
        
        Hugo uses the term *list* in its truest sense; i.e. a sequential arrangement of material, especially in alphabetical or numerical order. Hugo uses list templates on any output HTML page where content is traditionally listed:
 (DIR) diff --git a/docs/content/templates/lookup-order.md b/docs/content/templates/lookup-order.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-05-25
        categories: [templates,fundamentals]
       -#tags: [lookup]
       +keywords: [lookup]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/menu-templates.md b/docs/content/templates/menu-templates.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [lists,sections,menus]
       +keywords: [lists,sections,menus]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/ordering-and-grouping.md b/docs/content/templates/ordering-and-grouping.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: []
       +keywords: []
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/output-formats.md b/docs/content/templates/output-formats.md
       @@ -6,7 +6,7 @@ date: 2017-03-22
        publishdate: 2017-03-22
        lastmod: 2017-03-22
        categories: [templates]
       -#tags: ["amp","outputs","rss"]
       +keywords: ["amp","outputs","rss"]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/pagination.md b/docs/content/templates/pagination.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [lists,sections,pagination]
       +keywords: [lists,sections,pagination]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/partials.md b/docs/content/templates/partials.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [lists,sections,partials]
       +keywords: [lists,sections,partials]
        menu:
          docs:
            parent: "templates"
       @@ -18,6 +18,8 @@ aliases: [/templates/partial/,/layout/chrome/,/extras/analytics/]
        toc: true
        ---
        
       +{{< youtube pjS4pOLyB7c >}}
       +
        ## Partial Template Lookup Order
        
        Partial templates---like [single page templates][singletemps] and [list page templates][listtemps]---have a specific [lookup order][]. However, partials are simpler in that Hugo will only check in two places:
 (DIR) diff --git a/docs/content/templates/robots.md b/docs/content/templates/robots.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [robots,search engines]
       +keywords: [robots,search engines]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/rss.md b/docs/content/templates/rss.md
       @@ -5,7 +5,7 @@ description: Hugo ships with its own RSS 2.0 template that requires almost no co
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [rss, xml]
       +keywords: [rss, xml]
        categories: [templates]
        menu:
          docs:
 (DIR) diff --git a/docs/content/templates/section-templates.md b/docs/content/templates/section-templates.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [lists,sections]
       +keywords: [lists,sections]
        menu:
          docs:
            parent: "templates"
       @@ -35,6 +35,8 @@ The [lookup order][lookup] for section templates is as follows:
        7. `/themes/<THEME>/layouts/_default/section.html`
        8. `/themes/<THEME>/layouts/_default/list.html`
        
       +{{< youtube jrMClsB3VsY >}}
       +
        ## `.Site.GetPage` with Sections
        
        Every `Page` in Hugo has a `.Kind` attribute. `Kind` can easily be combined with the [`where` function][where] in your templates to create kind-specific lists of content. This method is ideal for creating lists, but there are times where you may want to fetch just the index page of a single section via the section's path.
 (DIR) diff --git a/docs/content/templates/shortcode-templates.md b/docs/content/templates/shortcode-templates.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [shortcodes]
       +keywords: [shortcodes]
        menu:
          docs:
            parent: "templates"
       @@ -28,6 +28,8 @@ Hugo also ships with built-in shortcodes for common use cases. (See [Content Man
        
        Hugo's built-in shortcodes cover many common, but not all, use cases. Luckily, Hugo provides the ability to easily create custom shortcodes to meet your website's needs.
        
       +{{< youtube Eu4zSaKOY4A >}}
       +
        ### File Placement
        
        To create a shortcode, place an HTML template in the `layouts/shortcodes` directory of your [source organization][]. Consider the file name carefully since the shortcode name will mirror that of the file but without the `.html` extension. For example, `layouts/shortcodes/myshortcode.html` will be called with either `{{</* myshortcode /*/>}}` or `{{%/* myshortcode /*/%}}` depending on the type of parameters you choose.
       @@ -105,7 +107,7 @@ The `.Params` variable in shortcodes contains the list parameters passed to shor
        `$.Page.Site.Params`
        : refers to global variables as defined in your [site's configuration file][config].
        
       -#### `.IsNameParams`
       +#### `.IsNamedParams`
        
        The `.IsNamedParams` variable checks whether the shortcode declaration uses named parameters and returns a boolean value.
        
 (DIR) diff --git a/docs/content/templates/single-page-templates.md b/docs/content/templates/single-page-templates.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-04-06
        categories: [templates]
       -#tags: [page]
       +keywords: [page]
        menu:
          docs:
            parent: "templates"
       @@ -35,6 +35,8 @@ Hugo assumes your content section and content type are the same unless you tell 
        9. `/themes/<THEME>/layouts/<SECTION>/single.html`
        10. `/themes/<THEME>/layouts/_default/single.html`
        
       +{{< youtube ZYQ5k0RQzmo >}}
       +
        ## Example Single Page Templates
        
        Content pages are of the type `page` and will therefore have all the [page variables][pagevars] and [site variables][] available to use in their templates.
 (DIR) diff --git a/docs/content/templates/sitemap-template.md b/docs/content/templates/sitemap-template.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [sitemap, xml]
       +keywords: [sitemap, xml]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/taxonomy-templates.md b/docs/content/templates/taxonomy-templates.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [taxonomies,metadata,front matter,terms]
       +keywords: [taxonomies,metadata,front matter,terms]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/template-debugging.md b/docs/content/templates/template-debugging.md
       @@ -7,7 +7,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [debugging,troubleshooting]
       +keywords: [debugging,troubleshooting]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/templates/views.md b/docs/content/templates/views.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [templates]
       -#tags: [views]
       +keywords: [views]
        menu:
          docs:
            parent: "templates"
 (DIR) diff --git a/docs/content/themes/_index.md b/docs/content/themes/_index.md
       @@ -12,7 +12,7 @@ menu:
        weight: 01
        sections_weight: 01
        categories: [themes]
       -#tags: [themes,introduction,overview]
       +keywords: [themes,introduction,overview]
        draft: false
        aliases: [/themes/overview/]
        toc: false
 (DIR) diff --git a/docs/content/themes/creating.md b/docs/content/themes/creating.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [themes]
       -#tags: [themes, source, organization, directories]
       +keywords: [themes, source, organization, directories]
        menu:
          docs:
            parent: "themes"
 (DIR) diff --git a/docs/content/themes/customizing.md b/docs/content/themes/customizing.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [themes]
       -#tags: [themes, source, organization, directories]
       +keywords: [themes, source, organization, directories]
        menu:
          docs:
            parent: "themes"
 (DIR) diff --git a/docs/content/themes/installing-and-using-themes.md b/docs/content/themes/installing-and-using-themes.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [themes]
       -#tags: [install, themes, source, organization, directories,usage]
       +keywords: [install, themes, source, organization, directories,usage]
        menu:
          docs:
            parent: "themes"
       @@ -30,6 +30,8 @@ Hugo currently doesn’t ship with a “default” theme. This decision is inten
        
        ## Install Themes
        
       +{{< youtube L34JL_3Jkyc >}}
       +
        The community-contributed themes featured on [themes.gohugo.io](//themes.gohugo.io/) are hosted in a [centralized GitHub repository][themesrepo]. The Hugo Themes Repo at <https://github.com/gohugoio/hugoThemes> is really a meta repository that contains pointers to a set of contributed themes.
        
        {{% warning "Get `git` First" %}}
 (DIR) diff --git a/docs/content/tools/_index.md b/docs/content/tools/_index.md
       @@ -6,7 +6,7 @@ date: 2016-12-05
        publishdate: 2016-12-05
        lastmod: 2017-02-26
        categories: [developer tools]
       -#tags: []
       +keywords: []
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/editors.md b/docs/content/tools/editors.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [developer tools]
       -#tags: [editor, plug-ins]
       +keywords: [editor, plug-ins]
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/frontends.md b/docs/content/tools/frontends.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [developer tools]
       -#tags: [frontend,gui]
       +keywords: [frontend,gui]
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/migrations.md b/docs/content/tools/migrations.md
       @@ -5,7 +5,7 @@ description: A list of community-developed tools for migrating from your existin
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [migrations,jekyll,wordpress,drupal,ghost,contentful]
       +keywords: [migrations,jekyll,wordpress,drupal,ghost,contentful]
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/other.md b/docs/content/tools/other.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [developer tools]
       -#tags: [frontend,gui]
       +keywords: [frontend,gui]
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/search.md b/docs/content/tools/search.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-26
        categories: [developer tools]
       -#tags: [search,tools]
       +keywords: [search,tools]
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/starter-kits.md b/docs/content/tools/starter-kits.md
       @@ -5,7 +5,7 @@ description: A list of community-developed projects designed to help you get up 
        date: 2017-02-22
        publishdate: 2017-02-01
        lastmod: 2017-02-22
       -#tags: [starters,assets,pipeline]
       +keywords: [starters,assets,pipeline]
        menu:
          docs:
            parent: "tools"
 (DIR) diff --git a/docs/content/tools/syntax-highlighting.md b/docs/content/tools/syntax-highlighting.md
       @@ -5,7 +5,7 @@ description: Hugo provides server-side syntax highlighting via Pygments and, lik
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [highlighting,pygments,code blocks,syntax]
       +keywords: [highlighting,pygments,code blocks,syntax]
        categories: [developer tools]
        menu:
          docs:
       @@ -103,7 +103,7 @@ The keywords in the `highlight` shortcode mirror those of Pygments from the comm
        
        It is also possible to add syntax highlighting with GitHub flavored code fences. To enable this, set the `PygmentsCodeFences` to `true` in Hugo's [configuration file](/getting-started/configuration/);
        
       -```
       +````
        ```
        <section id="main">
          <div>
       @@ -114,7 +114,7 @@ It is also possible to add syntax highlighting with GitHub flavored code fences.
          </div>
        </section>
        ```
       -```
       +````
        
        {{% note "Disclaimers on Pygments" %}}
        * Pygments is relatively slow and _causes a performance hit when building your site_, but Hugo has been designed to cache the results to disk.
 (DIR) diff --git a/docs/content/troubleshooting/accented-characters-in-urls.md b/docs/content/troubleshooting/accented-characters-in-urls.md
       @@ -5,7 +5,7 @@ description: If you're having trouble with special characters in your taxonomies
        date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
       -#tags: [urls,multilingual,special characters]
       +keywords: [urls,multilingual,special characters]
        categories: [troubleshooting]
        menu:
          docs:
 (DIR) diff --git a/docs/content/troubleshooting/build-performance.md b/docs/content/troubleshooting/build-performance.md
       @@ -5,7 +5,7 @@ description:
        date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-12
       -#tags: [performance, build]
       +keywords: [performance, build]
        categories: [troubleshooting]
        menu:
          docs:
 (DIR) diff --git a/docs/content/troubleshooting/eof-error.md b/docs/content/troubleshooting/eof-error.md
       @@ -9,7 +9,7 @@ categories: [troubleshooting]
        menu:
          docs:
            parent: "troubleshooting"
       -#tags: [eof, end of file, error, faqs]
       +keywords: [eof, end of file, error, faqs]
        draft: false
        weight:
        aliases: [/troubleshooting/strange-eof-error/]
 (DIR) diff --git a/docs/content/variables/_index.md b/docs/content/variables/_index.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [variables and params]
       -#tags: [variables,params,values,globals]
       +keywords: [variables,params,values,globals]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/files.md b/docs/content/variables/files.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [variables and params]
       -#tags: [files]
       +keywords: [files]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/git.md b/docs/content/variables/git.md
       @@ -6,7 +6,7 @@ date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-12
        categories: [variables and params]
       -#tags: [git]
       +keywords: [git]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/hugo.md b/docs/content/variables/hugo.md
       @@ -6,7 +6,7 @@ date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-12
        categories: [variables and params]
       -#tags: [hugo,generator]
       +keywords: [hugo,generator]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/menus.md b/docs/content/variables/menus.md
       @@ -6,7 +6,7 @@ date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-12
        categories: [variables and params]
       -#tags: [menus]
       +keywords: [menus]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/page.md b/docs/content/variables/page.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [variables and params]
       -#tags: [pages]
       +keywords: [pages]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/shortcodes.md b/docs/content/variables/shortcodes.md
       @@ -6,7 +6,7 @@ date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-12
        categories: [variables and params]
       -#tags: [shortcodes]
       +keywords: [shortcodes]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/site.md b/docs/content/variables/site.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [variables and params]
       -#tags: [global,site]
       +keywords: [global,site]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/sitemap.md b/docs/content/variables/sitemap.md
       @@ -6,7 +6,7 @@ date: 2017-03-12
        publishdate: 2017-03-12
        lastmod: 2017-03-12
        categories: [variables and params]
       -#tags: [sitemap]
       +keywords: [sitemap]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/content/variables/taxonomy.md b/docs/content/variables/taxonomy.md
       @@ -6,7 +6,7 @@ date: 2017-02-01
        publishdate: 2017-02-01
        lastmod: 2017-02-01
        categories: [variables and params]
       -#tags: [taxonomies,terms]
       +keywords: [taxonomies,terms]
        draft: false
        menu:
          docs:
 (DIR) diff --git a/docs/netlify.toml b/docs/netlify.toml
       @@ -3,15 +3,15 @@
          command = "hugo"
        
        [context.production.environment]
       -  HUGO_VERSION = "0.26"
       +  HUGO_VERSION = "0.27.1"
          HUGO_ENV = "production"
          HUGO_ENABLEGITINFO = "true"
        
        [context.deploy-preview.environment]
       -  HUGO_VERSION = "0.26"
       +  HUGO_VERSION = "0.27.1"
        
        [context.branch-deploy.environment]
       -  HUGO_VERSION = "0.26"
       +  HUGO_VERSION = "0.27.1"
        
        [context.next.environment]
          HUGO_BASEURL = "https://next--gohugoio.netlify.com/"
 (DIR) diff --git a/docs/static/images/blog/hugo-27-poster.png b/docs/static/images/blog/hugo-27-poster.png
       Binary files differ.
 (DIR) diff --git a/docs/static/images/blog/hugo-bug-poster.png b/docs/static/images/blog/hugo-bug-poster.png
       Binary files differ.
 (DIR) diff --git a/docs/static/images/hosting-and-deployment/hosting-on-keycdn/keycdn-pull-zone.png b/docs/static/images/hosting-and-deployment/hosting-on-keycdn/keycdn-pull-zone.png
       Binary files differ.
 (DIR) diff --git a/docs/static/images/hosting-and-deployment/hosting-on-keycdn/secret-api-key.png b/docs/static/images/hosting-and-deployment/hosting-on-keycdn/secret-api-key.png
       Binary files differ.
 (DIR) diff --git a/docs/static/images/hosting-and-deployment/hosting-on-keycdn/secret-zone-id.png b/docs/static/images/hosting-and-deployment/hosting-on-keycdn/secret-zone-id.png
       Binary files differ.
 (DIR) diff --git a/docs/themes/gohugoioTheme/layouts/_default/single.html b/docs/themes/gohugoioTheme/layouts/_default/single.html
       @@ -11,6 +11,7 @@
                  <div id="readout" class="fixed right-0 bottom-0">
                  </div>
                  {{ .Render "page" }}
       +          {{ partial "related.html" . }}
                </div>
              </div>
              <div class="order-0 w-20 dn db-l">
 (DIR) diff --git a/docs/themes/gohugoioTheme/layouts/partials/related.html b/docs/themes/gohugoioTheme/layouts/partials/related.html
       @@ -0,0 +1,9 @@
       +{{ $related := .Site.RegularPages.Related . | first 5 }}
       +{{ with $related }}
       +<h2>See Also</h2>
       +<ul>
       +        {{ range . }}
       +        <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
       +        {{ end }}
       +</ul>
       +{{ end }}
       +\ No newline at end of file