Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/gohugoio/hugo.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorBjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>2018-07-18 12:05:58 +0300
committerBjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com>2018-07-18 12:05:58 +0300
commit59ebc83d72b09d28d62d8600517c73a4ffe70c66 (patch)
tree1432d4fac5a6ff28ef815e6d6bb2ecb24b503c35
parentebe4d39f175f73e4f130972cb3d74ef0af5d5761 (diff)
parentb6b37a1f00f808f3c0d2715f65ca2d3091f36495 (diff)
Merge commit 'b6b37a1f00f808f3c0d2715f65ca2d3091f36495'
-rw-r--r--docs/config.toml1
-rw-r--r--docs/content/en/about/new-in-032/index.md2
-rw-r--r--docs/content/en/about/what-is-hugo.md18
-rw-r--r--docs/content/en/content-management/authors.md2
-rw-r--r--docs/content/en/content-management/menus.md45
-rw-r--r--docs/content/en/content-management/related.md2
-rw-r--r--docs/content/en/content-management/shortcodes.md4
-rw-r--r--docs/content/en/content-management/static-files.md52
-rw-r--r--docs/content/en/content-management/summaries.md6
-rw-r--r--docs/content/en/content-management/syntax-highlighting.md4
-rw-r--r--docs/content/en/functions/after.md4
-rw-r--r--docs/content/en/functions/first.md3
-rw-r--r--docs/content/en/functions/hasmenucurrent.md12
-rw-r--r--docs/content/en/functions/ismenucurrent.md12
-rw-r--r--docs/content/en/functions/last.md3
-rw-r--r--docs/content/en/functions/render.md2
-rw-r--r--docs/content/en/functions/scratch.md12
-rw-r--r--docs/content/en/functions/where.md10
-rw-r--r--docs/content/en/getting-started/configuration.md3
-rw-r--r--docs/content/en/getting-started/installing.md13
-rw-r--r--docs/content/en/news/0.30-relnotes/index.md2
-rw-r--r--docs/content/en/news/0.43-relnotes/featured-hugo-43-poster.pngbin0 -> 78299 bytes
-rw-r--r--docs/content/en/news/0.43-relnotes/index.md4
-rw-r--r--docs/content/en/news/0.44-relnotes/featured-hugo-44-poster.pngbin0 -> 77631 bytes
-rw-r--r--docs/content/en/news/0.44-relnotes/index.md4
-rw-r--r--docs/content/en/news/lets-celebrate-hugos-5th-birthday/index.md16
-rw-r--r--docs/content/en/readfiles/menuvars.md39
-rw-r--r--docs/content/en/templates/404.md2
-rw-r--r--docs/content/en/templates/base.md2
-rw-r--r--docs/content/en/templates/homepage.md8
-rw-r--r--docs/content/en/templates/introduction.md2
-rw-r--r--docs/content/en/templates/lists.md60
-rw-r--r--docs/content/en/templates/ordering-and-grouping.md56
-rw-r--r--docs/content/en/templates/pagination.md8
-rw-r--r--docs/content/en/templates/robots.md2
-rw-r--r--docs/content/en/templates/rss.md2
-rw-r--r--docs/content/en/templates/sitemap-template.md4
-rw-r--r--docs/content/en/templates/taxonomy-templates.md4
-rw-r--r--docs/content/en/templates/template-debugging.md8
-rw-r--r--docs/content/en/templates/views.md2
-rw-r--r--docs/content/en/variables/menus.md117
-rw-r--r--docs/content/en/variables/page.md4
-rw-r--r--docs/content/zh/templates/base.md2
-rw-r--r--docs/netlify.toml8
-rw-r--r--docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_480x0_resize_catmullrom_2.pngbin0 -> 36338 bytes
-rw-r--r--docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_640x0_resize_catmullrom_2.pngbin0 -> 57591 bytes
-rw-r--r--docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_480x0_resize_catmullrom_2.pngbin0 -> 35977 bytes
-rw-r--r--docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_640x0_resize_catmullrom_2.pngbin0 -> 57252 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/contribute/development/accept-cla.pngbin33286 -> 33286 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/contribute/development/ci-errors.pngbin124801 -> 124801 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/contribute/development/copy-remote-url.pngbin10570 -> 10570 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/contribute/development/forking-a-repository.pngbin6759 -> 6759 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/contribute/development/open-pull-request.pngbin59990 -> 59990 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-a-github-pages-step.pngbin49765 -> 49765 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-the-project-to-github.pngbin67637 -> 67637 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/and-we-ve-got-an-app.pngbin45696 -> 45696 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/configure-the-deploy-step.pngbin91874 -> 91874 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/creating-a-basic-hugo-site.pngbin34409 -> 34409 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/public-or-not.pngbin16659 -> 16659 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/using-hugo-build.pngbin14897 -> 14897 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-access.pngbin60815 -> 60815 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-add-app.pngbin46966 -> 46966 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-git-connections.pngbin27003 -> 27003 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-search.pngbin31555 -> 31555 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-owner.pngbin19496 -> 19496 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-repository.pngbin30944 -> 30944 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/deployment-with-wercker/werckeryml.pngbin52440 -> 52440 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.pngbin37585 -> 37585 bytes
-rw-r--r--[-rwxr-xr-x]docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.pngbin24689 -> 24689 bytes
-rw-r--r--docs/themes/gohugoioTheme/README.md8
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/404.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/_default/baseof.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/_default/list.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/_default/single.html0
-rw-r--r--docs/themes/gohugoioTheme/layouts/_default/taxonomy.html2
-rw-r--r--docs/themes/gohugoioTheme/layouts/_default/terms.html2
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/boxes-small-news.html2
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/icon-link.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/manifest.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/nav-links.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/nav-top.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/page-edit.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/site-footer.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/site-nav.html0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/apple.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/facebook.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/freebsd.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/github-squared.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/gopher-front.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/gopher-side_path.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/instagram.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/link-ext.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/md.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/partials/svg/windows.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/layouts/robots.txt0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/css/_columns.css0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/css/_tachyons.css0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/css/_variables.css0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/css/main.css0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/css/postcss.config.js0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/js/main.js0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/package.json0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/readme.md0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/src/webpack.config.js0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/static/images/gopher-side_color.svg0
-rw-r--r--[-rwxr-xr-x]docs/themes/gohugoioTheme/static/images/homepage-screenshot-hugo-themes.jpgbin33701 -> 33701 bytes
106 files changed, 304 insertions, 276 deletions
diff --git a/docs/config.toml b/docs/config.toml
index 63d9cef15..12398be26 100644
--- a/docs/config.toml
+++ b/docs/config.toml
@@ -34,7 +34,6 @@ section = [ "HTML", "RSS"]
[mediaTypes]
[mediaTypes."text/netlify"]
-suffix = ""
delimiter = ""
[outputFormats]
diff --git a/docs/content/en/about/new-in-032/index.md b/docs/content/en/about/new-in-032/index.md
index b8ca6430e..5ae688fc6 100644
--- a/docs/content/en/about/new-in-032/index.md
+++ b/docs/content/en/about/new-in-032/index.md
@@ -24,7 +24,7 @@ This documentation belongs in other places in this documentation site, but is pu
Also see this demo project from [bep](https://github.com/bep/), the clever Norwegian behind these new features:
-* http://hugotest.bep.is/
+* https://temp.bep.is/hugotest/
* https://github.com/bep/hugotest (source)
## Page Resources
diff --git a/docs/content/en/about/what-is-hugo.md b/docs/content/en/about/what-is-hugo.md
index 2c7339f7c..de7344866 100644
--- a/docs/content/en/about/what-is-hugo.md
+++ b/docs/content/en/about/what-is-hugo.md
@@ -43,27 +43,23 @@ Hugo is for people building a blog, a company site, a portfolio site, documentat
[@spf13]: https://twitter.com/@spf13
[Aerobatic]: https://www.aerobatic.com/
-[Amazon S3]: http://aws.amazon.com/s3/
+[Amazon S3]: https://aws.amazon.com/s3/
[Azure]: https://blogs.msdn.microsoft.com/acoat/2016/01/28/publish-a-static-web-site-using-azure-web-apps/
-[CloudFront]: http://aws.amazon.com/cloudfront/ "Amazon CloudFront"
-[contributing to it]: https://github.com/gohugoio/hugo
-[DreamHost]: http://www.dreamhost.com/
+[CloudFront]: https://aws.amazon.com/cloudfront/ "Amazon CloudFront"
+[DreamHost]: https://www.dreamhost.com/
[Firebase]: https://firebase.google.com/docs/hosting/ "Firebase static hosting"
[GitHub Pages]: https://pages.github.com/
[GitLab Pages]: https://about.gitlab.com/features/pages/
[Go language]: https://golang.org/
[GoDaddy]: https://www.godaddy.com/ "Godaddy.com Hosting"
-[Google Cloud Storage]: http://cloud.google.com/storage/
+[Google Cloud Storage]: https://cloud.google.com/storage/
[Heroku]: https://www.heroku.com/
-[Jekyll]: http://jekyllrb.com/
[Jekyll]: https://jekyllrb.com/
[Middleman]: https://middlemanapp.com/
-[Middleman]: https://middlemanapp.com/
-[Nanoc]: http://nanoc.ws/
[Nanoc]: https://nanoc.ws/
[Netlify]: https://netlify.com
-[rackspace]: https://www.rackspace.com/cloud/files
-[static site generator]: /about/benefits/
[Rackspace]: https://www.rackspace.com/cloud/files
-[static site generator]: /about/benefits/
[Surge]: https://surge.sh
+[contributing to it]: https://github.com/gohugoio/hugo
+[rackspace]: https://www.rackspace.com/cloud/files
+[static site generator]: /about/benefits/
diff --git a/docs/content/en/content-management/authors.md b/docs/content/en/content-management/authors.md
index afc94fa62..530557ac0 100644
--- a/docs/content/en/content-management/authors.md
+++ b/docs/content/en/content-management/authors.md
@@ -170,7 +170,7 @@ Last but not least, we have to create the second list that contains all publicat
The layout for this page can be defined in the template `layouts/taxonomy/author.html`.
{{< code file="layouts/taxonomy/author.html" download="author.html" >}}
-{{ range .Data.Pages }}
+{{ range .Pages }}
<h2><a href="{{ .Permalink }}">{{ .Title }}</a></h2>
<span>written by {{ .Author.DisplayName }}</span>
{{ .Summary }}
diff --git a/docs/content/en/content-management/menus.md b/docs/content/en/content-management/menus.md
index c2eadf50f..4278b03be 100644
--- a/docs/content/en/content-management/menus.md
+++ b/docs/content/en/content-management/menus.md
@@ -36,47 +36,7 @@ A **menu** is a named array of menu entries accessible by name via the [`.Site.M
If you make use of the [multilingual feature](/content-management/multilingual/), you can define language-independent menus.
{{% /note %}}
-A menu entry has the following properties (i.e., variables) available to it:
-
-`.URL`
-: string
-
-`.Name`
-: string
-
-`.Menu`
-: string
-
-`.Identifier`
-: string
-
-`.Pre`
-: template.HTML
-
-`.Post`
-: template.HTML
-
-`.Weight`
-: int
-
-`.Parent`
-: string
-
-`.Children`
-: Menu
-
-Note that menus also have the following functions available as well:
-
-`.HasChildren`
-: boolean
-
-Additionally, there are some relevant functions available to menus on a page:
-
-`.IsMenuCurrent`
-: (menu string, menuEntry *MenuEntry ) boolean
-
-`.HasMenuCurrent`
-: (menu string, menuEntry *MenuEntry) boolean
+See the [Menu Entry Properties][me-props] for all the variables and functions related to a menu entry.
## Add content to menus
@@ -139,7 +99,7 @@ The URLs must be relative to the context root. If the `baseURL` is `https://exam
{{% /note %}}
## Nesting
-
+
All nesting of content is done via the `parent` field.
The parent of an entry should be the identifier of another entry. The identifier should be unique (within a menu).
@@ -159,3 +119,4 @@ See [Menu Templates](/templates/menu-templates/) for information on how to rende
[config]: /getting-started/configuration/
[multilingual]: /content-management/multilingual/
[sitevars]: /variables/
+[me-props]: /variables/menus/
diff --git a/docs/content/en/content-management/related.md b/docs/content/en/content-management/related.md
index 5755676c3..9a4c77d40 100644
--- a/docs/content/en/content-management/related.md
+++ b/docs/content/en/content-management/related.md
@@ -39,7 +39,7 @@ To list up to 5 related pages is as simple as including something similar to thi
Read [this blog article](https://regisphilibert.com/blog/2018/04/hugo-optmized-relashionships-with-related-content/) for a great explanation of more advanced usage of this feature.
{{% /note %}}
-The full set of methods available on the page lists can bee seen in this Go interface:
+The full set of methods available on the page lists can be seen in this Go interface:
```go
// A PageGenealogist finds related pages in a page collection. This interface is implemented
diff --git a/docs/content/en/content-management/shortcodes.md b/docs/content/en/content-management/shortcodes.md
index 0116078f4..35305764c 100644
--- a/docs/content/en/content-management/shortcodes.md
+++ b/docs/content/en/content-management/shortcodes.md
@@ -178,7 +178,7 @@ This shortcode will convert the source code provided into syntax-highlighted HTM
<section id="main">
<div>
<h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
@@ -194,7 +194,7 @@ The `highlight` shortcode example above would produce the following HTML when th
<span style="color: #f92672">&lt;section</span> <span style="color: #a6e22e">id=</span><span style="color: #e6db74">&quot;main&quot;</span><span style="color: #f92672">&gt;</span>
<span style="color: #f92672">&lt;div&gt;</span>
<span style="color: #f92672">&lt;h1</span> <span style="color: #a6e22e">id=</span><span style="color: #e6db74">&quot;title&quot;</span><span style="color: #f92672">&gt;</span>{{ .Title }}<span style="color: #f92672">&lt;/h1&gt;</span>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render &quot;summary&quot;}}
{{ end }}
<span style="color: #f92672">&lt;/div&gt;</span>
diff --git a/docs/content/en/content-management/static-files.md b/docs/content/en/content-management/static-files.md
index fe5ea77e0..8967f5983 100644
--- a/docs/content/en/content-management/static-files.md
+++ b/docs/content/en/content-management/static-files.md
@@ -1,6 +1,6 @@
---
title: Static Files
-description: "The `static` folder is where you place all your **static files**."
+description: "Files that get served **statically** (as-is, no modification) on the site root."
date: 2017-11-18
categories: [content management]
keywords: [source, directories]
@@ -13,36 +13,58 @@ aliases: [/static-files]
toc: true
---
-The `static` folder is where you place all your **static files**, e.g. stylesheets, JavaScript, images etc.
+By default, the `static/` directory in the site project is used for
+all **static files** (e.g. stylesheets, JavaScript, images).
-You can set the name of the static folder to use in your configuration file. From **Hugo 0.31** you can configure as many static directories as you need. All the files in all the static directories will form a union filesystem.
+Hugo can be configured to look into a different directory, or even
+**multiple directories** for such static files by configuring the
+`staticDir` parameter in the [site config][]. All the files in all the
+static directories will form a union filesystem.
-Example:
+This union filesystem will be served from your site root. So a file
+`<SITE PROJECT>/static/me.png` will be accessible as
+`<MY_BASEURL>/me.png`.
+
+Here's an example of setting `staticDir` and `staticDir2` for a
+multi-language site:
{{< code-toggle copy="false" file="config" >}}
staticDir = ["static1", "static2"]
-[languages]
-[languages.no]
-staticDir = ["staticDir_override", "static_no"]
-baseURL = "https://example.no"
-languageName = "Norsk"
-weight = 1
-title = "På norsk"
+[languages]
[languages.en]
staticDir2 = "static_en"
baseURL = "https://example.com"
languageName = "English"
weight = 2
title = "In English"
+[languages.no]
+staticDir = ["staticDir_override", "static_no"]
+baseURL = "https://example.no"
+languageName = "Norsk"
+weight = 1
+title = "På norsk"
{{</ code-toggle >}}
In the above, with no theme used:
-* The English site will get its static files as a union of "static1", "static2" and "static_en". On file duplicates, the right-most version will win.
-* The Norwegian site will get its static files as a union of "staticDir_override" and "static_no".
+- The English site will get its static files as a union of "static1",
+ "static2" and "static_en". On file duplicates, the right-most
+ version will win.
+- The Norwegian site will get its static files as a union of
+ "staticDir_override" and "static_no".
+
+Note 1
+: The **2** (can be a number between 0 and 10) in `staticDir2` is
+ added to tell Hugo that you want to **add** this directory to the
+ global set of static directories defined using `staticDir`. Using
+ `staticDir` on the language level would replace the global value (as
+ can be seen in the Norwegian site case).
-**Note:** The `2` `static2` (can be a number between 0 and 10) is added to tell Hugo that you want to **add** this directory to the global set of static directories. Using `staticDir` on the language level would replace the global value.
+Note 2
+: The example above is a [multihost setup][]. In a regular setup, all
+ the static directories will be available to all sites.
-**Note:** The example above is a [multihost setup](/content-management/multilingual/#configure-multilingual-multihost). In a regular setup, all the static directories will be available to all sites.
+[site config]: /getting-started/configuration/#all-configuration-settings
+[multihost setup]: /content-management/multilingual/#configure-multilingual-multihost
diff --git a/docs/content/en/content-management/summaries.md b/docs/content/en/content-management/summaries.md
index 1c341400e..0f8939377 100644
--- a/docs/content/en/content-management/summaries.md
+++ b/docs/content/en/content-management/summaries.md
@@ -1,7 +1,7 @@
---
title: Content Summaries
linktitle: Summaries
-description: Hugo generates summaries of your content.
+description: Hugo generates summaries of your content.
date: 2017-01-10
publishdate: 2017-01-10
lastmod: 2017-01-10
@@ -57,7 +57,7 @@ Be careful to enter <code>&#60;&#33;&#45;&#45;more&#45;&#45;&#62;</code> exactly
You can show content summaries with the following code. You could use the following snippet, for example, in a [section template][].
{{< code file="page-list-with-summaries.html" >}}
-{{ range first 10 .Data.Pages }}
+{{ range first 10 .Pages }}
<article>
<!-- this <div> includes the title summary -->
<div>
@@ -78,4 +78,4 @@ Note how the `.Truncated` boolean valuable may be used to hide the "Read More...
[org]: /content-management/formats/
[pagevariables]: /variables/page/
-[section template]: /templates/section-templates/ \ No newline at end of file
+[section template]: /templates/section-templates/
diff --git a/docs/content/en/content-management/syntax-highlighting.md b/docs/content/en/content-management/syntax-highlighting.md
index 4576624d0..841ecbd3d 100644
--- a/docs/content/en/content-management/syntax-highlighting.md
+++ b/docs/content/en/content-management/syntax-highlighting.md
@@ -134,7 +134,7 @@ Highlighting is carried out via the [built-in shortcode](/content-management/sho
<section id="main">
<div>
<h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
@@ -157,7 +157,7 @@ It is also possible to add syntax highlighting with GitHub flavored code fences.
<section id="main">
<div>
<h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
diff --git a/docs/content/en/functions/after.md b/docs/content/en/functions/after.md
index f01ba1436..d627f792a 100644
--- a/docs/content/en/functions/after.md
+++ b/docs/content/en/functions/after.md
@@ -39,7 +39,7 @@ You can use `after` in combination with the [`first` function][] and Hugo's [pow
{{ define "main" }}
<section class="row featured-article">
<h2>Featured Article</h2>
- {{ range first 1 .Data.Pages.ByPublishDate.Reverse }}
+ {{ range first 1 .Pages.ByPublishDate.Reverse }}
<header>
<h3><a href="{{.Permalink}}">{{.Title}}</a></h3>
</header>
@@ -48,7 +48,7 @@ You can use `after` in combination with the [`first` function][] and Hugo's [pow
</section>
<div class="row recent-articles">
<h2>Recent Articles</h2>
- {{ range first 3 (after 1 .Data.Pages.ByPublishDate.Reverse) }}
+ {{ range first 3 (after 1 .Pages.ByPublishDate.Reverse) }}
<section class="recent-article">
<header>
<h3><a href="{{.Permalink}}">{{.Title}}</a></h3>
diff --git a/docs/content/en/functions/first.md b/docs/content/en/functions/first.md
index 29ba3ac1c..464dfa671 100644
--- a/docs/content/en/functions/first.md
+++ b/docs/content/en/functions/first.md
@@ -21,8 +21,7 @@ aliases: []
```
-{{ range first 10 .Data.Pages }}
+{{ range first 10 .Pages }}
{{ .Render "summary" }}
{{ end }}
```
-
diff --git a/docs/content/en/functions/hasmenucurrent.md b/docs/content/en/functions/hasmenucurrent.md
index eac41103e..c7b8eb7a9 100644
--- a/docs/content/en/functions/hasmenucurrent.md
+++ b/docs/content/en/functions/hasmenucurrent.md
@@ -10,14 +10,18 @@ menu:
docs:
parent: "functions"
keywords: [menus]
-signature: ["HasMenuCurrent"]
+signature: ["PAGE.HasMenuCurrent MENU MENUENTRY"]
workson: [menus]
hugoversion:
-relatedfuncs: []
+relatedfuncs: ["IsMenuCurrent"]
deprecated: false
toc: false
-draft: true
+draft: false
aliases: []
---
-Used in [menu templates](/templates/menu-templates/).
+`.HasMenuCurrent` is a method in `Page` object returning a _boolean_ value. It
+returns `true` if the PAGE is the same object as the `.Page` in one of the
+**children menu entries** under MENUENTRY in a given MENU.
+
+You can find its example use in [menu templates](/templates/menu-templates/).
diff --git a/docs/content/en/functions/ismenucurrent.md b/docs/content/en/functions/ismenucurrent.md
index 647dcdcf0..66c7197a2 100644
--- a/docs/content/en/functions/ismenucurrent.md
+++ b/docs/content/en/functions/ismenucurrent.md
@@ -10,14 +10,18 @@ menu:
docs:
parent: "functions"
keywords: [menus]
-signature: ["IsMenuCurrent"]
+signature: ["PAGE.IsMenuCurrent MENU MENUENTRY"]
workson: [menus]
hugoversion:
-relatedfuncs: []
+relatedfuncs: ["HasMenuCurrent"]
deprecated: false
-draft: true
+draft: false
aliases: []
needsexample: true
---
-Used in [menu templates](/templates/menu-templates/).
+`.IsMenuCurrent` is a method in `Page` object returning a _boolean_ value. It
+returns `true` if the PAGE is the same object as the `.Page` in MENUENTRY in a
+given MENU.
+
+You can find its example use in [menu templates](/templates/menu-templates/).
diff --git a/docs/content/en/functions/last.md b/docs/content/en/functions/last.md
index ea633837b..f992b980a 100644
--- a/docs/content/en/functions/last.md
+++ b/docs/content/en/functions/last.md
@@ -23,8 +23,7 @@ aliases: []
```
-{{ range last 10 .Data.Pages }}
+{{ range last 10 .Pages }}
{{ .Render "summary" }}
{{ end }}
```
-
diff --git a/docs/content/en/functions/render.md b/docs/content/en/functions/render.md
index a4abfa81d..c76af39fe 100644
--- a/docs/content/en/functions/render.md
+++ b/docs/content/en/functions/render.md
@@ -26,7 +26,7 @@ This function is only available when applied to a single piece of content within
This example could render a piece of content using the content view located at `/layouts/_default/summary.html`:
```
-{{ range .Data.Pages }}
+{{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
```
diff --git a/docs/content/en/functions/scratch.md b/docs/content/en/functions/scratch.md
index 93a1e426a..c0ecaca80 100644
--- a/docs/content/en/functions/scratch.md
+++ b/docs/content/en/functions/scratch.md
@@ -33,11 +33,19 @@ See [this Go issue](https://github.com/golang/go/issues/10608) for the main moti
For a detailed analysis of `.Scratch` and in context use cases, see this [post](https://regisphilibert.com/blog/2017/04/hugo-scratch-explained-variable/).
{{% /note %}}
-## Methods
+## Get a Scratch
-`Scratch` is added to both `Page` and `Shortcode` -- with following methods:
+From Hugo `0.43` you can also create a locally scoped `Scratch` by calling `newScratch`:
+
+```go-html-template
+$scratch := newScratch
+$scratch.Set "greeting" "Hello"
+```
+
+A `Scratch` is also added to both `Page` and `Shortcode`. `Sratch` have the following methods:
#### .Set
+
Set the given value to a given key
```go-html-template
diff --git a/docs/content/en/functions/where.md b/docs/content/en/functions/where.md
index eb3111215..9ad8daf2a 100644
--- a/docs/content/en/functions/where.md
+++ b/docs/content/en/functions/where.md
@@ -23,7 +23,7 @@ needsexample: true
`where` filters an array to only the elements containing a matching value for a given field.
```go-html-template
-{{ range where .Data.Pages "Section" "post" }}
+{{ range where .Pages "Section" "post" }}
{{ .Content }}
{{ end }}
```
@@ -45,7 +45,7 @@ series: golang
It can also be used with the logical operators `!=`, `>=`, `in`, etc. Without an operator, `where` compares a given field with a matching value equivalent to `=`.
```go-html-template
-{{ range where .Data.Pages "Section" "!=" "post" }}
+{{ range where .Pages "Section" "!=" "post" }}
{{ .Content }}
{{ end }}
```
@@ -104,7 +104,7 @@ You can also put the returned value of the `where` clauses into a variable:
The following grabs the first five content files in `post` using the [default ordering](/templates/lists/) for lists (i.e., `weight => date`):
{{< code file="where-with-first.html" >}}
-{{ range first 5 (where .Data.Pages "Section" "post") }}
+{{ range first 5 (where .Pages "Section" "post") }}
{{ .Content }}
{{ end }}
{{< /code >}}
@@ -114,7 +114,7 @@ The following grabs the first five content files in `post` using the [default or
You can also nest `where` clauses to drill down on lists of content by more than one parameter. The following first grabs all pages in the "blog" section and then ranges through the result of the first `where` clause and finds all pages that are *not* featured:
```go-html-template
-{{ range where (where .Data.Pages "Section" "blog" ) ".Params.featured" "!=" "true" }}
+{{ range where (where .Pages "Section" "blog" ) ".Params.featured" "!=" "true" }}
```
## Unset Fields
@@ -129,7 +129,7 @@ Only the following operators are available for `nil`
* `!=`, `<>`, `ne`: True if the given field is set.
```go-html-template
-{{ range where .Data.Pages ".Params.specialpost" "!=" nil }}
+{{ range where .Pages ".Params.specialpost" "!=" nil }}
{{ .Content }}
{{ end }}
```
diff --git a/docs/content/en/getting-started/configuration.md b/docs/content/en/getting-started/configuration.md
index ea21fa5ce..7b0ca2a01 100644
--- a/docs/content/en/getting-started/configuration.md
+++ b/docs/content/en/getting-started/configuration.md
@@ -193,7 +193,7 @@ sitemap
: Default [sitemap configuration](/templates/sitemap-template/#configure-sitemap-xml).
staticDir ("static")
-: Relative directory from where Hugo reads static files.
+: A directory or a list of directories from where Hugo reads [static files][static-files].
stepAnalysis (false)
: Display memory and timing of different steps of the program.
@@ -405,3 +405,4 @@ Hugo v0.20 introduced the ability to render your content to multiple output form
[templates]: /templates/
[toml]: https://github.com/toml-lang/toml
[yaml]: http://yaml.org/spec/
+[static-files]: /content-management/static-files/
diff --git a/docs/content/en/getting-started/installing.md b/docs/content/en/getting-started/installing.md
index 7a81d097c..a4cf0801f 100644
--- a/docs/content/en/getting-started/installing.md
+++ b/docs/content/en/getting-started/installing.md
@@ -1,7 +1,7 @@
---
title: Install Hugo
linktitle: Install Hugo
-description: Install Hugo on macOS, Windows, Linux, FreeBSD, and on any machine where the Go compiler tool chain can run.
+description: Install Hugo on macOS, Windows, Linux, OpenBSD, FreeBSD, and on any machine where the Go compiler tool chain can run.
date: 2016-11-01
publishdate: 2016-11-01
lastmod: 2018-01-02
@@ -31,6 +31,7 @@ Hugo currently provides pre-built binaries for the following:
* macOS (Darwin) for x64, i386, and ARM architectures
* Windows
* Linux
+* OpenBSD
* FreeBSD
Hugo may also be compiled from source wherever the Go compiler tool chain can run; e.g., on other operating systems such as DragonFly BSD, OpenBSD, Plan&nbsp;9, Solaris, and others. See <https://golang.org/doc/install/source> for the full set of supported combinations of target operating systems and compilation architectures.
@@ -451,7 +452,7 @@ Hugo-as-a-snap can write only inside the user’s `$HOME` directory---and gvfs-m
You can also install Hugo from the Arch Linux [community](https://www.archlinux.org/packages/community/x86_64/hugo/) repository. Applies also for derivatives such as Manjaro.
```
-sudo pacman -Sy hugo
+sudo pacman -Syu hugo
```
### Fedora
@@ -468,6 +469,14 @@ sudo dnf install hugo
See the [related discussion in the Hugo forums][redhatforum].
+## OpenBSD
+
+OpenBSD provides a package for Hugo via `pkg_add`:
+
+```
+doas pkg_add hugo
+```
+
## Upgrade Hugo
Upgrading Hugo is as easy as downloading and replacing the executable you’ve placed in your `PATH` or run `brew upgrade hugo` if using Homebrew.
diff --git a/docs/content/en/news/0.30-relnotes/index.md b/docs/content/en/news/0.30-relnotes/index.md
index db49a1bf3..9281a5c20 100644
--- a/docs/content/en/news/0.30-relnotes/index.md
+++ b/docs/content/en/news/0.30-relnotes/index.md
@@ -9,7 +9,7 @@ images:
---
-Hugo `0.30` is the **Race Car Edition**. Hugo is already very very fast, but much wants more. So we added **Fast Render Mode**. It is hard to explain, so start the Hugo development server with `hugo server` and start editing. Live reloads just got so much faster! The "how and what" is discussed at length in [other places](https://github.com/gohugoio/hugo/pull/3959), but the short version is that we now re-render only the parts of the site that you are working on.
+Hugo `0.30` is the **Race Car Edition**. Hugo is already very very fast, but wants much more. So we added **Fast Render Mode**. It is hard to explain, so start the Hugo development server with `hugo server` and start editing. Live reloads just got so much faster! The "how and what" is discussed at length in [other places](https://github.com/gohugoio/hugo/pull/3959), but the short version is that we now re-render only the parts of the site that you are working on.
The second performance-related feature is a follow-up to the Template Metrics added in Hugo `0.29`. Now, if you add the flag `--templateMetricsHints`, we will calculate a score for how your partials can be cached (with the `partialCached` template func).
diff --git a/docs/content/en/news/0.43-relnotes/featured-hugo-43-poster.png b/docs/content/en/news/0.43-relnotes/featured-hugo-43-poster.png
new file mode 100644
index 000000000..b221ca7f1
--- /dev/null
+++ b/docs/content/en/news/0.43-relnotes/featured-hugo-43-poster.png
Binary files differ
diff --git a/docs/content/en/news/0.43-relnotes/index.md b/docs/content/en/news/0.43-relnotes/index.md
index 483131033..cd8515995 100644
--- a/docs/content/en/news/0.43-relnotes/index.md
+++ b/docs/content/en/news/0.43-relnotes/index.md
@@ -1,8 +1,8 @@
---
date: 2018-07-09
-title: "0.43"
-description: "0.43"
+title: "And Now: Hugo Pipes!"
+description: "Hugo 0.43 adds a powerful and simple to use assets pipeline with SASS/SCSS and much, much more …"
categories: ["Releases"]
---
diff --git a/docs/content/en/news/0.44-relnotes/featured-hugo-44-poster.png b/docs/content/en/news/0.44-relnotes/featured-hugo-44-poster.png
new file mode 100644
index 000000000..330b235fb
--- /dev/null
+++ b/docs/content/en/news/0.44-relnotes/featured-hugo-44-poster.png
Binary files differ
diff --git a/docs/content/en/news/0.44-relnotes/index.md b/docs/content/en/news/0.44-relnotes/index.md
index 2725d4746..aa8396898 100644
--- a/docs/content/en/news/0.44-relnotes/index.md
+++ b/docs/content/en/news/0.44-relnotes/index.md
@@ -1,8 +1,8 @@
---
date: 2018-07-13
-title: "0.44"
-description: "0.44"
+title: "Hugo 0.44: Friday the 13th Edition"
+description: "A sequel to the very popular Hugo Pipes Edition; bug-fixes and enhancements …"
categories: ["Releases"]
---
diff --git a/docs/content/en/news/lets-celebrate-hugos-5th-birthday/index.md b/docs/content/en/news/lets-celebrate-hugos-5th-birthday/index.md
index a06d535d5..9912027b5 100644
--- a/docs/content/en/news/lets-celebrate-hugos-5th-birthday/index.md
+++ b/docs/content/en/news/lets-celebrate-hugos-5th-birthday/index.md
@@ -59,7 +59,7 @@ Hugo has stuck with the sub-zero versions to signal active development, with a n
### The Road to 1.0
-We have some more technical tasks that needs to be done (there is ongoing work to get the page quries into a more consistent state, also a simpler `.GetPage` method), but also some cool new functionality. The following roadmap is taken from memory, and may not be complete, but should be a good indication of what's ahead.
+We have some more technical tasks that needs to be done (there is ongoing work to get the page queries into a more consistent state, also a simpler `.GetPage` method), but also some cool new functionality. The following roadmap is taken from memory, and may not be complete, but should be a good indication of what's ahead.
Pages from "other data sources"
: Currently, in addition to Hugo's list pages, every URL must be backed by a content file (Markdown, HTML etc.). This covers most use cases, but we need a flexible way to generate pages from other data sources. Think product catalogues and similar.
@@ -67,7 +67,7 @@ Pages from "other data sources"
Upgrade Blackfriday to v2
: [Blackfriday](https://github.com/russross/blackfriday) is the main content renderer in Hugo. It has been rewritten to a more flexible architecture, which should allow us to fix some of the current shortcomings.
-We should be able to create a better and easier-to-use data structure from the rendered content: Summary, the content after the summary, being able to range over the footnotes and the ToC. Having ToC as a proper data structure also open up a few other potential uses; using it as an index in [Related Content](https://gohugo.io/content-management/related/) would be one example.
+We should be able to create a better and easier-to-use data structure from the rendered content: Summary, the content after the summary, being able to range over the footnotes and the ToC. Having ToC as a proper data structure also opens up a few other potential uses; using it as an index in [Related Content](https://gohugo.io/content-management/related/) would be one example.
This should also enable us to _do more_ with [Custom Output Formats](/templates/output-formats). It is already very powerful. GettyPubs are using it in [Quire](https://github.com/gettypubs/quire) to build [beautiful multi-platform publications](http://www.getty.edu/publications/digital/digitalpubs.html). But it can be improved. For rendering of content files, you are currently restricted to HTML. It would be great if we could configure alternative renderers per output format, such as LaTeX and EPUB.
@@ -75,7 +75,7 @@ Related to this is also to add a configurable "Markdown URL rewriter", which sho
### The Road to the Future
-These are the items that first comes to mind if you ask me to think even further ahead:
+These are the items that first come to mind if you ask me to think even further ahead:
Dependency manager for Theme Components
: In Hugo `0.42` we added [Theme Components](/themes/theme-components/) and Theme Inheritance. With SCSS support in Hugo `0.43`, which also follows the same project/themes precedence order (add `_variables.scss` to your project, configure SASS colour variables in `config.toml`), we have a solid foundation for creating easy to use and extensible themes. But we are missing some infrastructure around this. We have a site with 235+ [themes](https://themes.gohugo.io/)[^themes] listed, but you currently need to do some added work to get the theme up and running for your site. In the Go world, we don't have NPM to use, which is a curse and a blessing, but I have some ideas about building a simple dependency manager into Hugo, modelled after how Go is doing it (`hugo install`). You should be able to configure what theme and theme components you want to use, and Hugo should handle the installation of the correct versions. This should make it easier for the user, but it would also enable community driven and even commercial "theme stores".
@@ -90,19 +90,19 @@ The "New York Times on Hugo" Use Case
: There are recurring questions on the support forum from [really big sites](https://discourse.gohugo.io/t/transition-2m-posts-from-wordpress-to-hugo/12704) that want to move to Hugo. There are many [good reasons](https://www.netlify.com/blog/2016/05/18/9-reasons-your-site-should-be-static/) why they want this (security, cost-saving, EU regulations etc.). And while there have been reports about companies building 600 000 pages with Hugo on very powerful hardware, we will have to rethink the build model to make this usable. Keywords are: streaming builds, segmented builds, partial rebuilds. There are other site generators also talking about this. It should be possible, and my instinct tells me that it should be easier to do when your starting point is "really fast". But this is not a small weekend project for me, and I have already talked to several companies about sponsoring this.
Plugins
-: A Theme Component could also be called a plugin. But there are several potential plugin hooks into Hugo's build pipeline: Resource transformations, content rendering etc. We will eventually get there, but we should do it without giving up too much of the Hugo speed and simplicity.
+: A Theme Component could also be called a plugin. But there are several potential plugin hooks into Hugo's build pipeline: resource transformations, content rendering, etc. We will eventually get there, but we should do it without giving up too much of the Hugo speed and simplicity.
## Thanks
-So, thanks to everyone who have contributed to getting Hugo where it is today. It is hard to single out individuals, but a big shout-out to all the Hugo experts and moderators helping out making the [discourse.gohugo.io](https://discourse.gohugo.io/) a very active and possibly one of the best support forums out there.
+So, thanks to everyone who has contributed to getting Hugo where it is today. It is hard to single out individuals, but a big shout-out to all the Hugo experts and moderators helping out making [discourse.gohugo.io](https://discourse.gohugo.io/) a very active and possibly one of the best support forums out there.
-And the last shout-out goes to two maintainers who have been there more or less from the start. [@digitalcraftsman](https://github.com/digitalcraftsman/) has been doing a fantastic job keeping the fast growing theme site and [repository](https://github.com/gohugoio/hugoThemes) in pristine condition. I have it on my watch list, but that is just out of curiosity. There are lots of activity, but it runs as clock work. [Anthony Fok](https://github.com/anthonyfok) has contributed with a variety of things but is most notable as the Linux expert on the team. He manages the Debian build and is the one to thank for up-to-date binaries on Debian and Ubuntu.
+And the last shout-out goes to two maintainers who have been there more or less from the start. [@digitalcraftsman](https://github.com/digitalcraftsman/) has been doing a fantastic job keeping the fast growing theme site and [repository](https://github.com/gohugoio/hugoThemes) in pristine condition. I have it on my watch list, but that is just out of curiosity. There is lots of activity, but it runs as clock work. [Anthony Fok](https://github.com/anthonyfok) has contributed with a variety of things but is most notable as the Linux expert on the team. He manages the Debian build and is the one to thank for up-to-date binaries on Debian and Ubuntu.
One final note: If you have not done so already, please visit [github.com/gohugoio/hugo](https://github.com/gohugoio/hugo) and push the "star button".
Gopher artwork by [Ashley McNamara](https://github.com/ashleymcnamara/gophers/) (licensed under [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)). Inspired by [Renee French](https://reneefrench.blogspot.com/).
-[^2]: Numbers from Google Analytics. The Hugo websites are https://discourse.gohugo.io/, https://gohugo.io/ and https://themes.gohugo.io/. It is rumoured that when [Matt Biilman](https://twitter.com/biilmann?lang=en), CEO and Co-founder of Netlify, opened the first power bill after sponsoring Hugo's hosting, said: "Du må lave fis med mig, those Hugo sites have lots of web traffic!"
+[^2]: Numbers from Google Analytics. The Hugo websites are https://discourse.gohugo.io, https://gohugo.io and https://themes.gohugo.io. It is rumoured that when [Matt Biilman](https://twitter.com/biilmann?lang=en), CEO and Co-founder of Netlify, opened the first power bill after sponsoring Hugo's hosting, said: "Du må lave fis med mig, those Hugo sites have lots of web traffic!"
[^sgen]: That was at the time of writing this article. _Next_, a React based static site generator, has momentum and is closing in on Hugo's 2nd place.
-[^themes]: We pull all the themes from GitHub and build the theme site and 235 demo sites on Netlify in 4 minutes. And that is impressing.
+[^themes]: We pull all the themes from GitHub and build the theme site and 235 demo sites on Netlify in 4 minutes. That is impressive.
diff --git a/docs/content/en/readfiles/menuvars.md b/docs/content/en/readfiles/menuvars.md
deleted file mode 100644
index 339fc108d..000000000
--- a/docs/content/en/readfiles/menuvars.md
+++ /dev/null
@@ -1,39 +0,0 @@
-`.URL`
-: string
-
-`.Name`
-: string
-
-`.Menu`
-: string
-
-`.Identifier`
-: string
-
-`.Pre`
-: template.HTML
-
-`.Post`
-: template.HTML
-
-`.Weight`
-: int
-
-`.Parent`
-: string
-
-`.Children`
-: Menu
-
-Note that menus also have the following functions available as well:
-
-[`.HasChildren`](/functions/haschildren/)
-: boolean
-
-Additionally, there are some relevant functions available to menus on a page:
-
-[`.IsMenuCurrent`](/functions/ismenucurrent/)
-: (menu string, menuEntry *MenuEntry ) boolean
-
-[`.HasMenuCurrent`](/functions/hasmenucurrent/)
-: (menu string, menuEntry *MenuEntry) boolean \ No newline at end of file
diff --git a/docs/content/en/templates/404.md b/docs/content/en/templates/404.md
index eaa479d29..64ebe1694 100644
--- a/docs/content/en/templates/404.md
+++ b/docs/content/en/templates/404.md
@@ -21,7 +21,7 @@ When using Hugo with [GitHub Pages](http://pages.github.com/), you can provide y
404 pages will have all the regular [page variables][pagevars] available to use in the templates.
-In addition to the standard page variables, the 404 page has access to all site content accessible from `.Data.Pages`.
+In addition to the standard page variables, the 404 page has access to all site content accessible from `.Pages`.
```
▾ layouts/
diff --git a/docs/content/en/templates/base.md b/docs/content/en/templates/base.md
index 94d4cb2ef..4948f6f35 100644
--- a/docs/content/en/templates/base.md
+++ b/docs/content/en/templates/base.md
@@ -90,7 +90,7 @@ From the above base template, you can define a [default list template][hugolists
{{< code file="layouts/_default/list.html" download="list.html" >}}
{{ define "main" }}
<h1>Posts</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<article>
<h2>{{ .Title }}</h2>
{{ .Content }}
diff --git a/docs/content/en/templates/homepage.md b/docs/content/en/templates/homepage.md
index 833664866..48130c39b 100644
--- a/docs/content/en/templates/homepage.md
+++ b/docs/content/en/templates/homepage.md
@@ -36,9 +36,9 @@ The homepage, similar to other [list pages in Hugo][lists], accepts content and
See the homepage template below or [Content Organization][contentorg] for more information on the role of `_index.md` in adding content and front matter to list pages.
-## `.Data.Pages` on the Homepage
+## `.Pages` on the Homepage
-In addition to the standard [page variables][pagevars], the homepage template has access to *all* site content via `.Data.Pages`.
+In addition to the standard [page variables][pagevars], the homepage template has access to *all* site content via `.Pages`.
## Example Homepage Template
@@ -58,8 +58,8 @@ The following is an example of a homepage template that uses [partial][partials]
{{.Content}}
</div>
<div>
- <!-- Note that .Data.Pages is the equivalent of .Site.Pages on the homepage template. -->
- {{ range first 10 .Data.Pages }}
+ <!-- Note that .Pages is the same as .Site.RegularPages on the homepage template. -->
+ {{ range first 10 .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
diff --git a/docs/content/en/templates/introduction.md b/docs/content/en/templates/introduction.md
index f13378ef0..7f3a862ef 100644
--- a/docs/content/en/templates/introduction.md
+++ b/docs/content/en/templates/introduction.md
@@ -504,7 +504,7 @@ Go allows you to do more than what's shown here. Using Hugo's [`where` function]
{{< code file="layouts/partials/upcoming-events.html" download="upcoming-events.html" >}}
<h4>Upcoming Events</h4>
<ul class="upcoming-events">
-{{ range where .Data.Pages.ByDate "Section" "events" }}
+{{ range where .Pages.ByDate "Section" "events" }}
{{ if ge .Date.Unix .Now.Unix }}
<li>
<!-- add span for event type -->
diff --git a/docs/content/en/templates/lists.md b/docs/content/en/templates/lists.md
index 431407e43..2871b181e 100644
--- a/docs/content/en/templates/lists.md
+++ b/docs/content/en/templates/lists.md
@@ -101,7 +101,7 @@ You can now access this `_index.md`'s' content in your list template:
</article>
<ul>
<!-- Ranges through content/post/*.md -->
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<li>
<a href="{{.Permalink}}">{{.Date.Format "2006-01-02"}} | {{.Title}}</a>
</li>
@@ -172,7 +172,7 @@ This list template has been modified slightly from a template originally used in
<h1>{{ .Title }}</h1>
<ul>
<!-- Renders the li.html content view for each content/post/*.md -->
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "li"}}
{{ end }}
</ul>
@@ -189,7 +189,7 @@ This list template has been modified slightly from a template originally used in
<div>
<h1>{{ .Title }}</h1>
<!-- ranges through each of the content files associated with a particular taxonomy term and renders the summary.html content view -->
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
@@ -205,7 +205,7 @@ Hugo lists render the content based on metadata you provide in [front matter][].
{{< code file="layouts/partials/default-order.html" >}}
<ul>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -220,7 +220,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-weight.html" >}}
<ul>
- {{ range .Data.Pages.ByWeight }}
+ {{ range .Pages.ByWeight }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -234,7 +234,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-date.html" >}}
<ul>
<!-- orders content according to the "date" field in front matter -->
- {{ range .Data.Pages.ByDate }}
+ {{ range .Pages.ByDate }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -248,7 +248,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-publish-date.html" >}}
<ul>
<!-- orders content according to the "publishdate" field in front matter -->
- {{ range .Data.Pages.ByPublishDate }}
+ {{ range .Pages.ByPublishDate }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -261,7 +261,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-expiry-date.html" >}}
<ul>
- {{ range .Data.Pages.ByExpiryDate }}
+ {{ range .Pages.ByExpiryDate }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -275,7 +275,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-last-mod.html" >}}
<ul>
<!-- orders content according to the "lastmod" field in front matter -->
- {{ range .Data.Pages.ByLastmod }}
+ {{ range .Pages.ByLastmod }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -289,7 +289,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-length.html" >}}
<ul>
<!-- orders content according to content length in ascending order (i.e., the shortest content will be listed first) -->
- {{ range .Data.Pages.ByLength }}
+ {{ range .Pages.ByLength }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -303,7 +303,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-title.html" >}}
<ul>
<!-- ranges through content in ascending order according to the "title" field set in front matter -->
- {{ range .Data.Pages.ByTitle }}
+ {{ range .Pages.ByTitle }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -317,7 +317,7 @@ Lower weight gets higher precedence. So content with lower weight will come firs
{{< code file="layouts/partials/by-link-title.html" >}}
<ul>
<!-- ranges through content in ascending order according to the "linktitle" field in front matter. If a "linktitle" field is not set, the range will start with content that only has a "title" field and use that value for .LinkTitle -->
- {{ range .Data.Pages.ByLinkTitle }}
+ {{ range .Pages.ByLinkTitle }}
<li>
<h1><a href="{{ .Permalink }}">{{ .LinkTitle }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -332,7 +332,7 @@ Order based on the specified front matter parameter. Content that does not have
{{< code file="layouts/partials/by-rating.html" >}}
<!-- Ranges through content according to the "rating" field set in front matter -->
-{{ range (.Data.Pages.ByParam "rating") }}
+{{ range (.Pages.ByParam "rating") }}
<!-- ... -->
{{ end }}
{{< /code >}}
@@ -340,7 +340,7 @@ Order based on the specified front matter parameter. Content that does not have
If the targeted front matter field is nested beneath another field, you can access the field using dot notation.
{{< code file="layouts/partials/by-nested-param.html" >}}
-{{ range (.Data.Pages.ByParam "author.last_name") }}
+{{ range (.Pages.ByParam "author.last_name") }}
<!-- ... -->
{{ end }}
{{< /code >}}
@@ -351,7 +351,7 @@ Reversing order can be applied to any of the above methods. The following uses `
{{< code file="layouts/partials/by-date-reverse.html" >}}
<ul>
- {{ range .Data.Pages.ByDate.Reverse }}
+ {{ range .Pages.ByDate.Reverse }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -368,7 +368,7 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
{{< code file="layouts/partials/by-page-field.html" >}}
<!-- Groups content according to content section. The ".Key" in this instance will be the section's title. -->
-{{ range .Data.Pages.GroupBy "Section" }}
+{{ range .Pages.GroupBy "Section" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -385,7 +385,7 @@ In the above example, you may want `{{.Title}}` to point the `title` field you h
{{< code file="layouts/partials/by-page-field.html" >}}
<!-- Groups content according to content section.-->
-{{ range .Data.Pages.GroupBy "Section" }}
+{{ range .Pages.GroupBy "Section" }}
<!-- Checks for existence of _index.md for a section; if available, pulls from "title" in front matter -->
{{ with $.Site.GetPage "section" .Key }}
<h3>{{.Title}}</h3>
@@ -408,7 +408,7 @@ In the above example, you may want `{{.Title}}` to point the `title` field you h
{{< code file="layouts/partials/by-page-date.html" >}}
<!-- Groups content by month according to the "date" field in front matter -->
-{{ range .Data.Pages.GroupByDate "2006-01" }}
+{{ range .Pages.GroupByDate "2006-01" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -425,7 +425,7 @@ In the above example, you may want `{{.Title}}` to point the `title` field you h
{{< code file="layouts/partials/by-page-publish-date.html" >}}
<!-- Groups content by month according to the "publishdate" field in front matter -->
-{{ range .Data.Pages.GroupByPublishDate "2006-01" }}
+{{ range .Pages.GroupByPublishDate "2006-01" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -442,7 +442,7 @@ In the above example, you may want `{{.Title}}` to point the `title` field you h
{{< code file="layouts/partials/by-page-param.html" >}}
<!-- Groups content according to the "param_key" field in front matter -->
-{{ range .Data.Pages.GroupByParam "param_key" }}
+{{ range .Pages.GroupByParam "param_key" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -461,7 +461,7 @@ The following template takes grouping by `date` a step further and uses Go's lay
{{< code file="layouts/partials/by-page-param-as-date.html" >}}
<!-- Groups content by month according to the "param_key" field in front matter -->
-{{ range .Data.Pages.GroupByParamDate "param_key" "2006-01" }}
+{{ range .Pages.GroupByParamDate "param_key" "2006-01" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -483,21 +483,21 @@ While these are logical defaults, they are not always the desired order. There a
#### 1. Adding the Reverse Method
```
-{{ range (.Data.Pages.GroupBy "Section").Reverse }}
+{{ range (.Pages.GroupBy "Section").Reverse }}
```
```
-{{ range (.Data.Pages.GroupByDate "2006-01").Reverse }}
+{{ range (.Pages.GroupByDate "2006-01").Reverse }}
```
#### 2. Providing the Alternate Direction
```
-{{ range .Data.Pages.GroupByDate "2006-01" "asc" }}
+{{ range .Pages.GroupByDate "2006-01" "asc" }}
```
```
-{{ range .Data.Pages.GroupBy "Section" "desc" }}
+{{ range .Pages.GroupBy "Section" "desc" }}
```
### Order Within Groups
@@ -511,7 +511,7 @@ Here is the ordering for the example that follows:
3. Pages within each respective group are ordered alphabetically according to the `title`.
{{< code file="layouts/partials/by-group-by-page.html" >}}
-{{ range .Data.Pages.GroupByDate "2006-01" "asc" }}
+{{ range .Pages.GroupByDate "2006-01" "asc" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages.ByTitle }}
@@ -536,8 +536,8 @@ Sometimes you only want to list a subset of the available content. A common is t
2. `key` *or* `field name`
3. `match value`
-{{< code file="layouts/_default/.html" >}}
-{{ range where .Data.Pages "Section" "post" }}
+{{< code file="layouts/_default/index.html" >}}
+{{ range where .Pages "Section" "post" }}
{{ .Content }}
{{ end }}
{{< /code >}}
@@ -552,7 +552,7 @@ You can see more examples in the [functions documentation for `where`][wherefunc
2. `number of elements`
{{< code file="layout/_default/section.html" >}}
-{{ range first 10 .Data.Pages }}
+{{ range first 10 .Pages }}
{{ .Render "summary" }}
{{ end }}
{{< /code >}}
@@ -563,7 +563,7 @@ Using `first` and `where` together can be very powerful:
{{< code file="first-and-where-together.html" >}}
<!-- Orders the content inside the "posts" section by the "title" field and then ranges through only the first 5 posts -->
-{{ range first 5 (where .Data.Pages "Section" "post").ByTitle }}
+{{ range first 5 (where .Pages "Section" "post").ByTitle }}
{{ .Content }}
{{ end }}
{{< /code >}}
diff --git a/docs/content/en/templates/ordering-and-grouping.md b/docs/content/en/templates/ordering-and-grouping.md
index 37a355877..2125ee6a4 100644
--- a/docs/content/en/templates/ordering-and-grouping.md
+++ b/docs/content/en/templates/ordering-and-grouping.md
@@ -35,7 +35,7 @@ This list template is used for [spf13.com](http://spf13.com/). It makes use of [
<div>
<h1 id="title">{{ .Title }}</h1>
<ul id="list">
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "li"}}
{{ end }}
</ul>
@@ -51,7 +51,7 @@ This list template is used for [spf13.com](http://spf13.com/). It makes use of [
<section id="main">
<div>
<h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
@@ -70,7 +70,7 @@ your list templates:
{{< code file="layouts/partials/order-default.html" >}}
<ul class="pages">
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<li>
<h1><a href="{{ .Permalink }}">{{ .Title }}</a></h1>
<time>{{ .Date.Format "Mon, Jan 2, 2006" }}</time>
@@ -82,7 +82,7 @@ your list templates:
### By Weight
{{< code file="layouts/partials/by-weight.html" >}}
-{{ range .Data.Pages.ByWeight }}
+{{ range .Pages.ByWeight }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -93,7 +93,7 @@ your list templates:
### By Date
{{< code file="layouts/partials/by-date.html" >}}
-{{ range .Data.Pages.ByDate }}
+{{ range .Pages.ByDate }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -104,7 +104,7 @@ your list templates:
### By Publish Date
{{< code file="layouts/partials/by-publish-date.html" >}}
-{{ range .Data.Pages.ByPublishDate }}
+{{ range .Pages.ByPublishDate }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .PublishDate.Format "Mon, Jan 2, 2006" }}</div>
@@ -115,7 +115,7 @@ your list templates:
### By Expiration Date
{{< code file="layouts/partials/by-expiry-date.html" >}}
-{{ range .Data.Pages.ByExpiryDate }}
+{{ range .Pages.ByExpiryDate }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .ExpiryDate.Format "Mon, Jan 2, 2006" }}</div>
@@ -126,7 +126,7 @@ your list templates:
### By Last Modified Date
{{< code file="layouts/partials/by-last-mod.html" >}}
-{{ range .Data.Pages.ByLastmod }}
+{{ range .Pages.ByLastmod }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -137,7 +137,7 @@ your list templates:
### By Length
{{< code file="layouts/partials/by-length.html" >}}
-{{ range .Data.Pages.ByLength }}
+{{ range .Pages.ByLength }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -149,7 +149,7 @@ your list templates:
### By Title
{{< code file="layouts/partials/by-title.html" >}}
-{{ range .Data.Pages.ByTitle }}
+{{ range .Pages.ByTitle }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -160,7 +160,7 @@ your list templates:
### By Link Title
{{< code file="layouts/partials/by-link-title.html" >}}
-{{ range .Data.Pages.ByLinkTitle }}
+{{ range .Pages.ByLinkTitle }}
<li>
<a href="{{ .Permalink }}">{{ .LinkTitle }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -175,7 +175,7 @@ Order based on the specified front matter parameter. Content that does not have
The below example sorts a list of posts by their rating.
{{< code file="layouts/partials/by-rating.html" >}}
-{{ range (.Data.Pages.ByParam "rating") }}
+{{ range (.Pages.ByParam "rating") }}
<!-- ... -->
{{ end }}
{{< /code >}}
@@ -184,7 +184,7 @@ If the front matter field of interest is nested beneath another field, you can
also get it:
{{< code file="layouts/partials/by-nested-param.html" >}}
-{{ range (.Data.Pages.ByParam "author.last_name") }}
+{{ range (.Pages.ByParam "author.last_name") }}
<!-- ... -->
{{ end }}
{{< /code >}}
@@ -194,7 +194,7 @@ also get it:
Reversing order can be applied to any of the above methods. The following uses `ByDate` as an example:
{{< code file="layouts/partials/by-date-reverse.html" >}}
-{{ range .Data.Pages.ByDate.Reverse }}
+{{ range .Pages.ByDate.Reverse }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
<div class="meta">{{ .Date.Format "Mon, Jan 2, 2006" }}</div>
@@ -209,7 +209,7 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
### By Page Field
{{< code file="layouts/partials/by-page-field.html" >}}
-{{ range .Data.Pages.GroupBy "Section" }}
+{{ range .Pages.GroupBy "Section" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -225,7 +225,7 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
### By Page date
{{< code file="layouts/partials/by-page-date.html" >}}
-{{ range .Data.Pages.GroupByDate "2006-01" }}
+{{ range .Pages.GroupByDate "2006-01" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -241,7 +241,7 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
### By Page publish date
{{< code file="layouts/partials/by-page-publish-date.html" >}}
-{{ range .Data.Pages.GroupByPublishDate "2006-01" }}
+{{ range .Pages.GroupByPublishDate "2006-01" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -257,7 +257,7 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
### By Page Param
{{< code file="layouts/partials/by-page-param.html" >}}
-{{ range .Data.Pages.GroupByParam "param_key" }}
+{{ range .Pages.GroupByParam "param_key" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -273,7 +273,7 @@ Hugo provides some functions for grouping pages by Section, Type, Date, etc.
### By Page Param in Date Format
{{< code file="layouts/partials/by-page-param-as-date.html" >}}
-{{ range .Data.Pages.GroupByParamDate "param_key" "2006-01" }}
+{{ range .Pages.GroupByParamDate "param_key" "2006-01" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages }}
@@ -295,22 +295,22 @@ While these are logical defaults, they are not always the desired order. There a
#### Reverse Method
```
-{{ range (.Data.Pages.GroupBy "Section").Reverse }}
+{{ range (.Pages.GroupBy "Section").Reverse }}
```
```
-{{ range (.Data.Pages.GroupByDate "2006-01").Reverse }}
+{{ range (.Pages.GroupByDate "2006-01").Reverse }}
```
#### Provide the Alternate Direction
```
-{{ range .Data.Pages.GroupByDate "2006-01" "asc" }}
+{{ range .Pages.GroupByDate "2006-01" "asc" }}
```
```
-{{ range .Data.Pages.GroupBy "Section" "desc" }}
+{{ range .Pages.GroupBy "Section" "desc" }}
```
### Order Within Groups
@@ -321,7 +321,7 @@ In the following example, groups are ordered chronologically and then content
within each group is ordered alphabetically by title.
{{< code file="layouts/partials/by-group-by-page.html" >}}
-{{ range .Data.Pages.GroupByDate "2006-01" "asc" }}
+{{ range .Pages.GroupByDate "2006-01" "asc" }}
<h3>{{ .Key }}</h3>
<ul>
{{ range .Pages.ByTitle }}
@@ -346,8 +346,8 @@ Sometimes you only want to list a subset of the available content. A common requ
2. `key` or `field name`
3. `match value`
-{{< code file="layouts/_default/.html" >}}
-{{ range where .Data.Pages "Section" "post" }}
+{{< code file="layouts/_default/index.html" >}}
+{{ range where .Pages "Section" "post" }}
{{ .Content }}
{{ end }}
{{< /code >}}
@@ -360,7 +360,7 @@ Sometimes you only want to list a subset of the available content. A common requ
2. `number of elements`
{{< code file="layout/_default/section.html" >}}
-{{ range first 10 .Data.Pages }}
+{{ range first 10 .Pages }}
{{ .Render "summary" }}
{{ end }}
{{< /code >}}
@@ -370,7 +370,7 @@ Sometimes you only want to list a subset of the available content. A common requ
Using `first` and `where` together can be very powerful:
{{< code file="first-and-where-together.html" >}}
-{{ range first 5 (where .Data.Pages "Section" "post") }}
+{{ range first 5 (where .Pages "Section" "post") }}
{{ .Content }}
{{ end }}
{{< /code >}}
diff --git a/docs/content/en/templates/pagination.md b/docs/content/en/templates/pagination.md
index 22acb3079..2ea1daae9 100644
--- a/docs/content/en/templates/pagination.md
+++ b/docs/content/en/templates/pagination.md
@@ -43,19 +43,19 @@ Setting `Paginate` to a positive value will split the list pages for the homepag
There are two ways to configure and use a `.Paginator`:
1. The simplest way is just to call `.Paginator.Pages` from a template. It will contain the pages for *that page*.
-2. Select a subset of the pages with the available template functions and ordering options, and pass the slice to `.Paginate`, e.g. `{{ range (.Paginate ( first 50 .Data.Pages.ByTitle )).Pages }}`.
+2. Select a subset of the pages with the available template functions and ordering options, and pass the slice to `.Paginate`, e.g. `{{ range (.Paginate ( first 50 .Pages.ByTitle )).Pages }}`.
For a given **Page**, it's one of the options above. The `.Paginator` is static and cannot change once created.
The global page size setting (`Paginate`) can be overridden by providing a positive integer as the last argument. The examples below will give five items per page:
* `{{ range (.Paginator 5).Pages }}`
-* `{{ $paginator := .Paginate (where .Data.Pages "Type" "post") 5 }}`
+* `{{ $paginator := .Paginate (where .Pages "Type" "post") 5 }}`
It is also possible to use the `GroupBy` functions in combination with pagination:
```
-{{ range (.Paginate (.Data.Pages.GroupByDate "2006")).PageGroups }}
+{{ range (.Paginate (.Pages.GroupByDate "2006")).PageGroups }}
```
## Build the navigation
@@ -75,7 +75,7 @@ If you use any filters or ordering functions to create your `.Paginator` *and* y
The following example shows how to create `.Paginator` before its used:
```
-{{ $paginator := .Paginate (where .Data.Pages "Type" "post") }}
+{{ $paginator := .Paginate (where .Pages "Type" "post") }}
{{ template "_internal/pagination.html" . }}
{{ range $paginator.Pages }}
{{ .Title }}
diff --git a/docs/content/en/templates/robots.md b/docs/content/en/templates/robots.md
index 5237fec0b..cfb077e30 100644
--- a/docs/content/en/templates/robots.md
+++ b/docs/content/en/templates/robots.md
@@ -42,7 +42,7 @@ The following is an example `robots.txt` layout:
{{< code file="layouts/robots.txt" download="robots.txt" >}}
User-agent: *
-{{range .Data.Pages}}
+{{range .Pages}}
Disallow: {{.RelPermalink}}
{{end}}
{{< /code >}}
diff --git a/docs/content/en/templates/rss.md b/docs/content/en/templates/rss.md
index 7162597aa..834cb1277 100644
--- a/docs/content/en/templates/rss.md
+++ b/docs/content/en/templates/rss.md
@@ -73,7 +73,7 @@ This is the default RSS template that ships with Hugo. It adheres to the [RSS 2.
{{ with .OutputFormats.Get "RSS" }}
{{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
{{ end }}
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<item>
<title>{{ .Title }}</title>
<link>{{ .Permalink }}</link>
diff --git a/docs/content/en/templates/sitemap-template.md b/docs/content/en/templates/sitemap-template.md
index 29b59ad12..4df9c2490 100644
--- a/docs/content/en/templates/sitemap-template.md
+++ b/docs/content/en/templates/sitemap-template.md
@@ -41,7 +41,7 @@ This template respects the version 0.9 of the [Sitemap Protocol](http://www.site
```
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<url>
<loc>{{ .Permalink }}</loc>{{ if not .Lastmod.IsZero }}
<lastmod>{{ safeHTML ( .Lastmod.Format "2006-01-02T15:04:05-07:00" ) }}</lastmod>{{ end }}{{ with .Sitemap.ChangeFreq }}
@@ -72,4 +72,4 @@ Defaults for `<changefreq>`, `<priority>` and `filename` values can be set in th
The same fields can be specified in an individual content file's front matter in order to override the value assigned to that piece of content at render time.
-[pagevars]: /variables/page/ \ No newline at end of file
+[pagevars]: /variables/page/
diff --git a/docs/content/en/templates/taxonomy-templates.md b/docs/content/en/templates/taxonomy-templates.md
index f3b349a39..284500e00 100644
--- a/docs/content/en/templates/taxonomy-templates.md
+++ b/docs/content/en/templates/taxonomy-templates.md
@@ -103,11 +103,11 @@ type WeightedPages []WeightedPage
## Displaying custom metadata in Taxonomy Terms Templates
-If you need to display custom metadata for each taxonomy term, you will need to create a page for that term at `/content/<TAXONOMY>/<TERM>/_index.md` and add your metadata in it's front matter, [as explained in the taxonomies documentation](/content-management/taxonomies/#add-custom-meta-data-to-a-taxonomy-term). Based on the Actors taxonomy example shown there, within your taxonomy terms template, you may access your custom fields by iterating through the variable `.Data.Pages` as such:
+If you need to display custom metadata for each taxonomy term, you will need to create a page for that term at `/content/<TAXONOMY>/<TERM>/_index.md` and add your metadata in it's front matter, [as explained in the taxonomies documentation](/content-management/taxonomies/#add-custom-meta-data-to-a-taxonomy-term). Based on the Actors taxonomy example shown there, within your taxonomy terms template, you may access your custom fields by iterating through the variable `.Pages` as such:
```
<ul>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<li>
<a href="{{ .Permalink }}">{{ .Title }}</a>
{{ .Params.wikipedia }}
diff --git a/docs/content/en/templates/template-debugging.md b/docs/content/en/templates/template-debugging.md
index e94a073af..bba84b9fe 100644
--- a/docs/content/en/templates/template-debugging.md
+++ b/docs/content/en/templates/template-debugging.md
@@ -51,14 +51,14 @@ This will print out a list of all the variables scoped to the current context
When developing a [homepage][], what does one of the pages you're looping through look like?
```
-{{ range .Data.Pages }}
+{{ range .Pages }}
{{/* The context, ".", is now each one of the pages as it goes through the loop */}}
{{ printf "%#v" . }}
{{ end }}
```
-{{% note "`.Data.Pages` on the Homepage" %}}
-`.Data.Pages` on the homepage is equivalent to `.Site.Pages`.
+{{% note "`.Pages` on the Homepage" %}}
+`.Pages` on the homepage is equivalent to `.Site.RegularPages`.
{{% /note %}}
## Why Am I Showing No Defined Variables?
@@ -78,4 +78,4 @@ This example will render the header partial, but the header partial will not hav
The dot (`.`) is considered fundamental to understanding Hugo templating. For more information, see [Introduction to Hugo Templating][tempintro].
[homepage]: /templates/homepage/
-[tempintro]: /templates/introduction/ \ No newline at end of file
+[tempintro]: /templates/introduction/
diff --git a/docs/content/en/templates/views.md b/docs/content/en/templates/views.md
index ac863646b..b1a6451b2 100644
--- a/docs/content/en/templates/views.md
+++ b/docs/content/en/templates/views.md
@@ -73,7 +73,7 @@ In this example, `.Render` is passed into the template to call the [render funct
<main id="main">
<div>
<h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
{{ .Render "summary"}}
{{ end }}
</div>
diff --git a/docs/content/en/variables/menus.md b/docs/content/en/variables/menus.md
index 4216d9763..69d46ca2b 100644
--- a/docs/content/en/variables/menus.md
+++ b/docs/content/en/variables/menus.md
@@ -1,7 +1,7 @@
---
-title: Menu Variables
-linktitle: Menu Variables
-description: A menu entry in a menu template has specific variables and functions to make menu management easier.
+title: Menu Entry Properties
+linktitle: Menu Entry Properties
+description: A menu entry in a menu-template has specific variables and functions to make menu management easier.
date: 2017-03-12
publishdate: 2017-03-12
lastmod: 2017-03-12
@@ -19,49 +19,106 @@ aliases: [/variables/menu/]
toc: false
---
-The [menu template][] has the following properties:
+A **menu entry** has the following properties available that can be used in a
+[menu template][menu-template].
-.URL
-: string
-
-.Name
-: string
+## Menu Entry Variables
-.Title
-: string
+.Menu
+: _string_ <br />
+Name of the **menu** that contains this **menu entry**.
-This is a link title, meant to be used in `title`-Attributes of the menu's `<a>`-tags.
-By default it returns `.Page.LinkTitle`, as long as the menu entry was created
-through the page's front matter and not through the site config.
-Setting it explicitly in the site config or the page's front matter overrides this behaviour.
+.URL
+: _string_ <br />
+URL that the menu entry points to. The `url` key, if set for the menu entry,
+sets this value. If that key is not set, and if the menu entry is set in a page
+front-matter, this value defaults to the page's `.RelPermalink`.
.Page
-: [Page Object](/variables/page/)
+: _\*Page_ <br />
+Reference to the [page object][page-object] associated with the menu entry. This
+will be non-nil if the menu entry is set via a page's front-matter and not via
+the site config.
-The `.Page` variable holds a reference to the page.
-It's only set when the menu entry is created from the page's front matter,
-not when it's created from the site config.
-
-
-.Menu
-: string
+.Name
+: _string_ <br />
+Name of the menu entry. The `name` key, if set for the menu entry, sets
+this value. If that key is not set, and if the menu entry is set in a page
+front-matter, this value defaults to the page's `.LinkTitle`.
.Identifier
-: string
+: _string_ <br />
+Value of the `identifier` key if set for the menu entry. This value must be
+unique for each menu entry. **It is necessary to set a unique identifier
+manually if two or more menu entries have the same `.Name`.**
.Pre
-: template.HTML
+: _template.HTML_ <br />
+Value of the `pre` key if set for the menu entry. This value typically contains
+a string representing HTML.
.Post
-: template.HTML
+: _template.HTML_ <br />
+Value of the `post` key if set for the menu entry. This value typically contains
+a string representing HTML.
.Weight
-: int
+: _int_ <br />
+Value of the `weight` key if set for the menu entry. If that key is not set,
+and if the menu entry is set in a page front-matter, this value defaults to the
+page's `.Weight`.
.Parent
-: string
+: _string_ <br />
+Name (or Identifier if present) of this menu entry's parent **menu entry**. The
+`parent` key, if set for the menu entry, sets this value. If this key is set,
+this menu entry nests under that parent entry, else it nests directly under the
+`.Menu`.
.Children
-: Menu
+: _Menu_ <br />
+This value is auto-populated by Hugo. It is a collection of children menu
+entries, if any, under the current menu entry.
+
+## Menu Entry Functions
+
+Menus also have the following functions available:
+
+[.HasChildren](/functions/haschildren/)
+: _boolean_ <br />
+Returns `true` if `.Children` is non-nil.
+
+.KeyName
+: _string_ <br />
+Returns the `.Identifier` if present, else returns the `.Name`.
+
+.IsEqual
+: _boolean_ <br />
+Returns `true` if the two compared menu entries represent the same menu entry.
+
+.IsSameResource
+: _boolean_ <br />
+Returns `true` if the two compared menu entries have the same `.URL`.
+
+.Title
+: _string_ <br />
+Link title, meant to be used in the `title` attribute of a menu entry's
+`<a>`-tags. Returns the menu entry's `title` key if set. Else, if the menu
+entry was created through a page's front-matter, it returns the page's
+`.LinkTitle`. Else, it just returns an empty string.
+
+## Other Menu-related Functions
+
+Additionally, here are some relevant methods available to menus on a page:
+
+.IsMenuCurrent
+: _(menu string, menuEntry *MenuEntry ) boolean_ <br />
+See [`.IsMenuCurrent` method](/functions/ismenucurrent/).
+
+.HasMenuCurrent
+: _(menu string, menuEntry *MenuEntry) boolean_ <br />
+See [`.HasMenuCurrent` method](/functions/hasmenucurrent/).
+
-[menu template]: /templates/menu-templates/
+[menu-template]: /templates/menu-templates/
+[page-object]: /variables/page/
diff --git a/docs/content/en/variables/page.md b/docs/content/en/variables/page.md
index 4e3673559..7279eec7e 100644
--- a/docs/content/en/variables/page.md
+++ b/docs/content/en/variables/page.md
@@ -106,7 +106,9 @@ See also `.ExpiryDate`, `.Date`, `.PublishDate`, and [`.GitInfo`][gitinfo].
: contains all formats, including the current format, for a given page. Can be combined the with [`.Get` function](/functions/get/) to grab a specific format. (See [Output Formats](/templates/output-formats/).)
.Pages
-: a collection of associated pages. This value will be `nil` for regular content pages. `.Pages` is an alias for `.Data.Pages`.
+: a collection of associated pages. `.Pages` is an alias for
+ `.Data.Pages`. This value will be `nil` within the context of
+ regular content pages.
.Permalink
: the Permanent link for this page; see [Permalinks](/content-management/urls/)
diff --git a/docs/content/zh/templates/base.md b/docs/content/zh/templates/base.md
index 8f98cfdfe..68f245662 100644
--- a/docs/content/zh/templates/base.md
+++ b/docs/content/zh/templates/base.md
@@ -90,7 +90,7 @@ From the above base template, you can define a [default list template][hugolists
{{< code file="layouts/_default/list.html" download="list.html" >}}
{{ define "main" }}
<h1>Posts</h1>
- {{ range .Data.Pages }}
+ {{ range .Pages }}
<article>
<h2>{{ .Title }}</h2>
{{ .Content }}
diff --git a/docs/netlify.toml b/docs/netlify.toml
index 6bb2f00d1..6bb3019f4 100644
--- a/docs/netlify.toml
+++ b/docs/netlify.toml
@@ -3,7 +3,7 @@ publish = "public"
command = "hugo"
[context.production.environment]
-HUGO_VERSION = "0.42.2"
+HUGO_VERSION = "0.44"
HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true"
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --enableGitInfo"
[context.split1.environment]
-HUGO_VERSION = "0.42.2"
+HUGO_VERSION = "0.44"
HUGO_ENV = "production"
[context.deploy-preview]
command = "hugo --buildFuture -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment]
-HUGO_VERSION = "0.42.2"
+HUGO_VERSION = "0.44"
[context.branch-deploy]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment]
-HUGO_VERSION = "0.42.2"
+HUGO_VERSION = "0.44"
[context.next.environment]
HUGO_ENABLEGITINFO = "true"
diff --git a/docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..7a9eea7ac
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..02b8217bf
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.43-relnotes/featured-hugo-43-poster_hu3948fe44e4a966d8149b4bf077395057_78299_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_480x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..6691fdc17
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_480x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_640x0_resize_catmullrom_2.png
new file mode 100644
index 000000000..841552fa2
--- /dev/null
+++ b/docs/resources/_gen/images/news/0.44-relnotes/featured-hugo-44-poster_hu6505d1982bab71bfe9c6c7adcedfd7f7_77631_640x0_resize_catmullrom_2.png
Binary files differ
diff --git a/docs/static/images/contribute/development/accept-cla.png b/docs/static/images/contribute/development/accept-cla.png
index 929fda6ab..929fda6ab 100755..100644
--- a/docs/static/images/contribute/development/accept-cla.png
+++ b/docs/static/images/contribute/development/accept-cla.png
Binary files differ
diff --git a/docs/static/images/contribute/development/ci-errors.png b/docs/static/images/contribute/development/ci-errors.png
index 95cd290b6..95cd290b6 100755..100644
--- a/docs/static/images/contribute/development/ci-errors.png
+++ b/docs/static/images/contribute/development/ci-errors.png
Binary files differ
diff --git a/docs/static/images/contribute/development/copy-remote-url.png b/docs/static/images/contribute/development/copy-remote-url.png
index 9006f4a48..9006f4a48 100755..100644
--- a/docs/static/images/contribute/development/copy-remote-url.png
+++ b/docs/static/images/contribute/development/copy-remote-url.png
Binary files differ
diff --git a/docs/static/images/contribute/development/forking-a-repository.png b/docs/static/images/contribute/development/forking-a-repository.png
index ea132cab3..ea132cab3 100755..100644
--- a/docs/static/images/contribute/development/forking-a-repository.png
+++ b/docs/static/images/contribute/development/forking-a-repository.png
Binary files differ
diff --git a/docs/static/images/contribute/development/open-pull-request.png b/docs/static/images/contribute/development/open-pull-request.png
index 63b504fb2..63b504fb2 100755..100644
--- a/docs/static/images/contribute/development/open-pull-request.png
+++ b/docs/static/images/contribute/development/open-pull-request.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-a-github-pages-step.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-a-github-pages-step.png
index ff28a0661..ff28a0661 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-a-github-pages-step.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-a-github-pages-step.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-the-project-to-github.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-the-project-to-github.png
index e1065bb00..e1065bb00 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-the-project-to-github.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/adding-the-project-to-github.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/and-we-ve-got-an-app.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/and-we-ve-got-an-app.png
index 7f8e10e70..7f8e10e70 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/and-we-ve-got-an-app.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/and-we-ve-got-an-app.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/configure-the-deploy-step.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/configure-the-deploy-step.png
index 550ea1bf2..550ea1bf2 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/configure-the-deploy-step.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/configure-the-deploy-step.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/creating-a-basic-hugo-site.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/creating-a-basic-hugo-site.png
index 78d238f88..78d238f88 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/creating-a-basic-hugo-site.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/creating-a-basic-hugo-site.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/public-or-not.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/public-or-not.png
index 9d81a8ba4..9d81a8ba4 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/public-or-not.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/public-or-not.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/using-hugo-build.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/using-hugo-build.png
index b0dbec94c..b0dbec94c 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/using-hugo-build.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/using-hugo-build.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-access.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-access.png
index 6e89c0ef3..6e89c0ef3 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-access.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-access.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-add-app.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-add-app.png
index 94ccef518..94ccef518 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-add-app.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-add-app.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-git-connections.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-git-connections.png
index d89c0cd8b..d89c0cd8b 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-git-connections.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-git-connections.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-search.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-search.png
index d099cfd5c..d099cfd5c 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-search.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-search.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-owner.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-owner.png
index 111308508..111308508 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-owner.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-owner.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-repository.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-repository.png
index e8835f21a..e8835f21a 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-repository.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/wercker-select-repository.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/deployment-with-wercker/werckeryml.png b/docs/static/images/hosting-and-deployment/deployment-with-wercker/werckeryml.png
index be46e6136..be46e6136 100755..100644
--- a/docs/static/images/hosting-and-deployment/deployment-with-wercker/werckeryml.png
+++ b/docs/static/images/hosting-and-deployment/deployment-with-wercker/werckeryml.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.png b/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.png
index b78f6fd15..b78f6fd15 100755..100644
--- a/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.png
+++ b/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-blog-post.png
Binary files differ
diff --git a/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.png b/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.png
index e97f13465..e97f13465 100755..100644
--- a/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.png
+++ b/docs/static/images/hosting-and-deployment/hosting-on-bitbucket/bitbucket-create-repo.png
Binary files differ
diff --git a/docs/themes/gohugoioTheme/README.md b/docs/themes/gohugoioTheme/README.md
index c95c9e739..1898fb19a 100644
--- a/docs/themes/gohugoioTheme/README.md
+++ b/docs/themes/gohugoioTheme/README.md
@@ -1 +1,7 @@
-Theme for gohugo.io sites. More info to come.
+# GoHugo Sites Theme
+
+Theme for gohugo.io sites:
+* [https://gohugo.io/](https://gohugo.io/)
+* [https://themes.gohugo.io/](https://themes.gohugo.io/)
+
+More info to come.
diff --git a/docs/themes/gohugoioTheme/layouts/404.html b/docs/themes/gohugoioTheme/layouts/404.html
index 156db1452..156db1452 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/404.html
+++ b/docs/themes/gohugoioTheme/layouts/404.html
diff --git a/docs/themes/gohugoioTheme/layouts/_default/baseof.html b/docs/themes/gohugoioTheme/layouts/_default/baseof.html
index 3a0a9f7f2..3a0a9f7f2 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/_default/baseof.html
+++ b/docs/themes/gohugoioTheme/layouts/_default/baseof.html
diff --git a/docs/themes/gohugoioTheme/layouts/_default/list.html b/docs/themes/gohugoioTheme/layouts/_default/list.html
index 3b7a2307e..3b7a2307e 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/_default/list.html
+++ b/docs/themes/gohugoioTheme/layouts/_default/list.html
diff --git a/docs/themes/gohugoioTheme/layouts/_default/single.html b/docs/themes/gohugoioTheme/layouts/_default/single.html
index 8cd289624..8cd289624 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/_default/single.html
+++ b/docs/themes/gohugoioTheme/layouts/_default/single.html
diff --git a/docs/themes/gohugoioTheme/layouts/_default/taxonomy.html b/docs/themes/gohugoioTheme/layouts/_default/taxonomy.html
index 9968398b2..77d1812d9 100644
--- a/docs/themes/gohugoioTheme/layouts/_default/taxonomy.html
+++ b/docs/themes/gohugoioTheme/layouts/_default/taxonomy.html
@@ -1,4 +1,4 @@
{{ define "main" }}
- {{ $section_to_display := .Data.Pages }}
+ {{ $section_to_display := .Pages }}
{{ partial "pagelayout.html" (dict "context" . "section_to_display" $section_to_display ) }}
{{ end }}
diff --git a/docs/themes/gohugoioTheme/layouts/_default/terms.html b/docs/themes/gohugoioTheme/layouts/_default/terms.html
index 28795cf44..f6b566656 100644
--- a/docs/themes/gohugoioTheme/layouts/_default/terms.html
+++ b/docs/themes/gohugoioTheme/layouts/_default/terms.html
@@ -1,6 +1,6 @@
{{/* {{ define "header" }}{{ partial "page-header" . }}{{ end }} */}}
{{ define "main" }}
-{{ $section_to_display := .Data.Pages }}
+{{ $section_to_display := .Pages }}
<div class="w-100 ph4 pb5 pb6-ns pt1 pt3-ns">
<div class="flex">
diff --git a/docs/themes/gohugoioTheme/layouts/partials/boxes-small-news.html b/docs/themes/gohugoioTheme/layouts/partials/boxes-small-news.html
index ad254b6aa..0d89f057f 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/boxes-small-news.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/boxes-small-news.html
@@ -3,7 +3,7 @@
<!-- <a href="/news/" class="link accent-color tr-ns f6 w-100 w-50-m w-10-l bg-animate hover-bg-accent-color hover-white pv3 pv4-l ph3 ph4-l dib">
Latest News:
</a> -->
- {{ range first 4 ( sort (where .Data.Pages "Section" "news") "Date" "desc" ) }}
+ {{ range first 4 ( sort (where .Pages "Section" "news") "Date" "desc" ) }}
<!-- only show 2 boxes on mobile -->
{{ $.Scratch.Add "i" 1 }}{{ $i := $.Scratch.Get "i" }}
<a href="{{ .URL }}" class="link lh-copy light-gray f6 w-100 w-50-m w-25-l bg-animate hover-bg-accent-color hover-white pv3 pv4-ns ph3 ph4-ns{{ if ge $i 3 }} dn dib-l{{ else }} dib{{ end }}">
diff --git a/docs/themes/gohugoioTheme/layouts/partials/icon-link.html b/docs/themes/gohugoioTheme/layouts/partials/icon-link.html
index dec9ae48b..dec9ae48b 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/icon-link.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/icon-link.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/manifest.html b/docs/themes/gohugoioTheme/layouts/partials/manifest.html
index 54472ba16..54472ba16 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/manifest.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/manifest.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/nav-links.html b/docs/themes/gohugoioTheme/layouts/partials/nav-links.html
index af3790b16..af3790b16 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/nav-links.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/nav-links.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/nav-top.html b/docs/themes/gohugoioTheme/layouts/partials/nav-top.html
index d8e87eb63..d8e87eb63 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/nav-top.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/nav-top.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/page-edit.html b/docs/themes/gohugoioTheme/layouts/partials/page-edit.html
index edf84669e..edf84669e 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/page-edit.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/page-edit.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/site-footer.html b/docs/themes/gohugoioTheme/layouts/partials/site-footer.html
index 771ec348f..771ec348f 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/site-footer.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/site-footer.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/site-nav.html b/docs/themes/gohugoioTheme/layouts/partials/site-nav.html
index eabf0ea7c..eabf0ea7c 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/site-nav.html
+++ b/docs/themes/gohugoioTheme/layouts/partials/site-nav.html
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/apple.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/apple.svg
index 6f3c20f76..6f3c20f76 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/apple.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/apple.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/facebook.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/facebook.svg
index 6e6af44a2..6e6af44a2 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/facebook.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/facebook.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/freebsd.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/freebsd.svg
index 842be09a1..842be09a1 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/freebsd.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/freebsd.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/github-squared.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/github-squared.svg
index dabc741e0..dabc741e0 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/github-squared.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/github-squared.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-front.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-front.svg
index 0f8fbe0d9..0f8fbe0d9 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-front.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-front.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-side_path.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-side_path.svg
index 05cfb84d1..05cfb84d1 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-side_path.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/gopher-side_path.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/instagram.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/instagram.svg
index ae915113b..ae915113b 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/instagram.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/instagram.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/link-ext.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/link-ext.svg
index ba9400b7f..ba9400b7f 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/link-ext.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/link-ext.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/md.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/md.svg
index f1a794565..f1a794565 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/md.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/md.svg
diff --git a/docs/themes/gohugoioTheme/layouts/partials/svg/windows.svg b/docs/themes/gohugoioTheme/layouts/partials/svg/windows.svg
index fe3bf0296..fe3bf0296 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/partials/svg/windows.svg
+++ b/docs/themes/gohugoioTheme/layouts/partials/svg/windows.svg
diff --git a/docs/themes/gohugoioTheme/layouts/robots.txt b/docs/themes/gohugoioTheme/layouts/robots.txt
index 25b9e9a0d..25b9e9a0d 100755..100644
--- a/docs/themes/gohugoioTheme/layouts/robots.txt
+++ b/docs/themes/gohugoioTheme/layouts/robots.txt
diff --git a/docs/themes/gohugoioTheme/src/css/_columns.css b/docs/themes/gohugoioTheme/src/css/_columns.css
index e1e938c74..e1e938c74 100755..100644
--- a/docs/themes/gohugoioTheme/src/css/_columns.css
+++ b/docs/themes/gohugoioTheme/src/css/_columns.css
diff --git a/docs/themes/gohugoioTheme/src/css/_tachyons.css b/docs/themes/gohugoioTheme/src/css/_tachyons.css
index d697c4d85..d697c4d85 100755..100644
--- a/docs/themes/gohugoioTheme/src/css/_tachyons.css
+++ b/docs/themes/gohugoioTheme/src/css/_tachyons.css
diff --git a/docs/themes/gohugoioTheme/src/css/_variables.css b/docs/themes/gohugoioTheme/src/css/_variables.css
index 8701b1530..8701b1530 100755..100644
--- a/docs/themes/gohugoioTheme/src/css/_variables.css
+++ b/docs/themes/gohugoioTheme/src/css/_variables.css
diff --git a/docs/themes/gohugoioTheme/src/css/main.css b/docs/themes/gohugoioTheme/src/css/main.css
index a3ad83a0a..a3ad83a0a 100755..100644
--- a/docs/themes/gohugoioTheme/src/css/main.css
+++ b/docs/themes/gohugoioTheme/src/css/main.css
diff --git a/docs/themes/gohugoioTheme/src/css/postcss.config.js b/docs/themes/gohugoioTheme/src/css/postcss.config.js
index 4b9d4a7ac..4b9d4a7ac 100755..100644
--- a/docs/themes/gohugoioTheme/src/css/postcss.config.js
+++ b/docs/themes/gohugoioTheme/src/css/postcss.config.js
diff --git a/docs/themes/gohugoioTheme/src/js/main.js b/docs/themes/gohugoioTheme/src/js/main.js
index b6ae53f3c..b6ae53f3c 100755..100644
--- a/docs/themes/gohugoioTheme/src/js/main.js
+++ b/docs/themes/gohugoioTheme/src/js/main.js
diff --git a/docs/themes/gohugoioTheme/src/package.json b/docs/themes/gohugoioTheme/src/package.json
index 04bd261f3..04bd261f3 100755..100644
--- a/docs/themes/gohugoioTheme/src/package.json
+++ b/docs/themes/gohugoioTheme/src/package.json
diff --git a/docs/themes/gohugoioTheme/src/readme.md b/docs/themes/gohugoioTheme/src/readme.md
index db7041a1b..db7041a1b 100755..100644
--- a/docs/themes/gohugoioTheme/src/readme.md
+++ b/docs/themes/gohugoioTheme/src/readme.md
diff --git a/docs/themes/gohugoioTheme/src/webpack.config.js b/docs/themes/gohugoioTheme/src/webpack.config.js
index 284cbcb1e..284cbcb1e 100755..100644
--- a/docs/themes/gohugoioTheme/src/webpack.config.js
+++ b/docs/themes/gohugoioTheme/src/webpack.config.js
diff --git a/docs/themes/gohugoioTheme/static/images/gopher-side_color.svg b/docs/themes/gohugoioTheme/static/images/gopher-side_color.svg
index 85f949783..85f949783 100755..100644
--- a/docs/themes/gohugoioTheme/static/images/gopher-side_color.svg
+++ b/docs/themes/gohugoioTheme/static/images/gopher-side_color.svg
diff --git a/docs/themes/gohugoioTheme/static/images/homepage-screenshot-hugo-themes.jpg b/docs/themes/gohugoioTheme/static/images/homepage-screenshot-hugo-themes.jpg
index 0f60f6a4e..0f60f6a4e 100755..100644
--- a/docs/themes/gohugoioTheme/static/images/homepage-screenshot-hugo-themes.jpg
+++ b/docs/themes/gohugoioTheme/static/images/homepage-screenshot-hugo-themes.jpg
Binary files differ