commit 914cc85e22af2e6c28f24a5fc70de94e4b9f1b1b parent a6816db77574ba3d48a6414c97a53a691c34e705 Author: Bjørn Erik Pedersen <bjorn.erik.pedersen@gmail.com> Date: Fri, 4 May 2018 09:44:59 +0200 Merge commit '83bef6955e014d40c0f00db9cebe09113154e999' Diffstat:
425 files changed, 5135 insertions(+), 4631 deletions(-)
diff --git a/docs/config.toml b/docs/config.toml
@@ -271,3 +271,139 @@ anchor = "smart"
identifier = "github"
post = "external"
url = "https://github.com/gohugoio/hugo"
+
+### LANGUAGES ###
+
+[languages]
+ [languages.en]
+ contentDir = "content/en"
+ languageName = "English"
+ weight = 1
+ [languages.zh]
+ contentDir = "content/zh"
+ languageName = "中文"
+ weight = 2
+
+
+### LANGUAGE-SPECIFIC MENUS ###
+
+# Chinese menus
+
+[[languages.zh.menu.docs]]
+ name = "关于 Hugo"
+ weight = 1
+ identifier = "about"
+ url = "/zh/about/"
+
+[[languages.zh.menu.docs]]
+ name = "入门"
+ weight = 5
+ identifier = "getting-started"
+ url = "/zh/getting-started/"
+
+[[languages.zh.menu.docs]]
+ name = "主题"
+ weight = 15
+ identifier = "themes"
+ post = "break"
+ url = "/zh/themes/"
+
+# Core languages.zh.menus
+
+[[languages.zh.menu.docs]]
+ name = "内容管理"
+ weight = 20
+ identifier = "content-management"
+ post = "expanded"
+ url = "/zh/content-management/"
+
+[[languages.zh.menu.docs]]
+ name = "模板"
+ weight = 25
+ identifier = "templates"
+ url = "/zh/templates/"
+
+[[languages.zh.menu.docs]]
+ name = "函数"
+ weight = 30
+ identifier = "functions"
+ url = "/zh/functions/"
+
+[[languages.zh.menu.docs]]
+ name = "变量"
+ weight = 35
+ identifier = "variables"
+ url = "/zh/variables/"
+
+[[languages.zh.menu.docs]]
+ name = "CLI"
+ weight = 40
+ post = "break"
+ identifier = "commands"
+ url = "/commands/"
+
+# LOW LEVEL ITEMS
+[[languages.zh.menu.docs]]
+ name = "故障排除"
+ weight = 60
+ identifier = "troubleshooting"
+ url = "/zh/troubleshooting/"
+
+[[languages.zh.menu.docs]]
+ name = "工具"
+ weight = 70
+ identifier = "tools"
+ url = "/zh/tools/"
+
+[[languages.zh.menu.docs]]
+ name = "托管与部署"
+ weight = 80
+ identifier = "hosting-and-deployment"
+ url = "/zh/hosting-and-deployment/"
+
+[[languages.zh.menu.docs]]
+ name = "贡献"
+ weight = 100
+ post = "break"
+ identifier = "contribute"
+ url = "/zh/contribute/"
+
+[[languages.zh.menu.global]]
+ name = "新闻"
+ weight = 1
+ identifier = "news"
+ url = "/zh/news/"
+
+[[languages.zh.menu.global]]
+ name = "文档"
+ weight = 5
+ identifier = "docs"
+ url = "/zh/documentation/"
+
+[[languages.zh.menu.global]]
+ name = "主题"
+ weight = 10
+ identifier = "themes"
+ url = "https://themes.gohugo.io/"
+
+[[languages.zh.menu.global]]
+ name = "作品展示"
+ weight = 20
+ identifier = "showcase"
+ url = "/zh/showcase/"
+
+# Anything with a weight > 100 gets an external icon
+[[languages.zh.menu.global]]
+ name = "社区"
+ weight = 150
+ icon = true
+ identifier = "community"
+ post = "external"
+ url = "https://discourse.gohugo.io/"
+
+[[languages.zh.menu.global]]
+ name = "GitHub"
+ weight = 200
+ identifier = "github"
+ post = "external"
+ url = "https://github.com/gohugoio/hugo"
diff --git a/docs/content/content-management/archetypes.md b/docs/content/content-management/archetypes.md
@@ -1,75 +0,0 @@
----
-title: Archetypes
-linktitle: Archetypes
-description: Archetypes are templates used when creating new content.
-date: 2017-02-01
-publishdate: 2017-02-01
-keywords: [archetypes,generators,metadata,front matter]
-categories: ["content management"]
-menu:
- docs:
- parent: "content-management"
- weight: 70
- quicklinks:
-weight: 70 #rem
-draft: false
-aliases: [/content/archetypes/]
-toc: true
----
-
-## What are Archetypes?
-
-**Archetypes** are content template files in the [archetypes directory][] of your project that contain preconfigured [front matter][] and possibly also a content disposition for your website's [content types][]. These will be used when you run `hugo new`.
-
-
-The `hugo new` uses the `content-section` to find the most suitable archetype template in your project. If your project does not contain any archetype files, it will also look in the theme.
-
-{{< code file="archetype-example.sh" >}}
-hugo new posts/my-first-post.md
-{{< /code >}}
-
-The above will create a new content file in `content/posts/my-first-post.md` using the first archetype file found of these:
-
-1. `archetypes/posts.md`
-2. `archetypes/default.md`
-3. `themes/my-theme/posts.md`
-4. `themes/my-theme/default.md`
-
-The last two list items is only applicable if you use a theme and it uses the `my-theme` theme name as an example.
-
-## Create a New Archetype Template
-
-A fictional example for the section `newsletter` and the archetype file `archetypes/newsletter.md`. Create a new file in `archetypes/newsletter.md` and open it in a text editor.
-
-{{< code file="archetypes/newsletter.md" >}}
----
-title: "{{ replace .Name "-" " " | title }}"
-date: {{ .Date }}
-draft: true
----
-
-**Insert Lead paragraph here.**
-
-## New Cool Posts
-
-{{ range first 10 ( where .Site.RegularPages "Type" "cool" ) }}
-* {{ .Title }}
-{{ end }}
-{{< /code >}}
-
-When you create a new newsletter with:
-
-```bash
-hugo new newsletter/the-latest-cool.stuff.md
-```
-
-It will create a new newsletter type of content file based on the archetype template.
-
-**Note:** the site will only be built if the `.Site` is in use in the archetype file, and this can be time consuming for big sites.
-
-The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo's template funcs can be used in the archetype file.
-
-
-[archetypes directory]: /getting-started/directory-structure/
-[content types]: /content-management/types/
-[front matter]: /content-management/front-matter/
diff --git a/docs/content/content-management/formats.md b/docs/content/content-management/formats.md
@@ -1,249 +0,0 @@
----
-title: Supported Content Formats
-linktitle: Supported Content Formats
-description: Markdown and Emacs Org-Mode have native support, and additional formats (e.g. Asciidoc) come via external helpers.
-date: 2017-01-10
-publishdate: 2017-01-10
-lastmod: 2017-04-06
-categories: [content management]
-keywords: [markdown,asciidoc,mmark,pandoc,content format]
-menu:
- docs:
- parent: "content-management"
- weight: 20
-weight: 20 #rem
-draft: false
-aliases: [/content/markdown-extras/,/content/supported-formats/,/doc/supported-formats/,/tutorials/mathjax/]
-toc: true
----
-
-**Markdown is the main content format** and comes in two flavours: The excellent [Blackfriday project][blackfriday] (name your files `*.md` or set `markup = "markdown"` in front matter) or its fork [Mmark][mmark] (name your files `*.mmark` or set `markup = "mmark"` in front matter), both very fast markdown engines written in Go.
-
-For Emacs users, [goorgeous](https://github.com/chaseadamsio/goorgeous) provides built-in native support for Org-mode (name your files `*.org` or set `markup = "org"` in front matter)
-
-{{% note "Deeply Nested Lists" %}}
-Before you begin writing your content in markdown, Blackfriday has a known issue [(#329)](https://github.com/russross/blackfriday/issues/329) with handling deeply nested lists. Luckily, there is an easy workaround. Use 4-spaces (i.e., <kbd>tab</kbd>) rather than 2-space indentations.
-{{% /note %}}
-
-## Configure BlackFriday Markdown Rendering
-
-You can configure multiple aspects of Blackfriday as show in the following list. See the docs on [Configuration][config] for the full list of explicit directions you can give to Hugo when rendering your site.
-
-{{< readfile file="/content/readfiles/bfconfig.md" markdown="true" >}}
-
-## Extend Markdown
-
-Hugo provides some convenient methods for extending markdown.
-
-### Task Lists
-
-Hugo supports [GitHub-styled task lists (i.e., TODO lists)][gfmtasks] for the Blackfriday markdown renderer. If you do not want to use this feature, you can disable it in your configuration.
-
-#### Example Task List Input
-
-{{< code file="content/my-to-do-list.md" >}}
-- [ ] a task list item
-- [ ] list syntax required
-- [ ] incomplete
-- [x] completed
-{{< /code >}}
-
-#### Example Task List Output
-
-The preceding markdown produces the following HTML in your rendered website:
-
-```
-<ul class="task-list">
- <li><input type="checkbox" disabled="" class="task-list-item"> a task list item</li>
- <li><input type="checkbox" disabled="" class="task-list-item"> list syntax required</li>
- <li><input type="checkbox" disabled="" class="task-list-item"> incomplete</li>
- <li><input type="checkbox" checked="" disabled="" class="task-list-item"> completed</li>
-</ul>
-```
-
-#### Example Task List Display
-
-The following shows how the example task list will look to the end users of your website. Note that visual styling of lists is up to you. This list has been styled according to [the Hugo Docs stylesheet][hugocss].
-
-- [ ] a task list item
-- [ ] list syntax required
-- [ ] incomplete
-- [x] completed
-
-### Emojis
-
-To add emojis directly to content, set `enableEmoji` to `true` in your [site configuration][config]. To use emojis in templates or shortcodes, see [`emojify` function][].
-
-For a full list of emojis, see the [Emoji cheat sheet][emojis].
-
-### Shortcodes
-
-If you write in Markdown and find yourself frequently embedding your content with raw HTML, Hugo provides built-in shortcodes functionality. This is one of the most powerful features in Hugo and allows you to create your own Markdown extensions very quickly.
-
-See [Shortcodes][sc] for usage, particularly for the built-in shortcodes that ship with Hugo, and [Shortcode Templating][sct] to learn how to build your own.
-
-### Code Blocks
-
-Hugo supports GitHub-flavored markdown's use of triple back ticks, as well as provides a special [`highlight` shortcode][hlsc], and syntax highlights those code blocks natively using *Chroma*. Users also have an option to use *Pygments* instead. See the [Syntax Highlighting][hl] section for details.
-
-## Mmark
-
-Mmark is a [fork of BlackFriday][mmark] and markdown superset that is well suited for writing [IETF documentation][ietf]. You can see examples of the syntax in the [Mmark GitHub repository][mmarkgh] or the full syntax on [Miek Gieben's website][].
-
-### Use Mmark
-
-As Hugo ships with Mmark, using the syntax is as easy as changing the extension of your content files from `.md` to `.mmark`.
-
-In the event that you want to only use Mmark in specific files, you can also define the Mmark syntax in your content's front matter:
-
-```
----
-title: My Post
-date: 2017-04-01
-markup: mmark
----
-```
-
-{{% warning %}}
-Thare are some features not available in Mmark; one example being that shortcodes are not translated when used in an included `.mmark` file ([#3131](https://github.com/gohugoio/hugo/issues/3137)), and `EXTENSION_ABBREVIATION` ([#1970](https://github.com/gohugoio/hugo/issues/1970)) and the aforementioned GFM todo lists ([#2270](https://github.com/gohugoio/hugo/issues/2270)) are not fully supported. Contributions are welcome.
-{{% /warning %}}
-
-## MathJax with Hugo
-
-[MathJax](http://www.mathjax.org/) is a JavaScript library that allows the display of mathematical expressions described via a LaTeX-style syntax in the HTML (or Markdown) source of a web page. As it is a pure a JavaScript library, getting it to work within Hugo is fairly straightforward, but does have some oddities that will be discussed here.
-
-This is not an introduction into actually using MathJax to render typeset mathematics on your website. Instead, this page is a collection of tips and hints for one way to get MathJax working on a website built with Hugo.
-
-### Enable MathJax
-
-The first step is to enable MathJax on pages that you would like to have typeset math. There are multiple ways to do this (adventurous readers can consult the [Loading and Configuring](http://docs.mathjax.org/en/latest/configuration.html) section of the MathJax documentation for additional methods of including MathJax), but the easiest way is to use the secure MathJax CDN by include a `<script>` tag for the officially recommended secure CDN ([cdn.js.com](https://cdnjs.com)):
-
-{{< code file="add-mathjax-to-page.html" >}}
-<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
-</script>
-{{< /code >}}
-
-One way to ensure that this code is included in all pages is to put it in one of the templates that live in the `layouts/partials/` directory. For example, I have included this in the bottom of my template `footer.html` because I know that the footer will be included in every page of my website.
-
-### Options and Features
-
-MathJax is a stable open-source library with many features. I encourage the interested reader to view the [MathJax Documentation](http://docs.mathjax.org/en/latest/index.html), specifically the sections on [Basic Usage](http://docs.mathjax.org/en/latest/index.html#basic-usage) and [MathJax Configuration Options](http://docs.mathjax.org/en/latest/index.html#mathjax-configuration-options).
-
-### Issues with Markdown
-
-{{% note %}}
-The following issues with Markdown assume you are using `.md` for content and BlackFriday for parsing. Using [Mmark](#mmark) as your content format will obviate the need for the following workarounds.
-
-When using Mmark with MathJax, use `displayMath: [['$$','$$'], ['\\[','\\]']]`. See the [Mmark `README.md`](https://github.com/miekg/mmark/wiki/Syntax#math-blocks) for more information. In addition to MathJax, Mmark has been shown to work well with [KaTeX](https://github.com/Khan/KaTeX). See this [related blog post from a Hugo user](http://nosubstance.me/post/a-great-toolset-for-static-blogging/).
-{{% /note %}}
-
-After enabling MathJax, any math entered between proper markers (see the [MathJax documentation][mathjaxdocs]) will be processed and typeset in the web page. One issue that comes up, however, with Markdown is that the underscore character (`_`) is interpreted by Markdown as a way to wrap text in `emph` blocks while LaTeX (MathJax) interprets the underscore as a way to create a subscript. This "double speak" of the underscore can result in some unexpected and unwanted behavior.
-
-### Solution
-
-There are multiple ways to remedy this problem. One solution is to simply escape each underscore in your math code by entering `\_` instead of `_`. This can become quite tedious if the equations you are entering are full of subscripts.
-
-Another option is to tell Markdown to treat the MathJax code as verbatim code and not process it. One way to do this is to wrap the math expression inside a `<div>` `</div>` block. Markdown would ignore these sections and they would get passed directly on to MathJax and processed correctly. This works great for display style mathematics, but for inline math expressions the line break induced by the `<div>` is not acceptable. The syntax for instructing Markdown to treat inline text as verbatim is by wrapping it in backticks (`` ` ``). You might have noticed, however, that the text included in between backticks is rendered differently than standard text (on this site these are items highlighted in red). To get around this problem, we could create a new CSS entry that would apply standard styling to all inline verbatim text that includes MathJax code. Below I will show the HTML and CSS source that would accomplish this (note this solution was adapted from [this blog post](http://doswa.com/2011/07/20/mathjax-in-markdown.html)---all credit goes to the original author).
-
-{{< code file="mathjax-markdown-solution.html" >}}
-<script type="text/x-mathjax-config">
-MathJax.Hub.Config({
- tex2jax: {
- inlineMath: [['$','$'], ['\\(','\\)']],
- displayMath: [['$$','$$'], ['\[','\]']],
- processEscapes: true,
- processEnvironments: true,
- skipTags: ['script', 'noscript', 'style', 'textarea', 'pre'],
- TeX: { equationNumbers: { autoNumber: "AMS" },
- extensions: ["AMSmath.js", "AMSsymbols.js"] }
- }
-});
-</script>
-
-<script type="text/x-mathjax-config">
- MathJax.Hub.Queue(function() {
- // Fix <code> tags after MathJax finishes running. This is a
- // hack to overcome a shortcoming of Markdown. Discussion at
- // https://github.com/mojombo/jekyll/issues/199
- var all = MathJax.Hub.getAllJax(), i;
- for(i = 0; i < all.length; i += 1) {
- all[i].SourceElement().parentNode.className += ' has-jax';
- }
-});
-</script>
-{{< /code >}}
-
-
-
-As before, this content should be included in the HTML source of each page that will be using MathJax. The next code snippet contains the CSS that is used to have verbatim MathJax blocks render with the same font style as the body of the page.
-
-{{< code file="mathjax-style.css" >}}
-code.has-jax {
- font: inherit;
- font-size: 100%;
- background: inherit;
- border: inherit;
- color: #515151;
-}
-{{< /code >}}
-
-In the CSS snippet, notice the line `color: #515151;`. `#515151` is the value assigned to the `color` attribute of the `body` class in my CSS. In order for the equations to fit in with the body of a web page, this value should be the same as the color of the body.
-
-### Usage
-
-With this setup, everything is in place for a natural usage of MathJax on pages generated using Hugo. In order to include inline mathematics, just put LaTeX code in between `` `$ TeX Code $` `` or `` `\( TeX Code \)` ``. To include display style mathematics, just put LaTeX code in between `<div>$$TeX Code$$</div>`. All the math will be properly typeset and displayed within your Hugo generated web page!
-
-## Additional Formats Through External Helpers
-
-Hugo has a new concept called _external helpers_. It means that you can write your content using [Asciidoc][ascii], [reStructuredText][rest], or [pandoc]. If you have files with associated extensions, Hugo will call external commands to generate the content. ([See the Hugo source code for external helpers][helperssource].)
-
-For example, for Asciidoc files, Hugo will try to call the `asciidoctor` or `asciidoc` command. This means that you will have to install the associated tool on your machine to be able to use these formats. ([See the Asciidoctor docs for installation instructions](http://asciidoctor.org/docs/install-toolchain/)).
-
-To use these formats, just use the standard extension and the front matter exactly as you would do with natively supported `.md` files.
-
-Hugo passes reasonable default arguments to these external helpers by default:
-
-- `asciidoc`: `--no-header-footer --safe -`
-- `asciidoctor`: `--no-header-footer --safe --trace -`
-- `rst2html`: `--leave-comments --initial-header-level=2`
-- `pandoc`: `--mathjax`
-
-{{% warning "Performance of External Helpers" %}}
-Because additional formats are external commands generation performance will rely heavily on the performance of the external tool you are using. As this feature is still in its infancy, feedback is welcome.
-{{% /warning %}}
-
-## Learn Markdown
-
-Markdown syntax is simple enough to learn in a single sitting. The following are excellent resources to get you up and running:
-
-* [Daring Fireball: Markdown, John Gruber (Creator of Markdown)][fireball]
-* [Markdown Cheatsheet, Adam Pritchard][mdcheatsheet]
-* [Markdown Tutorial (Interactive), Garen Torikian][mdtutorial]
-
-[`emojify` function]: /functions/emojify/
-[ascii]: http://asciidoctor.org/
-[bfconfig]: /getting-started/configuration/#configuring-blackfriday-rendering
-[blackfriday]: https://github.com/russross/blackfriday
-[mmark]: https://github.com/miekg/mmark
-[config]: /getting-started/configuration/
-[developer tools]: /tools/
-[emojis]: https://www.webpagefx.com/tools/emoji-cheat-sheet/
-[fireball]: https://daringfireball.net/projects/markdown/
-[gfmtasks]: https://guides.github.com/features/mastering-markdown/#syntax
-[helperssource]: https://github.com/gohugoio/hugo/blob/77c60a3440806067109347d04eb5368b65ea0fe8/helpers/general.go#L65
-[hl]: /content-management/syntax-highlighting/
-[hlsc]: /content-management/shortcodes/#highlight
-[hugocss]: /css/style.css
-[ietf]: https://tools.ietf.org/html/
-[mathjaxdocs]: https://docs.mathjax.org/en/latest/
-[mdcheatsheet]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
-[mdtutorial]: http://www.markdowntutorial.com/
-[Miek Gieben's website]: https://miek.nl/2016/March/05/mmark-syntax-document/
-[mmark]: https://github.com/miekg/mmark
-[mmarkgh]: https://github.com/miekg/mmark/wiki/Syntax
-[org]: http://orgmode.org/
-[pandoc]: http://www.pandoc.org/
-[Pygments]: http://pygments.org/
-[rest]: http://docutils.sourceforge.net/rst.html
-[sc]: /content-management/shortcodes/
-[sct]: /templates/shortcode-templates/
diff --git a/docs/content/content-management/page-bundles.md b/docs/content/content-management/page-bundles.md
@@ -1,182 +0,0 @@
----
-title : "Page Bundles"
-description : "Content organization using Page Bundles"
-date : 2018-01-24T13:09:00-05:00
-lastmod : 2018-01-28T22:26:40-05:00
-linktitle : "Page Bundles"
-keywords : ["page", "bundle", "leaf", "branch"]
-categories : ["content management"]
-toc : true
-menu :
- docs:
- identifier : "page-bundles"
- parent : "content-management"
- weight : 11
----
-
-Page Bundles are a way to group [Page Resources](/content-management/page-resources/).
-
-A Page Bundle can be one of:
-
-- Leaf Bundle (leaf means it has no children)
-- Branch Bundle (home page, section, taxonomy terms, taxonomy list)
-
-| | Leaf Bundle | Branch Bundle |
-|-----------------|--------------------------------------------------------|---------------------------------------------------------|
-| Usage | Collection of resources (pages, images etc.) for single pages | Collection of non-page resources (images etc.)for list pages |
-| Index file name | `index.md` [^fn:1] | `_index.md` [^fn:1] |
-| Layout type | `single` | `list` |
-| Nesting | Doesn't allow nesting of more bundles under it | Allows nesting of leaf/branch bundles under it |
-| Example | `content/posts/my-post/index.md` | `content/posts/_index.md` |
-
-
-## Leaf Bundles {#leaf-bundles}
-
-A _Leaf Bundle_ is a directory at any hierarchy within the `content/`
-directory, that contains an **`index.md`** file.
-
-### Examples of Leaf Bundle organization {#examples-of-leaf-bundle-organization}
-
-```text
-content/
-├── about
-│ ├── index.md
-├── posts
-│ ├── my-post
-│ │ ├── content1.md
-│ │ ├── content2.md
-│ │ ├── image1.jpg
-│ │ ├── image2.png
-│ │ └── index.md
-│ └── my-another-post
-│ └── index.md
-│
-└── another-section
- ├── ..
- └── not-a-leaf-bundle
- ├── ..
- └── another-leaf-bundle
- └── index.md
-```
-
-In the above example `content/` directory, there are four leaf
-bundles:
-
-about
-: This leaf bundle is at the root level (directly under
- `content` directory) and has only the `index.md`.
-
-my-post
-: This leaf bundle has the `index.md`, two other content
- Markdown files and two image files.
-
-my-another-post
-: This leaf bundle has only the `index.md`.
-
-another-leaf-bundle
-: This leaf bundle is nested under couple of
- directories. This bundle also has only the `index.md`.
-
-{{% note %}}
-The hierarchy depth at which a leaf bundle is created does not matter,
-as long as it is not inside another **leaf** bundle.
-{{% /note %}}
-
-
-### Headless Bundle {#headless-bundle}
-
-A headless bundle is a bundle that is configured to not get published
-anywhere:
-
-- It will have no `Permalink` and no rendered HTML in `public/`.
-- It will not be part of `.Site.RegularPages`, etc.
-
-But you can get it by `.Site.GetPage`. Here is an example:
-
-```go-html-template
-{{ $headless := .Site.GetPage "page" "some-headless-bundle" }}
-{{ $reusablePages := $headless.Resources.Match "author*" }}
-<h2>Authors</h2>
-{{ range $reusablePages }}
- <h3>{{ .Title }}</h3>
- {{ .Content }}
-{{ end }}
-```
-
-_In this example, we are assuming the `some-headless-bundle` to be a headless
- bundle containing one or more **page** resources whose `.Name` matches
- `"author*"`._
-
-Explanation of the above example:
-
-1. Get the `some-headless-bundle` Page "object".
-2. Collect a *slice* of resources in this *Page Bundle* that matches
- `"author*"` using `.Resources.Match`.
-3. Loop through that *slice* of nested pages, and output their `.Title` and
- `.Content`.
-
----
-
-A leaf bundle can be made headless by adding below in the Front Matter
-(in the `index.md`):
-
-```toml
-headless = true
-```
-
-{{% note %}}
-Only leaf bundles can be made headless.
-{{% /note %}}
-
-There are many use cases of such headless page bundles:
-
-- Shared media galleries
-- Reusable page content "snippets"
-
-
-## Branch Bundles {#branch-bundles}
-
-A _Branch Bundle_ is any directory at any hierarchy within the
-`content/` directory, that contains at least an **`_index.md`** file.
-
-This `_index.md` can also be directly under the `content/` directory.
-
-{{% note %}}
-Here `md` (markdown) is used just as an example. You can use any file
-type as a content resource as long as it is a content type recognized by Hugo.
-{{% /note %}}
-
-
-### Examples of Branch Bundle organization {#examples-of-branch-bundle-organization}
-
-```text
-content/
-├── branch-bundle-1
-│ ├── branch-content1.md
-│ ├── branch-content2.md
-│ ├── image1.jpg
-│ ├── image2.png
-│ └── _index.md
-└── branch-bundle-2
- ├── _index.md
- └── a-leaf-bundle
- └── index.md
-```
-
-In the above example `content/` directory, there are two branch
-bundles (and a leaf bundle):
-
-`branch-bundle-1`
-: This branch bundle has the `_index.md`, two
- other content Markdown files and two image files.
-
-`branch-bundle-2`
-: This branch bundle has the `_index.md` and a
- nested leaf bundle.
-
-{{% note %}}
-The hierarchy depth at which a branch bundle is created does not
-matter.
-{{% /note %}}
-
-[^fn:1]: The `.md` extension is just an example. The extension can be `.html`, `.json` or any of any valid MIME type.
diff --git a/docs/content/content-management/sections.md b/docs/content/content-management/sections.md
@@ -1,98 +0,0 @@
----
-title: Content Sections
-linktitle: Sections
-description: "Hugo generates a **section tree** that matches your content."
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-02-01
-categories: [content management]
-keywords: [lists,sections,content types,organization]
-menu:
- docs:
- parent: "content-management"
- weight: 50
-weight: 50 #rem
-draft: false
-aliases: [/content/sections/]
-toc: true
----
-
-A **Section** is a collection of pages that gets defined based on the
-organization structure under the `content/` directory.
-
-By default, all the **first-level** directories under `content/` form their own
-sections (**root sections**).
-
-If a user needs to define a section `foo` at a deeper level, they need to create
-a directory named `foo` with an `_index.md` file (see [Branch Bundles][branch bundles]
-for more information).
-
-
-{{% note %}}
-A **section** cannot be defined or overridden by a front matter parameter -- it
-is strictly derived from the content organization structure.
-{{% /note %}}
-
-## Nested Sections
-
-The sections can be nested as deeply as you need.
-
-```bash
-content
-└── blog <-- Section, because first-level dir under content/
- ├── funny-cats
- │ ├── mypost.md
- │ └── kittens <-- Section, because contains _index.md
- │ └── _index.md
- └── tech <-- Section, because contains _index.md
- └── _index.md
-```
-
-**The important part to understand is, that to make the section tree fully navigational, at least the lower-most section needs a content file. (e.g. `_index.md`).**
-
-{{% note %}}
-When we talk about a **section** in correlation with template selection, it is
-currently always the *root section* only (`/blog/funny-cats/mypost/ => blog`).
-
-If you need a specific template for a sub-section, you need to adjust either the `type` or `layout` in front matter.
-{{% /note %}}
-
-## Example: Breadcrumb Navigation
-
-With the available [section variables and methods](#section-page-variables-and-methods) you can build powerful navigation. One common example would be a partial to show Breadcrumb navigation:
-
-{{< code file="layouts/partials/breadcrumb.html" download="breadcrumb.html" >}}
-<ol class="nav navbar-nav">
- {{ template "breadcrumbnav" (dict "p1" . "p2" .) }}
-</ol>
-{{ define "breadcrumbnav" }}
-{{ if .p1.Parent }}
-{{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 ) }}
-{{ else if not .p1.IsHome }}
-{{ template "breadcrumbnav" (dict "p1" .p1.Site.Home "p2" .p2 ) }}
-{{ end }}
-<li{{ if eq .p1 .p2 }} class="active"{{ end }}>
- <a href="{{ .p1.Permalink }}">{{ .p1.Title }}</a>
-</li>
-{{ end }}
-{{< /code >}}
-
-## Section Page Variables and Methods
-
-Also see [Page Variables](/variables/page/).
-
-{{< readfile file="/content/readfiles/sectionvars.md" markdown="true" >}}
-
-## Content Section Lists
-
-Hugo will automatically create pages for each *root section* that list all of the content in that section. See the documentation on [section templates][] for details on customizing the way these pages are rendered.
-
-## Content *Section* vs Content *Type*
-
-By default, everything created within a section will use the [content `type`][content type] that matches the *root section* name. For example, Hugo will assume that `posts/post-1.md` has a `posts` content `type`. If you are using an [archetype][] for your `posts` section, Hugo will generate front matter according to what it finds in `archetypes/posts.md`.
-
-[archetype]: /content-management/archetypes/
-[content type]: /content-management/types/
-[directory structure]: /getting-started/directory-structure/
-[section templates]: /templates/section-templates/
-[branch bundles]: /content-management/page-bundles/#branch-bundles
diff --git a/docs/content/content-management/shortcodes.md b/docs/content/content-management/shortcodes.md
@@ -1,424 +0,0 @@
----
-title: Shortcodes
-linktitle:
-description: Shortcodes are simple snippets inside your content files calling built-in or custom templates.
-godocref:
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-03-31
-menu:
- docs:
- parent: "content-management"
- weight: 35
-weight: 35 #rem
-categories: [content management]
-keywords: [markdown,content,shortcodes]
-draft: false
-aliases: [/extras/shortcodes/]
-toc: true
----
-
-## What a Shortcode is
-
-Hugo loves Markdown because of its simple content format, but there are times when Markdown falls short. Often, content authors are forced to add raw HTML (e.g., video `<iframes>`) to Markdown content. We think this contradicts the beautiful simplicity of Markdown's syntax.
-
-Hugo created **shortcodes** to circumvent these limitations.
-
-A shortcode is a simple snippet inside a content file that Hugo will render using a predefined template. Note that shortcodes will not work in template files. If you need the type of drop-in functionality that shortcodes provide but in a template, you most likely want a [partial template][partials] instead.
-
-In addition to cleaner Markdown, shortcodes can be updated any time to reflect new classes, techniques, or standards. At the point of site generation, Hugo shortcodes will easily merge in your changes. You avoid a possibly complicated search and replace operation.
-
-## Use Shortcodes
-
-{{< youtube 2xkNJL4gJ9E >}}
-
-In your content files, a shortcode can be called by calling `{{%/* shortcodename parameters */%}}`. Shortcode parameters are space delimited, and parameters with internal spaces can be quoted.
-
-The first word in the shortcode declaration is always the name of the shortcode. Parameters follow the name. Depending upon how the shortcode is defined, the parameters may be named, positional, or both, although you can't mix parameter types in a single call. The format for named parameters models that of HTML with the format `name="value"`.
-
-Some shortcodes use or require closing shortcodes. Again like HTML, the opening and closing shortcodes match (name only) with the closing declaration, which is prepended with a slash.
-
-Here are two examples of paired shortcodes:
-
-```
-{{%/* mdshortcode */%}}Stuff to `process` in the *center*.{{%/* /mdshortcode */%}}
-```
-
-```
-{{</* highlight go */>}} A bunch of code here {{</* /highlight */>}}
-```
-
-The examples above use two different delimiters, the difference being the `%` character in the first and the `<>` characters in the second.
-
-### Shortcodes with Markdown
-
-The `%` character indicates that the shortcode's inner content---called in the [shortcode template][sctemps] with the [`.Inner` variable][scvars]---needs further processing by the page's rendering processor (i.e. markdown via Blackfriday). In the following example, Blackfriday would convert `**World**` to `<strong>World</strong>`:
-
-```
-{{%/* myshortcode */%}}Hello **World!**{{%/* /myshortcode */%}}
-```
-
-### Shortcodes Without Markdown
-
-The `<` character indicates that the shortcode's inner content does *not* need further rendering. Often shortcodes without markdown include internal HTML:
-
-```
-{{</* myshortcode */>}}<p>Hello <strong>World!</strong></p>{{</* /myshortcode */>}}
-```
-
-### Nested Shortcodes
-
-You can call shortcodes within other shortcodes by creating your own templates that leverage the `.Parent` variable. `.Parent` allows you to check the context in which the shortcode is being called. See [Shortcode templates][sctemps].
-
-## Use Hugo's Built-in Shortcodes
-
-Hugo ships with a set of predefined shortcodes that represent very common usage. These shortcodes are provided for author convenience and to keep your markdown content clean.
-
-### `figure`
-
-`figure` is an extension of the image syntax in markdown, which does not provide a shorthand for the more semantic [HTML5 `<figure>` element][figureelement].
-
-The `figure` shortcode can use the following named parameters:
-
-src
-: URL of the image to be displayed.
-
-link
-: If the image needs to be hyperlinked, URL of the destination.
-
-target
-: Optional `target` attribute for the URL if `link` parameter is set.
-
-rel
-: Optional `rel` attribute for the URL if `link` parameter is set.
-
-alt
-: Alternate text for the image if the image cannot be displayed.
-
-title
-: Image title.
-
-caption
-: Image caption.
-
-class
-: `class` attribute of the HTML `figure` tag.
-
-height
-: `height` attribute of the image.
-
-width
-: `width` attribute of the image.
-
-attr
-: Image attribution text.
-
-attrlink
-: If the attribution text needs to be hyperlinked, URL of the destination.
-
-#### Example `figure` Input
-
-{{< code file="figure-input-example.md" >}}
-{{</* figure src="/media/spf13.jpg" title="Steve Francia" */>}}
-{{< /code >}}
-
-#### Example `figure` Output
-
-{{< output file="figure-output-example.html" >}}
-<figure>
- <img src="/media/spf13.jpg" />
- <figcaption>
- <h4>Steve Francia</h4>
- </figcaption>
-</figure>
-{{< /output >}}
-
-### `gist`
-
-Bloggers often want to include GitHub gists when writing posts. Let's suppose we want to use the [gist at the following url][examplegist]:
-
-```
-https://gist.github.com/spf13/7896402
-```
-
-We can embed the gist in our content via username and gist ID pulled from the URL:
-
-```
-{{</* gist spf13 7896402 */>}}
-```
-
-#### Example `gist` Input
-
-If the gist contains several files and you want to quote just one of them, you can pass the filename (quoted) as an optional third argument:
-
-{{< code file="gist-input.md" >}}
-{{</* gist spf13 7896402 "img.html" */>}}
-{{< /code >}}
-
-#### Example `gist` Output
-
-{{< output file="gist-output.html" >}}
-{{< gist spf13 7896402 >}}
-{{< /output >}}
-
-#### Example `gist` Display
-
-To demonstrate the remarkably efficiency of Hugo's shortcode feature, we have embedded the `spf13` `gist` example in this page. The following simulates the experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
-
-{{< gist spf13 7896402 >}}
-
-### `highlight`
-
-This shortcode will convert the source code provided into syntax-highlighted HTML. Read more on [highlighting](/tools/syntax-highlighting/). `highlight` takes exactly one required `language` parameter and requires a closing shortcode.
-
-#### Example `highlight` Input
-
-{{< code file="content/tutorials/learn-html.md" >}}
-{{</* highlight html */>}}
-<section id="main">
- <div>
- <h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
- {{ .Render "summary"}}
- {{ end }}
- </div>
-</section>
-{{</* /highlight */>}}
-{{< /code >}}
-
-#### Example `highlight` Output
-
-The `highlight` shortcode example above would produce the following HTML when the site is rendered:
-
-{{< output file="tutorials/learn-html/index.html" >}}
-<span style="color: #f92672"><section</span> <span style="color: #a6e22e">id=</span><span style="color: #e6db74">"main"</span><span style="color: #f92672">></span>
- <span style="color: #f92672"><div></span>
- <span style="color: #f92672"><h1</span> <span style="color: #a6e22e">id=</span><span style="color: #e6db74">"title"</span><span style="color: #f92672">></span>{{ .Title }}<span style="color: #f92672"></h1></span>
- {{ range .Data.Pages }}
- {{ .Render "summary"}}
- {{ end }}
- <span style="color: #f92672"></div></span>
-<span style="color: #f92672"></section></span>
-{{< /output >}}
-
-{{% note "More on Syntax Highlighting" %}}
-To see even more options for adding syntax-highlighted code blocks to your website, see [Syntax Highlighting in Developer Tools](/tools/syntax-highlighting/).
-{{% /note %}}
-
-### `instagram`
-
-If you'd like to embed a photo from [Instagram][], you only need the photo's ID. You can discern an Instagram photo ID from the URL:
-
-```
-https://www.instagram.com/p/BWNjjyYFxVx/
-```
-
-#### Example `instagram` Input
-
-{{< code file="instagram-input.md" >}}
-{{</* instagram BWNjjyYFxVx */>}}
-{{< /code >}}
-
-You also have the option to hide the caption:
-
-{{< code file="instagram-input-hide-caption.md" >}}
-{{</* instagram BWNjjyYFxVx hidecaption */>}}
-{{< /code >}}
-
-#### Example `instagram` Output
-
-By adding the preceding `hidecaption` example, the following HTML will be added to your rendered website's markup:
-
-{{< output file="instagram-hide-caption-output.html" >}}
-{{< instagram BWNjjyYFxVx hidecaption >}}
-{{< /output >}}
-
-#### Example `instagram` Display
-
-Using the preceding `instagram` with hidecaption` example above, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
-
-{{< instagram BWNjjyYFxVx hidecaption >}}
-
-
-### `ref` and `relref`
-
-These shortcodes will look up the pages by their relative path (e.g., `blog/post.md`) or their logical name (`post.md`) and return the permalink (`ref`) or relative permalink (`relref`) for the found page.
-
-`ref` and `relref` also make it possible to make fragmentary links that work for the header links generated by Hugo.
-
-{{% note "More on Cross References" %}}
-Read a more extensive description of `ref` and `relref` in the [cross references](/content-management/cross-references/) documentation.
-{{% /note %}}
-
-`ref` and `relref` take exactly one required parameter of _reference_, quoted and in position `0`.
-
-#### Example `ref` and `relref` Input
-
-```
-[Neat]({{</* ref "blog/neat.md" */>}})
-[Who]({{</* relref "about.md#who" */>}})
-```
-
-#### Example `ref` and `relref` Output
-
-Assuming that standard Hugo pretty URLs are turned on.
-
-```
-<a href="/blog/neat">Neat</a>
-<a href="/about/#who:c28654c202e73453784cfd2c5ab356c0">Who</a>
-```
-
-### `speakerdeck`
-
-To embed slides from [Speaker Deck][], click on "< /> Embed" (under Share right next to the template on Speaker Deck) and copy the URL:
-
-```
-<script async class="speakerdeck-embed" data-id="4e8126e72d853c0060001f97" data-ratio="1.33333333333333" src="//speakerdeck.com/assets/embed.js"></script>
-```
-
-#### `speakerdeck` Example Input
-
-Extract the value from the field `data-id` and pass it to the shortcode:
-
-{{< code file="speakerdeck-example-input.md" >}}
-{{</* speakerdeck 4e8126e72d853c0060001f97 */>}}
-{{< /code >}}
-
-#### `speakerdeck` Example Output
-
-{{< output file="speakerdeck-example-input.md" >}}
-{{< speakerdeck 4e8126e72d853c0060001f97 >}}
-{{< /output >}}
-
-#### `speakerdeck` Example Display
-
-For the preceding `speakerdeck` example, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
-
-{{< speakerdeck 4e8126e72d853c0060001f97 >}}
-
-### `tweet`
-
-You want to include a single tweet into your blog post? Everything you need is the URL of the tweet:
-
-```
-https://twitter.com/spf13/status/877500564405444608
-```
-
-#### Example `tweet` Input
-
-Pass the tweet's ID from the URL as a parameter to the `tweet` shortcode:
-
-{{< code file="example-tweet-input.md" >}}
-{{</* tweet 877500564405444608 */>}}
-{{< /code >}}
-
-#### Example `tweet` Output
-
-Using the preceding `tweet` example, the following HTML will be added to your rendered website's markup:
-
-{{< output file="example-tweet-output.html" >}}
-{{< tweet 877500564405444608 >}}
-{{< /output >}}
-
-#### Example `tweet` Display
-
-Using the preceding `tweet` example, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
-
-{{< tweet 877500564405444608 >}}
-
-### `vimeo`
-
-Adding a video from [Vimeo][] is equivalent to the YouTube shortcode above.
-
-```
-https://vimeo.com/channels/staffpicks/146022717
-```
-
-#### Example `vimeo` Input
-
-Extract the ID from the video's URL and pass it to the `vimeo` shortcode:
-
-{{< code file="example-vimeo-input.md" >}}
-{{</* vimeo 146022717 */>}}
-{{< /code >}}
-
-#### Example `vimeo` Output
-
-Using the preceding `vimeo` example, the following HTML will be added to your rendered website's markup:
-
-{{< output file="example-vimeo-output.html" >}}
-{{< vimeo 146022717 >}}
-{{< /output >}}
-
-{{% tip %}}
-If you want to further customize the visual styling of the YouTube or Vimeo output, add a `class` named parameter when calling the shortcode. The new `class` will be added to the `<div>` that wraps the `<iframe>` *and* will remove the inline styles. Note that you will need to call the `id` as a named parameter as well.
-
-```
-{{</* vimeo id="146022717" class="my-vimeo-wrapper-class" */>}}
-```
-{{% /tip %}}
-
-#### Example `vimeo` Display
-
-Using the preceding `vimeo` example, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
-
-{{< vimeo 146022717 >}}
-
-### `youtube`
-
-The `youtube` shortcode embeds a responsive video player for [YouTube videos][]. Only the ID of the video is required, e.g.:
-
-```
-https://www.youtube.com/watch?v=w7Ft2ymGmfc
-```
-
-
-#### Example `youtube` Input
-
-Copy the YouTube video ID that follows `v=` in the video's URL and pass it to the `youtube` shortcode:
-
-{{< code file="example-youtube-input.md" >}}
-{{</* youtube w7Ft2ymGmfc */>}}
-{{< /code >}}
-
-Furthermore, you can automatically start playback of the embedded video by setting the `autoplay` parameter to `true`. Remember that you can't mix named an unnamed parameters, so you'll need to assign the yet unnamed video id to the parameter `id`:
-
-
-{{< code file="example-youtube-input-with-autoplay.md" >}}
-{{</* youtube id="w7Ft2ymGmfc" autoplay="true" */>}}
-{{< /code >}}
-
-#### Example `youtube` Output
-
-Using the preceding `youtube` example, the following HTML will be added to your rendered website's markup:
-
-{{< code file="example-youtube-output.html" >}}
-{{< youtube id="w7Ft2ymGmfc" autoplay="true" >}}
-{{< /code >}}
-
-#### Example `youtube` Display
-
-Using the preceding `youtube` example (without `autoplay="true"`), the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup. The video is also include in the [Quick Start of the Hugo documentation][quickstart].
-
-{{< youtube w7Ft2ymGmfc >}}
-
-## Create Custom Shortcodes
-
-To learn more about creating custom shortcodes, see the [shortcode template documentation][].
-
-[`figure` shortcode]: #figure
-[contentmanagementsection]: /content-management/formats/
-[examplegist]: https://gist.github.com/spf13/7896402
-[figureelement]: http://html5doctor.com/the-figure-figcaption-elements/ "An article from HTML5 doctor discussing the fig and figcaption elements."
-[Instagram]: https://www.instagram.com/
-[pagevariables]: /variables/page/
-[partials]: /templates/partials/
-[Pygments]: http://pygments.org/
-[quickstart]: /getting-started/quick-start/
-[sctemps]: /templates/shortcode-templates/
-[scvars]: /variables/shortcodes/
-[shortcode template documentation]: /templates/shortcode-templates/
-[Speaker Deck]: https://speakerdeck.com/
-[templatessection]: /templates/
-[Vimeo]: https://vimeo.com/
-[YouTube Videos]: https://www.youtube.com/
diff --git a/docs/content/content-management/syntax-highlighting.md b/docs/content/content-management/syntax-highlighting.md
@@ -1,193 +0,0 @@
----
-title: Syntax Highlighting
-description: Hugo comes with reallly fast syntax highlighting from Chroma.
-date: 2017-02-01
-publishdate: 2017-02-01
-keywords: [highlighting,pygments,chroma,code blocks,syntax]
-categories: [content management]
-menu:
- docs:
- parent: "content-management"
- weight: 300
-weight: 20
-sections_weight: 20
-draft: false
-aliases: [/extras/highlighting/,/extras/highlight/,/tools/syntax-highlighting/]
-toc: true
----
-
-From Hugo 0.28, the default syntax hightlighter in Hugo is [Chroma](https://github.com/alecthomas/chroma); it is built in Go and is really, really fast -- and for the most important parts compatible with Pygments.
-
-If you want to continue to use Pygments (see below), set `pygmentsUseClassic=true` in your site config.
-
-The example below shows a simple code snippet from the Hugo source highlighted with the `highlight` shortcode. Note that the gohugo.io site is generated with `pygmentsUseClasses=true` (see [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css)).
-
-* `linenos=inline` or `linenos=table` (`table` will give copy-and-paste friendly code blocks) turns on line numbers.
-* `hl_lines` lists a set of line numbers or line number ranges to be highlighted. Note that the hyphen range syntax is only supported for Chroma.
-* `linenostart=199` starts the line number count from 199.
-
-With that, this:
-
-```
-{{</* highlight go "linenos=table,hl_lines=8 15-17,linenostart=199" */>}}
-// ... code
-{{</* / highlight */>}}
-```
-
-Gives this:
-
-{{< highlight go "linenos=table,hl_lines=8 15-17,linenostart=199" >}}
-// GetTitleFunc returns a func that can be used to transform a string to
-// title case.
-//
-// The supported styles are
-//
-// - "Go" (strings.Title)
-// - "AP" (see https://www.apstylebook.com/)
-// - "Chicago" (see http://www.chicagomanualofstyle.org/home.html)
-//
-// If an unknown or empty style is provided, AP style is what you get.
-func GetTitleFunc(style string) func(s string) string {
- switch strings.ToLower(style) {
- case "go":
- return strings.Title
- case "chicago":
- tc := transform.NewTitleConverter(transform.ChicagoStyle)
- return tc.Title
- default:
- tc := transform.NewTitleConverter(transform.APStyle)
- return tc.Title
- }
-}
-{{< / highlight >}}
-
-
-## Configure Syntax Highlighter
-To make the transition from Pygments to Chroma seamless, they share a common set of configuration options:
-
-pygmentsOptions
-: A comma separated list of options. See below for a full list.
-
-pygmentsCodefences
-: Set to true to enable syntax highlighting in code fences with a language tag in markdown (see below for an example).
-
-pygmentsStyle
-: The style of code highlighting. See https://help.farbox.com/pygments.html for a gallery. Note that this option is not relevant when `pygmentsUseClasses` is set.
-
-pygmentsUseClasses
-: Set to `true` to use CSS classes to format your highlighted code. See [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css).
-
-pygmentsCodefencesGuessSyntax
-: Set to `true` to try to do syntax highlighting on code fenced blocks in markdown without a language tag.
-
-pygmentsUseClassic
-: Set to true to use Pygments instead of the much faster Chroma.
-
-### Options
-
-`pygmentsOptions` can be set either in site config or overridden per code block in the Highlight shortcode or template func.
-
-noclasses
-: Use inline style.
-
-linenos
-: For Chroma, any value in this setting will print line numbers. Pygments has some more fine grained control.
-
-linenostart
-: Start the line numbers from this value (default is 1).
-
-
-hl_lines
-: Highlight a space separated list of line numbers. For Chroma, you can provide a list of ranges, i.e. "3-8 10-20".
-
-
-The full set of supported options for Pygments is: `encoding`, `outencoding`, `nowrap`, `full`, `title`, `style`, `noclasses`, `classprefix`, `cssclass`, `cssstyles`, `prestyles`, `linenos`, `hl_lines`, `linenostart`, `linenostep`, `linenospecial`, `nobackground`, `lineseparator`, `lineanchors`, `linespans`, `anchorlinenos`, `startinline`. See the [Pygments HTML Formatter Documentation](http://pygments.org/docs/formatters/#HtmlFormatter) for details.
-
-
-## Generate Syntax Highlighter CSS
-
-If you run with `pygmentsUseClasses=true` in your site config, you need a style sheet.
-
-You can generate one with Hugo:
-
-```bash
-hugo gen chromastyles --style=monokai > syntax.css
-```
-
-Run `hugo gen chromastyles -h` for more options. See https://help.farbox.com/pygments.html for a gallery of available styles.
-
-
-## Highlight Shortcode
-
-Highlighting is carried out via the [built-in shortcode](/content-management/shortcodes/) `highlight`. `highlight` takes exactly one required parameter for the programming language to be highlighted and requires a closing shortcode. Note that `highlight` is *not* used for client-side javascript highlighting.
-
-### Example `highlight` Shortcode
-
-{{< code file="example-highlight-shortcode-input.md" >}}
-{{</* highlight html */>}}
-<section id="main">
- <div>
- <h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
- {{ .Render "summary"}}
- {{ end }}
- </div>
-</section>
-{{</* /highlight */>}}
-{{< /code >}}
-
-
-
-## Highlight Template Func
-
-See [Highlight](/functions/highlight/).
-
-## Highlight in Code Fences
-
-It is also possible to add syntax highlighting with GitHub flavored code fences. To enable this, set the `pygmentsCodeFences` to `true` in Hugo's [configuration file](/getting-started/configuration/);
-
-````
-```go-html-template
-<section id="main">
- <div>
- <h1 id="title">{{ .Title }}</h1>
- {{ range .Data.Pages }}
- {{ .Render "summary"}}
- {{ end }}
- </div>
-</section>
-```
-````
-
-## List of Chroma Highlighting Languages
-
-The full list of Chroma lexers and their aliases (which is the identifier used in the `hightlight` template func or when doing highlighting in code fences):
-
-{{< chroma-lexers >}}
-
-## Highlight with Pygments Classic
-
-If you for some reason don't want to use the built-in Chroma highlighter, you can set `pygmentsUseClassic=true` in your config and add Pygments to your path.
-
-{{% note "Disclaimers on Pygments" %}}
-* Pygments is relatively slow and _causes a performance hit when building your site_, but Hugo has been designed to cache the results to disk.
-* The caching can be turned off by setting the `--ignoreCache` flag to `true`.
-* The languages available for highlighting depend on your Pygments installation.
-{{% /note %}}
-
-If you have never worked with Pygments before, here is a brief primer:
-
-+ Install Python from [python.org](https://www.python.org/downloads/). Version 2.7.x is already sufficient.
-+ Run `pip install Pygments` in order to install Pygments. Once installed, Pygments gives you a command `pygmentize`. Make sure it sits in your PATH; otherwise, Hugo will not be able to find and use it.
-
-On Debian and Ubuntu systems, you may also install Pygments by running `sudo apt-get install python3-pygments`.
-
-
-
-[Prism]: http://prismjs.com
-[prismdownload]: http://prismjs.com/download.html
-[Highlight.js]: http://highlightjs.org/
-[Rainbow]: http://craig.is/making/rainbows
-[Syntax Highlighter]: http://alexgorbatchev.com/SyntaxHighlighter/
-[Google Prettify]: https://github.com/google/code-prettify
-[Yandex]: http://yandex.ru/
diff --git a/docs/content/_index.md b/docs/content/en/_index.md
diff --git a/docs/content/about/_index.md b/docs/content/en/about/_index.md
diff --git a/docs/content/about/benefits.md b/docs/content/en/about/benefits.md
diff --git a/docs/content/about/features.md b/docs/content/en/about/features.md
diff --git a/docs/content/about/license.md b/docs/content/en/about/license.md
diff --git a/docs/content/about/new-in-032/index.md b/docs/content/en/about/new-in-032/index.md
diff --git a/docs/content/about/new-in-032/sunset.jpg b/docs/content/en/about/new-in-032/sunset.jpg
Binary files differ.
diff --git a/docs/content/about/what-is-hugo.md b/docs/content/en/about/what-is-hugo.md
diff --git a/docs/content/commands/hugo.md b/docs/content/en/commands/hugo.md
diff --git a/docs/content/commands/hugo_benchmark.md b/docs/content/en/commands/hugo_benchmark.md
diff --git a/docs/content/commands/hugo_check.md b/docs/content/en/commands/hugo_check.md
diff --git a/docs/content/commands/hugo_check_ulimit.md b/docs/content/en/commands/hugo_check_ulimit.md
diff --git a/docs/content/commands/hugo_config.md b/docs/content/en/commands/hugo_config.md
diff --git a/docs/content/commands/hugo_convert.md b/docs/content/en/commands/hugo_convert.md
diff --git a/docs/content/commands/hugo_convert_toJSON.md b/docs/content/en/commands/hugo_convert_toJSON.md
diff --git a/docs/content/commands/hugo_convert_toTOML.md b/docs/content/en/commands/hugo_convert_toTOML.md
diff --git a/docs/content/commands/hugo_convert_toYAML.md b/docs/content/en/commands/hugo_convert_toYAML.md
diff --git a/docs/content/commands/hugo_env.md b/docs/content/en/commands/hugo_env.md
diff --git a/docs/content/commands/hugo_gen.md b/docs/content/en/commands/hugo_gen.md
diff --git a/docs/content/commands/hugo_gen_autocomplete.md b/docs/content/en/commands/hugo_gen_autocomplete.md
diff --git a/docs/content/commands/hugo_gen_chromastyles.md b/docs/content/en/commands/hugo_gen_chromastyles.md
diff --git a/docs/content/commands/hugo_gen_doc.md b/docs/content/en/commands/hugo_gen_doc.md
diff --git a/docs/content/commands/hugo_gen_man.md b/docs/content/en/commands/hugo_gen_man.md
diff --git a/docs/content/commands/hugo_import.md b/docs/content/en/commands/hugo_import.md
diff --git a/docs/content/commands/hugo_import_jekyll.md b/docs/content/en/commands/hugo_import_jekyll.md
diff --git a/docs/content/commands/hugo_list.md b/docs/content/en/commands/hugo_list.md
diff --git a/docs/content/commands/hugo_list_drafts.md b/docs/content/en/commands/hugo_list_drafts.md
diff --git a/docs/content/commands/hugo_list_expired.md b/docs/content/en/commands/hugo_list_expired.md
diff --git a/docs/content/commands/hugo_list_future.md b/docs/content/en/commands/hugo_list_future.md
diff --git a/docs/content/commands/hugo_new.md b/docs/content/en/commands/hugo_new.md
diff --git a/docs/content/commands/hugo_new_site.md b/docs/content/en/commands/hugo_new_site.md
diff --git a/docs/content/commands/hugo_new_theme.md b/docs/content/en/commands/hugo_new_theme.md
diff --git a/docs/content/commands/hugo_server.md b/docs/content/en/commands/hugo_server.md
diff --git a/docs/content/commands/hugo_version.md b/docs/content/en/commands/hugo_version.md
diff --git a/docs/content/content-management/_index.md b/docs/content/en/content-management/_index.md
diff --git a/docs/content/en/content-management/archetypes.md b/docs/content/en/content-management/archetypes.md
@@ -0,0 +1,75 @@
+---
+title: Archetypes
+linktitle: Archetypes
+description: Archetypes are templates used when creating new content.
+date: 2017-02-01
+publishdate: 2017-02-01
+keywords: [archetypes,generators,metadata,front matter]
+categories: ["content management"]
+menu:
+ docs:
+ parent: "content-management"
+ weight: 70
+ quicklinks:
+weight: 70 #rem
+draft: false
+aliases: [/content/archetypes/]
+toc: true
+---
+
+## What are Archetypes?
+
+**Archetypes** are content template files in the [archetypes directory][] of your project that contain preconfigured [front matter][] and possibly also a content disposition for your website's [content types][]. These will be used when you run `hugo new`.
+
+
+The `hugo new` uses the `content-section` to find the most suitable archetype template in your project. If your project does not contain any archetype files, it will also look in the theme.
+
+{{< code file="archetype-example.sh" >}}
+hugo new posts/my-first-post.md
+{{< /code >}}
+
+The above will create a new content file in `content/posts/my-first-post.md` using the first archetype file found of these:
+
+1. `archetypes/posts.md`
+2. `archetypes/default.md`
+3. `themes/my-theme/archetypes/posts.md`
+4. `themes/my-theme/archetypes/default.md`
+
+The last two list items is only applicable if you use a theme and it uses the `my-theme` theme name as an example.
+
+## Create a New Archetype Template
+
+A fictional example for the section `newsletter` and the archetype file `archetypes/newsletter.md`. Create a new file in `archetypes/newsletter.md` and open it in a text editor.
+
+{{< code file="archetypes/newsletter.md" >}}
+---
+title: "{{ replace .Name "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
+
+**Insert Lead paragraph here.**
+
+## New Cool Posts
+
+{{ range first 10 ( where .Site.RegularPages "Type" "cool" ) }}
+* {{ .Title }}
+{{ end }}
+{{< /code >}}
+
+When you create a new newsletter with:
+
+```bash
+hugo new newsletter/the-latest-cool.stuff.md
+```
+
+It will create a new newsletter type of content file based on the archetype template.
+
+**Note:** the site will only be built if the `.Site` is in use in the archetype file, and this can be time consuming for big sites.
+
+The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo's template funcs can be used in the archetype file.
+
+
+[archetypes directory]: /getting-started/directory-structure/
+[content types]: /content-management/types/
+[front matter]: /content-management/front-matter/
diff --git a/docs/content/content-management/authors.md b/docs/content/en/content-management/authors.md
diff --git a/docs/content/content-management/comments.md b/docs/content/en/content-management/comments.md
diff --git a/docs/content/content-management/cross-references.md b/docs/content/en/content-management/cross-references.md
diff --git a/docs/content/en/content-management/formats.md b/docs/content/en/content-management/formats.md
@@ -0,0 +1,249 @@
+---
+title: Supported Content Formats
+linktitle: Supported Content Formats
+description: Markdown and Emacs Org-Mode have native support, and additional formats (e.g. Asciidoc) come via external helpers.
+date: 2017-01-10
+publishdate: 2017-01-10
+lastmod: 2017-04-06
+categories: [content management]
+keywords: [markdown,asciidoc,mmark,pandoc,content format]
+menu:
+ docs:
+ parent: "content-management"
+ weight: 20
+weight: 20 #rem
+draft: false
+aliases: [/content/markdown-extras/,/content/supported-formats/,/doc/supported-formats/,/tutorials/mathjax/]
+toc: true
+---
+
+**Markdown is the main content format** and comes in two flavours: The excellent [Blackfriday project][blackfriday] (name your files `*.md` or set `markup = "markdown"` in front matter) or its fork [Mmark][mmark] (name your files `*.mmark` or set `markup = "mmark"` in front matter), both very fast markdown engines written in Go.
+
+For Emacs users, [goorgeous](https://github.com/chaseadamsio/goorgeous) provides built-in native support for Org-mode (name your files `*.org` or set `markup = "org"` in front matter)
+
+{{% note "Deeply Nested Lists" %}}
+Before you begin writing your content in markdown, Blackfriday has a known issue [(#329)](https://github.com/russross/blackfriday/issues/329) with handling deeply nested lists. Luckily, there is an easy workaround. Use 4-spaces (i.e., <kbd>tab</kbd>) rather than 2-space indentations.
+{{% /note %}}
+
+## Configure BlackFriday Markdown Rendering
+
+You can configure multiple aspects of Blackfriday as show in the following list. See the docs on [Configuration][config] for the full list of explicit directions you can give to Hugo when rendering your site.
+
+{{< readfile file="/content/en/readfiles/bfconfig.md" markdown="true" >}}
+
+## Extend Markdown
+
+Hugo provides some convenient methods for extending markdown.
+
+### Task Lists
+
+Hugo supports [GitHub-styled task lists (i.e., TODO lists)][gfmtasks] for the Blackfriday markdown renderer. If you do not want to use this feature, you can disable it in your configuration.
+
+#### Example Task List Input
+
+{{< code file="content/my-to-do-list.md" >}}
+- [ ] a task list item
+- [ ] list syntax required
+- [ ] incomplete
+- [x] completed
+{{< /code >}}
+
+#### Example Task List Output
+
+The preceding markdown produces the following HTML in your rendered website:
+
+```
+<ul class="task-list">
+ <li><input type="checkbox" disabled="" class="task-list-item"> a task list item</li>
+ <li><input type="checkbox" disabled="" class="task-list-item"> list syntax required</li>
+ <li><input type="checkbox" disabled="" class="task-list-item"> incomplete</li>
+ <li><input type="checkbox" checked="" disabled="" class="task-list-item"> completed</li>
+</ul>
+```
+
+#### Example Task List Display
+
+The following shows how the example task list will look to the end users of your website. Note that visual styling of lists is up to you. This list has been styled according to [the Hugo Docs stylesheet][hugocss].
+
+- [ ] a task list item
+- [ ] list syntax required
+- [ ] incomplete
+- [x] completed
+
+### Emojis
+
+To add emojis directly to content, set `enableEmoji` to `true` in your [site configuration][config]. To use emojis in templates or shortcodes, see [`emojify` function][].
+
+For a full list of emojis, see the [Emoji cheat sheet][emojis].
+
+### Shortcodes
+
+If you write in Markdown and find yourself frequently embedding your content with raw HTML, Hugo provides built-in shortcodes functionality. This is one of the most powerful features in Hugo and allows you to create your own Markdown extensions very quickly.
+
+See [Shortcodes][sc] for usage, particularly for the built-in shortcodes that ship with Hugo, and [Shortcode Templating][sct] to learn how to build your own.
+
+### Code Blocks
+
+Hugo supports GitHub-flavored markdown's use of triple back ticks, as well as provides a special [`highlight` shortcode][hlsc], and syntax highlights those code blocks natively using *Chroma*. Users also have an option to use *Pygments* instead. See the [Syntax Highlighting][hl] section for details.
+
+## Mmark
+
+Mmark is a [fork of BlackFriday][mmark] and markdown superset that is well suited for writing [IETF documentation][ietf]. You can see examples of the syntax in the [Mmark GitHub repository][mmarkgh] or the full syntax on [Miek Gieben's website][].
+
+### Use Mmark
+
+As Hugo ships with Mmark, using the syntax is as easy as changing the extension of your content files from `.md` to `.mmark`.
+
+In the event that you want to only use Mmark in specific files, you can also define the Mmark syntax in your content's front matter:
+
+```
+---
+title: My Post
+date: 2017-04-01
+markup: mmark
+---
+```
+
+{{% warning %}}
+Thare are some features not available in Mmark; one example being that shortcodes are not translated when used in an included `.mmark` file ([#3131](https://github.com/gohugoio/hugo/issues/3137)), and `EXTENSION_ABBREVIATION` ([#1970](https://github.com/gohugoio/hugo/issues/1970)) and the aforementioned GFM todo lists ([#2270](https://github.com/gohugoio/hugo/issues/2270)) are not fully supported. Contributions are welcome.
+{{% /warning %}}
+
+## MathJax with Hugo
+
+[MathJax](http://www.mathjax.org/) is a JavaScript library that allows the display of mathematical expressions described via a LaTeX-style syntax in the HTML (or Markdown) source of a web page. As it is a pure a JavaScript library, getting it to work within Hugo is fairly straightforward, but does have some oddities that will be discussed here.
+
+This is not an introduction into actually using MathJax to render typeset mathematics on your website. Instead, this page is a collection of tips and hints for one way to get MathJax working on a website built with Hugo.
+
+### Enable MathJax
+
+The first step is to enable MathJax on pages that you would like to have typeset math. There are multiple ways to do this (adventurous readers can consult the [Loading and Configuring](http://docs.mathjax.org/en/latest/configuration.html) section of the MathJax documentation for additional methods of including MathJax), but the easiest way is to use the secure MathJax CDN by include a `<script>` tag for the officially recommended secure CDN ([cdn.js.com](https://cdnjs.com)):
+
+{{< code file="add-mathjax-to-page.html" >}}
+<script type="text/javascript" src="https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1/MathJax.js?config=TeX-AMS-MML_HTMLorMML">
+</script>
+{{< /code >}}
+
+One way to ensure that this code is included in all pages is to put it in one of the templates that live in the `layouts/partials/` directory. For example, I have included this in the bottom of my template `footer.html` because I know that the footer will be included in every page of my website.
+
+### Options and Features
+
+MathJax is a stable open-source library with many features. I encourage the interested reader to view the [MathJax Documentation](http://docs.mathjax.org/en/latest/index.html), specifically the sections on [Basic Usage](http://docs.mathjax.org/en/latest/index.html#basic-usage) and [MathJax Configuration Options](http://docs.mathjax.org/en/latest/index.html#mathjax-configuration-options).
+
+### Issues with Markdown
+
+{{% note %}}
+The following issues with Markdown assume you are using `.md` for content and BlackFriday for parsing. Using [Mmark](#mmark) as your content format will obviate the need for the following workarounds.
+
+When using Mmark with MathJax, use `displayMath: [['$$','$$'], ['\\[','\\]']]`. See the [Mmark `README.md`](https://github.com/miekg/mmark/wiki/Syntax#math-blocks) for more information. In addition to MathJax, Mmark has been shown to work well with [KaTeX](https://github.com/Khan/KaTeX). See this [related blog post from a Hugo user](http://nosubstance.me/post/a-great-toolset-for-static-blogging/).
+{{% /note %}}
+
+After enabling MathJax, any math entered between proper markers (see the [MathJax documentation][mathjaxdocs]) will be processed and typeset in the web page. One issue that comes up, however, with Markdown is that the underscore character (`_`) is interpreted by Markdown as a way to wrap text in `emph` blocks while LaTeX (MathJax) interprets the underscore as a way to create a subscript. This "double speak" of the underscore can result in some unexpected and unwanted behavior.
+
+### Solution
+
+There are multiple ways to remedy this problem. One solution is to simply escape each underscore in your math code by entering `\_` instead of `_`. This can become quite tedious if the equations you are entering are full of subscripts.
+
+Another option is to tell Markdown to treat the MathJax code as verbatim code and not process it. One way to do this is to wrap the math expression inside a `<div>` `</div>` block. Markdown would ignore these sections and they would get passed directly on to MathJax and processed correctly. This works great for display style mathematics, but for inline math expressions the line break induced by the `<div>` is not acceptable. The syntax for instructing Markdown to treat inline text as verbatim is by wrapping it in backticks (`` ` ``). You might have noticed, however, that the text included in between backticks is rendered differently than standard text (on this site these are items highlighted in red). To get around this problem, we could create a new CSS entry that would apply standard styling to all inline verbatim text that includes MathJax code. Below I will show the HTML and CSS source that would accomplish this (note this solution was adapted from [this blog post](http://doswa.com/2011/07/20/mathjax-in-markdown.html)---all credit goes to the original author).
+
+{{< code file="mathjax-markdown-solution.html" >}}
+<script type="text/x-mathjax-config">
+MathJax.Hub.Config({
+ tex2jax: {
+ inlineMath: [['$','$'], ['\\(','\\)']],
+ displayMath: [['$$','$$'], ['\[','\]']],
+ processEscapes: true,
+ processEnvironments: true,
+ skipTags: ['script', 'noscript', 'style', 'textarea', 'pre'],
+ TeX: { equationNumbers: { autoNumber: "AMS" },
+ extensions: ["AMSmath.js", "AMSsymbols.js"] }
+ }
+});
+</script>
+
+<script type="text/x-mathjax-config">
+ MathJax.Hub.Queue(function() {
+ // Fix <code> tags after MathJax finishes running. This is a
+ // hack to overcome a shortcoming of Markdown. Discussion at
+ // https://github.com/mojombo/jekyll/issues/199
+ var all = MathJax.Hub.getAllJax(), i;
+ for(i = 0; i < all.length; i += 1) {
+ all[i].SourceElement().parentNode.className += ' has-jax';
+ }
+});
+</script>
+{{< /code >}}
+
+
+
+As before, this content should be included in the HTML source of each page that will be using MathJax. The next code snippet contains the CSS that is used to have verbatim MathJax blocks render with the same font style as the body of the page.
+
+{{< code file="mathjax-style.css" >}}
+code.has-jax {
+ font: inherit;
+ font-size: 100%;
+ background: inherit;
+ border: inherit;
+ color: #515151;
+}
+{{< /code >}}
+
+In the CSS snippet, notice the line `color: #515151;`. `#515151` is the value assigned to the `color` attribute of the `body` class in my CSS. In order for the equations to fit in with the body of a web page, this value should be the same as the color of the body.
+
+### Usage
+
+With this setup, everything is in place for a natural usage of MathJax on pages generated using Hugo. In order to include inline mathematics, just put LaTeX code in between `` `$ TeX Code $` `` or `` `\( TeX Code \)` ``. To include display style mathematics, just put LaTeX code in between `<div>$$TeX Code$$</div>`. All the math will be properly typeset and displayed within your Hugo generated web page!
+
+## Additional Formats Through External Helpers
+
+Hugo has a new concept called _external helpers_. It means that you can write your content using [Asciidoc][ascii], [reStructuredText][rest], or [pandoc]. If you have files with associated extensions, Hugo will call external commands to generate the content. ([See the Hugo source code for external helpers][helperssource].)
+
+For example, for Asciidoc files, Hugo will try to call the `asciidoctor` or `asciidoc` command. This means that you will have to install the associated tool on your machine to be able to use these formats. ([See the Asciidoctor docs for installation instructions](http://asciidoctor.org/docs/install-toolchain/)).
+
+To use these formats, just use the standard extension and the front matter exactly as you would do with natively supported `.md` files.
+
+Hugo passes reasonable default arguments to these external helpers by default:
+
+- `asciidoc`: `--no-header-footer --safe -`
+- `asciidoctor`: `--no-header-footer --safe --trace -`
+- `rst2html`: `--leave-comments --initial-header-level=2`
+- `pandoc`: `--mathjax`
+
+{{% warning "Performance of External Helpers" %}}
+Because additional formats are external commands generation performance will rely heavily on the performance of the external tool you are using. As this feature is still in its infancy, feedback is welcome.
+{{% /warning %}}
+
+## Learn Markdown
+
+Markdown syntax is simple enough to learn in a single sitting. The following are excellent resources to get you up and running:
+
+* [Daring Fireball: Markdown, John Gruber (Creator of Markdown)][fireball]
+* [Markdown Cheatsheet, Adam Pritchard][mdcheatsheet]
+* [Markdown Tutorial (Interactive), Garen Torikian][mdtutorial]
+
+[`emojify` function]: /functions/emojify/
+[ascii]: http://asciidoctor.org/
+[bfconfig]: /getting-started/configuration/#configuring-blackfriday-rendering
+[blackfriday]: https://github.com/russross/blackfriday
+[mmark]: https://github.com/miekg/mmark
+[config]: /getting-started/configuration/
+[developer tools]: /tools/
+[emojis]: https://www.webpagefx.com/tools/emoji-cheat-sheet/
+[fireball]: https://daringfireball.net/projects/markdown/
+[gfmtasks]: https://guides.github.com/features/mastering-markdown/#syntax
+[helperssource]: https://github.com/gohugoio/hugo/blob/77c60a3440806067109347d04eb5368b65ea0fe8/helpers/general.go#L65
+[hl]: /content-management/syntax-highlighting/
+[hlsc]: /content-management/shortcodes/#highlight
+[hugocss]: /css/style.css
+[ietf]: https://tools.ietf.org/html/
+[mathjaxdocs]: https://docs.mathjax.org/en/latest/
+[mdcheatsheet]: https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
+[mdtutorial]: http://www.markdowntutorial.com/
+[Miek Gieben's website]: https://miek.nl/2016/March/05/mmark-syntax-document/
+[mmark]: https://github.com/miekg/mmark
+[mmarkgh]: https://github.com/miekg/mmark/wiki/Syntax
+[org]: http://orgmode.org/
+[pandoc]: http://www.pandoc.org/
+[Pygments]: http://pygments.org/
+[rest]: http://docutils.sourceforge.net/rst.html
+[sc]: /content-management/shortcodes/
+[sct]: /templates/shortcode-templates/
diff --git a/docs/content/content-management/front-matter.md b/docs/content/en/content-management/front-matter.md
diff --git a/docs/content/content-management/image-processing/index.md b/docs/content/en/content-management/image-processing/index.md
diff --git a/docs/content/content-management/image-processing/sunset.jpg b/docs/content/en/content-management/image-processing/sunset.jpg
Binary files differ.
diff --git a/docs/content/content-management/menus.md b/docs/content/en/content-management/menus.md
diff --git a/docs/content/content-management/multilingual.md b/docs/content/en/content-management/multilingual.md
diff --git a/docs/content/content-management/organization/1-featured-content-bundles.png b/docs/content/en/content-management/organization/1-featured-content-bundles.png
Binary files differ.
diff --git a/docs/content/content-management/organization/index.md b/docs/content/en/content-management/organization/index.md
diff --git a/docs/content/en/content-management/page-bundles.md b/docs/content/en/content-management/page-bundles.md
@@ -0,0 +1,185 @@
+---
+title : "Page Bundles"
+description : "Content organization using Page Bundles"
+date : 2018-01-24T13:09:00-05:00
+lastmod : 2018-01-28T22:26:40-05:00
+linktitle : "Page Bundles"
+keywords : ["page", "bundle", "leaf", "branch"]
+categories : ["content management"]
+toc : true
+menu :
+ docs:
+ identifier : "page-bundles"
+ parent : "content-management"
+ weight : 11
+---
+
+Page Bundles are a way to group [Page Resources](/content-management/page-resources/).
+
+A Page Bundle can be one of:
+
+- Leaf Bundle (leaf means it has no children)
+- Branch Bundle (home page, section, taxonomy terms, taxonomy list)
+
+| | Leaf Bundle | Branch Bundle |
+|-------------------------------------|----------------------------------------------------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Usage | Collection of content and attachments for single pages | Collection of attachments for section pages (home page, section, taxonomy terms, taxonomy list) |
+| Index file name | `index.md` [^fn:1] | `_index.md` [^fn:1] |
+| Allowed Resources | Page and non-page (like images, pdf, etc.) types | Only non-page (like images, pdf, etc.) types |
+| Where can the Resources live? | At any directory level within the leaf bundle directory. | Only in the directory level **of** the branch bundle directory i.e. the directory containing the `_index.md` ([ref](https://discourse.gohugo.io/t/question-about-content-folder-structure/11822/4?u=kaushalmodi)). |
+| Layout type | `single` | `list` |
+| Nesting | Does not allow nesting of more bundles under it | Allows nesting of leaf or branch bundles under it |
+| Example | `content/posts/my-post/index.md` | `content/posts/_index.md` |
+| Content from non-index page files .. | Accessed only as page resources | Accessed only as regular pages |
+
+
+## Leaf Bundles {#leaf-bundles}
+
+A _Leaf Bundle_ is a directory at any hierarchy within the `content/`
+directory, that contains an **`index.md`** file.
+
+### Examples of Leaf Bundle organization {#examples-of-leaf-bundle-organization}
+
+```text
+content/
+├── about
+│ ├── index.md
+├── posts
+│ ├── my-post
+│ │ ├── content1.md
+│ │ ├── content2.md
+│ │ ├── image1.jpg
+│ │ ├── image2.png
+│ │ └── index.md
+│ └── my-another-post
+│ └── index.md
+│
+└── another-section
+ ├── ..
+ └── not-a-leaf-bundle
+ ├── ..
+ └── another-leaf-bundle
+ └── index.md
+```
+
+In the above example `content/` directory, there are four leaf
+bundles:
+
+about
+: This leaf bundle is at the root level (directly under
+ `content` directory) and has only the `index.md`.
+
+my-post
+: This leaf bundle has the `index.md`, two other content
+ Markdown files and two image files.
+
+my-another-post
+: This leaf bundle has only the `index.md`.
+
+another-leaf-bundle
+: This leaf bundle is nested under couple of
+ directories. This bundle also has only the `index.md`.
+
+{{% note %}}
+The hierarchy depth at which a leaf bundle is created does not matter,
+as long as it is not inside another **leaf** bundle.
+{{% /note %}}
+
+
+### Headless Bundle {#headless-bundle}
+
+A headless bundle is a bundle that is configured to not get published
+anywhere:
+
+- It will have no `Permalink` and no rendered HTML in `public/`.
+- It will not be part of `.Site.RegularPages`, etc.
+
+But you can get it by `.Site.GetPage`. Here is an example:
+
+```go-html-template
+{{ $headless := .Site.GetPage "page" "some-headless-bundle" }}
+{{ $reusablePages := $headless.Resources.Match "author*" }}
+<h2>Authors</h2>
+{{ range $reusablePages }}
+ <h3>{{ .Title }}</h3>
+ {{ .Content }}
+{{ end }}
+```
+
+_In this example, we are assuming the `some-headless-bundle` to be a headless
+ bundle containing one or more **page** resources whose `.Name` matches
+ `"author*"`._
+
+Explanation of the above example:
+
+1. Get the `some-headless-bundle` Page "object".
+2. Collect a *slice* of resources in this *Page Bundle* that matches
+ `"author*"` using `.Resources.Match`.
+3. Loop through that *slice* of nested pages, and output their `.Title` and
+ `.Content`.
+
+---
+
+A leaf bundle can be made headless by adding below in the Front Matter
+(in the `index.md`):
+
+```toml
+headless = true
+```
+
+{{% note %}}
+Only leaf bundles can be made headless.
+{{% /note %}}
+
+There are many use cases of such headless page bundles:
+
+- Shared media galleries
+- Reusable page content "snippets"
+
+
+## Branch Bundles {#branch-bundles}
+
+A _Branch Bundle_ is any directory at any hierarchy within the
+`content/` directory, that contains at least an **`_index.md`** file.
+
+This `_index.md` can also be directly under the `content/` directory.
+
+{{% note %}}
+Here `md` (markdown) is used just as an example. You can use any file
+type as a content resource as long as it is a content type recognized by Hugo.
+{{% /note %}}
+
+
+### Examples of Branch Bundle organization {#examples-of-branch-bundle-organization}
+
+```text
+content/
+├── branch-bundle-1
+│ ├── branch-content1.md
+│ ├── branch-content2.md
+│ ├── image1.jpg
+│ ├── image2.png
+│ └── _index.md
+└── branch-bundle-2
+ ├── _index.md
+ └── a-leaf-bundle
+ └── index.md
+```
+
+In the above example `content/` directory, there are two branch
+bundles (and a leaf bundle):
+
+`branch-bundle-1`
+: This branch bundle has the `_index.md`, two
+ other content Markdown files and two image files.
+
+`branch-bundle-2`
+: This branch bundle has the `_index.md` and a
+ nested leaf bundle.
+
+{{% note %}}
+The hierarchy depth at which a branch bundle is created does not
+matter.
+{{% /note %}}
+
+[^fn:1]: The `.md` extension is just an example. The extension can be `.html`, `.json` or any of any valid MIME type.
diff --git a/docs/content/content-management/page-resources.md b/docs/content/en/content-management/page-resources.md
diff --git a/docs/content/content-management/related.md b/docs/content/en/content-management/related.md
diff --git a/docs/content/en/content-management/sections.md b/docs/content/en/content-management/sections.md
@@ -0,0 +1,98 @@
+---
+title: Content Sections
+linktitle: Sections
+description: "Hugo generates a **section tree** that matches your content."
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [content management]
+keywords: [lists,sections,content types,organization]
+menu:
+ docs:
+ parent: "content-management"
+ weight: 50
+weight: 50 #rem
+draft: false
+aliases: [/content/sections/]
+toc: true
+---
+
+A **Section** is a collection of pages that gets defined based on the
+organization structure under the `content/` directory.
+
+By default, all the **first-level** directories under `content/` form their own
+sections (**root sections**).
+
+If a user needs to define a section `foo` at a deeper level, they need to create
+a directory named `foo` with an `_index.md` file (see [Branch Bundles][branch bundles]
+for more information).
+
+
+{{% note %}}
+A **section** cannot be defined or overridden by a front matter parameter -- it
+is strictly derived from the content organization structure.
+{{% /note %}}
+
+## Nested Sections
+
+The sections can be nested as deeply as you need.
+
+```bash
+content
+└── blog <-- Section, because first-level dir under content/
+ ├── funny-cats
+ │ ├── mypost.md
+ │ └── kittens <-- Section, because contains _index.md
+ │ └── _index.md
+ └── tech <-- Section, because contains _index.md
+ └── _index.md
+```
+
+**The important part to understand is, that to make the section tree fully navigational, at least the lower-most section needs a content file. (e.g. `_index.md`).**
+
+{{% note %}}
+When we talk about a **section** in correlation with template selection, it is
+currently always the *root section* only (`/blog/funny-cats/mypost/ => blog`).
+
+If you need a specific template for a sub-section, you need to adjust either the `type` or `layout` in front matter.
+{{% /note %}}
+
+## Example: Breadcrumb Navigation
+
+With the available [section variables and methods](#section-page-variables-and-methods) you can build powerful navigation. One common example would be a partial to show Breadcrumb navigation:
+
+{{< code file="layouts/partials/breadcrumb.html" download="breadcrumb.html" >}}
+<ol class="nav navbar-nav">
+ {{ template "breadcrumbnav" (dict "p1" . "p2" .) }}
+</ol>
+{{ define "breadcrumbnav" }}
+{{ if .p1.Parent }}
+{{ template "breadcrumbnav" (dict "p1" .p1.Parent "p2" .p2 ) }}
+{{ else if not .p1.IsHome }}
+{{ template "breadcrumbnav" (dict "p1" .p1.Site.Home "p2" .p2 ) }}
+{{ end }}
+<li{{ if eq .p1 .p2 }} class="active"{{ end }}>
+ <a href="{{ .p1.Permalink }}">{{ .p1.Title }}</a>
+</li>
+{{ end }}
+{{< /code >}}
+
+## Section Page Variables and Methods
+
+Also see [Page Variables](/variables/page/).
+
+{{< readfile file="/content/en/readfiles/sectionvars.md" markdown="true" >}}
+
+## Content Section Lists
+
+Hugo will automatically create pages for each *root section* that list all of the content in that section. See the documentation on [section templates][] for details on customizing the way these pages are rendered.
+
+## Content *Section* vs Content *Type*
+
+By default, everything created within a section will use the [content `type`][content type] that matches the *root section* name. For example, Hugo will assume that `posts/post-1.md` has a `posts` content `type`. If you are using an [archetype][] for your `posts` section, Hugo will generate front matter according to what it finds in `archetypes/posts.md`.
+
+[archetype]: /content-management/archetypes/
+[content type]: /content-management/types/
+[directory structure]: /getting-started/directory-structure/
+[section templates]: /templates/section-templates/
+[branch bundles]: /content-management/page-bundles/#branch-bundles
diff --git a/docs/content/en/content-management/shortcodes.md b/docs/content/en/content-management/shortcodes.md
@@ -0,0 +1,424 @@
+---
+title: Shortcodes
+linktitle:
+description: Shortcodes are simple snippets inside your content files calling built-in or custom templates.
+godocref:
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-03-31
+menu:
+ docs:
+ parent: "content-management"
+ weight: 35
+weight: 35 #rem
+categories: [content management]
+keywords: [markdown,content,shortcodes]
+draft: false
+aliases: [/extras/shortcodes/]
+toc: true
+---
+
+## What a Shortcode is
+
+Hugo loves Markdown because of its simple content format, but there are times when Markdown falls short. Often, content authors are forced to add raw HTML (e.g., video `<iframes>`) to Markdown content. We think this contradicts the beautiful simplicity of Markdown's syntax.
+
+Hugo created **shortcodes** to circumvent these limitations.
+
+A shortcode is a simple snippet inside a content file that Hugo will render using a predefined template. Note that shortcodes will not work in template files. If you need the type of drop-in functionality that shortcodes provide but in a template, you most likely want a [partial template][partials] instead.
+
+In addition to cleaner Markdown, shortcodes can be updated any time to reflect new classes, techniques, or standards. At the point of site generation, Hugo shortcodes will easily merge in your changes. You avoid a possibly complicated search and replace operation.
+
+## Use Shortcodes
+
+{{< youtube 2xkNJL4gJ9E >}}
+
+In your content files, a shortcode can be called by calling `{{%/* shortcodename parameters */%}}`. Shortcode parameters are space delimited, and parameters with internal spaces can be quoted.
+
+The first word in the shortcode declaration is always the name of the shortcode. Parameters follow the name. Depending upon how the shortcode is defined, the parameters may be named, positional, or both, although you can't mix parameter types in a single call. The format for named parameters models that of HTML with the format `name="value"`.
+
+Some shortcodes use or require closing shortcodes. Again like HTML, the opening and closing shortcodes match (name only) with the closing declaration, which is prepended with a slash.
+
+Here are two examples of paired shortcodes:
+
+```
+{{%/* mdshortcode */%}}Stuff to `process` in the *center*.{{%/* /mdshortcode */%}}
+```
+
+```
+{{</* highlight go */>}} A bunch of code here {{</* /highlight */>}}
+```
+
+The examples above use two different delimiters, the difference being the `%` character in the first and the `<>` characters in the second.
+
+### Shortcodes with Markdown
+
+The `%` character indicates that the shortcode's inner content---called in the [shortcode template][sctemps] with the [`.Inner` variable][scvars]---needs further processing by the page's rendering processor (i.e. markdown via Blackfriday). In the following example, Blackfriday would convert `**World**` to `<strong>World</strong>`:
+
+```
+{{%/* myshortcode */%}}Hello **World!**{{%/* /myshortcode */%}}
+```
+
+### Shortcodes Without Markdown
+
+The `<` character indicates that the shortcode's inner content does *not* need further rendering. Often shortcodes without markdown include internal HTML:
+
+```
+{{</* myshortcode */>}}<p>Hello <strong>World!</strong></p>{{</* /myshortcode */>}}
+```
+
+### Nested Shortcodes
+
+You can call shortcodes within other shortcodes by creating your own templates that leverage the `.Parent` variable. `.Parent` allows you to check the context in which the shortcode is being called. See [Shortcode templates][sctemps].
+
+## Use Hugo's Built-in Shortcodes
+
+Hugo ships with a set of predefined shortcodes that represent very common usage. These shortcodes are provided for author convenience and to keep your markdown content clean.
+
+### `figure`
+
+`figure` is an extension of the image syntax in markdown, which does not provide a shorthand for the more semantic [HTML5 `<figure>` element][figureelement].
+
+The `figure` shortcode can use the following named parameters:
+
+src
+: URL of the image to be displayed.
+
+link
+: If the image needs to be hyperlinked, URL of the destination.
+
+target
+: Optional `target` attribute for the URL if `link` parameter is set.
+
+rel
+: Optional `rel` attribute for the URL if `link` parameter is set.
+
+alt
+: Alternate text for the image if the image cannot be displayed.
+
+title
+: Image title.
+
+caption
+: Image caption.
+
+class
+: `class` attribute of the HTML `figure` tag.
+
+height
+: `height` attribute of the image.
+
+width
+: `width` attribute of the image.
+
+attr
+: Image attribution text.
+
+attrlink
+: If the attribution text needs to be hyperlinked, URL of the destination.
+
+#### Example `figure` Input
+
+{{< code file="figure-input-example.md" >}}
+{{</* figure src="/media/spf13.jpg" title="Steve Francia" */>}}
+{{< /code >}}
+
+#### Example `figure` Output
+
+{{< output file="figure-output-example.html" >}}
+<figure>
+ <img src="/media/spf13.jpg" />
+ <figcaption>
+ <h4>Steve Francia</h4>
+ </figcaption>
+</figure>
+{{< /output >}}
+
+### `gist`
+
+Bloggers often want to include GitHub gists when writing posts. Let's suppose we want to use the [gist at the following url][examplegist]:
+
+```
+https://gist.github.com/spf13/7896402
+```
+
+We can embed the gist in our content via username and gist ID pulled from the URL:
+
+```
+{{</* gist spf13 7896402 */>}}
+```
+
+#### Example `gist` Input
+
+If the gist contains several files and you want to quote just one of them, you can pass the filename (quoted) as an optional third argument:
+
+{{< code file="gist-input.md" >}}
+{{</* gist spf13 7896402 "img.html" */>}}
+{{< /code >}}
+
+#### Example `gist` Output
+
+{{< output file="gist-output.html" >}}
+{{< gist spf13 7896402 >}}
+{{< /output >}}
+
+#### Example `gist` Display
+
+To demonstrate the remarkably efficiency of Hugo's shortcode feature, we have embedded the `spf13` `gist` example in this page. The following simulates the experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
+
+{{< gist spf13 7896402 >}}
+
+### `highlight`
+
+This shortcode will convert the source code provided into syntax-highlighted HTML. Read more on [highlighting](/tools/syntax-highlighting/). `highlight` takes exactly one required `language` parameter and requires a closing shortcode.
+
+#### Example `highlight` Input
+
+{{< code file="content/tutorials/learn-html.md" >}}
+{{</* highlight html */>}}
+<section id="main">
+ <div>
+ <h1 id="title">{{ .Title }}</h1>
+ {{ range .Data.Pages }}
+ {{ .Render "summary"}}
+ {{ end }}
+ </div>
+</section>
+{{</* /highlight */>}}
+{{< /code >}}
+
+#### Example `highlight` Output
+
+The `highlight` shortcode example above would produce the following HTML when the site is rendered:
+
+{{< output file="tutorials/learn-html/index.html" >}}
+<span style="color: #f92672"><section</span> <span style="color: #a6e22e">id=</span><span style="color: #e6db74">"main"</span><span style="color: #f92672">></span>
+ <span style="color: #f92672"><div></span>
+ <span style="color: #f92672"><h1</span> <span style="color: #a6e22e">id=</span><span style="color: #e6db74">"title"</span><span style="color: #f92672">></span>{{ .Title }}<span style="color: #f92672"></h1></span>
+ {{ range .Data.Pages }}
+ {{ .Render "summary"}}
+ {{ end }}
+ <span style="color: #f92672"></div></span>
+<span style="color: #f92672"></section></span>
+{{< /output >}}
+
+{{% note "More on Syntax Highlighting" %}}
+To see even more options for adding syntax-highlighted code blocks to your website, see [Syntax Highlighting in Developer Tools](/tools/syntax-highlighting/).
+{{% /note %}}
+
+### `instagram`
+
+If you'd like to embed a photo from [Instagram][], you only need the photo's ID. You can discern an Instagram photo ID from the URL:
+
+```
+https://www.instagram.com/p/BWNjjyYFxVx/
+```
+
+#### Example `instagram` Input
+
+{{< code file="instagram-input.md" >}}
+{{</* instagram BWNjjyYFxVx */>}}
+{{< /code >}}
+
+You also have the option to hide the caption:
+
+{{< code file="instagram-input-hide-caption.md" >}}
+{{</* instagram BWNjjyYFxVx hidecaption */>}}
+{{< /code >}}
+
+#### Example `instagram` Output
+
+By adding the preceding `hidecaption` example, the following HTML will be added to your rendered website's markup:
+
+{{< output file="instagram-hide-caption-output.html" >}}
+{{< instagram BWNjjyYFxVx hidecaption >}}
+{{< /output >}}
+
+#### Example `instagram` Display
+
+Using the preceding `instagram` with `hidecaption` example above, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
+
+{{< instagram BWNjjyYFxVx hidecaption >}}
+
+
+### `ref` and `relref`
+
+These shortcodes will look up the pages by their relative path (e.g., `blog/post.md`) or their logical name (`post.md`) and return the permalink (`ref`) or relative permalink (`relref`) for the found page.
+
+`ref` and `relref` also make it possible to make fragmentary links that work for the header links generated by Hugo.
+
+{{% note "More on Cross References" %}}
+Read a more extensive description of `ref` and `relref` in the [cross references](/content-management/cross-references/) documentation.
+{{% /note %}}
+
+`ref` and `relref` take exactly one required parameter of _reference_, quoted and in position `0`.
+
+#### Example `ref` and `relref` Input
+
+```
+[Neat]({{</* ref "blog/neat.md" */>}})
+[Who]({{</* relref "about.md#who" */>}})
+```
+
+#### Example `ref` and `relref` Output
+
+Assuming that standard Hugo pretty URLs are turned on.
+
+```
+<a href="/blog/neat">Neat</a>
+<a href="/about/#who:c28654c202e73453784cfd2c5ab356c0">Who</a>
+```
+
+### `speakerdeck`
+
+To embed slides from [Speaker Deck][], click on "< /> Embed" (under Share right next to the template on Speaker Deck) and copy the URL:
+
+```
+<script async class="speakerdeck-embed" data-id="4e8126e72d853c0060001f97" data-ratio="1.33333333333333" src="//speakerdeck.com/assets/embed.js"></script>
+```
+
+#### `speakerdeck` Example Input
+
+Extract the value from the field `data-id` and pass it to the shortcode:
+
+{{< code file="speakerdeck-example-input.md" >}}
+{{</* speakerdeck 4e8126e72d853c0060001f97 */>}}
+{{< /code >}}
+
+#### `speakerdeck` Example Output
+
+{{< output file="speakerdeck-example-input.md" >}}
+{{< speakerdeck 4e8126e72d853c0060001f97 >}}
+{{< /output >}}
+
+#### `speakerdeck` Example Display
+
+For the preceding `speakerdeck` example, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
+
+{{< speakerdeck 4e8126e72d853c0060001f97 >}}
+
+### `tweet`
+
+You want to include a single tweet into your blog post? Everything you need is the URL of the tweet:
+
+```
+https://twitter.com/spf13/status/877500564405444608
+```
+
+#### Example `tweet` Input
+
+Pass the tweet's ID from the URL as a parameter to the `tweet` shortcode:
+
+{{< code file="example-tweet-input.md" >}}
+{{</* tweet 877500564405444608 */>}}
+{{< /code >}}
+
+#### Example `tweet` Output
+
+Using the preceding `tweet` example, the following HTML will be added to your rendered website's markup:
+
+{{< output file="example-tweet-output.html" >}}
+{{< tweet 877500564405444608 >}}
+{{< /output >}}
+
+#### Example `tweet` Display
+
+Using the preceding `tweet` example, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
+
+{{< tweet 877500564405444608 >}}
+
+### `vimeo`
+
+Adding a video from [Vimeo][] is equivalent to the YouTube shortcode above.
+
+```
+https://vimeo.com/channels/staffpicks/146022717
+```
+
+#### Example `vimeo` Input
+
+Extract the ID from the video's URL and pass it to the `vimeo` shortcode:
+
+{{< code file="example-vimeo-input.md" >}}
+{{</* vimeo 146022717 */>}}
+{{< /code >}}
+
+#### Example `vimeo` Output
+
+Using the preceding `vimeo` example, the following HTML will be added to your rendered website's markup:
+
+{{< output file="example-vimeo-output.html" >}}
+{{< vimeo 146022717 >}}
+{{< /output >}}
+
+{{% tip %}}
+If you want to further customize the visual styling of the YouTube or Vimeo output, add a `class` named parameter when calling the shortcode. The new `class` will be added to the `<div>` that wraps the `<iframe>` *and* will remove the inline styles. Note that you will need to call the `id` as a named parameter as well.
+
+```
+{{</* vimeo id="146022717" class="my-vimeo-wrapper-class" */>}}
+```
+{{% /tip %}}
+
+#### Example `vimeo` Display
+
+Using the preceding `vimeo` example, the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup.
+
+{{< vimeo 146022717 >}}
+
+### `youtube`
+
+The `youtube` shortcode embeds a responsive video player for [YouTube videos][]. Only the ID of the video is required, e.g.:
+
+```
+https://www.youtube.com/watch?v=w7Ft2ymGmfc
+```
+
+
+#### Example `youtube` Input
+
+Copy the YouTube video ID that follows `v=` in the video's URL and pass it to the `youtube` shortcode:
+
+{{< code file="example-youtube-input.md" >}}
+{{</* youtube w7Ft2ymGmfc */>}}
+{{< /code >}}
+
+Furthermore, you can automatically start playback of the embedded video by setting the `autoplay` parameter to `true`. Remember that you can't mix named an unnamed parameters, so you'll need to assign the yet unnamed video id to the parameter `id`:
+
+
+{{< code file="example-youtube-input-with-autoplay.md" >}}
+{{</* youtube id="w7Ft2ymGmfc" autoplay="true" */>}}
+{{< /code >}}
+
+#### Example `youtube` Output
+
+Using the preceding `youtube` example, the following HTML will be added to your rendered website's markup:
+
+{{< code file="example-youtube-output.html" >}}
+{{< youtube id="w7Ft2ymGmfc" autoplay="true" >}}
+{{< /code >}}
+
+#### Example `youtube` Display
+
+Using the preceding `youtube` example (without `autoplay="true"`), the following simulates the displayed experience for visitors to your website. Naturally, the final display will be contingent on your stylesheets and surrounding markup. The video is also include in the [Quick Start of the Hugo documentation][quickstart].
+
+{{< youtube w7Ft2ymGmfc >}}
+
+## Create Custom Shortcodes
+
+To learn more about creating custom shortcodes, see the [shortcode template documentation][].
+
+[`figure` shortcode]: #figure
+[contentmanagementsection]: /content-management/formats/
+[examplegist]: https://gist.github.com/spf13/7896402
+[figureelement]: http://html5doctor.com/the-figure-figcaption-elements/ "An article from HTML5 doctor discussing the fig and figcaption elements."
+[Instagram]: https://www.instagram.com/
+[pagevariables]: /variables/page/
+[partials]: /templates/partials/
+[Pygments]: http://pygments.org/
+[quickstart]: /getting-started/quick-start/
+[sctemps]: /templates/shortcode-templates/
+[scvars]: /variables/shortcodes/
+[shortcode template documentation]: /templates/shortcode-templates/
+[Speaker Deck]: https://speakerdeck.com/
+[templatessection]: /templates/
+[Vimeo]: https://vimeo.com/
+[YouTube Videos]: https://www.youtube.com/
diff --git a/docs/content/content-management/static-files.md b/docs/content/en/content-management/static-files.md
diff --git a/docs/content/content-management/summaries.md b/docs/content/en/content-management/summaries.md
diff --git a/docs/content/en/content-management/syntax-highlighting.md b/docs/content/en/content-management/syntax-highlighting.md
@@ -0,0 +1,193 @@
+---
+title: Syntax Highlighting
+description: Hugo comes with really fast syntax highlighting from Chroma.
+date: 2017-02-01
+publishdate: 2017-02-01
+keywords: [highlighting,pygments,chroma,code blocks,syntax]
+categories: [content management]
+menu:
+ docs:
+ parent: "content-management"
+ weight: 300
+weight: 20
+sections_weight: 20
+draft: false
+aliases: [/extras/highlighting/,/extras/highlight/,/tools/syntax-highlighting/]
+toc: true
+---
+
+From Hugo 0.28, the default syntax hightlighter in Hugo is [Chroma](https://github.com/alecthomas/chroma); it is built in Go and is really, really fast -- and for the most important parts compatible with Pygments.
+
+If you want to continue to use Pygments (see below), set `pygmentsUseClasses=true` in your site config.
+
+The example below shows a simple code snippet from the Hugo source highlighted with the `highlight` shortcode. Note that the gohugo.io site is generated with `pygmentsUseClasses=true` (see [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css)).
+
+* `linenos=inline` or `linenos=table` (`table` will give copy-and-paste friendly code blocks) turns on line numbers.
+* `hl_lines` lists a set of line numbers or line number ranges to be highlighted. Note that the hyphen range syntax is only supported for Chroma.
+* `linenostart=199` starts the line number count from 199.
+
+With that, this:
+
+```
+{{</* highlight go "linenos=table,hl_lines=8 15-17,linenostart=199" */>}}
+// ... code
+{{</* / highlight */>}}
+```
+
+Gives this:
+
+{{< highlight go "linenos=table,hl_lines=8 15-17,linenostart=199" >}}
+// GetTitleFunc returns a func that can be used to transform a string to
+// title case.
+//
+// The supported styles are
+//
+// - "Go" (strings.Title)
+// - "AP" (see https://www.apstylebook.com/)
+// - "Chicago" (see http://www.chicagomanualofstyle.org/home.html)
+//
+// If an unknown or empty style is provided, AP style is what you get.
+func GetTitleFunc(style string) func(s string) string {
+ switch strings.ToLower(style) {
+ case "go":
+ return strings.Title
+ case "chicago":
+ tc := transform.NewTitleConverter(transform.ChicagoStyle)
+ return tc.Title
+ default:
+ tc := transform.NewTitleConverter(transform.APStyle)
+ return tc.Title
+ }
+}
+{{< / highlight >}}
+
+
+## Configure Syntax Highlighter
+To make the transition from Pygments to Chroma seamless, they share a common set of configuration options:
+
+pygmentsOptions
+: A comma separated list of options. See below for a full list.
+
+pygmentsCodefences
+: Set to true to enable syntax highlighting in code fences with a language tag in markdown (see below for an example).
+
+pygmentsStyle
+: The style of code highlighting. See https://help.farbox.com/pygments.html for a gallery. Note that this option is not relevant when `pygmentsUseClasses` is set.
+
+pygmentsUseClasses
+: Set to `true` to use CSS classes to format your highlighted code. See [Generate Syntax Highlighter CSS](#generate-syntax-highlighter-css).
+
+pygmentsCodefencesGuessSyntax
+: Set to `true` to try to do syntax highlighting on code fenced blocks in markdown without a language tag.
+
+pygmentsUseClassic
+: Set to true to use Pygments instead of the much faster Chroma.
+
+### Options
+
+`pygmentsOptions` can be set either in site config or overridden per code block in the Highlight shortcode or template func.
+
+noclasses
+: Use inline style.
+
+linenos
+: For Chroma, any value in this setting will print line numbers. Pygments has some more fine grained control.
+
+linenostart
+: Start the line numbers from this value (default is 1).
+
+
+hl_lines
+: Highlight a space separated list of line numbers. For Chroma, you can provide a list of ranges, i.e. "3-8 10-20".
+
+
+The full set of supported options for Pygments is: `encoding`, `outencoding`, `nowrap`, `full`, `title`, `style`, `noclasses`, `classprefix`, `cssclass`, `cssstyles`, `prestyles`, `linenos`, `hl_lines`, `linenostart`, `linenostep`, `linenospecial`, `nobackground`, `lineseparator`, `lineanchors`, `linespans`, `anchorlinenos`, `startinline`. See the [Pygments HTML Formatter Documentation](http://pygments.org/docs/formatters/#HtmlFormatter) for details.
+
+
+## Generate Syntax Highlighter CSS
+
+If you run with `pygmentsUseClasses=true` in your site config, you need a style sheet.
+
+You can generate one with Hugo:
+
+```bash
+hugo gen chromastyles --style=monokai > syntax.css
+```
+
+Run `hugo gen chromastyles -h` for more options. See https://help.farbox.com/pygments.html for a gallery of available styles.
+
+
+## Highlight Shortcode
+
+Highlighting is carried out via the [built-in shortcode](/content-management/shortcodes/) `highlight`. `highlight` takes exactly one required parameter for the programming language to be highlighted and requires a closing shortcode. Note that `highlight` is *not* used for client-side javascript highlighting.
+
+### Example `highlight` Shortcode
+
+{{< code file="example-highlight-shortcode-input.md" >}}
+{{</* highlight html */>}}
+<section id="main">
+ <div>
+ <h1 id="title">{{ .Title }}</h1>
+ {{ range .Data.Pages }}
+ {{ .Render "summary"}}
+ {{ end }}
+ </div>
+</section>
+{{</* /highlight */>}}
+{{< /code >}}
+
+
+
+## Highlight Template Func
+
+See [Highlight](/functions/highlight/).
+
+## Highlight in Code Fences
+
+It is also possible to add syntax highlighting with GitHub flavored code fences. To enable this, set the `pygmentsCodeFences` to `true` in Hugo's [configuration file](/getting-started/configuration/);
+
+````
+```go-html-template
+<section id="main">
+ <div>
+ <h1 id="title">{{ .Title }}</h1>
+ {{ range .Data.Pages }}
+ {{ .Render "summary"}}
+ {{ end }}
+ </div>
+</section>
+```
+````
+
+## List of Chroma Highlighting Languages
+
+The full list of Chroma lexers and their aliases (which is the identifier used in the `hightlight` template func or when doing highlighting in code fences):
+
+{{< chroma-lexers >}}
+
+## Highlight with Pygments Classic
+
+If you for some reason don't want to use the built-in Chroma highlighter, you can set `pygmentsUseClassic=true` in your config and add Pygments to your path.
+
+{{% note "Disclaimers on Pygments" %}}
+* Pygments is relatively slow and _causes a performance hit when building your site_, but Hugo has been designed to cache the results to disk.
+* The caching can be turned off by setting the `--ignoreCache` flag to `true`.
+* The languages available for highlighting depend on your Pygments installation.
+{{% /note %}}
+
+If you have never worked with Pygments before, here is a brief primer:
+
++ Install Python from [python.org](https://www.python.org/downloads/). Version 2.7.x is already sufficient.
++ Run `pip install Pygments` in order to install Pygments. Once installed, Pygments gives you a command `pygmentize`. Make sure it sits in your PATH; otherwise, Hugo will not be able to find and use it.
+
+On Debian and Ubuntu systems, you may also install Pygments by running `sudo apt-get install python3-pygments`.
+
+
+
+[Prism]: http://prismjs.com
+[prismdownload]: http://prismjs.com/download.html
+[Highlight.js]: http://highlightjs.org/
+[Rainbow]: http://craig.is/making/rainbows
+[Syntax Highlighter]: http://alexgorbatchev.com/SyntaxHighlighter/
+[Google Prettify]: https://github.com/google/code-prettify
+[Yandex]: http://yandex.ru/
diff --git a/docs/content/content-management/taxonomies.md b/docs/content/en/content-management/taxonomies.md
diff --git a/docs/content/content-management/toc.md b/docs/content/en/content-management/toc.md
diff --git a/docs/content/content-management/types.md b/docs/content/en/content-management/types.md
diff --git a/docs/content/content-management/urls.md b/docs/content/en/content-management/urls.md
diff --git a/docs/content/contribute/_index.md b/docs/content/en/contribute/_index.md
diff --git a/docs/content/contribute/development.md b/docs/content/en/contribute/development.md
diff --git a/docs/content/contribute/documentation.md b/docs/content/en/contribute/documentation.md
diff --git a/docs/content/contribute/themes.md b/docs/content/en/contribute/themes.md
diff --git a/docs/content/documentation.md b/docs/content/en/documentation.md
diff --git a/docs/content/functions/GetPage.md b/docs/content/en/functions/GetPage.md
diff --git a/docs/content/functions/NumFmt.md b/docs/content/en/functions/NumFmt.md
diff --git a/docs/content/functions/_index.md b/docs/content/en/functions/_index.md
diff --git a/docs/content/functions/abslangurl.md b/docs/content/en/functions/abslangurl.md
diff --git a/docs/content/functions/absurl.md b/docs/content/en/functions/absurl.md
diff --git a/docs/content/functions/adddate.md b/docs/content/en/functions/adddate.md
diff --git a/docs/content/functions/after.md b/docs/content/en/functions/after.md
diff --git a/docs/content/functions/apply.md b/docs/content/en/functions/apply.md
diff --git a/docs/content/functions/base64.md b/docs/content/en/functions/base64.md
diff --git a/docs/content/functions/chomp.md b/docs/content/en/functions/chomp.md
diff --git a/docs/content/functions/cond.md b/docs/content/en/functions/cond.md
diff --git a/docs/content/functions/countrunes.md b/docs/content/en/functions/countrunes.md
diff --git a/docs/content/functions/countwords.md b/docs/content/en/functions/countwords.md
diff --git a/docs/content/functions/dateformat.md b/docs/content/en/functions/dateformat.md
diff --git a/docs/content/functions/default.md b/docs/content/en/functions/default.md
diff --git a/docs/content/en/functions/delimit.md b/docs/content/en/functions/delimit.md
@@ -0,0 +1,64 @@
+---
+title: delimit
+description: Loops through any array, slice, or map and returns a string of all the values separated by a delimiter.
+godocref:
+workson: []
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [functions]
+menu:
+ docs:
+ parent: "functions"
+keywords: [iteration]
+toc: false
+signature: ["delimit COLLECTION DELIMIT LAST"]
+workson: [lists,taxonomies,terms]
+hugoversion:
+relatedfuncs: []
+deprecated: false
+draft: false
+aliases: []
+---
+
+`delimit` called in your template takes the form of
+
+```
+{{ delimit array/slice/map delimiter optionallastdelimiter}}
+```
+
+`delimit` loops through any array, slice, or map and returns a string of all the values separated by a delimiter, the second argument in the function call. There is an optional third parameter that lets you choose a different delimiter to go between the last two values in the loop.
+
+To maintain a consistent output order, maps will be sorted by keys and only a slice of the values will be returned.
+
+The examples of `delimit` that follow all use the same front matter:
+
+{{< code file="delimit-example-front-matter.toml" nocopy="true" >}}
++++
+title: I love Delimit
+tags: [ "tag1", "tag2", "tag3" ]
++++
+{{< /code >}}
+
+{{< code file="delimit-page-tags-input.html" >}}
+<p>Tags: {{ delimit .Params.tags ", " }}</p>
+{{< /code >}}
+
+{{< output file="delimit-page-tags-output.html" >}}
+<p>Tags: tag1, tag2, tag3</p>
+{{< /output >}}
+
+Here is the same example but with the optional "last" delimiter:
+
+{{< code file="delimit-page-tags-final-and-input.html" >}}
+Tags: {{ delimit .Params.tags ", " ", and " }}
+{{< /code >}}
+
+{{< output file="delimit-page-tags-final-and-output.html" >}}
+<p>Tags: tag1, tag2, and tag3</p>
+{{< /output >}}
+
+
+[lists]: /templates/lists/
+[taxonomies]: /templates/taxonomy-templates/#taxonomy-list-templates
+[terms]: /templates/taxonomy-templates/#terms-list-templates
diff --git a/docs/content/functions/dict.md b/docs/content/en/functions/dict.md
diff --git a/docs/content/functions/echoparam.md b/docs/content/en/functions/echoparam.md
diff --git a/docs/content/functions/emojify.md b/docs/content/en/functions/emojify.md
diff --git a/docs/content/functions/eq.md b/docs/content/en/functions/eq.md
diff --git a/docs/content/functions/errorf.md b/docs/content/en/functions/errorf.md
diff --git a/docs/content/functions/fileExists.md b/docs/content/en/functions/fileExists.md
diff --git a/docs/content/functions/findRe.md b/docs/content/en/functions/findRe.md
diff --git a/docs/content/functions/first.md b/docs/content/en/functions/first.md
diff --git a/docs/content/functions/float.md b/docs/content/en/functions/float.md
diff --git a/docs/content/functions/format.md b/docs/content/en/functions/format.md
diff --git a/docs/content/functions/ge.md b/docs/content/en/functions/ge.md
diff --git a/docs/content/functions/get.md b/docs/content/en/functions/get.md
diff --git a/docs/content/functions/getenv.md b/docs/content/en/functions/getenv.md
diff --git a/docs/content/functions/gt.md b/docs/content/en/functions/gt.md
diff --git a/docs/content/functions/hasPrefix.md b/docs/content/en/functions/hasPrefix.md
diff --git a/docs/content/functions/haschildren.md b/docs/content/en/functions/haschildren.md
diff --git a/docs/content/functions/hasmenucurrent.md b/docs/content/en/functions/hasmenucurrent.md
diff --git a/docs/content/functions/highlight.md b/docs/content/en/functions/highlight.md
diff --git a/docs/content/functions/htmlEscape.md b/docs/content/en/functions/htmlEscape.md
diff --git a/docs/content/functions/htmlUnescape.md b/docs/content/en/functions/htmlUnescape.md
diff --git a/docs/content/functions/humanize.md b/docs/content/en/functions/humanize.md
diff --git a/docs/content/functions/i18n.md b/docs/content/en/functions/i18n.md
diff --git a/docs/content/functions/imageConfig.md b/docs/content/en/functions/imageConfig.md
diff --git a/docs/content/functions/in.md b/docs/content/en/functions/in.md
diff --git a/docs/content/functions/index-function.md b/docs/content/en/functions/index-function.md
diff --git a/docs/content/functions/int.md b/docs/content/en/functions/int.md
diff --git a/docs/content/functions/intersect.md b/docs/content/en/functions/intersect.md
diff --git a/docs/content/functions/ismenucurrent.md b/docs/content/en/functions/ismenucurrent.md
diff --git a/docs/content/functions/isset.md b/docs/content/en/functions/isset.md
diff --git a/docs/content/functions/jsonify.md b/docs/content/en/functions/jsonify.md
diff --git a/docs/content/functions/lang.Merge.md b/docs/content/en/functions/lang.Merge.md
diff --git a/docs/content/functions/last.md b/docs/content/en/functions/last.md
diff --git a/docs/content/functions/le.md b/docs/content/en/functions/le.md
diff --git a/docs/content/functions/len.md b/docs/content/en/functions/len.md
diff --git a/docs/content/functions/lower.md b/docs/content/en/functions/lower.md
diff --git a/docs/content/functions/lt.md b/docs/content/en/functions/lt.md
diff --git a/docs/content/functions/markdownify.md b/docs/content/en/functions/markdownify.md
diff --git a/docs/content/functions/math.md b/docs/content/en/functions/math.md
diff --git a/docs/content/functions/md5.md b/docs/content/en/functions/md5.md
diff --git a/docs/content/functions/ne.md b/docs/content/en/functions/ne.md
diff --git a/docs/content/en/functions/now.md b/docs/content/en/functions/now.md
@@ -0,0 +1,50 @@
+---
+title: now
+linktitle: now
+description: Returns the current local time
+godocref: https://godoc.org/time#Time
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-04-30
+categories: [functions]
+menu:
+ docs:
+ parent: "functions"
+keywords: [dates,time]
+signature: ["now"]
+workson: []
+hugoversion:
+relatedfuncs: [Unix,dateFormat]
+deprecated: false
+aliases: []
+---
+
+See [`time.Time`](https://godoc.org/time#Time).
+
+For example, building your site on June 24, 2017, with the following templating:
+
+```
+<div>
+ <small>© {{ now.Format "2006"}}</small>
+</div>
+```
+
+would produce the following:
+
+```
+<div>
+ <small>© 2017</small>
+</div>
+```
+
+The above example uses the [`.Format` function](/functions/format), which page includes a full listing of date formatting using Golang's layout string.
+
+{{% note %}}
+Older Hugo themes may still be using the obsolete Page’s `.Now` (uppercase with leading dot), which causes build error that looks like the following:
+
+ ERROR ... Error while rendering "..." in "...": ...
+ executing "..." at <.Now.Format>:
+ can't evaluate field Now in type *hugolib.PageOutput
+
+Be sure to use `now` (lowercase with _**no**_ leading dot) in your templating.
+{{% /note %}}
diff --git a/docs/content/functions/param.md b/docs/content/en/functions/param.md
diff --git a/docs/content/functions/partialCached.md b/docs/content/en/functions/partialCached.md
diff --git a/docs/content/functions/plainify.md b/docs/content/en/functions/plainify.md
diff --git a/docs/content/functions/pluralize.md b/docs/content/en/functions/pluralize.md
diff --git a/docs/content/functions/print.md b/docs/content/en/functions/print.md
diff --git a/docs/content/functions/printf.md b/docs/content/en/functions/printf.md
diff --git a/docs/content/functions/println.md b/docs/content/en/functions/println.md
diff --git a/docs/content/functions/querify.md b/docs/content/en/functions/querify.md
diff --git a/docs/content/functions/range.md b/docs/content/en/functions/range.md
diff --git a/docs/content/functions/readdir.md b/docs/content/en/functions/readdir.md
diff --git a/docs/content/functions/readfile.md b/docs/content/en/functions/readfile.md
diff --git a/docs/content/functions/ref.md b/docs/content/en/functions/ref.md
diff --git a/docs/content/functions/relLangURL.md b/docs/content/en/functions/relLangURL.md
diff --git a/docs/content/functions/relref.md b/docs/content/en/functions/relref.md
diff --git a/docs/content/functions/relurl.md b/docs/content/en/functions/relurl.md
diff --git a/docs/content/functions/render.md b/docs/content/en/functions/render.md
diff --git a/docs/content/functions/replace.md b/docs/content/en/functions/replace.md
diff --git a/docs/content/functions/replacere.md b/docs/content/en/functions/replacere.md
diff --git a/docs/content/functions/safeCSS.md b/docs/content/en/functions/safeCSS.md
diff --git a/docs/content/functions/safeHTML.md b/docs/content/en/functions/safeHTML.md
diff --git a/docs/content/functions/safeHTMLAttr.md b/docs/content/en/functions/safeHTMLAttr.md
diff --git a/docs/content/functions/safeJS.md b/docs/content/en/functions/safeJS.md
diff --git a/docs/content/functions/safeURL.md b/docs/content/en/functions/safeURL.md
diff --git a/docs/content/functions/scratch.md b/docs/content/en/functions/scratch.md
diff --git a/docs/content/functions/seq.md b/docs/content/en/functions/seq.md
diff --git a/docs/content/functions/sha.md b/docs/content/en/functions/sha.md
diff --git a/docs/content/functions/shuffle.md b/docs/content/en/functions/shuffle.md
diff --git a/docs/content/functions/singularize.md b/docs/content/en/functions/singularize.md
diff --git a/docs/content/functions/slice.md b/docs/content/en/functions/slice.md
diff --git a/docs/content/functions/slicestr.md b/docs/content/en/functions/slicestr.md
diff --git a/docs/content/functions/sort.md b/docs/content/en/functions/sort.md
diff --git a/docs/content/functions/split.md b/docs/content/en/functions/split.md
diff --git a/docs/content/functions/string.md b/docs/content/en/functions/string.md
diff --git a/docs/content/functions/strings.TrimLeft.md b/docs/content/en/functions/strings.TrimLeft.md
diff --git a/docs/content/functions/strings.TrimPrefix.md b/docs/content/en/functions/strings.TrimPrefix.md
diff --git a/docs/content/functions/strings.TrimRight.md b/docs/content/en/functions/strings.TrimRight.md
diff --git a/docs/content/functions/strings.TrimSuffix.md b/docs/content/en/functions/strings.TrimSuffix.md
diff --git a/docs/content/functions/substr.md b/docs/content/en/functions/substr.md
diff --git a/docs/content/functions/time.md b/docs/content/en/functions/time.md
diff --git a/docs/content/functions/title.md b/docs/content/en/functions/title.md
diff --git a/docs/content/functions/trim.md b/docs/content/en/functions/trim.md
diff --git a/docs/content/functions/truncate.md b/docs/content/en/functions/truncate.md
diff --git a/docs/content/functions/union.md b/docs/content/en/functions/union.md
diff --git a/docs/content/functions/uniq.md b/docs/content/en/functions/uniq.md
diff --git a/docs/content/functions/unix.md b/docs/content/en/functions/unix.md
diff --git a/docs/content/functions/upper.md b/docs/content/en/functions/upper.md
diff --git a/docs/content/functions/urlize.md b/docs/content/en/functions/urlize.md
diff --git a/docs/content/functions/urls.Parse.md b/docs/content/en/functions/urls.Parse.md
diff --git a/docs/content/functions/where.md b/docs/content/en/functions/where.md
diff --git a/docs/content/functions/with.md b/docs/content/en/functions/with.md
diff --git a/docs/content/getting-started/_index.md b/docs/content/en/getting-started/_index.md
diff --git a/docs/content/getting-started/code-toggle.md b/docs/content/en/getting-started/code-toggle.md
diff --git a/docs/content/en/getting-started/configuration.md b/docs/content/en/getting-started/configuration.md
@@ -0,0 +1,404 @@
+---
+title: Configure Hugo
+linktitle: Configuration
+description: How to configure your Hugo site.
+date: 2013-07-01
+publishdate: 2017-01-02
+lastmod: 2017-03-05
+categories: [getting started,fundamentals]
+keywords: [configuration,toml,yaml,json]
+menu:
+ docs:
+ parent: "getting-started"
+ weight: 60
+weight: 60
+sections_weight: 60
+draft: false
+aliases: [/overview/source-directory/,/overview/configuration/]
+toc: true
+---
+
+Hugo uses the `config.toml`, `config.yaml`, or `config.json` (if found in the
+site root) as the default site config file.
+
+The user can choose to override that default with one or more site config files
+using the command line `--config` switch.
+
+Examples:
+
+```
+hugo --config debugconfig.toml
+hugo --config a.toml,b.toml,c.toml
+```
+
+{{% note %}}
+Multiple site config files can be specified as a comma-separated string to the `--config` switch.
+{{% /note %}}
+
+## All Configuration Settings
+
+The following is the full list of Hugo-defined variables with their default
+value in parentheses. Users may choose to override those values in their site
+config file(s).
+
+archetypeDir ("archetypes")
+: The directory where Hugo finds archetype files (content templates).
+
+baseURL
+: Hostname (and path) to the root, e.g. http://bep.is/
+
+blackfriday
+: See [Configure Blackfriday](/getting-started/configuration/#configure-blackfriday)
+
+buildDrafts (false)
+: Include drafts when building.
+
+buildExpired (false)
+: Include content already expired.
+
+buildFuture (false)
+: Include content with publishdate in the future.
+
+canonifyURLs (false)
+: Enable to turn relative URLs into absolute.
+
+contentDir ("content")
+: The directory from where Hugo reads content files.
+
+dataDir ("data")
+: The directory from where Hugo reads data files.
+
+defaultContentLanguage ("en")
+: Content without language indicator will default to this language.
+
+defaultContentLanguageInSubdir (false)
+: Render the default content language in subdir, e.g. `content/en/`. The site root `/` will then redirect to `/en/`.
+
+disableHugoGeneratorInject (false)
+: Hugo will, by default, inject a generator meta tag in the HTML head on the _home page only_. You can turn it off, but we would really appreciate if you don't, as this is a good way to watch Hugo's popularity on the rise.
+
+disableKinds ([])
+: Enable disabling of all pages of the specified *Kinds*. Allowed values in this list: `"page"`, `"home"`, `"section"`, `"taxonomy"`, `"taxonomyTerm"`, `"RSS"`, `"sitemap"`, `"robotsTXT"`, `"404"`.
+
+disableLiveReload (false)
+: Disable automatic live reloading of browser window.
+
+disablePathToLower (false)
+: Do not convert the url/path to lowercase.
+
+enableEmoji (false)
+: Enable Emoji emoticons support for page content; see the [Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet/).
+
+enableGitInfo (false)
+: Enable `.GitInfo` object for each page (if the Hugo site is versioned by Git). This will then update the `Lastmod` parameter for each page using the last git commit date for that content file.
+
+enableMissingTranslationPlaceholders (false)
+: Show a placeholder instead of the default value or an empty string if a translation is missing.
+
+enableRobotsTXT (false)
+: Enable generation of `robots.txt` file.
+
+frontmatter
+
+: See [Front matter Configuration](#configure-front-matter).
+
+footnoteAnchorPrefix ("")
+: Prefix for footnote anchors.
+
+footnoteReturnLinkContents ("")
+: Text to display for footnote return links.
+
+googleAnalytics ("")
+: Google Analytics tracking ID.
+
+hasCJKLanguage (false)
+: If true, auto-detect Chinese/Japanese/Korean Languages in the content. This will make `.Summary` and `.WordCount` behave correctly for CJK languages.
+
+imaging
+: See [Image Processing Config](/content-management/image-processing/#image-processing-config).
+
+languages
+: See [Configure Languages](/content-management/multilingual/#configure-languages).
+
+languageCode ("")
+: The site's language code.
+
+disableLanguages
+: See [Disable a Language](/content-management/multilingual/#disable-a-language)
+
+layoutDir ("layouts")
+: The directory from where Hugo reads layouts (templates).
+
+log (false)
+: Enable logging.
+
+logFile ("")
+: Log File path (if set, logging enabled automatically).
+
+menu
+: See [Add Non-content Entries to a Menu](/content-management/menus/#add-non-content-entries-to-a-menu).
+
+metaDataFormat ("toml")
+: Front matter meta-data format. Valid values: `"toml"`, `"yaml"`, or `"json"`.
+
+newContentEditor ("")
+: The editor to use when creating new content.
+
+noChmod (false)
+: Don't sync permission mode of files.
+
+noTimes (false)
+: Don't sync modification time of files.
+
+paginate (10)
+: Default number of pages per page in [pagination](/templates/pagination/).
+
+paginatePath ("page")
+: The path element used during pagination (https://example.com/page/2).
+
+permalinks
+: See [Content Management](/content-management/urls/#permalinks).
+
+pluralizeListTitles (true)
+: Pluralize titles in lists.
+
+preserveTaxonomyNames (false)
+: Preserve special characters in taxonomy names ("Gérard Depardieu" vs "Gerard Depardieu").
+
+publishDir ("public")
+: The directory to where Hugo will write the final static site (the HTML files etc.).
+
+pygmentsCodeFencesGuessSyntax (false)
+: Enable syntax guessing for code fences without specified language.
+
+pygmentsStyle ("monokai")
+: Color-theme or style for syntax highlighting. See [Pygments Color Themes](https://help.farbox.com/pygments.html).
+
+pygmentsUseClasses (false)
+: Enable using external CSS for syntax highlighting.
+
+related
+: See [Related Content](/content-management/related/#configure-related-content).
+
+relativeURLs (false)
+: Enable this to make all relative URLs relative to content root. Note that this does not affect absolute URLs.
+
+rssLimit (unlimited)
+: Maximum number of items in the RSS feed.
+
+sectionPagesMenu ("")
+: See ["Section Menu for Lazy Bloggers"](/templates/menu-templates/#section-menu-for-lazy-bloggers).
+
+sitemap
+: Default [sitemap configuration](/templates/sitemap-template/#configure-sitemap-xml).
+
+staticDir ("static")
+: Relative directory from where Hugo reads static files.
+
+stepAnalysis (false)
+: Display memory and timing of different steps of the program.
+
+summaryLength (70)
+: The length of text to show in a [`.Summary`](/content-management/summaries/#hugo-defined-automatic-summary-splitting).
+
+taxonomies
+: See [Configure Taxonomies](/content-management/taxonomies#configure-taxonomies).
+
+theme ("")
+: Theme to use (located by default in `/themes/THEMENAME/`).
+
+themesDir ("themes")
+: The directory where Hugo reads the themes from.
+
+title ("")
+: Site title.
+
+uglyURLs (false)
+: When enabled, creates URL of the form `/filename.html` instead of `/filename/`.
+
+verbose (false)
+: Enable verbose output.
+
+verboseLog (false)
+: Enable verbose logging.
+
+watch (false)
+: Watch filesystem for changes and recreate as needed.
+
+{{% note %}}
+If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line:
+```
+cd ~/sites/yourhugosite
+hugo config | grep emoji
+```
+
+which shows output like
+
+```
+enableemoji: true
+```
+{{% /note %}}
+
+## Configuration Lookup Order
+
+Similar to the template [lookup order][], Hugo has a default set of rules for searching for a configuration file in the root of your website's source directory as a default behavior:
+
+1. `./config.toml`
+2. `./config.yaml`
+3. `./config.json`
+
+In your `config` file, you can direct Hugo as to how you want your website rendered, control your website's menus, and arbitrarily define site-wide parameters specific to your project.
+
+
+## Example Configuration
+
+The following is a typical example of a configuration file. The values nested under `params:` will populate the [`.Site.Params`][] variable for use in [templates][]:
+
+{{< code-toggle file="config">}}
+baseURL: "https://yoursite.example.com/"
+title: "My Hugo Site"
+footnoteReturnLinkContents: "↩"
+permalinks:
+ post: /:year/:month/:title/
+params:
+ Subtitle: "Hugo is Absurdly Fast!"
+ AuthorName: "Jon Doe"
+ GitHubUser: "spf13"
+ ListOfFoo:
+ - "foo1"
+ - "foo2"
+ SidebarRecentLimit: 5
+{{< /code-toggle >}}
+
+## Configure with Environment Variables
+
+In addition to the 3 config options already mentioned, configuration key-values can be defined through operating system environment variables.
+
+For example, the following command will effectively set a website's title on Unix-like systems:
+
+```
+$ env HUGO_TITLE="Some Title" hugo
+```
+
+This is really useful if you use a service such as Netlify to deploy your site. Look at the Hugo docs [Netlify configuration file](https://github.com/gohugoio/hugoDocs/blob/master/netlify.toml) for an example.
+
+{{% note "Setting Environment Variables" %}}
+Names must be prefixed with `HUGO_` and the configuration key must be set in uppercase when setting operating system environment variables.
+{{% /note %}}
+
+{{< todo >}}
+Test and document setting params via JSON env var.
+{{< /todo >}}
+
+## Ignore Files When Rendering
+
+The following statement inside `./config.toml` will cause Hugo to ignore files ending with `.foo` and `.boo` when rendering:
+
+```
+ignoreFiles = [ "\\.foo$", "\\.boo$" ]
+```
+
+The above is a list of regular expressions. Note that the backslash (`\`) character is escaped in this example to keep TOML happy.
+
+## Configure Front Matter
+
+### Configure Dates
+
+Dates are important in Hugo, and you can configure how Hugo assigns dates to your content pages. You do this by adding a `frontmatter` section to your `config.toml`.
+
+
+The default configuration is:
+
+```toml
+[frontmatter]
+date = ["date","publishDate", "lastmod"]
+lastmod = [":git" "lastmod", "date","publishDate"]
+publishDate = ["publishDate", "date"]
+expiryDate = ["expiryDate"]
+```
+
+If you, as an example, have a non-standard date parameter in some of your content, you can override the setting for `date`:
+
+ ```toml
+[frontmatter]
+date = [ "myDate", ":default"]
+```
+
+The `:default` is a shortcut to the default settings. The above will set `.Date` to the date value in `myDate` if present, if not we will look in `date`,`publishDate`, `lastmod` and pick the first valid date.
+
+In the list to the right, values starting with ":" are date handlers with a special meaning (see below). The others are just names of date parameters (case insensitive) in your front matter configuration. Also note that Hugo have some built-in aliases to the above: `lastmod` => `modified`, `publishDate` => `pubdate`, `published` and `expiryDate` => `unpublishdate`. With that, as an example, using `pubDate` as a date in front matter, will, by default, be assigned to `.PublishDate`.
+
+The special date handlers are:
+
+
+`:fileModTime`
+: Fetches the date from the content file's last modification timestamp.
+
+An example:
+
+ ```toml
+[frontmatter]
+lastmod = ["lastmod" ,":fileModTime", ":default"]
+```
+
+
+The above will try first to extract the value for `.Lastmod` starting with the `lastmod` front matter parameter, then the content file's modification timestamp. The last, `:default` should not be needed here, but Hugo will finally look for a valid date in `:git`, `date` and then `publishDate`.
+
+
+`:filename`
+: Fetches the date from the content file's filename. For example, `218-02-22-mypage.md` will extract the date `218-02-22`. Also, if `slug` is not set, `mypage` will be used as the value for `.Slug`.
+
+An example:
+
+```toml
+[frontmatter]
+date = [":filename", ":default"]
+```
+
+The above will try first to extract the value for `.Date` from the filename, then it will look in front matter parameters `date`, `publishDate` and lastly `lastmod`.
+
+
+`:git`
+: This is the Git author date for the last revision of this content file. This will only be set if `--enableGitInfo` is set or `enableGitInfo = true` is set in site config.
+
+## Configure Blackfriday
+
+[Blackfriday](https://github.com/russross/blackfriday) is Hugo's built-in Markdown rendering engine.
+
+Hugo typically configures Blackfriday with sane default values that should fit most use cases reasonably well.
+
+However, if you have specific needs with respect to Markdown, Hugo exposes some of its Blackfriday behavior options for you to alter. The following table lists these Hugo options, paired with the corresponding flags from Blackfriday's source code ( [html.go](https://github.com/russross/blackfriday/blob/master/html.go) and [markdown.go](https://github.com/russross/blackfriday/blob/master/markdown.go)).
+
+{{< readfile file="/content/en/readfiles/bfconfig.md" markdown="true" >}}
+
+{{% note %}}
+1. Blackfriday flags are *case sensitive* as of Hugo v0.15.
+2. Blackfriday flags must be grouped under the `blackfriday` key and can be set on both the site level *and* the page level. Any setting on a page will override its respective site setting.
+{{% /note %}}
+
+{{< code-toggle file="config" >}}
+[blackfriday]
+ angledQuotes = true
+ fractions = false
+ plainIDAnchors = true
+ extensions = ["hardLineBreak"]
+{{< /code-toggle >}}
+
+## Configure Additional Output Formats
+
+Hugo v0.20 introduced the ability to render your content to multiple output formats (e.g., to JSON, AMP html, or CSV). See [Output Formats][] for information on how to add these values to your Hugo project's configuration file.
+
+## Configuration Format Specs
+
+* [TOML Spec][toml]
+* [YAML Spec][yaml]
+* [JSON Spec][json]
+
+[`.Site.Params`]: /variables/site/
+[directory structure]: /getting-started/directory-structure
+[json]: https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf "Specification for JSON, JavaScript Object Notation"
+[lookup order]: /templates/lookup-order/
+[Output Formats]: /templates/output-formats/
+[templates]: /templates/
+[toml]: https://github.com/toml-lang/toml
+[yaml]: http://yaml.org/spec/
diff --git a/docs/content/getting-started/directory-structure.md b/docs/content/en/getting-started/directory-structure.md
diff --git a/docs/content/getting-started/installing.md b/docs/content/en/getting-started/installing.md
diff --git a/docs/content/getting-started/quick-start.md b/docs/content/en/getting-started/quick-start.md
diff --git a/docs/content/getting-started/usage.md b/docs/content/en/getting-started/usage.md
diff --git a/docs/content/hosting-and-deployment/_index.md b/docs/content/en/hosting-and-deployment/_index.md
diff --git a/docs/content/hosting-and-deployment/deployment-with-nanobox.md b/docs/content/en/hosting-and-deployment/deployment-with-nanobox.md
diff --git a/docs/content/hosting-and-deployment/deployment-with-rsync.md b/docs/content/en/hosting-and-deployment/deployment-with-rsync.md
diff --git a/docs/content/hosting-and-deployment/deployment-with-wercker.md b/docs/content/en/hosting-and-deployment/deployment-with-wercker.md
diff --git a/docs/content/hosting-and-deployment/hosting-on-bitbucket.md b/docs/content/en/hosting-and-deployment/hosting-on-bitbucket.md
diff --git a/docs/content/hosting-and-deployment/hosting-on-firebase.md b/docs/content/en/hosting-and-deployment/hosting-on-firebase.md
diff --git a/docs/content/hosting-and-deployment/hosting-on-github.md b/docs/content/en/hosting-and-deployment/hosting-on-github.md
diff --git a/docs/content/hosting-and-deployment/hosting-on-gitlab.md b/docs/content/en/hosting-and-deployment/hosting-on-gitlab.md
diff --git a/docs/content/hosting-and-deployment/hosting-on-keycdn.md b/docs/content/en/hosting-and-deployment/hosting-on-keycdn.md
diff --git a/docs/content/hosting-and-deployment/hosting-on-netlify.md b/docs/content/en/hosting-and-deployment/hosting-on-netlify.md
diff --git a/docs/content/maintenance/_index.md b/docs/content/en/maintenance/_index.md
diff --git a/docs/content/en/news/0.16-relnotes/index.md b/docs/content/en/news/0.16-relnotes/index.md
@@ -0,0 +1,251 @@
+---
+date: 2016-06-06T13:54:06-04:00
+description: "Hugo 0.16 is our best and biggest release ever. The Hugo community has outdone itself with continued performance improvements, beautiful themes and increased stability."
+title: "Hugo 0.16"
+categories: ["Releases"]
+aliases: [/0-16/]
+---
+
+Hugo 0.16 is our best and biggest release ever. The Hugo community has
+outdone itself with continued performance improvements,
+[beautiful themes](http://themes.gohugo.io) for all types of sites from project
+sites to documentation to blogs to portfolios, and increased stability.
+
+This release represents **over 550 contributions by over 110 contributors** to
+the main Hugo code base. Since last release Hugo has **gained 3500 stars, 90
+contributors and 23 additional themes.**
+
+This release celebrates 3 years since {{< gh "@spf13" >}} wrote the first lines
+of Hugo. During those 3 years Hugo has accomplished some major milestones
+including...
+
+* 10,000+ stars on GitHub
+* 320+ contributors
+* 90+ themes
+* 1000s of happy websites
+* Many subprojects like {{< gh "@spf13/cobra">}}, {{< gh "@spf13/viper">}} and
+ {{< gh "@spf13/afero">}} which have experienced broad usage across the Go
+ ecosystem.
+
+{{< gh "@bep" >}} led the development of Hugo for the 3rd consecutive release
+with nearly half of the contributions to 0.16 in addition to his considerable
+contributions as lead maintainer. {{< gh "@anthonyfok" >}}, {{< gh
+"@DigitalCraftsman" >}}, {{< gh "@MooreReason" >}} all made significant
+contributions. A special thanks to {{< gh "@abourget" >}} for his considerable
+work on multilingual support. Due to its broad impact we wanted to spend more
+time testing it and it will be included in Hugo's next release.
+
+### Highlights
+
+**Partial Builds:** Prior to this release Hugo would always reread and rebuild
+the entire site. This release introduces support for reactive site building
+while watching (`hugo server`). Hugo will watch the filesystem for changes and
+only re-read the changed files. Depending on the files change Hugo will
+intelligently re-render only the needed portion of the site. Performance gains
+depend on the operation performed and size of the site. In our testing build
+times decreased anywhere from 10% to 99%.
+
+**Template Improvements:** Template improvements continue to be a mainstay of each Hugo release. Hugo 0.16 adds support for the new `block` keyword introduced in Go 1.6 -- think base templates with default sections -- as well as many new template functions.
+
+**Polish:** As Hugo matures releases will inevitably contain fewer huge new features. This release represents hundreds of small improvements across ever facet of Hugo which will make for a much better experience for all of our users. Worth mentioning here is the curious bug where live reloading didn't work in some editors on OS X, including the popular TextMate 2. This is now fixed. Oh, and now any error will exit with an error code, a big thing for automated deployments.
+
+### New Features
+* Support reading configuration variables from the OS environment {{<gh 2090 >}}
+* Add emoji support {{<gh 1892>}}
+* Add `themesDir` option to configuration {{<gh 1556>}}
+* Add support for Go 1.6 `block` keyword in templates {{<gh 1832>}}
+* Partial static sync {{<gh 1644>}}
+* Source file based relative linking (à la GitHub) {{<gh 0x0f6b334b6715253b030c4e783b88e911b6e53e56>}}
+* Add `ByLastmod` sort function to pages. {{<gh 0xeb627ca16de6fb5e8646279edd295a8bf0f72bf1 >}}
+* New templates functions:
+ * `readFile` {{<gh 1551 >}}
+ * `countwords` and `countrunes` {{<gh 1440>}}
+ * `default` {{<gh 1943>}}
+ * `hasPrefix` {{<gh 1243>}}
+ * `humanize` {{<gh 1818>}}
+ * `jsonify` {{<gh 0x435e996c4fd48e9009ffa9f83a19fb55f0777dbd>}}
+ * `md5` and `sha1` {{<gh 1932>}}
+ * `replaceRE` {{<gh 1845>}}
+ * `findRE` {{<gh 2048>}}
+ * `shuffle` {{<gh 1942>}}
+ * `slice` {{<gh 1902>}}
+ * `plainify` {{<gh 1915>}}
+
+### Enhancements
+
+* Hugo now exits with error code on any error. This is a big thing for
+ automated deployments. {{<gh 740 >}}
+* Print error when `/index.html` is zero-length {{<gh 947>}}
+* Enable dirname and filename bash autocompletion for more flags {{<gh
+ 0x666ddd237791b56fd048992dca9a27d1af50a10e>}}
+* Improve error handling in commands {{<gh 1502>}}
+* Add sanity checks for `hugo import jekyll` {{<gh 1625 >}}
+* Add description to `Page.Params` {{<gh 1484>}}
+* Add async version of Google Analytics internal template {{<gh 1711>}}
+* Add autostart option to YouTube shortcode {{<gh 1784>}}
+* Set Date and Lastmod for main home page {{<gh 1903>}}
+* Allow URL with extension in front matter {{<gh 1923>}}
+* Add list support in Scratch {{<gh
+ 0xeaba04e82bdfc5d4c29e970f11b4aab9cc0efeaa>}}
+* Add file option to gist shortcode {{<gh 1955>}}
+* Add config layout and content directory CLI options {{<gh 1698>}}
+* Add boolean value comparison to `where` template function {{<gh
+ 0xf3c74c9db484c8961e70cb3458f9e41e7832fa12>}}
+* Do not write to cache when `ignoreCache` is set {{<gh 2067>}}
+* Add option to disable rendering of 404 page {{<gh 2037>}}
+* Mercurial is no longer needed to build Hugo {{<gh 2062 >}}
+* Do not create `robots.txt` by default {{<gh 2049>}}
+* Disable syntax guessing for PygmentsCodeFences by default. To enable syntax
+ guessing again, add the following to your config file:
+ `PygmentsCodeFencesGuessSyntax = true` {{<gh 2034>}}
+* Make `ByCount` sort consistently {{<gh 1930>}}
+* Add `Scratch` to shortcode {{<gh 2000>}}
+* Add support for symbolic links for content, layout, static, theme {{<gh 1855
+ >}}
+* Add '+' as one of the valid characters in URLs specified in the front matter
+ {{<gh 1290 >}}
+* Make alias redirect output URLs relative when `RelativeURLs = true` {{<gh
+ 2093 >}}
+* Hugo injects meta generator tag on homepage if missing {{<gh
+ 2182 >}}
+
+### Fixes
+* Fix file change watcher for TextMate 2 and friends on OS X {{<gh 1053 >}}
+* Make dynamic reloading of config file reliable on all platform {{<gh 1684 >}}
+* Hugo now works on Linux/arm64 {{<gh 1772 >}}
+* `plainIDAnchors` now defaults to `true` {{<gh 2057>}}
+* Win32 and ARM builds fixed {{<gh 1716>}}
+* Copy static dir files without theme's static dir {{<gh 1656>}}
+* Make `noTimes` command flag work {{<gh 1657>}}
+* Change most global CLI flags into local ones {{<gh 1624>}}
+* Remove transformation of menu URLs {{<gh 1239>}}
+* Do not fail on unknown Jekyll file {{<gh 1705>}}
+* Use absolute path when editing with editor {{<gh 1589>}}
+* Fix hugo server "Watching for changes" path display {{<gh 1721>}}
+* Do not strip special characters out of URLs {{<gh 1292>}}
+* Fix `RSSLink` when uglyURLs are enabled {{<gh 175>}}
+* Get BaseURL from viper in server mode {{<gh 1821>}}
+* Fix shortcode handling in RST {{<gh 1904>}}
+* Use default sitemap configuration for homepage {{<gh 1304>}}
+* Exit if specific port is unavailable in server mode {{<gh 1901>}}
+* Fix regression in "section menus for lazy blogger" {{<gh 2065>}}
+
+****
+
+## **0.15.0** November 25, 2015
+
+The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after
+the 0.14 release, Hugo has seen massive growth and changes. Most notably, this
+is Hugo's first release under the Apache 2.0 license. With this license change
+we hope to expand the great community around Hugo and make it easier for our
+many users to contribute. This release represents over **377 contributions by
+87 contributors** to the main Hugo repo and hundreds of improvements to the
+libraries Hugo uses. Hugo also launched a [new theme
+showcase](http://themes.gohugo.io) and participated in
+[Hacktoberfest](https://hacktoberfest.digitalocean.com).
+
+Hugo now has:
+
+* 6700 (+2700) stars on GitHub
+* 235 (+75) contributors
+* 65 (+30) themes
+
+
+**Template Improvements:** This release takes Hugo to a new level of speed and
+usability. Considerable work has been done adding features and performance to
+the template system which now has full support of Ace, Amber and Go Templates.
+
+**Hugo Import:** Have a Jekyll site, but dreaming of porting it to Hugo? This
+release introduces a new `hugo import jekyll`command that makes this easier
+than ever.
+
+**Performance Improvements:** Just when you thought Hugo couldn't get any faster,
+Hugo continues to improve in speed while adding features. Notably Hugo 0.15
+introduces the ability to render and serve directly from memory resulting in
+30%+ lower render times.
+
+Huge thanks to all who participated in this release. A special thanks to
+{{< gh "@bep" >}} who led the development of Hugo this release again,
+{{< gh "@anthonyfok" >}},
+{{< gh "@eparis" >}},
+{{< gh "@tatsushid" >}} and
+{{< gh "@DigitalCraftsman" >}}.
+
+
+### New features
+* new `hugo import jekyll` command. {{< gh 1469 >}}
+* The new `Param` convenience method on `Page` and `Node` can be used to get the most specific parameter value for a given key. {{< gh 1462 >}}
+* Several new information elements have been added to `Page` and `Node`:
+ * `RuneCount`: The number of [runes](http://blog.golang.org/strings) in the content, excluding any whitespace. This may be a good alternative to `.WordCount` for Japanese and other CJK languages where a word-split by spaces makes no sense. {{< gh 1266 >}}
+ * `RawContent`: Raw Markdown as a string. One use case may be of embedding remarkjs.com slides.
+ * `IsHome`: tells the truth about whether you're on the home page or not.
+
+### Improvements
+* `hugo server` now builds ~30%+ faster by rendering to memory instead of disk. To get the old behavior, start the server with `--renderToDisk=true`.
+* Hugo now supports dynamic reloading of the config file when watching.
+* We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. {{< gh 1181 >}}
+* Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. {{< gh 917 >}}
+* Paginator now also supports page groups. {{< gh 1274 >}}
+* Markdown improvements:
+ * Hugo now supports GitHub-flavoured markdown code fences for highlighting for `md`-files (Blackfriday rendered markdown) and `mmark` files (MMark rendered markdown). {{< gh 362 1258 >}}
+ * Several new Blackfriday options are added:
+ * Option to disable Blackfriday's `Smartypants`.
+ * Option for Blackfriday to open links in a new window/tab. {{< gh 1220 >}}
+ * Option to disable Blackfriday's LaTeX style dashes {{< gh 1231 >}}
+ * Definition lists extension support.
+* `Scratch` now has built-in `map` support.
+* We now fall back to `link title` for the default page sort. {{< gh 1299 >}}
+* Some notable new configuration options:
+ * `IgnoreFiles` can be set with a list of Regular Expressions that matches files to be ignored during build. {{< gh 1189 >}}
+ * `PreserveTaxonomyNames`, when set to `true`, will preserve what you type as the taxonomy name both in the folders created and the taxonomy `key`, but it will be normalized for the URL. {{< gh 1180 >}}
+* `hugo gen` can now generate man files, bash auto complete and markdown documentation
+* Hugo will now make suggestions when a command is mistyped
+* Shortcodes now have a boolean `.IsNamedParams` property. {{< gh 1597 >}}
+
+### New Template Features
+* All template engines:
+ * The new `dict` function that could be used to pass maps into a template. {{< gh 1463 >}}
+ * The new `pluralize` and `singularize` template funcs.
+ * The new `base64Decode` and `base64Encode` template funcs.
+ * The `sort` template func now accepts field/key chaining arguments and pointer values. {{< gh 1330 >}}
+ * Several fixes for `slicestr` and `substr`, most importantly, they now have full `utf-8`-support. {{< gh 1190 1333 1347 >}}
+ * The new `last` template function allows the user to select the last `N` items of a slice. {{< gh 1148 >}}
+ * The new `after` func allows the user to select the items after the `Nth` item. {{< gh 1200 >}}
+ * Add `time.Time` type support to the `where`, `ge`, `gt`, `le`, and `lt` template functions.
+ * It is now possible to use constructs like `where Values ".Param.key" nil` to filter pages that doesn't have a particular parameter. {{< gh 1232 >}}
+ * `getJSON`/`getCSV`: Add retry on invalid content. {{< gh 1166 >}}
+ * The new `readDir` func lists local files. {{< gh 1204 >}}
+ * The new `safeJS` function allows the embedding of content into JavaScript contexts in Go templates.
+ * Get the main site RSS link from any page by accessing the `.Site.RSSLink` property. {{< gh 1566 >}}
+* Ace templates:
+ * Base templates now also works in themes. {{< gh 1215 >}}.
+ * And now also on Windows. {{< gh 1178 >}}
+* Full support for Amber templates including all template functions.
+* A built-in template for Google Analytics. {{< gh 1505 >}}
+* Hugo is now shipped with new built-in shortcodes: {{< gh 1576 >}}
+ * `youtube` for YouTube videos
+ * `vimeo` for Vimeo videos
+ * `gist` for GitHub gists
+ * `tweet` for Twitter Tweets
+ * `speakerdeck` for Speakerdeck slides
+
+
+### Bugfixes
+* Fix data races in page sorting and page reversal. These operations are now also cached. {{< gh 1293 >}}
+* `page.HasMenuCurrent()` and `node.HasMenuCurrent()` now work correctly in multi-level nested menus.
+* Support `Fish and Chips` style section titles. Previously, this would end up as `Fish And Chips`. Now, the first character is made toupper, but the rest are preserved as-is. {{< gh 1176 >}}
+* Hugo now removes superfluous p-tags around shortcodes. {{< gh 1148 >}}
+
+### Notices
+* `hugo server` will watch by default now.
+* Some fields and methods were deprecated in `0.14`. These are now removed, so the error message isn't as friendly if you still use the old values. So please change:
+ * `getJson` to `getJSON`, `getCsv` to `getCSV`, `safeHtml` to
+ `safeHTML`, `safeCss` to `safeCSS`, `safeUrl` to `safeURL`, `Url` to `URL`,
+ `UrlPath` to `URLPath`, `BaseUrl` to `BaseURL`, `Recent` to `Pages`.
+
+### Known Issues
+
+Using the Hugo v0.15 32-bit Windows or ARM binary, running `hugo server` would crash or hang due to a [memory alignment issue](https://golang.org/pkg/sync/atomic/#pkg-note-BUG) in [Afero](https://github.com/spf13/afero). The bug was discovered shortly after the v0.15.0 release and has since been [fixed](https://github.com/spf13/afero/pull/23) by {{< gh "@tpng" >}}. If you encounter this bug, you may either compile Hugo v0.16-DEV from source, or use the following solution/workaround:
+
+* **64-bit Windows users: Please use [hugo_0.15_windows_amd64.zip](https://github.com/gohugoio/hugo/releases/download/v0.15/hugo_0.15_windows_amd64.zip)** (amd64 == x86-64). It is only the 32-bit hugo_0.15_windows_386.zip that crashes/hangs (see {{< gh 1621 >}} and {{< gh 1628 >}}).
+* **32-bit Windows and ARM users: Please run `hugo server --renderToDisk` as a workaround** until Hugo v0.16 is released (see [“hugo server” returns runtime error on armhf](https://discourse.gohugo.io/t/hugo-server-returns-runtime-error-on-armhf/2293) and {{< gh 1716 >}}).
diff --git a/docs/content/en/news/0.17-relnotes/index.md b/docs/content/en/news/0.17-relnotes/index.md
@@ -0,0 +1,93 @@
+---
+author: bep
+categories: ["Releases"]
+date: 2016-10-07T13:54:06-04:00
+description: "Hugo now supports multilingual sites with the most simple and elegant experience."
+link: ""
+title: "0.17: Hugo is going global"
+draft: false
+aliases: [/0-17/]
+---
+Hugo is going global with our 0.17 release. We put a lot of thought into how we could extend Hugo
+to support multilingual websites with the most simple and elegant experience. Hugo's multilingual
+capabilities rival the best web and documentation software, but Hugo's experience is unmatched.
+If you have a single language website, the simple Hugo experience you already love is unchanged.
+Adding additional languages to your website is simple and straightforward. Hugo has been completely
+internally rewritten to be multilingual aware with translation and internationalization features
+embedded throughout Hugo.
+
+Hugo continues its trend of each release being faster than the last. It's quite a challenge to consistently add
+significant new functionality and simultaneously dramatically improve performance. {{<gh "@bep">}} has made it
+his personal mission to apply the Go mantra of "Enable more. Do less" to Hugo. Hugo's consistent improvement
+is a testament to his brilliance and his dedication to his craft. Hugo additionally benefits from the
+performance improvements from the Go team in the Go 1.7 release.
+
+This release represents **over 300 contributions by over 70 contributors** to
+the main Hugo code base. Since last release Hugo has **gained 2000 stars, 50 new
+contributors and 20 additional themes.**
+
+Hugo now has:
+
+* 12,000 stars on GitHub
+* 370+ contributors
+* 110+ themes
+
+{{<gh "@bep" >}} continues to lead the project with the lionshare of contributions
+and reviews. A special thanks to {{<gh "@bep" >}} and {{<gh "@abourget" >}} for their
+considerable work on multilingual support.
+
+A big welcome to newcomers {{<gh "@MarkDBlackwell" >}}, {{<gh "@bogem" >}} and
+{{<gh "@g3wanghc" >}} for their critical contributions.
+
+### Highlights
+
+**Multilingual Support:**
+Hugo now supports multiple languages side-by-side. A single site can now have multiple languages rendered with
+full support for translation and i18n.
+
+**Performance:**
+Hugo is faster than ever! Hugo 0.17 is not only our fastest release, it's also the most efficient.
+Hugo 0.17 is **nearly twice as fast as Hugo 0.16** and uses about 10% less memory.
+This means that the same site will build in nearly half the time it took with Hugo 0.16.
+For the first time Hugo sites are averaging well under 1ms per rendered content.
+
+**Docs overhaul:**
+This release really focused on improving the documentation. [Gohugo.io](http://gohugo.io) is
+more accurate and complete than ever.
+
+**Support for macOS Sierra**
+
+### New Features
+* Multilingual support {{<gh 2303>}}
+* Allow content expiration {{<gh 2137 >}}
+* New templates functions:
+ * `querify` function to generate query strings inside templates {{<gh 2257>}}
+ * `htmlEscape` and `htmlUnescape` template functions {{<gh 2287>}}
+ * `time` converts a timestamp string into a time.Time structure {{<gh 2329>}}
+
+### Enhancements
+
+* Render the shortcodes as late as possible {{<gh 0xed0985404db4630d1b9d3ad0b7e41fb186ae0112>}}
+* Remove unneeded casts in page.getParam {{<gh 2186 >}}
+* Automatic page date fallback {{<gh 2239>}}
+* Enable safeHTMLAttr {{<gh 2234>}}
+* Add TODO list support for markdown {{<gh 2296>}}
+* Make absURL and relURL accept any type {{<gh 2352>}}
+* Suppress 'missing static' error {{<gh 2344>}}
+* Make summary, wordcount etc. more efficient {{<gh 2378>}}
+* Better error reporting in `hugo convert` {{<gh 2440>}}
+* Reproducible builds thanks to govendor {{<gh 2461>}}
+
+### Fixes
+
+* Fix shortcode in markdown headers {{<gh 2210 >}}
+* Explicitly bind livereload to hugo server port {{<gh 2205>}}
+* Fix Emojify for certain text patterns {{<gh 2198>}}
+* Normalize file name to NFC {{<gh 2259>}}
+* Ignore emacs temp files {{<gh 2266>}}
+* Handle symlink change event {{<gh 2273>}}
+* Fix panic when using URLize {{<gh 2274>}}
+* `hugo import jekyll`: Fixed target path location check {{<gh 2293>}}
+* Return all errors from casting in templates {{<gh 2356>}}
+* Fix paginator counter on x86-32 {{<gh 2420>}}
+* Fix half-broken self-closing shortcodes {{<gh 2499>}}
diff --git a/docs/content/en/news/0.18-relnotes/index.md b/docs/content/en/news/0.18-relnotes/index.md
@@ -0,0 +1,114 @@
+---
+date: 2016-12-30T13:54:02-04:00
+categories: ["Releases"]
+description: "The primary new feature in Hugo 0.18 is that every piece of content is now a Page."
+link: ""
+title: "Hugo 0.18"
+draft: false
+author: bep
+aliases: [/0-18/]
+---
+
+Hugo 0.18.1 is a bug fix release fixing some issues introduced in Hugo 0.18:
+
+* Fix 32-bit binaries {{<gh 2847 >}}
+* Fix issues with `preserveTaxonomyNames` {{<gh 2809 >}}
+* Fix `.URL` for taxonomy pages when `uglyURLs=true` {{<gh 2819 >}}
+* Fix `IsTranslated` and `Translations` for node pages {{<gh 2812 >}}
+* Make template error messages more verbose {{<gh 2820 >}}
+
+## **0.18.0** December 19th 2016
+
+Today, we're excited to release the much-anticipated Hugo 0.18!
+
+We're heading towards the end of the year 2016, and we can look back on three releases and a steady growing community around the project.
+This release includes **over 220 contributions by nearly 50 contributors** to the main codebase.
+Since the last release, Hugo has **gained 1750 stars and 27 additional themes**.
+
+Hugo now has:
+
+- 13750+ stars
+- 408+ contributors
+- 137+ themes
+
+{{< gh "@bep" >}} once again took the lead of Hugo and contributed a significant amount of additions.
+Also a big shoutout to {{< gh "@digitalcraftsman" >}} for his relentless work on keeping the documentation and the themes site in pristine condition,
+and also a big thanks to {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for their contributions.
+
+We wish you all a Merry Christmas and a Happy New Year.<br>
+*The Hugo team*
+
+### Highlights
+
+The primary new feature in Hugo 0.18 is that every piece of content is now a `Page` ({{<gh 2297>}}). This means that every page, including the homepage, can have a content file with front matter.
+
+Not only is this a much simpler model to understand, it is also faster and paved the way for several important new features:
+
+* Enable proper titles for Nodes {{<gh 1051>}}
+* Sitemap.xml should include nodes, as well as pages {{<gh 1303>}}
+* Document homepage content workaround {{<gh 2240>}}
+* Allow home page to be easily authored in markdown {{<gh 720>}}
+* Minimalist website with homepage as content {{<gh 330>}}
+
+Hugo again continues its trend of each release being faster than the last. It's quite a challenge to consistently add significant new functionality and simultaneously dramatically improve performance. Running [this benchmark]( https://github.com/bep/hugo-benchmark) with [these sites](https://github.com/bep/hugo-benchmark/tree/master/sites) (renders to memory) shows about 60% reduction in time spent and 30% reduction in memory usage compared to Hugo 0.17.
+
+### Other New Features
+
+* Every `Page` now has a `Kind` property. Since everything is a `Page` now, the `Kind` is used to differentiate different kinds of pages.
+ Possible values are `page`, `home`, `section`, `taxonomy`, and `taxonomyTerm`.
+ (Internally, we also define `RSS`, `sitemap`, `robotsTXT`, and `404`, but those have no practical use for end users at the moment since they are not included in any collections.)
+* Add a `GitInfo` object to `Page` if `enableGitInfo` is set. It then also sets `Lastmod` for the given `Page` to the author date provided by Git. {{<gh 2291>}}
+* Implement support for alias templates {{<gh 2533 >}}
+* New template functions:
+ * Add `imageConfig` function {{<gh 2677>}}
+ * Add `sha256` function {{<gh 2762>}}
+ * Add `partialCached` template function {{<gh 1368>}}
+* Add shortcode to display Instagram images {{<gh 2690>}}
+* Add `noChmod` option to disable perm sync {{<gh 2749>}}
+* Add `quiet` build mode {{<gh 1218>}}
+
+
+### Notices
+
+* `.Site.Pages` will now contain *several kinds of pages*, including regular pages, sections, taxonomies, and the home page.
+ If you want a specific kind of page, you can filter it with `where` and `Kind`.
+ `.Site.RegularPages` is a shortcut to the page collection you have been used to getting.
+* `RSSlink` is now deprecated. Use `RSSLink` instead.
+ Note that in Hugo 0.17 both of them existed, so there is a fifty-fifty chance you will not have to do anything
+ (if you use a theme, the chance is close to 0), and `RSSlink` will still work for two Hugo versions.
+
+### Fixes
+
+* Revise the `base` template lookup logic so it now better matches the behavior of regular templates, making it easier to override the master templates from the theme {{<gh 2783>}}
+* Add workaround for `block` template crash.
+ Block templates are very useful, but there is a bug in Go 1.6 and 1.7 which makes the template rendering crash if you use the block template in more complex scenarios.
+ This is fixed in the upcoming Go 1.8, but Hugo adds a temporary workaround in Hugo 0.18. {{<gh 2549>}}
+* All the `Params` configurations are now case insensitive {{<gh 1129>}} {{<gh 2590>}} {{<gh 2615>}}
+* Make RawContent raw again {{<gh 2601>}}
+* Fix archetype title and date handling {{<gh 2750>}}
+* Fix TOML archetype parsing in `hugo new` {{<gh 2745>}}
+* Fix page sorting when weight is zero {{<gh 2673>}}
+* Fix page names that contain dot {{<gh 2555>}}
+* Fix RSS Title regression {{<gh 2645>}}
+* Handle ToC before handling shortcodes {{<gh 2433>}}
+* Only watch relevant themes dir {{<gh 2602>}}
+* Hugo new content creates TOML slices with closing bracket on new line {{<gh 2800>}}
+
+### Improvements
+
+* Add page information to error logging in rendering {{<gh 2570>}}
+* Deprecate `RSSlink` in favor of `RSSLink`
+* Make benchmark command more useful {{<gh 2432>}}
+* Consolidate the `Param` methods {{<gh 2590>}}
+* Allow to set cache dir in config file
+* Performance improvements:
+ * Avoid repeated Viper loads of `sectionPagesMenu` {{<gh 2728>}}
+ * Avoid reading from Viper for path and URL funcs {{<gh 2495>}}
+ * Add `partialCached` template function. This can be a significant performance boost if you have complex partials that does not need to be rerendered for every page. {{<gh 1368>}}
+
+### Documentation Updates
+
+* Update roadmap {{<gh 2666>}}
+* Update multilingual example {{<gh 2417>}}
+* Add a "Deployment with rsync" tutorial page {{<gh 2658>}}
+* Refactor `/docs` to use the `block` keyword {{<gh 2226>}}
diff --git a/docs/content/en/news/0.19-relnotes/index.md b/docs/content/en/news/0.19-relnotes/index.md
@@ -0,0 +1,83 @@
+---
+date: 2017-02-27T13:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.19 brings native Emacs Org-mode content support, and Hugo has its own Twitter account"
+link: ""
+title: "Hugo 0.19"
+draft: false
+author: budparr
+aliases: [/0-19/]
+---
+
+We're happy to announce the first release of Hugo in 2017.
+
+This release represents **over 180 contributions by over 50 contributors** to the main Hugo code base. Since last release Hugo has **gained 1450 stars, 35 new contributors, and 15 additional themes.**
+
+Hugo now has:
+
+* 15200+ stars
+* 470+ contributors
+* 151+ themes
+
+Furthermore, Hugo has its own Twitter account ([@gohugoio](https://twitter.com/gohugoio)) where we share bite-sized news and themes from the Hugo community.
+
+{{< gh "@bep" >}} leads the Hugo development and once again contributed a significant amount of additions. Also a big shoutout to {{< gh "@chaseadamsio" >}} for the Emacs Org-mode support, {{< gh "@digitalcraftsman" >}} for his relentless work on keeping the documentation and the themes site in pristine condition, {{< gh "@fj" >}}for his work on revising the `params` handling in Hugo, and {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for their ongoing contributions.
+
+### Highlights
+
+Hugo `0.19` brings native Emacs Org-mode content support ({{<gh 1483>}}), big thanks to {{< gh "@chaseadamsio" >}}.
+
+Also, a considerably amount of work have been put into cleaning up the Hugo source code, in an issue titled [Refactor the globals out of site build](https://github.com/gohugoio/hugo/issues/2701). This is not immediately visible to the Hugo end user, but will speed up future development.
+
+Hugo `0.18` was bringing full-parallel page rendering, so workarounds depending on rendering order did not work anymore, and pages with duplicate target paths (common examples would be `/index.md` or `/about/index.md`) would now conflict with the home page or the section listing.
+
+With Hugo `0.19`, you can control this behaviour by turning off page types you do not want ({{<gh 2534 >}}). In its most extreme case, if you put the below setting in your [`config.toml`](/getting-started/configuration/), you will get **nothing!**:
+
+```
+disableKinds = ["page", "home", "section", "taxonomy", "taxonomyTerm", "RSS", "sitemap", "robotsTXT", "404"]
+```
+
+### Other New Features
+
+* Add ability to sort pages by front matter parameters, enabling easy custom "top 10" page lists. {{<gh 3022 >}}
+* Add `truncate` template function {{<gh 2882 >}}
+* Add `now` function, which replaces the now deprecated `.Now` {{<gh 2859 >}}
+* Make RSS item limit configurable {{<gh 3035 >}}
+
+### Enhancements
+
+* Enhance `.Param` to permit arbitrarily nested parameter references {{<gh 2598 >}}
+* Use `Page.Params` more consistently when adding metadata {{<gh 3033 >}}
+* The `sectionPagesMenu` feature ("Section menu for the lazy blogger") is now integrated with the section content pages. {{<gh 2974 >}}
+* Hugo `0.19` is compiled with Go 1.8!
+* Make template funcs like `findRE` and friends more liberal in what argument types they accept {{<gh 3018 >}} {{<gh 2822 >}}
+* Improve generation of OpenGraph date tags {{<gh 2979 >}}
+
+### Notes
+
+* `sourceRelativeLinks` is now deprecated and will be removed in Hugo `0.21` if no one is stepping up to the plate and fixes and maintains this feature. {{<gh 3028 >}}
+
+### Fixes
+
+* Fix `.Site.LastChange` on sites where the default sort order is not chronological. {{<gh 2909 >}}
+* Fix regression of `.Truncated` evaluation in manual summaries. {{<gh 2989 >}}
+* Fix `preserveTaxonomyNames` regression {{<gh 3070 >}}
+* Fix issue with taxonomies when only some have content page {{<gh 2992 >}}
+* Fix instagram shortcode panic on invalid ID {{<gh 3048 >}}
+* Fix subtle data race in `getJSON` {{<gh 3045 >}}
+* Fix deadlock in cached partials {{<gh 2935 >}}
+* Avoid double-encoding of paginator URLs {{<gh 2177 >}}
+* Allow tilde in URLs {{<gh 2177 >}}
+* Fix `.Site.Pages` handling on live reloads {{<gh 2869 >}}
+* `UniqueID` now correctly uses the fill file path from the content root to calculate the hash, and is finally ... unique!
+* Discard current language based on `.Lang()`, go get translations correct for paginated pages. {{<gh 2972 >}}
+* Fix infinite loop in template AST handling for recursive templates {{<gh 2927 >}}
+* Fix issue with watching when config loading fails {{<gh 2603 >}}
+* Correctly flush the imageConfig on live-reload {{<gh 3016 >}}
+* Fix parsing of TOML arrays in front matter {{<gh 2752 >}}
+
+### Docs
+
+* Add tutorial "How to use Google Firebase to host a Hugo site" {{<gh 3007 >}}
+* Improve documentation for menu rendering {{<gh 3056 >}}
+* Revise GitHub Pages deployment tutorial {{<gh 2930 >}}
diff --git a/docs/content/en/news/0.20-relnotes/index.md b/docs/content/en/news/0.20-relnotes/index.md
@@ -0,0 +1,72 @@
+---
+date: 2017-04-10T13:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.20 introduces the powerful and long sought after feature Custom Output Formats"
+link: ""
+title: "Hugo 0.20"
+draft: false
+author: bep
+aliases: [/0-20/]
+---
+
+Hugo `0.20` introduces the powerful and long sought after feature [Custom Output Formats](http://gohugo.io/extras/output-formats/); Hugo isn’t just that “static HTML with an added RSS feed” anymore. _Say hello_ to calendars, e-book formats, Google AMP, and JSON search indexes, to name a few ( [#2828](//github.com/gohugoio/hugo/issues/2828) ).
+
+This release represents **over 180 contributions by over 30 contributors** to the main Hugo code base. Since last release Hugo has **gained 1100 stars, 20 new contributors and 5 additional themes.**
+
+Hugo now has:
+
+* 16300+ stars
+* 495+ contributors
+* 156+ themes
+
+[@bep](//github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. Also a big shoutout to [@digitalcraftsman](//github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition, and [@moorereason](//github.com/moorereason) and [@bogem](//github.com/bogem) for their ongoing contributions.
+
+## Other Highlights
+
+[@bogem](//github.com/bogem) has also contributed TOML as an alternative and much simpler format for language/i18n files ([#3200](//github.com/gohugoio/hugo/issues/3200)). A feature you will appreciate when you start to work on larger translations.
+
+Also, there have been some important updates in the Emacs Org-mode handling: [@chaseadamsio](//github.com/chaseadamsio) has fixed the newline-handling ( [#3126](//github.com/gohugoio/hugo/issues/3126) ) and [@clockoon](//github.com/clockoon) has added basic footnote support.
+
+Worth mentioning is also the ongoing work that [@rdwatters](//github.com/rdwatters) and [@budparr](//github.com/budparr) is doing to re-do the [gohugo.io](https://gohugo.io/) site, including a total restructuring and partial rewrite of the documentation. It is getting close to finished, and it looks fantastic!
+
+## Notes
+
+* `RSS` description in the built-in template is changed from full `.Content` to `.Summary`. This is a somewhat breaking change, but is what most people expect from their RSS feeds. If you want full content, please provide your own RSS template.
+* The deprecated `.RSSlink` is now removed. Use `.RSSLink`.
+* `RSSUri` is deprecated and will be removed in a future Hugo version, replace it with an output format definition.
+* The deprecated `.Site.GetParam` is now removed, use `.Site.Param`.
+* Hugo does no longer append missing trailing slash to `baseURL` set as a command line parameter, making it consistent with how it behaves from site config. [#3262](//github.com/gohugoio/hugo/issues/3262)
+
+## Enhancements
+
+* Hugo `0.20` is built with Go 1.8.1.
+* Add `.Site.Params.mainSections` that defaults to the section with the most pages. Plan is to get themes to use this instead of the hardcoded `blog` in `where` clauses. [#3206](//github.com/gohugoio/hugo/issues/3206)
+* File extension is now configurable. [#320](//github.com/gohugoio/hugo/issues/320)
+* Impove `markdownify` template function performance. [#3292](//github.com/gohugoio/hugo/issues/3292)
+* Add taxonomy terms’ pages to `.Data.Pages` [#2826](//github.com/gohugoio/hugo/issues/2826)
+* Change `RSS` description from full `.Content` to `.Summary`.
+* Ignore “.” dirs in `hugo --cleanDestinationDir` [#3202](//github.com/gohugoio/hugo/issues/3202)
+* Allow `jekyll import` to accept both `2006-01-02` and `2006-1-2` date format [#2738](//github.com/gohugoio/hugo/issues/2738)
+* Raise the default `rssLimit` [#3145](//github.com/gohugoio/hugo/issues/3145)
+* Unify section list vs single template lookup order [#3116](//github.com/gohugoio/hugo/issues/3116)
+* Allow `apply` to be used with the built-in Go template funcs `print`, `printf` and `println`. [#3139](//github.com/gohugoio/hugo/issues/3139)
+
+## Fixes
+
+* Fix deadlock in `getJSON` [#3211](//github.com/gohugoio/hugo/issues/3211)
+* Make sure empty terms pages are created. [#2977](//github.com/gohugoio/hugo/issues/2977)
+* Fix base template lookup order for sections [#2995](//github.com/gohugoio/hugo/issues/2995)
+* `URL` fixes:
+ * Fix pagination URLs with `baseURL` with sub-root and `canonifyUrls=false` [#1252](//github.com/gohugoio/hugo/issues/1252)
+ * Fix pagination URL for resources with “.” in name [#2110](//github.com/gohugoio/hugo/issues/2110) [#2374](//github.com/gohugoio/hugo/issues/2374) [#1885](//github.com/gohugoio/hugo/issues/1885)
+ * Handle taxonomy names with period [#3169](//github.com/gohugoio/hugo/issues/3169)
+ * Handle `uglyURLs` ambiguity in `Permalink` [#3102](//github.com/gohugoio/hugo/issues/3102)
+ * Fix `Permalink` for language-roots wrong when `uglyURLs` is `true` [#3179](//github.com/gohugoio/hugo/issues/3179)
+ * Fix misc case issues for `URLs` [#1641](//github.com/gohugoio/hugo/issues/1641)
+ * Fix for taxonomies URLs when `uglyUrls=true` [#1989](//github.com/gohugoio/hugo/issues/1989)
+ * Fix empty `RSSLink` for list pages with content page. [#3131](//github.com/gohugoio/hugo/issues/3131)
+* Correctly identify regular pages on the form “my_index_page.md” [#3234](//github.com/gohugoio/hugo/issues/3234)
+* `Exit -1` on `ERROR` in global logger [#3239](//github.com/gohugoio/hugo/issues/3239)
+* Document hugo `help command` [#2349](//github.com/gohugoio/hugo/issues/2349)
+* Fix internal `Hugo` version handling for bug fix releases. [#3025](//github.com/gohugoio/hugo/issues/3025)
+* Only return `RSSLink` for pages that actually have a RSS feed. [#1302](//github.com/gohugoio/hugo/issues/1302)+
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.1-relnotes/index.md b/docs/content/en/news/0.20.1-relnotes/index.md
@@ -0,0 +1,15 @@
+---
+date: 2017-04-13T13:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.20.1 is a bug fix release, fixing some important regressions introduced in 0.20"
+link: ""
+title: "Hugo 0.20.1"
+draft: false
+author: bep
+aliases: [/0-20-1/]
+---
+
+* Fix logic for base template in work dir vs in the theme [#3323](//github.com/gohugoio/hugo/issues/3323)
+* camelCased templates (partials, shortcodes etc.) not found [#3333](//github.com/gohugoio/hugo/issues/3333)
+* Live-reload fails with `_index.md` with paginator [#3315](//github.com/gohugoio/hugo/issues/3315)
+* `rssURI` WARNING always shown [#3319](//github.com/gohugoio/hugo/issues/3319)+
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.2-relnotes/index.md b/docs/content/en/news/0.20.2-relnotes/index.md
@@ -0,0 +1,45 @@
+---
+date: 2017-04-16T13:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.20.2 adds support for plain text partials included into HTML templates"
+link: ""
+title: "Hugo 0.20.2"
+draft: false
+author: bep
+aliases: [/0-20-2/]
+---
+
+Hugo `0.20.2` adds support for plain text partials included into `HTML` templates. This was a side-effect of the big new [Custom Output Format](https://gohugo.io/extras/output-formats/) feature in `0.20`, and while the change was intentional and there was an ongoing discussion about fixing it in [#3273](//github.com/gohugoio/hugo/issues/3273), it did break some themes. There were valid workarounds for these themes, but we might as well get it right.
+
+The most obvious use case for this is inline `CSS` styles, which you now can do without having to name your partials with a `html` suffix.
+
+A simple example:
+
+In `layouts/partials/mystyles.css`:
+
+ body {
+ background-color: {{ .Param "colors.main" }}
+ }
+
+Then in `config.toml` (note that by using the `.Param` lookup func, we can override the color in a page’s front matter if we want):
+
+ [params]
+ [params.colors]
+ main = "green"
+ text = "blue"
+
+And then in `layouts/partials/head.html` (or the partial used to include the head section into your layout):
+
+ <head>
+ <style type="text/css">
+ {{ partial "mystyles.css" . | safeCSS }}
+ </style>
+ </head>
+
+Of course, `0.20` also made it super-easy to create external `CSS` stylesheets based on your site and page configuration. A simple example:
+
+Add “CSS” to your home page’s `outputs` list, create the template `/layouts/index.css` using Go template syntax for the dynamic parts, and then include it into your `HTML` template with:
+
+ {{ with .OutputFormats.Get "css" }}
+ <link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | safeURL }}">
+ {{ end }}`+
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.3-relnotes/index.md b/docs/content/en/news/0.20.3-relnotes/index.md
@@ -0,0 +1,26 @@
+---
+date: 2017-04-24T13:53:58-04:00
+categories: ["Releases"]
+description: "This is a bug-fix release with one important fix. But it also adds some harness around GoReleaser"
+link: ""
+title: "Hugo 0.20.3"
+draft: false
+author: bep
+aliases: [/0-20-3/]
+---
+
+This is a bug-fix release with one important fix. But it also adds some harness around [GoReleaser](https://github.com/goreleaser/goreleaser) to automate the Hugo release process. Big thanks to [@caarlos0](https://github.com/caarlos0) for great and super-fast support fixing issues along the way.
+
+Hugo now has:
+
+* 16619+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 458+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 156+ [themes](http://themes.gohugo.io/)
+
+## Enhancement
+
+* Automate the Hugo release process [550eba64](https://github.com/gohugoio/hugo/commit/550eba64705725eb54fdb1042e0fb4dbf6f29fd0) [@bep](https://github.com/bep) [#3358](https://github.com/gohugoio/hugo/issues/3358)
+
+## Fix
+
+* Fix handling of zero-length files [9bf5c381](https://github.com/gohugoio/hugo/commit/9bf5c381b6b3e69d4d8dbfd7a40074ac44792bbf) [@bep](https://github.com/bep) [#3355](https://github.com/gohugoio/hugo/issues/3355) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.4-relnotes/index.md b/docs/content/en/news/0.20.4-relnotes/index.md
@@ -0,0 +1,24 @@
+---
+date: 2017-04-24T17:53:58-04:00
+categories: ["Releases"]
+description: "This is the second bug-fix release of the day, fixing a couple of issues related to the new release scripts"
+link: ""
+title: "Hugo 0.20.4"
+draft: false
+author: bep
+aliases: [/0-20-4/]
+---
+
+This is the second bug-fix release of the day, fixing a couple of issues related to the new release scripts.
+
+Hugo now has:
+
+* 16626+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 457+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 156+ [themes](http://themes.gohugo.io/)
+
+## Fixes
+
+* Fix statically linked binaries [275bcf56](https://github.com/gohugoio/hugo/commit/275bcf566c7cb72367d4423cf4810319311ff680) [@munnerz](https://github.com/munnerz) [#3382](https://github.com/gohugoio/hugo/issues/3382)
+* Filename change in Hugo 0.20.3 binaries [#3385](https://github.com/gohugoio/hugo/issues/3385)
+* Fix version calculation [cb3c6b6f](https://github.com/gohugoio/hugo/commit/cb3c6b6f7670f85189a4a3637e7132901d1ed6e9) [@bep](https://github.com/bep) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.5-relnotes/index.md b/docs/content/en/news/0.20.5-relnotes/index.md
@@ -0,0 +1,12 @@
+---
+date: 2017-04-25T17:53:58-04:00
+categories: ["Releases"]
+description: ""
+link: ""
+title: "Hugo 0.20.5"
+draft: false
+author: bep
+aliases: [/0-20-5/]
+---
+
+This is a bug-fix release which fixes the version number of `0.20.4` (which wrongly shows up as `0.21-DEV`) ([#3388](https://github.com/gohugoio/hugo/issues/3388)).+
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.6-relnotes/index.md b/docs/content/en/news/0.20.6-relnotes/index.md
@@ -0,0 +1,24 @@
+---
+date: 2017-04-27T17:53:58-04:00
+categories: ["Releases"]
+description: ""
+link: ""
+title: "Hugo 0.20.6"
+draft: false
+author: bep
+aliases: [/0-20-6/]
+---
+
+There have been some [shouting on discuss.gohugo.io](https://discuss.gohugo.io/t/index-md-is-generated-in-subfolder-index-index-html-hugo-0-20/6338/15) about some broken sites after the release of Hugo `0.20`. This release reintroduces the old behaviour, making `/my-blog-post/index.md` work as expected.
+
+Hugo now has:
+
+* 16675+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 456+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 156+ [themes](http://themes.gohugo.io/)
+
+## Fixes
+
+* Avoid index.md in /index/index.html [#3396](https://github.com/gohugoio/hugo/issues/3396)
+* Make missing GitInfo a WARNING [b30ca4be](https://github.com/gohugoio/hugo/commit/b30ca4bec811dbc17e9fd05925544db2b75e0e49) [@bep](https://github.com/bep) [#3376](https://github.com/gohugoio/hugo/issues/3376)
+* Fix some of the fpm fields for deb [3bd1d057](https://github.com/gohugoio/hugo/commit/3bd1d0571d5f2f6bf0dc8f90a8adf2dbfcb2fdfd) [@anthonyfok](https://github.com/anthonyfok) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.20.7-relnotes/index.md b/docs/content/en/news/0.20.7-relnotes/index.md
@@ -0,0 +1,23 @@
+---
+date: 2017-05-03T17:53:58-04:00
+categories: ["Releases"]
+description: "This just fixes an issue with the release scripts, no change in the binaries"
+link: ""
+title: "Hugo 0.20.7"
+draft: false
+author: bep
+aliases: [/0-20-7/]
+---
+
+This just fixes an issue with the release scripts, no change in the binaries.
+
+
+Hugo now has:
+
+* 16782+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 458+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 156+ [themes](http://themes.gohugo.io/)
+
+## Fix
+
+* Push the tag before goreleaser is run [3682bf52](https://github.com/gohugoio/hugo/commit/3682bf527989e86d9da32d76809306cb576383e8) [@bep](https://github.com/bep) [#3405](https://github.com/gohugoio/hugo/issues/3405) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.21-relnotes/index.md b/docs/content/en/news/0.21-relnotes/index.md
@@ -0,0 +1,105 @@
+---
+date: 2017-05-22T17:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.21 brings full support for shortcodes per Output Format, the last vital piece of that puzzle"
+link: ""
+title: "Hugo 0.21"
+draft: false
+author: bep
+aliases: [/0-21/]
+---
+
+Hugo `0.21` brings full support for shortcodes per [Output Format](https://gohugo.io/extras/output-formats/) ([#3220](https://github.com/gohugoio/hugo/issues/3220)), the last vital piece of that puzzle. This is especially useful for `Google AMP` with its many custom media tags.
+
+This release represents **126 contributions by 29 contributors** to the main Hugo code base. Since last main release Hugo has **gained 850 stars and 7 additional themes**.
+
+Hugo now has:
+
+* 17156+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 457+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 163+ [themes](http://themes.gohugo.io/)
+
+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@bogem](https://github.com/bogem), and [@munnerz](https://github.com/munnerz) for their ongoing contributions. And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
+
+## Other Highlights
+
+On a more technical side, [@moorereason](https://github.com/moorereason) and [@bep](https://github.com/bep) have introduced namespaces for Hugo's many template funcs ([#3042](https://github.com/gohugoio/hugo/issues/3042) ). There are so many now, and adding more into that big pile would be a sure path toward losing control. Now they are nicely categorised into namespaces with its own tests and examples, with an API that the documentation site can use to make sure it is correct and up-to-date.
+
+## Notes
+
+* The deprecated `.Extension`, `.Now` and `.TargetPath` will now `ERROR` [544f0a63](https://github.com/gohugoio/hugo/commit/544f0a6394b0e085d355e8217fc5bb3d96c12a98) [@bep](https://github.com/bep)
+* The config settings and flags `disable404`, `disableRSS`, `disableSitemap`, `disableRobotsTXT` are now deprecated. Use `disableKinds`. [5794a265](https://github.com/gohugoio/hugo/commit/5794a265b41ffdeebfd8485eecf65cf4088d49d6) [@bep](https://github.com/bep) [#3345](https://github.com/gohugoio/hugo/issues/3345)
+
+## Enhancements
+
+### Templates
+
+* Log a WARNING on wrong usage of `IsSet` [38661c17](https://github.com/gohugoio/hugo/commit/38661c17bb8c31c9f31ee18f8eba5e3bfddd5574) [@moorereason](https://github.com/moorereason) [#3092](https://github.com/gohugoio/hugo/issues/3092)
+* Add support for ellipsed paginator navigator, making paginators with lots of pages more compact [b6ea492b](https://github.com/gohugoio/hugo/commit/b6ea492b7a6325d04d44eeb00a990a3a0e29e0c0) [@bep](https://github.com/bep) [#3466](https://github.com/gohugoio/hugo/issues/3466)
+* Add support for interfaces to `intersect` [f1c29b01](https://github.com/gohugoio/hugo/commit/f1c29b017bbd88e701cd5151dd186e868672ef89) [@moorereason](https://github.com/moorereason) [#1952](https://github.com/gohugoio/hugo/issues/1952)
+* Add `NumFmt` function [93b3b138](https://github.com/gohugoio/hugo/commit/93b3b1386714999d716e03b131f77234248f1724) [@moorereason](https://github.com/moorereason) [#1444](https://github.com/gohugoio/hugo/issues/1444)
+* Add template function namespaces [#3418](https://github.com/gohugoio/hugo/issues/3418) [#3042](https://github.com/gohugoio/hugo/issues/3042) [@moorereason](https://github.com/moorereason) [@bep](https://github.com/bep)
+* Add translation links to the default sitemap template [90d3fbf1](https://github.com/gohugoio/hugo/commit/90d3fbf1da93a279cfe994a226ae82cf5441deab) [@rayjolt](https://github.com/rayjolt) [#2569](https://github.com/gohugoio/hugo/issues/2569)
+* Allow text partials in HTML templates and the other way around [1cf29200](https://github.com/gohugoio/hugo/commit/1cf29200b4bb0a9c006155ec76759b7f4b1ad925) [@bep](https://github.com/bep) [#3273](https://github.com/gohugoio/hugo/issues/3273)
+
+### Output
+
+* Refactor site rendering with an "output format context". In this release, this is used for shortcode handling only, but this paves the way for future niceness [1e4d082c](https://github.com/gohugoio/hugo/commit/1e4d082cf5b92fedbc60b1b4f0e9d1ee6ec45e33) [@bep](https://github.com/bep) [#3397](https://github.com/gohugoio/hugo/issues/3397) [2bcbf104](https://github.com/gohugoio/hugo/commit/2bcbf104006e0ec03be4fd500f2519301d460f8c) [@bep](https://github.com/bep) [#3220](https://github.com/gohugoio/hugo/issues/3220)
+
+
+### Core
+
+* Handle `shortcode` per `Output Format` [af72db80](https://github.com/gohugoio/hugo/commit/af72db806f2c1c0bf1dfe5832275c41eeba89906) [@bep](https://github.com/bep) [#3220](https://github.com/gohugoio/hugo/issues/3220)
+* Improve shortcode error message [58d9cbd3](https://github.com/gohugoio/hugo/commit/58d9cbd31bcf7c296a39860fd7e566d10faaff28) [@bep](https://github.com/bep)
+* Avoid `index.md` in `/index/index.html` [fea4fd86](https://github.com/gohugoio/hugo/commit/fea4fd86a324bf9679df23f8289887d91b42e919) [@bep](https://github.com/bep) [#3396](https://github.com/gohugoio/hugo/issues/3396)
+* Make missing `GitInfo` a `WARNING` [5ad2f176](https://github.com/gohugoio/hugo/commit/5ad2f17693a9860be76ef8089c8728d2b59d6b04) [@bep](https://github.com/bep) [#3376](https://github.com/gohugoio/hugo/issues/3376)
+* Prevent decoding `pageParam` in common cases [e98f885b](https://github.com/gohugoio/hugo/commit/e98f885b8af27f5473a89d31d0b1f02e61e8a5ec) [@bogem](https://github.com/bogem)
+* Ignore non-source files on partial rebuild [b5b6e81c](https://github.com/gohugoio/hugo/commit/b5b6e81c0269abf9b0f4bc6a127744a25344e5c6) [@xofyarg](https://github.com/xofyarg) [#3325](https://github.com/gohugoio/hugo/issues/3325)
+* Log `WARNING` only on unknown `/data` files [ab692e73](https://github.com/gohugoio/hugo/commit/ab692e73dea3ddfe979c88ee236cc394e47e82f1) [@bep](https://github.com/bep) [#3361](https://github.com/gohugoio/hugo/issues/3361)
+* Avoid processing the same notify event twice [3b677594](https://github.com/gohugoio/hugo/commit/3b67759495c9268c30e6ba2d8c7e3b75d52d2960) [@bep](https://github.com/bep)
+* Only show `rssURI` deprecation `WARNING` if it is actually set [cfd3af8e](https://github.com/gohugoio/hugo/commit/cfd3af8e691119461effa4385251b9d3818e2291) [@bep](https://github.com/bep) [#3319](https://github.com/gohugoio/hugo/issues/3319)
+
+### Docs
+
+* Add documentation on slug translation [635b3bb4](https://github.com/gohugoio/hugo/commit/635b3bb4eb873978c7d52e6c0cb85da0c4d25299) [@xavib](https://github.com/xavib)
+* Replace `cdn.mathjax.org` with `cdnjs.cloudflare.com` [4b637ac0](https://github.com/gohugoio/hugo/commit/4b637ac041d17b22187f5ccd0f65461f0065aaa9) [@takuti](https://github.com/takuti)
+* Add notes about some output format behaviour [162d3a58](https://github.com/gohugoio/hugo/commit/162d3a586d36cabf6376a76b096fd8b6414487ae) [@jpatters](https://github.com/jpatters)
+* Add `txtpen` as alternative commenting service [7cdc244a](https://github.com/gohugoio/hugo/commit/7cdc244a72de4c08edc0008e37aec83d945dccdf) [@rickyhan](https://github.com/rickyhan)
+
+### Other
+
+* Embed `Page` in `WeightedPage` [ebf677a5](https://github.com/gohugoio/hugo/commit/ebf677a58360126d8b9a1e98d086aa4279f53181) [@bep](https://github.com/bep) [#3435](https://github.com/gohugoio/hugo/issues/3435)
+* Improve the detection of untranslated strings [a40d1f6e](https://github.com/gohugoio/hugo/commit/a40d1f6ed2aedddc99725658993258cd557640ed) [@bogem](https://github.com/bogem) [#2607](https://github.com/gohugoio/hugo/issues/2607)
+* Make first letter of the Hugo commands flags' usage lowercase [f0f69d03](https://github.com/gohugoio/hugo/commit/f0f69d03c551acb8ac2eeedaad579cf0b596f9ef) [@bogem](https://github.com/bogem)
+* Import `Octopress` image tag in `Jekyll importer` [5f3ad1c3](https://github.com/gohugoio/hugo/commit/5f3ad1c31985450fab8d6772e9cbfcb57cf5cc53) [@buynov](https://github.com/buynov)
+
+## Fixes
+
+### Templates
+
+* Do not lower case template names [6d2ea0f7](https://github.com/gohugoio/hugo/commit/6d2ea0f7d7e8a54b8edfc36e52ff74266c30dc27) [@bep](https://github.com/bep) [#3333](https://github.com/gohugoio/hugo/issues/3333)
+
+### Output
+
+* Fix output format mixup in example [10287263](https://github.com/gohugoio/hugo/commit/10287263f529181d3169668b044cb84e2e3b049a) [@bep](https://github.com/bep) [#3481](https://github.com/gohugoio/hugo/issues/3481)
+* Fix base theme vs project base template logic [077005e5](https://github.com/gohugoio/hugo/commit/077005e514b1ed50d84ceb90c7c72f184cb04521) [@bep](https://github.com/bep) [#3323](https://github.com/gohugoio/hugo/issues/3323)
+
+### Core
+* Render `404` in default language only [154e18dd](https://github.com/gohugoio/hugo/commit/154e18ddb9ad205055d5bd4827c87f3f0daf499f) [@mitchchn](https://github.com/mitchchn) [#3075](https://github.com/gohugoio/hugo/issues/3075)
+* Fix `RSSLink` vs `RSS` `Output Format` [e682fcc6](https://github.com/gohugoio/hugo/commit/e682fcc62233b47cf5bdcaf598ac0657ef089471) [@bep](https://github.com/bep) [#3450](https://github.com/gohugoio/hugo/issues/3450)
+* Add default config for `ignoreFiles`, making that option work when running in server mode [42f4ce15](https://github.com/gohugoio/hugo/commit/42f4ce15a9d68053da36f9efcf7a7d975cc59559) [@chaseadamsio](https://github.com/chaseadamsio)
+* Fix output formats override when no outputs definition given [6e2f2dd8](https://github.com/gohugoio/hugo/commit/6e2f2dd8d3ca61c92a2ee8824fbf05cadef08425) [@bep](https://github.com/bep) [#3447](https://github.com/gohugoio/hugo/issues/3447)
+* Fix handling of zero-length files [0e87b18b](https://github.com/gohugoio/hugo/commit/0e87b18b66d2c8ba9e2abc429630cb03f5b093d6) [@bep](https://github.com/bep) [#3355](https://github.com/gohugoio/hugo/issues/3355)
+* Must recreate `Paginator` on live-reload [45c74526](https://github.com/gohugoio/hugo/commit/45c74526686f6a2afa02bcee767d837d6b9dd028) [@bep](https://github.com/bep) [#3315](https://github.com/gohugoio/hugo/issues/3315)
+
+### Docs
+
+* Fix incorrect path in `templates/list` [27e88154](https://github.com/gohugoio/hugo/commit/27e88154af2dd9af6d0523d6e67b612e6336f91c) [@MunifTanjim](https://github.com/MunifTanjim)
+* Fixed incorrect specification of directory structure [a28fbca6](https://github.com/gohugoio/hugo/commit/a28fbca6dcfa80b6541f5ef6c8c12cd1804ae9ed) [@TejasQ](https://github.com/TejasQ)
+* Fix `bash` command in `tutorials/github-pages-blog` [c9976155](https://github.com/gohugoio/hugo/commit/c99761555c014e4d041438d5d7e53a6cbaee4492) [@hansott](https://github.com/hansott)
+* Fix `.Data.Pages` range in example [b5e32eb6](https://github.com/gohugoio/hugo/commit/b5e32eb60993b4656918af2c959ae217a68c461e) [@hxlnt](https://github.com/hxlnt)
+
+### Other
+
+* Fix data race in live-reload close, avoiding some rare panics [355736ec](https://github.com/gohugoio/hugo/commit/355736ec357c81dfb2eb6851ee019d407090c5ec) [@bep](https://github.com/bep) [#2625](https://github.com/gohugoio/hugo/issues/2625)
+* Skip `.git` directories in file scan [94b5be67](https://github.com/gohugoio/hugo/commit/94b5be67fc73b87d114d94a7bb1a33ab997f30f1) [@bogem](https://github.com/bogem) [#3468](https://github.com/gohugoio/hugo/issues/3468) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.22-relnotes/index.md b/docs/content/en/news/0.22-relnotes/index.md
@@ -0,0 +1,89 @@
+---
+date: 2017-06-12T17:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.22 brings nested sections, by popular demand and a long sought after feature"
+link: ""
+title: "Hugo 0.22"
+draft: false
+author: bep
+aliases: [/0-22/]
+---
+
+
+Hugo `0.22` brings **nested sections**, by popular demand and a long sought after feature ([#465](https://github.com/gohugoio/hugo/issues/465)). We are still low on documentation for this great feature, but [@bep](https://github.com/bep) has been kind enough to accompany his implementation with a [demo site](http://hugotest.bep.is/).
+
+This release represents **58 contributions by 10 contributors** to the main Hugo code base. Since last release Hugo has **gained 420 stars and 2 additional themes.**
+
+[@bep](https://github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. But also a big shoutout to [@bogem](https://github.com/bogem), [@moorereason](https://github.com/moorereason), and [@onedrawingperday](https://github.com/onedrawingperday) for their ongoing contributions. And as always big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
+
+Hugo now has:
+
+* 17576+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 165+ [themes](http://themes.gohugo.io/)
+
+## Other Highlights
+
+`.Site.GetPage` can now also be used to get regular pages ([#2844](https://github.com/gohugoio/hugo/issues/2844)):
+
+```
+{{ (.Site.GetPage "page" "blog" "mypost.md" ).Title }}
+```
+
+Also, considerable work has been put into writing automated benchmark tests for the site builds, and we're happy to report that although this release comes with fundamental structural changes, this version is -- in general -- even faster than the previous. It’s quite a challenge to consistently add significant new functionality and simultaneously maintain the stellar performance Hugo is famous for.
+
+
+
+## Notes
+
+`.Site.Sections` is replaced. We have reworked how sections work in Hugo, they can now be nested and are no longer taxonomies. If you use the old collection, you should get detailed upgrade instructions in the log when you run `hugo`. For more information, see this [demo site](http://hugotest.bep.is/).
+
+## Enhancements
+
+### Templates
+
+* Add `uint` support to `In` [b82cd82f](https://github.com/gohugoio/hugo/commit/b82cd82f1198a371ed94bda7faafe22813f4cb29) [@moorereason](https://github.com/moorereason)
+* Support interfaces in `union` [204c3a9e](https://github.com/gohugoio/hugo/commit/204c3a9e32fcf6617ede978e35d3e2e89a5b491c) [@moorereason](https://github.com/moorereason) [#3411](https://github.com/gohugoio/hugo/issues/3411)
+* Add `uniq` function [e28d9aa4](https://github.com/gohugoio/hugo/commit/e28d9aa42c3429d22fe254e69e4605aaf1e684f3) [@adiabatic](https://github.com/adiabatic)
+* Handle `template.HTML` and friends in `ToInt` [4113693a](https://github.com/gohugoio/hugo/commit/4113693ac1b275f3a40aa5c248269340ef9b57f6) [@moorereason](https://github.com/moorereason) [#3308](https://github.com/gohugoio/hugo/issues/3308)
+
+
+### Core
+
+* Make the `RSS feed` use the date for the node it represents [f1da5a15](https://github.com/gohugoio/hugo/commit/f1da5a15a37666ee59350d6600a8c14c1383f5bc) [@bep](https://github.com/bep) [#2708](https://github.com/gohugoio/hugo/issues/2708)
+* Enable `nested sections` [b3968939](https://github.com/gohugoio/hugo/commit/b39689393ccb8434d9a57658a64b77568c718e99) [@bep](https://github.com/bep) [#465](https://github.com/gohugoio/hugo/issues/465)
+* Add test for "no 404" in `sitemap` [8aaec644](https://github.com/gohugoio/hugo/commit/8aaec644a90d09bd7f079d35d382f76bb4ed35db) [@bep](https://github.com/bep) [#3563](https://github.com/gohugoio/hugo/issues/3563)
+* Support regular pages in `.Site.GetPage` [e0c2e798](https://github.com/gohugoio/hugo/commit/e0c2e798201f75ae6e9a81a7442355288c2d141b) [@bep](https://github.com/bep) [#2844](https://github.com/gohugoio/hugo/issues/2844)
+[#3082](https://github.com/gohugoio/hugo/issues/3082)
+
+### Performance
+* Add site building benchmarks [8930e259](https://github.com/gohugoio/hugo/commit/8930e259d78cba4041b550cc51a7f40bc91d7c20) [@bep](https://github.com/bep) [#3535](https://github.com/gohugoio/hugo/issues/3535)
+* Add a cache to `GetPage` which makes it much faster [50d11138](https://github.com/gohugoio/hugo/commit/50d11138f3e18b545c15fadf52f7b0b744bf3e7c) [@bep](https://github.com/bep)
+* Speed up `GetPage` [fbb78b89](https://github.com/gohugoio/hugo/commit/fbb78b89df8ccef8f0ab26af00aa45d35c1ee2cf) [@bep](https://github.com/bep) [#3503](https://github.com/gohugoio/hugo/issues/3503)
+* Add BenchmarkFrontmatterTags [3d9c4f51](https://github.com/gohugoio/hugo/commit/3d9c4f513b0443648d7e88995e351df1739646d2) [@bep](https://github.com/bep) [#3464](https://github.com/gohugoio/hugo/issues/3464)
+* Add `benchSite.sh` to make it easy to run Hugo performance benchmarks [d74452cf](https://github.com/gohugoio/hugo/commit/d74452cfe8f69a85ec83e05481e16bebf199a5cb) [@bep](https://github.com/bep)
+* Cache language config [4aff2b6e](https://github.com/gohugoio/hugo/commit/4aff2b6e7409a308f30cff1825fec02991e0d56a) [@bep](https://github.com/bep)
+* Temporarily revert to BurntSushi for `TOML` front matter handling; it is currently much faster [0907a5c1](https://github.com/gohugoio/hugo/commit/0907a5c1c293755e6bf297246f07888448d81f8b) [@bep](https://github.com/bep) [#3541](https://github.com/gohugoio/hugo/issues/3541) [#3464](https://github.com/gohugoio/hugo/issues/3464)
+* Add a simple partitioned lazy cache [87203139](https://github.com/gohugoio/hugo/commit/87203139c38e0b992c96d7b8a23c7730649c68e5) [@bep](https://github.com/bep)
+
+### Other
+
+* Add `noindex` tag to HTML generated by Hugo aliases [d5ab7f08](https://github.com/gohugoio/hugo/commit/d5ab7f087d967b30e7de7d789e6ad3091b42f1f7) [@onedrawingperday](https://github.com/onedrawingperday)
+* Update Go versions [bde807bd](https://github.com/gohugoio/hugo/commit/bde807bd1e560fb4cc765c0fc22132db7f8a0801) [@bep](https://github.com/bep)
+* Remove the `rlimit` tweaking on `macOS` [bcd32f10](https://github.com/gohugoio/hugo/commit/bcd32f1086c8c604fb22a7496924e41cc46b1605) [@bep](https://github.com/bep) [#3512](https://github.com/gohugoio/hugo/issues/3512)
+
+### Docs
+* Rewrite “Archetypes” article [@davidturnbull](https://github.com/davidturnbull) [#3543](https://github.com/gohugoio/hugo/pull/3543/)
+* Remove Unmaintaned Frontends from Tools. [f41f7282](https://github.com/gohugoio/hugo/commit/f41f72822251c9a31031fd5b3dda585c57c8b028) [@onedrawingperday](https://github.com/onedrawingperday)
+
+## Fixes
+
+### Core
+* Improve `live-reload` on directory structure changes making removal of directories or pasting new content directories into `/content` just work [fe901b81](https://github.com/gohugoio/hugo/commit/fe901b81191860b60e6fcb29f8ebf87baef2ee79) [@bep](https://github.com/bep) [#3570](https://github.com/gohugoio/hugo/issues/3570)
+* Respect `disableKinds=["sitemap"]` [69d92dc4](https://github.com/gohugoio/hugo/commit/69d92dc49cb8ab9276ab013d427ba2d9aaf9135d) [@bep](https://github.com/bep) [#3544](https://github.com/gohugoio/hugo/issues/3544)
+* Fix `disablePathToLower` regression [5be04486](https://github.com/gohugoio/hugo/commit/5be0448635fdf5fe6b1ee673e869f2b9baf1a5c6) [@bep](https://github.com/bep) [#3374](https://github.com/gohugoio/hugo/issues/3374)
+* Fix `ref`/`relref` issue with duplicate base filenames [612f6e3a](https://github.com/gohugoio/hugo/commit/612f6e3afe0510c31f70f3621f3dc8ba609dade4) [@bep](https://github.com/bep) [#2507](https://github.com/gohugoio/hugo/issues/2507)
+
+### Docs
+
+* Fix parameter name in `YouTube` shortcode section [37e37877](https://github.com/gohugoio/hugo/commit/37e378773fbc127863f2b7a389d5ce3a14674c73) [@zivbk1](https://github.com/zivbk1) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.22.1-relnotes/index.md b/docs/content/en/news/0.22.1-relnotes/index.md
@@ -0,0 +1,37 @@
+---
+date: 2017-06-13T17:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.22.1 fixes a couple of issues reported after the 0.22 release"
+link: ""
+title: "Hugo 0.22.1"
+draft: false
+author: bep
+aliases: [/0-22-1/]
+---
+
+Hugo `0.22.1` fixes a couple of issues reported after the [0.22 release](https://github.com/gohugoio/hugo/releases/tag/v0.22) Monday. Most importantly a fix for detecting regular subfolders below the root-sections.
+
+Also, we forgot to adapt the `permalink settings` with support for nested sections, which made that feature less useful than it could be.
+
+With this release you can configure **permalinks with sections** like this:
+
+**First level only:**
+
+```
+[permalinks]
+blog = ":section/:title"
+```
+
+**Nested (all levels):**
+
+```
+[permalinks]
+blog = ":sections/:title"
+```
+## Fixes
+
+* Fix section logic for root folders with subfolders [a30023f5](https://github.com/gohugoio/hugo/commit/a30023f5cbafd06034807255181a5b7b17f3c25f) [@bep](https://github.com/bep) [#3586](https://github.com/gohugoio/hugo/issues/3586)
+* Support sub-sections in permalink settings [1f26420d](https://github.com/gohugoio/hugo/commit/1f26420d392a5ab4c7b7fe1911c0268b45d01ab8) [@bep](https://github.com/bep) [#3580](https://github.com/gohugoio/hugo/issues/3580)
+* Adjust rlimit to 64000 [ff54b6bd](https://github.com/gohugoio/hugo/commit/ff54b6bddcefab45339d8dc2b13776b92bdc04b9) [@bep](https://github.com/bep) [#3582](https://github.com/gohugoio/hugo/issues/3582)
+* Make error on setting rlimit a warning only [629e1439](https://github.com/gohugoio/hugo/commit/629e1439e819a7118ae483381d4634f16d3474dd) [@bep](https://github.com/bep) [#3582](https://github.com/gohugoio/hugo/issues/3582)
+* Revert: Remove the rlimit tweaking on macOS [26aa06a3](https://github.com/gohugoio/hugo/commit/26aa06a3db57ab7134a900d641fa2976f7971520) [@bep](https://github.com/bep) [#3582](https://github.com/gohugoio/hugo/issues/3582)+
\ No newline at end of file
diff --git a/docs/content/en/news/0.23-relnotes/index.md b/docs/content/en/news/0.23-relnotes/index.md
@@ -0,0 +1,46 @@
+---
+date: 2017-06-16T17:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.23 is mainly a release that handles all the small changes needed to get Hugo moved to a GitHub organisation"
+link: ""
+title: "Hugo 0.23"
+draft: false
+author: bep
+aliases: [/0-23/]
+---
+
+Hugo `0.23` is mainly a release that handles all the small changes needed to get Hugo moved to a GitHub organisation: [gohugoio](https://github.com/gohugoio), but it also contains a couple of important fixes that makes this an update worth-while for all.
+
+Hugo now has:
+
+* 17739+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 494+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 165+ [themes](http://themes.gohugo.io/)
+
+## Fixes
+
+* Fix handling of duplicate footnotes [a9e551a1](https://github.com/gohugoio/hugo/commit/a9e551a100e60a603210ee083103dd73369d6a98) [@bep](https://github.com/bep) [#1912](https://github.com/gohugoio/hugo/issues/1912)
+* Add support for spaces in project folder for `GitInfo` #3533 #3552
+
+## GitHub organisation related changes
+
+* Update layout references to gohugoio/hugo [66d4850b](https://github.com/gohugoio/hugo/commit/66d4850b89db293dc58e828de784037f06c6c8dc) [@bep](https://github.com/bep)
+* Update content references to gohugoio/hugo [715ff1f8](https://github.com/gohugoio/hugo/commit/715ff1f87406edf27738c8c0f52fe185fa974ee8) [@bep](https://github.com/bep)
+* Add note on updates for rpm-based distros [52a0cea6](https://github.com/gohugoio/hugo/commit/52a0cea65de7b75ae1662abe3dec36fca3604617) [@daftaupe](https://github.com/daftaupe)
+* Update logo link in README [ccb8300d](https://github.com/gohugoio/hugo/commit/ccb8300d380636d75a39f4133284eb0109e836c3) [@bep](https://github.com/bep)
+* Remove docs building from CI builds [214dbdfb](https://github.com/gohugoio/hugo/commit/214dbdfb6f016d21415bc1ed511a37a084238878) [@bep](https://github.com/bep)
+* Adjust docs path [729be807](https://github.com/gohugoio/hugo/commit/729be8074bddb58c9111f32c55cc769e49cd0d5a) [@bep](https://github.com/bep)
+* Add docs as submodule [6cee0dfe](https://github.com/gohugoio/hugo/commit/6cee0dfe53899d433afc3c173a87d56265904cb0) [@bep](https://github.com/bep)
+* Update Gitter link in README [fbb25014](https://github.com/gohugoio/hugo/commit/fbb25014e1306ce7127d53e5fc4fc49867790336) [@bep](https://github.com/bep)
+* Change Windows build badge link, take #3 [86543d6a](https://github.com/gohugoio/hugo/commit/86543d6a50251b40540ebd0b851d45eb99d017c7) [@bep](https://github.com/bep)
+* Update Windows build link [e6ae32a0](https://github.com/gohugoio/hugo/commit/e6ae32a0ba75b9894418227e87391defbb1b3b49) [@bep](https://github.com/bep)
+* Update links in CONTRIBUTING.md due to the org transition [95386544](https://github.com/gohugoio/hugo/commit/95386544e858949a2baa414f395f30aaf66a6257) [@digitalcraftsman](https://github.com/digitalcraftsman)
+* Update source path in Dockerfile due to the org transition [7b99fb9f](https://github.com/gohugoio/hugo/commit/7b99fb9f1ca8381457afe9d8e953a388b8ada182) [@digitalcraftsman](https://github.com/digitalcraftsman)
+* Update clone folder in appveyor.yml due to the org transition [d531d17b](https://github.com/gohugoio/hugo/commit/d531d17b3be0b14faf4934611e01ac3289e37835) [@digitalcraftsman](https://github.com/digitalcraftsman)
+* Update import path in snapcraft.yaml due to the org transition [9266bf9d](https://github.com/gohugoio/hugo/commit/9266bf9d4c24592b875a7f6b92f761b4cea40879) [@digitalcraftsman](https://github.com/digitalcraftsman)
+* Run gofmt to get imports in line vs gohugoio/hugo [873a6f18](https://github.com/gohugoio/hugo/commit/873a6f18851bcda79d562ff6c02e1109e8e31a88) [@bep](https://github.com/bep)
+* Update Makefile vs gohugoio/hugo [f503d76a](https://github.com/gohugoio/hugo/commit/f503d76a3b2719bbb65ab9df5595d0dbc871fae9) [@bep](https://github.com/bep)
+* Update README to point to gohugoio/hugo [93643860](https://github.com/gohugoio/hugo/commit/93643860c9db10c6c32176b17cc83f1c317279bd) [@bep](https://github.com/bep)
+* Update examples to point to gohugoio/hugo [db46bcf8](https://github.com/gohugoio/hugo/commit/db46bcf82d060656d4bc731550e63ec9cf8576f2) [@bep](https://github.com/bep)
+* Update textual references in Go source to point to gohugoio/hugo [c17ad675](https://github.com/gohugoio/hugo/commit/c17ad675e8fcdb2db40fc50816b8f016bc14294c) [@bep](https://github.com/bep)
+* Update import paths to gohugoio/hugo [d8717cd4](https://github.com/gohugoio/hugo/commit/d8717cd4c74e80ea8e20adead9321412a2d76022) [@bep](https://github.com/bep) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.24-relnotes/index.md b/docs/content/en/news/0.24-relnotes/index.md
@@ -0,0 +1,74 @@
+---
+date: 2017-06-17T17:53:58-04:00
+categories: ["Releases"]
+description: "The Revival of the Archetypes!"
+link: ""
+title: "Hugo 0.24"
+draft: false
+author: bep
+aliases: [/0-24/]
+---
+
+> "A feature that could be the name of the next Indiana Jones movie deserves its own release," says [@bep](https://github.com/bep).
+
+Hugo now handles the **archetype files as Go templates**. This means that the issues with sorting and lost comments are long gone. This also means that you will have to supply all values, including title and date. But this also opens up a lot of new windows.
+
+A fictional example for the section `newsletter` and the archetype file `archetypes/newsletter.md`:
+
+```
+---
+title: "{{ replace .TranslationBaseName "-" " " | title }}"
+date: {{ .Date }}
+draft: true
+---
+
+**Insert Lead paragraph here.**
+
+<!--more-->
+
+## New Cool Posts
+
+{{ range first 10 ( where .Site.RegularPages "Type" "cool" ) }}
+* {{ .Title }}
+{{ end }}
+```
+
+And then create a new post with:
+
+```
+hugo new newsletter/the-latest-cool.stuff.md
+```
+
+**Note:** the site will only be built if the `.Site` is in use in the archetype file, and this can be time consuming for big sites.
+
+**Hot Tip:** If you set the `newContentEditor` configuration variable to an editor on your `PATH`, the newly created article will be opened.
+
+The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo's template funcs can be used in the archetype file.
+
+**Also, Hugo now supports archetype files for all content formats, not just markdown.**
+
+Hugo now has:
+
+* 17839+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 493+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 166+ [themes](http://themes.gohugo.io/)
+
+## Notes
+
+* Archetype files now need to be complete, including `title` and `date`.
+* The `-f` (format) flag in `hugo new` is removed: Now use the archetype files as is.
+
+## Enhancements
+
+* Support extension-less media types. The motivation behind this change is to support Netlify's `_redirects` files, so we can generate server-side redirects for the Hugo docs site. See [this commit](https://github.com/gohugoio/hugoDocs/commit/c1ab9894e8292e0a74c43bbca2263b1fb3840f9e) to see how we configured that. [0f40e1fa](https://github.com/gohugoio/hugo/commit/0f40e1fadfca2276f65adefa6d7d5d63aef9160a) [@bep](https://github.com/bep) [#3614](https://github.com/gohugoio/hugo/issues/3614)
+* Add `disableAliases` [516e6c6d](https://github.com/gohugoio/hugo/commit/516e6c6dc5733cdaf985317d58eedbc6ec0ef2f7) [@bep](https://github.com/bep) [#3613](https://github.com/gohugoio/hugo/issues/3613)
+* Support non-md files as archetype files [19f2e729](https://github.com/gohugoio/hugo/commit/19f2e729135af700c5d4aa06e7b3540e6d4847fd) [@bep](https://github.com/bep) [#3597](https://github.com/gohugoio/hugo/issues/3597) [#3618](https://github.com/gohugoio/hugo/issues/3618)
+* Identify extension-less text types as text [c43b512b](https://github.com/gohugoio/hugo/commit/c43b512b4700f76ac77f12d632bb030c3a241393) [@bep](https://github.com/bep) [#3614](https://github.com/gohugoio/hugo/issues/3614)
+* Add `.Site` to the archetype templates [662e12f3](https://github.com/gohugoio/hugo/commit/662e12f348a638a6fcc92a416ee7f7c2a7ef8792) [@bep](https://github.com/bep) [#1629](https://github.com/gohugoio/hugo/issues/1629)
+* Use archetype template as-is as a Go template [422057f6](https://github.com/gohugoio/hugo/commit/422057f60709696bbbd1c38c9ead2bf114d47e31) [@bep](https://github.com/bep) [#452](https://github.com/gohugoio/hugo/issues/452) [#1629](https://github.com/gohugoio/hugo/issues/1629)
+* Update links to new discuss URL [4aa12390](https://github.com/gohugoio/hugo/commit/4aa1239070bb9d4324d3582f3e809b702a59d3ac) [@bep](https://github.com/bep)
+
+## Fixes
+
+* Fix error handling for `JSON` front matter [fb53987a](https://github.com/gohugoio/hugo/commit/fb53987a4ff2acb9da8dec6ec7b11924d37352ce) [@bep](https://github.com/bep) [#3610](https://github.com/gohugoio/hugo/issues/3610)
+* Fix handling of quoted brackets in `JSON` front matter [3183b9a2](https://github.com/gohugoio/hugo/commit/3183b9a29d8adac962fbc73f79b04542f4c4c55d) [@bep](https://github.com/bep) [#3511](https://github.com/gohugoio/hugo/issues/3511) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.24.1-relnotes/index.md b/docs/content/en/news/0.24.1-relnotes/index.md
@@ -0,0 +1,22 @@
+---
+date: 2017-06-24T17:53:58-04:00
+categories: ["Releases"]
+description: "This release fixes some important archetype-related regressions from Hugo 0.24"
+link: ""
+title: "Hugo 0.24.1"
+draft: false
+author: bep
+aliases: [/0-24-1/]
+---
+
+This release fixes some important **archetype-related regressions** from the recent Hugo 0.24-release.
+
+## Fixes
+
+* Fix archetype regression when no archetype file [4294dd8d](https://github.com/gohugoio/hugo/commit/4294dd8d9d22bd8107b7904d5389967da1f83f27) [@bep](https://github.com/bep) [#3626](https://github.com/gohugoio/hugo/issues/3626)
+* Preserve shortcodes in archetype templates [b63e4ee1](https://github.com/gohugoio/hugo/commit/b63e4ee198c875b73a6a9af6bb809589785ed589) [@bep](https://github.com/bep) [#3623](https://github.com/gohugoio/hugo/issues/3623)
+* Fix handling of timezones with positive UTC offset (e.g., +0800) in TOML [0744f81e](https://github.com/gohugoio/hugo/commit/0744f81ec00bb8888f59d6c8b5f57096e07e70b1) [@bep](https://github.com/bep) [#3628](https://github.com/gohugoio/hugo/issues/3628)
+
+## Enhancements
+
+* Create default archetype on new site [bfa336d9](https://github.com/gohugoio/hugo/commit/bfa336d96173377b9bbe2298dbd101f6a718c174) [@bep](https://github.com/bep) [#3626](https://github.com/gohugoio/hugo/issues/3626) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.25-relnotes/index.md b/docs/content/en/news/0.25-relnotes/index.md
@@ -0,0 +1,78 @@
+---
+date: 2017-07-07T17:53:58-04:00
+categories: ["Releases"]
+description: "Hugo 0.25 automatically opens the page you're working on in the browser"
+link: ""
+title: "Hugo 0.25"
+draft: false
+author: bep
+aliases: [/0-25/]
+---
+
+Hugo `0.25` is the **Kinder Surprise**: It automatically opens the page you're working on in the browser, it adds full `AND` and `OR` support in page queries, and you can now have templates per language.
+
+
+
+If you start with `hugo server --navigateToChanged`, Hugo will navigate to the relevant page on save (see animated GIF). This is extremely useful for site-wide edits. Another very useful feature in this version is the added support for `AND` (`intersect`) and `OR` (`union`) filters when combined with `where`.
+
+Example:
+
+```
+{{ $pages := where .Site.RegularPages "Type" "not in" (slice "page" "about") }}
+{{ $pages := $pages | union (where .Site.RegularPages "Params.pinned" true) }}
+{{ $pages := $pages | intersect (where .Site.RegularPages "Params.images" "!=" nil) }}
+```
+
+The above fetches regular pages not of `page` or `about` type unless they are pinned. And finally, we exclude all pages with no `images` set in Page params.
+
+This release represents **36 contributions by 12 contributors** to the main Hugo code base. [@bep](https://github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. But also a big shoutout to [@yihui](https://github.com/yihui), [@anthonyfok](https://github.com/anthonyfok), and [@kropp](https://github.com/kropp) for their ongoing contributions. And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
+
+Hugo now has:
+
+* 18209+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 168+ [themes](http://themes.gohugo.io/)
+
+## Enhancements
+
+### Templates
+
+* Add `Pages` support to `intersect` (`AND`) and `union`(`OR`). This makes the `where` template func even more powerful. [ccdd08d5](https://github.com/gohugoio/hugo/commit/ccdd08d57ab64441e93d6861ae126b5faacdb92f) [@bep](https://github.com/bep) [#3174](https://github.com/gohugoio/hugo/issues/3174)
+* Add `math.Log` function. This is very handy for creating tag clouds. [34c56677](https://github.com/gohugoio/hugo/commit/34c566773a1364077e1397daece85b22948dc721) [@artem-sidorenko](https://github.com/artem-sidorenko)
+* Add `WebP` images support [8431c8d3](https://github.com/gohugoio/hugo/commit/8431c8d39d878c18c6b5463d9091a953608df10b) [@bep](https://github.com/bep) [#3529](https://github.com/gohugoio/hugo/issues/3529)
+* Only show post's own keywords in schema.org [da72805a](https://github.com/gohugoio/hugo/commit/da72805a4304a57362e8e79a01cc145767b027c5) [@brunoamaral](https://github.com/brunoamaral) [#2635](https://github.com/gohugoio/hugo/issues/2635)[#2646](https://github.com/gohugoio/hugo/issues/2646)
+* Simplify the `Disqus` template a little bit (#3655) [eccb0647](https://github.com/gohugoio/hugo/commit/eccb0647821e9db20ba9800da1b4861807cc5205) [@yihui](https://github.com/yihui)
+* Improve the built-in Disqus template (#3639) [2e1e4934](https://github.com/gohugoio/hugo/commit/2e1e4934b60ce8081a7f3a79191ed204f3098481) [@yihui](https://github.com/yihui)
+
+### Output
+
+* Support templates per site/language. This is for both regular templates and shortcode templates. [aa6b1b9b](https://github.com/gohugoio/hugo/commit/aa6b1b9be7c9d7322333893b642aaf8c7a5f2c2e) [@bep](https://github.com/bep) [#3360](https://github.com/gohugoio/hugo/issues/3360)
+
+### Core
+
+* Extend the sections API [a1d260b4](https://github.com/gohugoio/hugo/commit/a1d260b41a6673adef679ec4e262c5f390432cf5) [@bep](https://github.com/bep) [#3591](https://github.com/gohugoio/hugo/issues/3591)
+* Make `.Site.Sections` return the top level sections [dd9b1baa](https://github.com/gohugoio/hugo/commit/dd9b1baab0cb860a3eb32fd9043bac18cab3f9f0) [@bep](https://github.com/bep) [#3591](https://github.com/gohugoio/hugo/issues/3591)
+* Render `404.html` for all languages [41805dca](https://github.com/gohugoio/hugo/commit/41805dca9e40e9b0952e04d06074e6fc91140495) [@mitchchn](https://github.com/mitchchn) [#3598](https://github.com/gohugoio/hugo/issues/3598)
+
+### Other
+
+* Support human-readable `YAML` boolean values in `undraft` [1039356e](https://github.com/gohugoio/hugo/commit/1039356edf747f044c989a5bc0e85d792341ed5d) [@kropp](https://github.com/kropp)
+* `hugo import jekyll` support nested `_posts` directories [7ee1f25e](https://github.com/gohugoio/hugo/commit/7ee1f25e9ef3be8f99c171e8e7982f4f82c13e16) [@coderzh](https://github.com/coderzh) [#1890](https://github.com/gohugoio/hugo/issues/1890)[#1911](https://github.com/gohugoio/hugo/issues/1911)
+* Update `Dockerfile` and add Docker optimizations [118f8f7c](https://github.com/gohugoio/hugo/commit/118f8f7cf22d756d8a894ff93551974a806f2155) [@ellerbrock](https://github.com/ellerbrock)
+* Add Blackfriday `joinLines` extension support (#3574) [a5440496](https://github.com/gohugoio/hugo/commit/a54404968a4b36579797f2e7ff7f5eada94866d9) [@choueric](https://github.com/choueric)
+* add `--initial-header-level=2` to rst2html (#3528) [bfce30d8](https://github.com/gohugoio/hugo/commit/bfce30d85972c27c27e8a2caac9db6315f813298) [@frankbraun](https://github.com/frankbraun)
+* Support open "current content page" in browser [c825a731](https://github.com/gohugoio/hugo/commit/c825a7312131b4afa67ee90d593640dee3525d98) [@bep](https://github.com/bep) [#3643](https://github.com/gohugoio/hugo/issues/3643)
+* Make `--navigateToChanged` more robust on Windows [30e14cc3](https://github.com/gohugoio/hugo/commit/30e14cc31678ddc204b082ab362f86b6b8063881) [@anthonyfok](https://github.com/anthonyfok) [#3645](https://github.com/gohugoio/hugo/issues/3645)
+* Remove the docs submodule [31393f60](https://github.com/gohugoio/hugo/commit/31393f6024416ea1b2e61d1080dfd7104df36eda) [@bep](https://github.com/bep) [#3647](https://github.com/gohugoio/hugo/issues/3647)
+* Use `example.com` as homepage for new theme [aff1ac32](https://github.com/gohugoio/hugo/commit/aff1ac3235b6c075d01f7237addf44fecdd36d82) [@anthonyfok](https://github.com/anthonyfok)
+
+## Fixes
+
+### Templates
+
+* Fix `in` function for JSON arrays [d12cf5a2](https://github.com/gohugoio/hugo/commit/d12cf5a25df00fa16c59f0b2ae282187a398214c) [@bep](https://github.com/bep) [#1468](https://github.com/gohugoio/hugo/issues/1468)
+
+### Other
+
+* Fix handling of `JSON` front matter with escaped quotes [e10e51a0](https://github.com/gohugoio/hugo/commit/e10e51a00827b9fdc1bee51439fef05afc529831) [@bep](https://github.com/bep) [#3661](https://github.com/gohugoio/hugo/issues/3661)
+* Fix typo in code comment [56d82aa0](https://github.com/gohugoio/hugo/commit/56d82aa025f4d2edb1dc6315132cd7ab52df649a) [@dvic](https://github.com/dvic) +
\ No newline at end of file
diff --git a/docs/content/en/news/0.25.1-relnotes/index.md b/docs/content/en/news/0.25.1-relnotes/index.md
@@ -0,0 +1,25 @@
+---
+date: 2017-07-10T17:53:58-04:00
+categories: ["Releases"]
+description: "This is a bug-fix release with a couple of important fixes"
+link: ""
+title: "Hugo 0.25.1"
+draft: false
+author: bep
+aliases: [/0-25-1/]
+---
+
+This is a bug-fix release with a couple of important fixes.
+
+Hugo now has:
+
+* 18277+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 456+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 170+ [themes](http://themes.gohugo.io/)
+
+## Fixes
+
+* Fix union when the first slice is empty [dbbc5c48](https://github.com/gohugoio/hugo/commit/dbbc5c4810a04ac06fad7500d88cf5c3bfe0c7fd) [@bep](https://github.com/bep) [#3686](https://github.com/gohugoio/hugo/issues/3686)
+* Navigate to changed on CREATE When working with content from IntelliJ IDE, like WebStorm, every file save is followed by two events: "RENAME" and then "CREATE". [7bcc1ce6](https://github.com/gohugoio/hugo/commit/7bcc1ce659710f2220b400ce3b76e50d2e48b241) [@miltador](https://github.com/miltador)
+* Final (!) fix for issue with escaped JSON front matter [7f82b41a](https://github.com/gohugoio/hugo/commit/7f82b41a24af0fd04d28fbfebf9254766a3c6e6f) [@bep](https://github.com/bep) [#3682](https://github.com/gohugoio/hugo/issues/3682)
+* Fix issue with escaped JSON front matter [84db6c74](https://github.com/gohugoio/hugo/commit/84db6c74a084d2b52117b999d4ec343cd3389a68) [@bep](https://github.com/bep) [#3682](https://github.com/gohugoio/hugo/issues/3682)+
\ No newline at end of file
diff --git a/docs/content/news/0.26-relnotes.md b/docs/content/en/news/0.26-relnotes/index.md
diff --git a/docs/content/news/0.27-relnotes.md b/docs/content/en/news/0.27-relnotes/index.md
diff --git a/docs/content/en/news/0.27.1-relnotes/index.md b/docs/content/en/news/0.27.1-relnotes/index.md
@@ -0,0 +1,21 @@
+
+---
+date: 2017-09-13
+title: "Hugo 0.27.1: One bugfix"
+description: "Hugo 0.27.1 fixes an issue introduced in Go 1.9 with HTML escaping of shortcodes in multi output sites."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+---
+
+
+
+This fixes a regression introduced in [Go 1.9](https://github.com/golang/go/issues/21844) which lead to HTML in shortcodes in multi output Hugo sites being wrongly escaped in some cases.
+
+* Fix escaped HTML Go 1.9 multioutput issue (#3880) [2d613dd9](https://github.com/gohugoio/hugo/commit/2d613dd905bb8eeb8af57e30ddd749a0f04fbd3c) [@bep](https://github.com/bep) [#3876](https://github.com/gohugoio/hugo/issues/3876)
+
+* Bump to Go 1.9 in the Snap build [642ba6ca](https://github.com/gohugoio/hugo/commit/642ba6cab24c558b16378178fe829cbc45845424) [@bep](https://github.com/bep)
+
+
+
+
diff --git a/docs/content/en/news/0.28-relnotes/index.md b/docs/content/en/news/0.28-relnotes/index.md
@@ -0,0 +1,64 @@
+
+---
+date: 2017-09-25
+title: "Hugo 0.28: High-speed Syntax Highlighting!"
+description: "Chroma is the new default syntax highlighter in Hugo."
+categories: ["Releases"]
+images:
+- images/blog/hugo-28-poster.png
+---
+
+ Hugo `0.28` brings **blistering fast and native syntax highlighting** from [Chroma](https://github.com/alecthomas/chroma) ([fb33d828](https://github.com/gohugoio/hugo/commit/fb33d8286d78a78a74deb44355b621852a1c4033) [@bep](https://github.com/bep) [#3888](https://github.com/gohugoio/hugo/issues/3888)). A big thank you to [Alec Thomas](https://github.com/alecthomas) for taking on this massive task of porting the popular python highlighter Pygments to Go.
+
+Hugo has been caching the highlighter output to disk, so for repeated builds it has been fine, but this little snippet, showing a build of the [gohugo.io](https://gohugo.io/) site without cache and with both Pygments and Chroma, should illustrate the improvement:
+
+{{< asciicast Lc5iwTVny2kuUC8lqvNnL6oDU >}}
+
+See the [Updated Documentation](https://gohugo.io/content-management/syntax-highlighting/) for more information about how this works.
+
+Worth mentioning is also the `liveReloadPort` flag on `hugo server`, which makes it possible to do "live reloads" behind a HTTPS proxy, which makes for very cool remote customer demos.
+
+One example would be a Hugo server running behind a [ngrok](https://ngrok.com) tunnel:
+
+```bash
+ngrok http 1313
+```
+Then start the Hugo server with:
+
+```bash
+hugo server -b https://youridhere.ngrok.io --appendPort=false --liveReloadPort=443 --navigateToChanged
+```
+
+The `navigateToChanged` flag is slightly unrelated, but it is super cool ...
+
+This release represents **15 contributions by 2 contributors** to the main Hugo code base.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **9 contributions by 7 contributors**. A special thanks to [@bep](https://github.com/bep), [@i-give-up](https://github.com/i-give-up), [@muhajirframe](https://github.com/muhajirframe), and [@icannotfly](https://github.com/icannotfly) for their work on the documentation site.
+
+Hugo now has:
+
+* 19771+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 180+ [themes](http://themes.gohugo.io/)
+
+## Notes
+* Hugo now uses Chroma as new default syntax highlighter. This should in most cases work out-of-the box or with very little adjustments. But if you want to continue to use Pygments, set `pygmentsUseClassic=true` in your site config.
+* We now add a set of "no cache" headers to the responses for `hugo server`, which makes the most sense in most development scenarios. Run with `hugo server --noHTTPCache=false` to get the old behaviour.
+
+## Enhancements
+
+### Templates
+
+* Add `urls.Parse` function [81ed5647](https://github.com/gohugoio/hugo/commit/81ed564793609a32be20a569cc15da2cc02dd734) [@moorereason](https://github.com/moorereason) [#3849](https://github.com/gohugoio/hugo/issues/3849)
+* Add `math.Ceil`, `Floor`, and `Round` [19c59104](https://github.com/gohugoio/hugo/commit/19c5910485242838d6678c2aacd8501f7e646a53) [@moorereason](https://github.com/moorereason) [#3883](https://github.com/gohugoio/hugo/issues/3883)
+
+### Other
+
+* Use Chroma as new default syntax highlighter [fb33d828](https://github.com/gohugoio/hugo/commit/fb33d8286d78a78a74deb44355b621852a1c4033) [@bep](https://github.com/bep) [#3888](https://github.com/gohugoio/hugo/issues/3888)
+* Trim newlines in the hightlight shortcode [0d29a0f7](https://github.com/gohugoio/hugo/commit/0d29a0f7819e8d73149701052c29f090cd6db42b) [@bep](https://github.com/bep) [#3898](https://github.com/gohugoio/hugo/issues/3898)
+* Update `goorgeous` [b8fabce2](https://github.com/gohugoio/hugo/commit/b8fabce217fcb52e3f273491bef95c7977058732) [@bep](https://github.com/bep) [#3899](https://github.com/gohugoio/hugo/issues/3899)
+* Add `liveReloadPort` flag to server [b1804776](https://github.com/gohugoio/hugo/commit/b180477631555824a06293053e2b6e63c5f07361) [@bep](https://github.com/bep) [#3882](https://github.com/gohugoio/hugo/issues/3882)
+* Add `noHTTPCache` flag to hugo server (default on) [0b34af21](https://github.com/gohugoio/hugo/commit/0b34af216154367af7f53ce93d44e6b3d58c3f34) [@bep](https://github.com/bep) [#3897](https://github.com/gohugoio/hugo/issues/3897)
+* Make `noHTTPCache` default on [80c7ea60](https://github.com/gohugoio/hugo/commit/80c7ea60a0e0f488563a6b7311f3d4c23457aac7) [@bep](https://github.com/bep) [#3897](https://github.com/gohugoio/hugo/issues/3897)
+
diff --git a/docs/content/en/news/0.29-relnotes/index.md b/docs/content/en/news/0.29-relnotes/index.md
@@ -0,0 +1,46 @@
+
+---
+date: 2017-09-26
+title: "Hugo 0.29: Template Metrics"
+description: "Makes it easy to find template bottle necks."
+categories: ["Releases"]
+images:
+- images/blog/hugo-29-poster.png
+---
+
+Hugo `0.29` brings Template Metrics by [@moorereason](https://github.com/moorereason). Hugo is very fast, but it is still possible to write ineffective templates. Now these should be easy to identify. Just run:
+
+```bash
+hugo --templateMetrics
+```
+Now, that was the tasty carrot. The real reason this release comes so fast after the last one is to change the default value for the new `noHTTPCache` flag, which gives away too much performance to make sense as a default value.
+
+Hugo now has:
+
+* 19817+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 180+ [themes](http://themes.gohugo.io/)
+
+## Notes
+* Make `noHTTPCache` default false [e94d4f01](https://github.com/gohugoio/hugo/commit/e94d4f0177852b357f40fb9686a0ff3667d86351) [@bep](https://github.com/bep)
+
+## Enhancements
+
+### Templates
+* Add simple template metrics feature [b4a14c25](https://github.com/gohugoio/hugo/commit/b4a14c25fe85c41b79497be27ead128502a4dd7b) [@moorereason](https://github.com/moorereason)
+* Set Metrics at creation time [b5e1dc58](https://github.com/gohugoio/hugo/commit/b5e1dc5892f81da798d0d4e964a1f3328532f45e) [@bep](https://github.com/bep)
+* Fix sort order [d3681f51](https://github.com/gohugoio/hugo/commit/d3681f51c08fb11e8addcf9f0b484848d20d46cc) [@bep](https://github.com/bep)
+* Add math.Ceil, Floor, and Round to method mappings [8a69d235](https://github.com/gohugoio/hugo/commit/8a69d2356703d9f2fcb75bce0ae514e70ebd8e01) [@moorereason](https://github.com/moorereason)
+
+### Other
+* Split go build in Dockerfile [d9697e27](https://github.com/gohugoio/hugo/commit/d9697e275ecb038958b3dcea2b43e11dcba28fc9) [@tjamet](https://github.com/tjamet)
+* Update Dockerfile to benefit build cache [09d960f1](https://github.com/gohugoio/hugo/commit/09d960f17396eb7fd2c8fe6527db9503d59f0b4f) [@tjamet](https://github.com/tjamet)
+* Add git to snap package for GitInfo [a3a3f5b8](https://github.com/gohugoio/hugo/commit/a3a3f5b86114213a23337499551f000662b26022) [@ghalse](https://github.com/ghalse)
+
+
+
+
+
+
+
+
diff --git a/docs/content/en/news/0.30-relnotes/index.md b/docs/content/en/news/0.30-relnotes/index.md
@@ -0,0 +1,63 @@
+
+---
+date: 2017-10-16
+title: "Hugo 0.30: Race Car Edition!"
+description: "Fast Render Mode boosts live reloading!"
+categories: ["Releases"]
+images:
+- images/blog/hugo-30-poster.png
+---
+
+
+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.
+
+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).
+
+This release also more or less makes the really fast Chroma highlighter a complete alternative to Pygments. Most notable is the new table `linenos` support ([7c30e2cb](https://github.com/gohugoio/hugo/commit/7c30e2cbb08fdf0e61f80c7f1aa29909aeca4211) [@bep](https://github.com/bep) [#3915](https://github.com/gohugoio/hugo/issues/3915)), which makes copy-and-paste code blocks much easier.
+
+This release represents **31 contributions by 10 contributors** to the main Hugo code base.
+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contribution, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@digitalcraftsman](https://github.com/digitalcraftsman), and [@bmon](https://github.com/bmon) for their ongoing contributions.
+And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **26 contributions by 15 contributors**. A special thanks to [@bep](https://github.com/bep), [@digitalcraftsman](https://github.com/digitalcraftsman), [@moorereason](https://github.com/moorereason), and [@kaushalmodi](https://github.com/kaushalmodi) for their work on the documentation site.
+
+Hugo now has:
+
+* 20195+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 180+ [themes](http://themes.gohugo.io/)
+
+## Notes
+
+* Running `hugo server` will now run with the new "Fast Render Mode" default on. To turn it off, run `hugo server --disableFastRender` or set `disableFastRender=true` in your site config.
+* There have been several fixes and enhancements in the Chroma highlighter. One is that it now creates Pygments compatible CSS classes, which means that you may want to re-generate the stylesheet. See the [Syntax Highlighting Doc](https://gohugo.io/content-management/syntax-highlighting/).
+
+## Enhancements
+
+### Performance
+* Only re-render the view(s) you're working on [60bd332c](https://github.com/gohugoio/hugo/commit/60bd332c1f68e49e6ac439047e7c660865189380) [@bep](https://github.com/bep) [#3962](https://github.com/gohugoio/hugo/issues/3962)
+* Detect `partialCached` candidates [5800a20a](https://github.com/gohugoio/hugo/commit/5800a20a258378440e203a6c4a4343f5077755df) [@bep](https://github.com/bep)
+* Move metrics output to the end of the site build [b277cb33](https://github.com/gohugoio/hugo/commit/b277cb33e4dfa7440fca3b7888026944ce056154) [@moorereason](https://github.com/moorereason)
+
+### Templates
+
+* Output `xmlns:xhtml` only if there are translations available [0859d9df](https://github.com/gohugoio/hugo/commit/0859d9dfe647db3b8a192da38ad7efb5480a29a1) [@jamieconnolly](https://github.com/jamieconnolly)
+* Add `errorf` template function [4fc67fe4](https://github.com/gohugoio/hugo/commit/4fc67fe44a3c65fc7faaed21d5fa5bb5f87edf2c) [@bmon](https://github.com/bmon) [#3817](https://github.com/gohugoio/hugo/issues/3817)
+* Add `os.FileExists` template function [28188789](https://github.com/gohugoio/hugo/commit/2818878994e906c292cbe00cb2a83f1531a21f32) [@digitalcraftsman](https://github.com/digitalcraftsman) [#3839](https://github.com/gohugoio/hugo/issues/3839)
+* Add `float` template function [57adc539](https://github.com/gohugoio/hugo/commit/57adc539fc98dcb6fba8070b9611b8bd545f6f7f) [@x3ro](https://github.com/x3ro) [#3307](https://github.com/gohugoio/hugo/issues/3307)
+* Rework the partial test and benchmarks [e2e8bcbe](https://github.com/gohugoio/hugo/commit/e2e8bcbec34702a27047b91b6b007a15f1fc0797) [@bep](https://github.com/bep)
+
+### Other
+
+* Change `SummaryLength` to be configurable (#3924) [8717a60c](https://github.com/gohugoio/hugo/commit/8717a60cc030f4310c1779c0cdd51db37ad636cd) [@bmon](https://github.com/bmon) [#3734](https://github.com/gohugoio/hugo/issues/3734)
+* Replace `make` with `mage` in CircleCI build [fe71cb6f](https://github.com/gohugoio/hugo/commit/fe71cb6f5f83cdc8374cf1fc35a6d48102bd4b12) [@bep](https://github.com/bep) [#3969](https://github.com/gohugoio/hugo/issues/3969)
+* Add table `linenos` support for Chroma highlighter [7c30e2cb](https://github.com/gohugoio/hugo/commit/7c30e2cbb08fdf0e61f80c7f1aa29909aeca4211) [@bep](https://github.com/bep) [#3915](https://github.com/gohugoio/hugo/issues/3915)
+* Replace `make` with `mage` [8d2580f0](https://github.com/gohugoio/hugo/commit/8d2580f07c0253e12524a4b5c13165f876d00b21) [@bep](https://github.com/bep) [#3937](https://github.com/gohugoio/hugo/issues/3937)
+* Create `magefile` from `Makefile` [384a6ac4](https://github.com/gohugoio/hugo/commit/384a6ac4bd2de16fcd6a1c952e7ca41b66023a12) [@natefinch](https://github.com/natefinch)
+* Clean up lint in various packages [47fdfd51](https://github.com/gohugoio/hugo/commit/47fdfd5196cd24a23b30afe1d88969ffb413ab59) [@moorereason](https://github.com/moorereason)
+
+## Fixes
+
+* Make sure `Date` and `PublishDate` are always set to a value if one is available [6a30874f](https://github.com/gohugoio/hugo/commit/6a30874f19610a38e846e120aac03c68e12f9b7b) [@bep](https://github.com/bep) [#3854](https://github.com/gohugoio/hugo/issues/3854)
+* Add correct config file name to verbose server log [15ec031d](https://github.com/gohugoio/hugo/commit/15ec031d9818d239bfbff525c00cd99cc3118a96) [@mdhender](https://github.com/mdhender)
diff --git a/docs/content/en/news/0.30.1-relnotes/index.md b/docs/content/en/news/0.30.1-relnotes/index.md
@@ -0,0 +1,23 @@
+
+---
+date: 2017-10-19T00:00:00+02:00
+title: "Hugo 0.30.1: Two Important Bugfixes!"
+description: "Fixes `hugo -w` and validator-broken Sitemap."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+---
+
+
+
+This is a bug-fix release with two important fixes.
+
+* Fix hugo -w [fa53b13c](https://github.com/gohugoio/hugo/commit/fa53b13ca0ffb1db6ed20f5353661d3f8a5fd455) [@bep](https://github.com/bep) [#3980](https://github.com/gohugoio/hugo/issues/3980)
+* Revert sitemap template change to make the Google validator happy [5109ed520](https://github.com/gohugoio/hugo/commit/5109ed520f2ddde815d50e7b31acbbfc57ce7719) [@bep](https://github.com/bep) [#3978](https://github.com/gohugoio/hugo/issues/3978)
+
+
+Hugo now has:
+
+* 20285+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 180+ [themes](http://themes.gohugo.io/)
diff --git a/docs/content/en/news/0.30.2-relnotes/index.md b/docs/content/en/news/0.30.2-relnotes/index.md
@@ -0,0 +1,14 @@
+
+---
+date: 2017-10-19T12:00:00+02:00
+title: "Hugo 0.30.2: One More Bugfix"
+description: "Fixes Fast Render mode when having sub-path in `baseURL`."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+---
+This release fixes Fast Render mode with sub-path in baseURL [31641033](https://github.com/gohugoio/hugo/commit/3164103310fbca1211cfa9ce4a5eb7437854b6ad) [@bep](https://github.com/bep) [#3981](https://github.com/gohugoio/hugo/issues/3981).
+
+
+
+
diff --git a/docs/content/en/news/0.31-relnotes/index.md b/docs/content/en/news/0.31-relnotes/index.md
@@ -0,0 +1,79 @@
+
+---
+date: 2017-11-20
+title: "Hugo 0.31: Language Multihost Edition!"
+description: "Hugo 0.31: Multihost, smart union static dirs, and more ..."
+categories: ["Releases"]
+images:
+- images/blog/hugo-31-poster.png
+---
+
+ Hugo `0.31` is the **Language Multihost Edition!**
+
+> <img src="https://esolia.com/img/eSolia-Logo-Flat-2015.svg" alt="eSolia" width="100px" align="top" style="width:100px" />The Multihost feature is sponsored by [eSolia](https://esolia.com/), [@rickcogley](https://github.com/rickcogley)'s company.
+
+[Multihost](https://gohugo.io/content-management/multilingual/#configure-multilingual-multihost) means that you can have a **`baseURL` per language**, for example, `https://no.example.com` and `https://en.example.com`. This is seamlessly integrated, and the built-in web server with live reload and `navigateToChanged` etc. just works. A related enhancement in this release is the support for **as many static dirs as you need**, with intelligent language overrides, forming a big union file system. Add to that several other language related fixes and enhancements, it is safe to say that this is the version you want for multilingual Hugo sites!
+
+This release represents **44 contributions by 7 contributors** to the main Hugo code base.
+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@kaushalmodi](https://github.com/kaushalmodi), [@natefinch](https://github.com/natefinch), and [@betaveros](https://github.com/betaveros) for their ongoing contributions.
+And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **13 contributions by 9 contributors**. A special thanks to [@oncletom](https://github.com/oncletom), [@kaushalmodi](https://github.com/kaushalmodi), [@XhmikosR](https://github.com/XhmikosR), and [@digitalcraftsman](https://github.com/digitalcraftsman) for their work on the documentation site.
+
+
+Hugo now has:
+
+* 21105+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 184+ [themes](http://themes.gohugo.io/)
+
+## Notes
+
+* For mapping of translated content, Hugo now considers the full path of the content file, which makes it possible with translation of duplicate content filenames such as `index.md`. A specific translation key can be specified with the new `translationKey` front matter variable. See [#2699](https://github.com/gohugoio/hugo/issues/2699).
+
+
+## Enhancements
+
+### Language related
+
+* Support unknown language codes [23ba779f](https://github.com/gohugoio/hugo/commit/23ba779fab90ce45cddd68b4f49a2515ce6d4878) [@bep](https://github.com/bep) [#3564](https://github.com/gohugoio/hugo/issues/3564)
+* Fix `.IsTranslated` with identical filenames [b3daa1f4](https://github.com/gohugoio/hugo/commit/b3daa1f4bf1b84bcc5da028257ba609be74e3ecc) [@bep](https://github.com/bep) [#2699](https://github.com/gohugoio/hugo/issues/2699)
+* Fall back to unstranslated base template [0a81a6b4](https://github.com/gohugoio/hugo/commit/0a81a6b4bae3de53aa9c179b855c671a2d30eec7) [@bep](https://github.com/bep) [#3893](https://github.com/gohugoio/hugo/issues/3893)
+* Add support for multiple static dirs [60dfb9a6](https://github.com/gohugoio/hugo/commit/60dfb9a6e076200ab3ca3fd30e34bb3c14e0a893) [@bep](https://github.com/bep) [#36](https://github.com/gohugoio/hugo/issues/36)[#4027](https://github.com/gohugoio/hugo/issues/4027)
+* Add multilingual multihost support [2e046576](https://github.com/gohugoio/hugo/commit/2e0465764b5dacc511b977b1c9aa07324ad0ee9c) [@bep](https://github.com/bep) [#4027](https://github.com/gohugoio/hugo/issues/4027)
+
+### Templates
+
+* Refactor `Mod` with `cast` [76dc811c](https://github.com/gohugoio/hugo/commit/76dc811c6539b2ed8b4d3b22693e5088b9f6ecfe) [@artem-sidorenko](https://github.com/artem-sidorenko)
+* Add support for height argument to figure shortcode [488631fe](https://github.com/gohugoio/hugo/commit/488631fe0abc3667355345c7eb98ba7a2204deb5) [@kaushalmodi](https://github.com/kaushalmodi) [#4014](https://github.com/gohugoio/hugo/issues/4014)
+
+### Core
+
+* Use ms precision for static change logging [bb048d81](https://github.com/gohugoio/hugo/commit/bb048d811d3977adb10656335cd339cd8c945a25) [@bep](https://github.com/bep)
+* Update Chroma to get the latest SASS lexer [b32ffed6](https://github.com/gohugoio/hugo/commit/b32ffed6abc67646cad89e163846f3ffef29cec8) [@bep](https://github.com/bep) [#4069](https://github.com/gohugoio/hugo/issues/4069)
+* Bump to Go 1.9.2 [9299a16c](https://github.com/gohugoio/hugo/commit/9299a16c9952a284d3ac3f31d2662f1812f77768) [@bep](https://github.com/bep) [#4064](https://github.com/gohugoio/hugo/issues/4064)
+* Update Travis and snapcraft to Go 1.9.2 [77cbd001](https://github.com/gohugoio/hugo/commit/77cbd001ff6b2e0aaa48566ef2af49ca68e19af9) [@bep](https://github.com/bep) [#4064](https://github.com/gohugoio/hugo/issues/4064)
+* Handle Taxonomy permalinks [d9a78b61](https://github.com/gohugoio/hugo/commit/d9a78b61adefe8e1803529f4774185874af85148) [@betaveros](https://github.com/betaveros) [#1208](https://github.com/gohugoio/hugo/issues/1208)
+
+
+### Other
+
+* Support Fast Render mode with sub-path in baseURL [31641033](https://github.com/gohugoio/hugo/commit/3164103310fbca1211cfa9ce4a5eb7437854b6ad) [@bep](https://github.com/bep) [#3981](https://github.com/gohugoio/hugo/issues/3981)
+* Simplify Site benchmarks [c3c10f2c](https://github.com/gohugoio/hugo/commit/c3c10f2c7ce4ee11186f51161943efc8b37a28c9) [@bep](https://github.com/bep)
+* Replace `make` with `mage` to build Hugo [#3969](https://github.com/gohugoio/hugo/issues/3969)
+* Convert to `dep` as dependency/vendor manager for Hugo [#3988](https://github.com/gohugoio/hugo/issues/3988)
+* Pre-allocate some slices [a9be687b](https://github.com/gohugoio/hugo/commit/a9be687b81df01c7343f78f0d3760042f467baa4) [@bep](https://github.com/bep)
+
+## Fixes
+
+### Templates
+
+* Make sure only one instance of a cached partial is rendered [#4086](https://github.com/gohugoio/hugo/issues/4086)
+
+### Other
+
+* Fix broken shortcodes for `Ace` and `Amber` [503ca6de](https://github.com/gohugoio/hugo/commit/503ca6de6ceb0b4af533f9efeff917d6f3871278) [@bep](https://github.com/bep) [#4051](https://github.com/gohugoio/hugo/issues/4051)
+* Fix error handling in `mage` build [c9c19d79](https://github.com/gohugoio/hugo/commit/c9c19d794537cf76ff281788c3d6cf5f2beac54d) [@natefinch](https://github.com/natefinch)
+* Fix `hugo -w` [fa53b13c](https://github.com/gohugoio/hugo/commit/fa53b13ca0ffb1db6ed20f5353661d3f8a5fd455) [@bep](https://github.com/bep) [#3980](https://github.com/gohugoio/hugo/issues/3980)
+
diff --git a/docs/content/en/news/0.31.1-relnotes/index.md b/docs/content/en/news/0.31.1-relnotes/index.md
@@ -0,0 +1,19 @@
+
+---
+date: 2017-11-27
+title: "Hugo 0.31.1: One Bugfix!"
+description: "Fixes broken `--appendPort=false`."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+This is a bug-fix release with one important bug fix:
+
+* Fix broken `--appendPort=false` [8afd7d9c](https://github.com/gohugoio/hugo/commit/8afd7d9ceb0d168300e3399c6e87a355a88c9a28) [@bep](https://github.com/bep) [#4111](https://github.com/gohugoio/hugo/issues/4111)
+
+
+
+
+
diff --git a/docs/content/en/news/0.32-relnotes/index.md b/docs/content/en/news/0.32-relnotes/index.md
@@ -0,0 +1,94 @@
+
+---
+date: 2017-12-31
+title: "Hugo 0.32: Page Bundles and Image Processing!"
+description: "Images and other resources with page-relative links, resize, scale and crop images, and much more."
+categories: ["Releases"]
+images:
+- images/blog/hugo-32-poster.png
+---
+
+ Hugo `0.32` features **Page Bundles and Image Processing** by [@bep](https://github.com/bep), which is very cool and useful on so many levels. Read about it in more detail in the [Hugo documentation](https://gohugo.io/about/new-in-032/), but some of the highlights include:
+
+* Automatic bundling of a content page with its resources. Resources can be anything: Images, `JSON` files ... and also other content pages.
+* A `Resource` will have its `RelPermalink` and `Permalink` relative to the "owning page". This makes the complete article with both text and images portable (just send a ZIP file with a folder to your editor), and it can be previewed directly on GitHub.
+* Powerful and simple to use image processing with the new `.Resize`, `.Fill`, and `.Fit` methods on the new `Image` resource.
+* Full support for symbolic links inside `/content`, both for regular files and directories.
+
+The built-in benchmarks in Hugo show that this is also the [fastest and most memory effective](https://gist.github.com/bep/2a9bbd221de2da5d39c8b32085c658f7) Hugo version to date. But note that the build time total reported in the console is now adjusted to be the *real total*, including the copy of static files. So, if it reports more milliseconds, it is still most likely faster ...
+
+This release represents **30 contributions by 7 contributors** to the main Hugo code base.
+
+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@betaveros](https://github.com/betaveros), [@chaseadamsio](https://github.com/chaseadamsio), and [@kropp](https://github.com/kropp). And as always big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **17 contributions by 7 contributors**. A special thanks to [@bep](https://github.com/bep), [@felicianotech](https://github.com/felicianotech), [@maiki](https://github.com/maiki), and [@carlchengli](https://github.com/carlchengli) for their work on the documentation site.
+
+Hugo now has:
+
+* 22061+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 193+ [themes](http://themes.gohugo.io/)
+
+Today is **New Year's Eve.** It is the last day of 2017, a year that have seen a **string of pearls of Hugo releases**, making Hugo _the_ top choice for website development:
+
+* 0.32, December 2017: **Page Bundles and Image Processing** edition.
+* 0.31, November 2017: The Language **Multihost Edition!** with one `baseURL` per language.
+* 0.30, October 2017: The Race Car Edition with the **Fast Render Mode**.
+* 0.29, September 2017: Added **Template Metrics**.
+* 0.28, September 2017: **Blistering fast and native syntax highlighting** from [Chroma](https://github.com/alecthomas/chroma).
+* 0.27, September 2017: Fast and flexible **Related Content.**
+* 0.26, August 2017: The **Language Style Edition** with AP Style or Chicago Style Title Case and « French Guillemets ».
+* 0.25, July 2017: The **Kinder Surprise** edition added, among other cool things, `hugo server --navigateToChanged` which navigates to the content page you start editing.
+* 0.24, June 2017: Was **The Revival of the Archetypes!** Now archetype files, i.e. the content file templates, can include template syntax with all of Hugo's functions and variables.
+* 0.23, June 2017: Hugo moved to it's own GitHub organization, **gohugoio**.
+* 0.22, June 2017: Added **nested sections**, a long sought after feature.
+* 0.21, May 2017: Full support for shortcodes per output format (think **AMP**).
+* 0.20, April 2017: Was all about **Custom Output Formats**.
+* 0.19, February 2017: Native Emacs Org-mode content support and lots of internal upgrades.
+
+## Notes
+
+* The build total in the console is now the ... total (i.e. it now includes both the copy of the static files and the Hugo build). So if your Hugo site seems to build slightly slower, it is in reality probably slightly faster than before this release.
+* Images and other static resources in folders with "_index.md" will have its `RelPermalink` relative to its page.
+* Images and other static resources in or below "index.md" folders will have its `RelPermalink` relative to its page (respecting permalink settings etc.)
+* Content pages in or below "index.md" will not get their own `URL`, but will be part of the `.Resources` collection of its page.
+* `.Site.Files` is deprecated.
+* Hugo no longer minfies CSS files inside `/content`. This was an undocumented "proof of concept feature". We may revisit the "assets handling" in a future release.
+* `Page.GetParam`does not lowercase your result anymore. If you really want to lowercase your params, do it with `.GetParam "myparam" | lower` or similar.
+
+Previously deprecated that will now `ERROR`:
+
+* `disable404`: Use `disableKinds=["404"]`
+* `disableRSS`: Use `disableKinds=["RSS"]`
+* `disableSitemap`: Use `disableKinds=["sitemap"]`
+* `disableRobotsTXT`: Use `disableKinds=["robotsTXT"]`
+
+## Enhancements
+
+* Add `.Title` and `.Page` to `MenuEntry` [9df3736f](https://github.com/gohugoio/hugo/commit/9df3736fec164c51d819797416dc263f2869be77) [@rmetzler](https://github.com/rmetzler) [#2784](https://github.com/gohugoio/hugo/issues/2784)
+* Add `Pandoc` support [e69da7a4](https://github.com/gohugoio/hugo/commit/e69da7a4cb725987f153707bf2fc59c135007e2a) [@betaveros](https://github.com/betaveros) [#234](https://github.com/gohugoio/hugo/issues/234)
+* Implement Page bundling and image handling [3cdf19e9](https://github.com/gohugoio/hugo/commit/3cdf19e9b7e46c57a9bb43ff02199177feb55768) [@bep](https://github.com/bep) [#3651](https://github.com/gohugoio/hugo/issues/3651)[#3158](https://github.com/gohugoio/hugo/issues/3158)[#1014](https://github.com/gohugoio/hugo/issues/1014)[#2021](https://github.com/gohugoio/hugo/issues/2021)[#1240](https://github.com/gohugoio/hugo/issues/1240)[#3757](https://github.com/gohugoio/hugo/issues/3757)
+* Make `chomp` return the type it receives [22cd89ad](https://github.com/gohugoio/hugo/commit/22cd89adc4792a3b55389d38acd4acfae3786775) [@kropp](https://github.com/kropp) [#2187](https://github.com/gohugoio/hugo/issues/2187)
+* Reuse the `BlackFriday` config instance when possible [db4b7a5c](https://github.com/gohugoio/hugo/commit/db4b7a5c6742c75f9cd9627d3b054d3a72802ec8) [@bep](https://github.com/bep)
+* Remove the goroutines from the shortcode lexer [24369410](https://github.com/gohugoio/hugo/commit/243694102a60da2fb1050020f68384539f9f9ef5) [@bep](https://github.com/bep)
+* Improve site benchmarks [051fa343](https://github.com/gohugoio/hugo/commit/051fa343d06d6c070df742f7cbd125432fcab665) [@bep](https://github.com/bep)
+* Update `Chroma` to `v0.2.0` [79892101](https://github.com/gohugoio/hugo/commit/7989210120dbde78da3741e2ef01b13f4aa78692) [@bep](https://github.com/bep) [#4087](https://github.com/gohugoio/hugo/issues/4087)
+* Update `goorgeous` to `v1.1.0` [7f2ae3ef](https://github.com/gohugoio/hugo/commit/7f2ae3ef39f27a9bd26ddb9258b073a840faf491) [@chaseadamsio](https://github.com/chaseadamsio)
+* Add test for homepage content for all rendering engines [407c2402](https://github.com/gohugoio/hugo/commit/407c24020ef2db90cf33fd07e7522b2257013722) [@bep](https://github.com/bep) [#4166](https://github.com/gohugoio/hugo/issues/4166)
+* Add output formats definition to benchmarks [a2d81ce9](https://github.com/gohugoio/hugo/commit/a2d81ce983d45b5742c93bd472503c88286f099a) [@bep](https://github.com/bep)
+
+## Fixes
+
+### Templates
+
+* Do not unescape input to `highlight` [c067f345](https://github.com/gohugoio/hugo/commit/c067f34558b82455b63b9ce8f5983b4b4849c7cf) [@bep](https://github.com/bep) [#4179](https://github.com/gohugoio/hugo/issues/4179)
+* Properly close image file in `imageConfig` [6d79beb5](https://github.com/gohugoio/hugo/commit/6d79beb5f67dbb54d7714c3195addf9d8e3924e8) [@bep](https://github.com/bep)
+ * Fix `opengraph` video range template [23f69efb](https://github.com/gohugoio/hugo/commit/23f69efb3914946b39ce673fcc0f2e3a9ed9d878) [@drlogout](https://github.com/drlogout) [#4136](https://github.com/gohugoio/hugo/issues/4136)
+* Fix `humanize` for multi-byte runes [e7652180](https://github.com/gohugoio/hugo/commit/e7652180a13ce149041c48a1c2754c471df569c8) [@bep](https://github.com/bep) [#4133](https://github.com/gohugoio/hugo/issues/4133)
+
+### Other
+
+* Fix broken live reload without a server port. [25114986](https://github.com/gohugoio/hugo/commit/25114986086e5877a0b4108d8cf5e4e95f377241) [@sainaen](https://github.com/sainaen) [#4141](https://github.com/gohugoio/hugo/issues/4141)
+* Make sure all language homes are always re-rendered in fast render mode [72903be5](https://github.com/gohugoio/hugo/commit/72903be587e9c4e3644f60b11e26238ec03da2db) [@bep](https://github.com/bep) [#4125](https://github.com/gohugoio/hugo/issues/4125)
+* Do not `tolower` result from Page.GetParam [1c114d53](https://github.com/gohugoio/hugo/commit/1c114d539b0755724443fe28c90b12fe2a19085a) [@bep](https://github.com/bep) [#4187](https://github.com/gohugoio/hugo/issues/4187)
diff --git a/docs/content/en/news/0.32.1-relnotes/index.md b/docs/content/en/news/0.32.1-relnotes/index.md
@@ -0,0 +1,18 @@
+
+---
+date: 2018-01-02
+title: "Hugo 0.32.1: Two bugfixes"
+description: "Fixes image processing in shortcodes."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+---
+
+This fixes 2 bugs from the Hugo 0.32 release.
+
+* Fix image processing from shortcodes in non-server mode. [@bep](https://github.com/bep) [#4202](https://github.com/gohugoio/hugo/issues/4202)
+* Fix broken `hugo --renderToMemory`. Note that this is only useful for benchmark testing, as there is no easy way to actually view the result. [d36d71ed](https://github.com/gohugoio/hugo/commit/d36d71edd3b04df3b34edf4d108e3995a244c4f0) [@bep](https://github.com/bep) [#4212](https://github.com/gohugoio/hugo/issues/4212)
+
+
+
+
diff --git a/docs/content/en/news/0.32.2-relnotes/index.md b/docs/content/en/news/0.32.2-relnotes/index.md
@@ -0,0 +1,23 @@
+
+---
+date: 2018-01-03
+title: "Hugo 0.32.2: One bugfix"
+description: "Fixes one issue with publishing of processed images when no cache."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+
+
+This is a bug-fix release with one important fix.
+
+
+* Handle publish of processed images to /public on fresh build with no image cache in /resources (as reported by one person in a Netlify build) [196da49c](https://github.com/gohugoio/hugo/commit/196da49c9d906fbae6d389fdd32b80c27cb38de4) [@bep](https://github.com/bep) [#4213](https://github.com/gohugoio/hugo/issues/4213)
+
+
+
+
+
+
diff --git a/docs/content/en/news/0.32.3-relnotes/index.md b/docs/content/en/news/0.32.3-relnotes/index.md
@@ -0,0 +1,30 @@
+
+---
+date: 2018-01-08
+title: "Hugo 0.32.3: Some important bug fixes"
+description: "Fixes multilingual resource (images etc.) handling etc."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+
+
+Hugo `0.32` was a big and [really cool](https://gohugo.io/news/0.32-relnotes/) release, and the [Hugo Forum](https://discourse.gohugo.io/) has been filled with questions from people wanting to upgrade their Hugo sites to be able to use the new image processing feature etc.
+
+And with that we have discovered some issues, which this release should fix, mostly releated to multilingual sites:
+
+* Fix multihost detection for sites without language definition [8969331f](https://github.com/gohugoio/hugo/commit/8969331f5be352939883074034adac6b7086ddc8) [@bep](https://github.com/bep) [#4221](https://github.com/gohugoio/hugo/issues/4221)
+* Fix hugo benchmark --renderToMemory [059e8458](https://github.com/gohugoio/hugo/commit/059e8458d690dbb9fcd3ebd58cfc61b062d3138e) [@bep](https://github.com/bep) [#4218](https://github.com/gohugoio/hugo/issues/4218)
+* Fix URLs for bundle resources in multihost mode [ab82a27d](https://github.com/gohugoio/hugo/commit/ab82a27d055c3aa177821d81a45a5c6e972aa29e) [@bep](https://github.com/bep) [#4217](https://github.com/gohugoio/hugo/issues/4217)
+* Fix sub-folder baseURL handling for Page resources [f25d8a9e](https://github.com/gohugoio/hugo/commit/f25d8a9e17fb65fa41dafdcbf0358853d68eaf45) [@bep](https://github.com/bep) [#4228](https://github.com/gohugoio/hugo/issues/4228)
+* Avoid processing and storing same image for each language [4b04db0f](https://github.com/gohugoio/hugo/commit/4b04db0f0855a1f54895d6c93c52dcea4b1ce3ca) [@bep](https://github.com/bep) [#4231](https://github.com/gohugoio/hugo/issues/4231)
+* Resources.ByType should return Resources [97c1866e](https://github.com/gohugoio/hugo/commit/97c1866e322284dec46db6f3d235807507f5b69f) [@bep](https://github.com/bep) [#4234](https://github.com/gohugoio/hugo/issues/4234)
+* Report build time on config.toml change [6feb1387](https://github.com/gohugoio/hugo/commit/6feb138785eeb9e813428d0df30010d9b5fb1059) [@bep](https://github.com/bep) [#4232](https://github.com/gohugoio/hugo/issues/4232)[#4224](https://github.com/gohugoio/hugo/issues/4224)
+* Fix handling of mixed-case taxonomy folders with content file [2d3189b2](https://github.com/gohugoio/hugo/commit/2d3189b22760e0a8995dae082a6bc5480f770bfe) [@bep](https://github.com/bep) [#4238](https://github.com/gohugoio/hugo/issues/4238)
+
+
+
+
+
diff --git a/docs/content/en/news/0.32.4-relnotes/index.md b/docs/content/en/news/0.32.4-relnotes/index.md
@@ -0,0 +1,20 @@
+
+---
+date: 2018-01-11
+title: "Hugo 0.32.4: Two bugfixes"
+description: "Fixes non-ASCII path handling for Page resources."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+---
+
+This is a bug-fix release with two of important fixes.
+
+* Fix non-ASCII path handling for Page resources [f0eecc6a](https://github.com/gohugoio/hugo/commit/f0eecc6a4f541838e9930c98bc982546f65c7a4f) [@bep](https://github.com/bep) [#4241](https://github.com/gohugoio/hugo/issues/4241)
+* Fix `--cleanDestinationDir` [5235a5bf](https://github.com/gohugoio/hugo/commit/5235a5bf5ef44b3789341e1d25b681a7bb14771a) [@biodranik](https://github.com/biodranik) [#4246](https://github.com/gohugoio/hugo/issues/4246)[#4248](https://github.com/gohugoio/hugo/issues/4248)
+
+
+
+
+
+
diff --git a/docs/content/news/0.33-relnotes/featured-hugo-33-poster.png b/docs/content/en/news/0.33-relnotes/featured-hugo-33-poster.png
Binary files differ.
diff --git a/docs/content/news/0.33-relnotes/index.md b/docs/content/en/news/0.33-relnotes/index.md
diff --git a/docs/content/news/0.34-relnotes/featured-34-poster.png b/docs/content/en/news/0.34-relnotes/featured-34-poster.png
Binary files differ.
diff --git a/docs/content/news/0.34-relnotes/index.md b/docs/content/en/news/0.34-relnotes/index.md
diff --git a/docs/content/news/0.35-relnotes/featured-hugo-35-poster.png b/docs/content/en/news/0.35-relnotes/featured-hugo-35-poster.png
Binary files differ.
diff --git a/docs/content/news/0.35-relnotes/index.md b/docs/content/en/news/0.35-relnotes/index.md
diff --git a/docs/content/news/0.36-relnotes/featured-hugo-36-poster.png b/docs/content/en/news/0.36-relnotes/featured-hugo-36-poster.png
Binary files differ.
diff --git a/docs/content/news/0.36-relnotes/index.md b/docs/content/en/news/0.36-relnotes/index.md
diff --git a/docs/content/en/news/0.36.1-relnotes/index.md b/docs/content/en/news/0.36.1-relnotes/index.md
@@ -0,0 +1,43 @@
+
+---
+date: 2018-02-15
+title: "Hugo 0.36.1: One Bugfix"
+description: "Fixes a multi-thread image processing issue."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+ This release fixes a multi-thread issue when reprocessing and reusing images across pages. When doing something like this with the same image from a partial used in, say, both the home page and the single page:
+
+```bash
+{{ with $img }}
+{{ $big := .Fill "1024x512 top" }}
+{{ $small := $big.Resize "512x" }}
+{{ end }}
+```
+
+There would be timing issues making Hugo in some cases trying to process the same image twice at the same time.
+
+You would experience errors of type:
+
+```bash
+png: invalid format: not enough pixel data
+```
+
+This commit fixes that by adding a mutex per image. This should also improve the performance, sligthly, as it avoids duplicate work.
+
+The current workaround before this fix is to always operate on the original:
+
+```bash
+{{ with $img }}
+{{ $big := .Fill "1024x512 top" }}
+{{ $small := .Fill "512x256 top" }}
+{{ end }}
+```
+This error was rare (no reports on GitHub or the discussion forum), but very hard to debug for the end user.
+
+* Fix multi-threaded image processing issue [d8fdffb5](https://github.com/gohugoio/hugo/commit/d8fdffb55268464d54558d6f9cd3874b612dc7c7) [@bep](https://github.com/bep) [#4404](https://github.com/gohugoio/hugo/issues/4404)
+* Improve error message in .Render [08521dac](https://github.com/gohugoio/hugo/commit/08521dac8323403933a8fd11acfd16930af5f17d) [@bep](https://github.com/bep)
+* Bump Travis/Snapcraft to Go 1.9.4 [fc23a80f](https://github.com/gohugoio/hugo/commit/fc23a80ffd3878b9ba9a160ce37e0e1d8703faf3) [@bep](https://github.com/bep)
+* Improve error processing error message [2851af02](https://github.com/gohugoio/hugo/commit/2851af0225cdf6c4e47058979cd22949ed6d1fc0) [@bep](https://github.com/bep)
diff --git a/docs/content/news/0.37-relnotes/featured-hugo-37-poster.png b/docs/content/en/news/0.37-relnotes/featured-hugo-37-poster.png
Binary files differ.
diff --git a/docs/content/news/0.37-relnotes/index.md b/docs/content/en/news/0.37-relnotes/index.md
diff --git a/docs/content/news/0.37.1-relnotes/index.md b/docs/content/en/news/0.37.1-relnotes/index.md
diff --git a/docs/content/news/0.38-relnotes/featured-poster.png b/docs/content/en/news/0.38-relnotes/featured-poster.png
Binary files differ.
diff --git a/docs/content/en/news/0.38-relnotes/index.md b/docs/content/en/news/0.38-relnotes/index.md
@@ -0,0 +1,66 @@
+
+---
+date: 2018-04-02
+title: "Hugo 0.38: The Easter Egg Edition"
+description: "Hugo 0.38: Date and slug from filenames, multiple content dirs, config from themes, language merge func …"
+categories: ["Releases"]
+---
+
+Hugo `0.38` is an **Easter egg** filled with good stuff. We now support fetching **date and slug from the content filename**, making the move from Jekyll even easier. And you can now set `contentDir` per language with intelligent merging, and themes can now provide configuration ... Also worth mentioning is several improvements in the [Chroma](https://github.com/alecthomas/chroma) highlighter, most notable support for Go templates.
+
+We are working hard to get the documentation up-to-date with the new features, but you can also see them in action with the full source at [hugotest.bep.is](http://hugotest.bep.is/).
+
+This release represents **39 contributions by 4 contributors** to the main Hugo code base.
+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@anthonyfok](https://github.com/anthonyfok), [@felicianotech](https://github.com/felicianotech), and [@paulcmal](https://github.com/paulcmal) for their ongoing contributions.
+
+And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the themes site in pristine condition and to [@kaushalmodi](https://github.com/kaushalmodi) for his great work on the documentation site.
+
+Also, a shoutout to [@regisphilibert](https://github.com/regisphilibert) for his work on the new [Code Toggle Shortcode](https://gohugo.io/getting-started/code-toggle/) on the Hugo docs site, which we will put to good use to improve all the configuration samples.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **55 contributions by 18 contributors**. A special thanks to [@kaushalmodi](https://github.com/kaushalmodi), [@bep](https://github.com/bep), [@xa0082249956](https://github.com/xa0082249956), and [@paulcmal](https://github.com/paulcmal) for their work on the documentation site.
+
+
+Hugo now has:
+
+* 24547+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 447+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 213+ [themes](http://themes.gohugo.io/)
+
+## Notes
+
+* Hugo now allows partial redefinition `outputs` in your site configuration. This is what most people would expect, but it is still a change in behaviour. For details, see [#4487](https://github.com/gohugoio/hugo/issues/4487)
+* Before this release, Hugo flattened URLs of processed images in sub-folders. This worked fine but was not intentional. See [#4502](https://github.com/gohugoio/hugo/issues/4502).
+
+## Enhancements
+
+* Allow themes to define output formats, media types and params [e9c7b620](https://github.com/gohugoio/hugo/commit/e9c7b6205f94a7edac0e0df2cd18d1456cb26a06) [@bep](https://github.com/bep) [#4490](https://github.com/gohugoio/hugo/issues/4490)
+* Allow partial redefinition of the `ouputs` config [f8dc47ee](https://github.com/gohugoio/hugo/commit/f8dc47eeffa847fd0b51e376da355e3d957848a6) [@bep](https://github.com/bep) [#4487](https://github.com/gohugoio/hugo/issues/4487)
+* Add a way to merge pages by language [ffaec4ca](https://github.com/gohugoio/hugo/commit/ffaec4ca8c4c6fd05b195879ccd65acf2fd5a6ac) [@bep](https://github.com/bep) [#4463](https://github.com/gohugoio/hugo/issues/4463)
+* Extract `date` and `slug` from filename [68bf1511](https://github.com/gohugoio/hugo/commit/68bf1511f2be39b6576d882d071196e477c72c9f) [@bep](https://github.com/bep) [#285](https://github.com/gohugoio/hugo/issues/285)[#3310](https://github.com/gohugoio/hugo/issues/3310)[#3762](https://github.com/gohugoio/hugo/issues/3762)[#4340](https://github.com/gohugoio/hugo/issues/4340)
+* Add `Delete` method to delete key from `Scratch` [e46ab29b](https://github.com/gohugoio/hugo/commit/e46ab29bd24caa9e2cfa51f24ba15037750850d6) [@paulcmal](https://github.com/paulcmal)
+* Simplify Prev/Next [79dd7cb3](https://github.com/gohugoio/hugo/commit/79dd7cb31a941d7545df33b938ca3ed46593ddfd) [@bep](https://github.com/bep)
+* List Chroma lexers [2c54f1ad](https://github.com/gohugoio/hugo/commit/2c54f1ad48fe2a2f7504117d351d45abc89dcb1f) [@bep](https://github.com/bep) [#4554](https://github.com/gohugoio/hugo/issues/4554)
+* Add support for a `contentDir` set per language [eb42774e](https://github.com/gohugoio/hugo/commit/eb42774e587816b1fbcafbcea59ed65df703882a) [@bep](https://github.com/bep) [#4523](https://github.com/gohugoio/hugo/issues/4523)[#4552](https://github.com/gohugoio/hugo/issues/4552)[#4553](https://github.com/gohugoio/hugo/issues/4553)
+* Update Chroma [7a634898](https://github.com/gohugoio/hugo/commit/7a634898c359a6af0da52be17df07cae97c7937c) [@bep](https://github.com/bep) [#4549](https://github.com/gohugoio/hugo/issues/4549)
+* Add `.Site.IsServer` [1823c053](https://github.com/gohugoio/hugo/commit/1823c053c8900cb6ee53b8e5c02939c7398e34dd) [@felicianotech](https://github.com/felicianotech) [#4478](https://github.com/gohugoio/hugo/issues/4478)
+* Move to Ubuntu Trusty image [511d5d3b](https://github.com/gohugoio/hugo/commit/511d5d3b7681cb76822098f430ed6862232ca529) [@anthonyfok](https://github.com/anthonyfok)
+* Bump some deprecations [b6798ee8](https://github.com/gohugoio/hugo/commit/b6798ee8676c48f86b0bd8581ea244f4be4ef3fa) [@bep](https://github.com/bep)
+* Update Chroma to get `Go template support` [904a3d9d](https://github.com/gohugoio/hugo/commit/904a3d9ddf523d452d04d0b5814503e0ff17bd2e) [@bep](https://github.com/bep) [#4515](https://github.com/gohugoio/hugo/issues/4515)
+* Recover from error in server [f0052b6d](https://github.com/gohugoio/hugo/commit/f0052b6d0f8e113a50aeb6cd7bd34555dbf34a00) [@bep](https://github.com/bep) [#4516](https://github.com/gohugoio/hugo/issues/4516)
+* Spring test cleaning, take 2 [da880157](https://github.com/gohugoio/hugo/commit/da88015776645cc68b96e8b94030c95905df53ae) [@bep](https://github.com/bep)
+* Add docs for `lang.Merge` [70005364](https://github.com/gohugoio/hugo/commit/70005364a245ea3bc59c74192e1f4c56cb6879cf) [@bep](https://github.com/bep)
+* Remove archetype title/date warning [ac12d51e](https://github.com/gohugoio/hugo/commit/ac12d51e7ea3a0ffb7d8053a10b6bf6acf1235ae) [@bep](https://github.com/bep) [#4504](https://github.com/gohugoio/hugo/issues/4504)
+* Add docs on the new front matter configuration [0dbf79c2](https://github.com/gohugoio/hugo/commit/0dbf79c2f8cd5b1a5c91c04a8d677f956b0b8fe8) [@bep](https://github.com/bep) [#4495](https://github.com/gohugoio/hugo/issues/4495)
+* Refactor the GitInfo into the date handlers [ce6e4310](https://github.com/gohugoio/hugo/commit/ce6e4310febf5659392a41b543594382441f3681) [@bep](https://github.com/bep) [#4495](https://github.com/gohugoio/hugo/issues/4495)
+* Do not print build total when `--quiet` is set [50a03a5a](https://github.com/gohugoio/hugo/commit/50a03a5acc7c200c795590c3f4b964fdc56085f2) [@bep](https://github.com/bep) [#4456](https://github.com/gohugoio/hugo/issues/4456)
+
+## Fixes
+
+* Fix freeze in invalid front matter error case [93e24a03](https://github.com/gohugoio/hugo/commit/93e24a03ce98d3212a2d49ad04739141229d0809) [@bep](https://github.com/bep) [#4526](https://github.com/gohugoio/hugo/issues/4526)
+* Fix path duplication/flattening in processed images [3fbc7553](https://github.com/gohugoio/hugo/commit/3fbc75534d1acda2be1c597aa77c919d3a02659d) [@bep](https://github.com/bep) [#4502](https://github.com/gohugoio/hugo/issues/4502)[#4501](https://github.com/gohugoio/hugo/issues/4501)
+* Fix SVG and similar resource handling [ba94abbf](https://github.com/gohugoio/hugo/commit/ba94abbf5dd90f989242af8a7027d67a572a6128) [@bep](https://github.com/bep) [#4455](https://github.com/gohugoio/hugo/issues/4455)
+
+
+
+
diff --git a/docs/content/en/news/0.38.1-relnotes/index.md b/docs/content/en/news/0.38.1-relnotes/index.md
@@ -0,0 +1,32 @@
+
+---
+date: 2018-04-05
+title: "Hugo 0.38.1: Some Live Reload Fixes"
+description: "Hugo 0.38.1 fixes some live reload issues introduced in 0.38."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+
+
+This is a bug-fix that is mainly motivated by some issues with server live reloading introduced in Hugo 0.38.
+
+* Fix livereload for the home page bundle [f87239e4](https://github.com/gohugoio/hugo/commit/f87239e4cab958bf59ecfb1beb8cac439441a553) [@bep](https://github.com/bep) [#4576](https://github.com/gohugoio/hugo/issues/4576)
+* Fix empty BuildDate in "hugo version" [294c0f80](https://github.com/gohugoio/hugo/commit/294c0f8001fe598278c1eb8015deb6b98e8de686) [@anthonyfok](https://github.com/anthonyfok)
+* Fix some livereload content regressions [a4deaeff](https://github.com/gohugoio/hugo/commit/a4deaeff0cfd70abfbefa6d40c0b86839a216f6d) [@bep](https://github.com/bep) [#4566](https://github.com/gohugoio/hugo/issues/4566)
+* Update github.com/bep/gitmap to fix snap build [4d115c56](https://github.com/gohugoio/hugo/commit/4d115c56fac9060230fbac6181a05f7cc6d10b42) [@anthonyfok](https://github.com/anthonyfok) [#4538](https://github.com/gohugoio/hugo/issues/4538)
+* Fix two tests that are broken on Windows [26f34fd5](https://github.com/gohugoio/hugo/commit/26f34fd59da1ce1885d4f2909c5d9ef9c1726944) [@neurocline](https://github.com/neurocline)
+
+
+This release also contains some improvements:
+
+* Add bash completion [874159b5](https://github.com/gohugoio/hugo/commit/874159b5436bc9080aec71a9c26d35f8f62c9fd0) [@anthonyfok](https://github.com/anthonyfok)
+* Handle mass content etc. edits in server mode [730b66b6](https://github.com/gohugoio/hugo/commit/730b66b6520f263af16f555d1d7be51205a8e51d) [@bep](https://github.com/bep) [#4563](https://github.com/gohugoio/hugo/issues/4563)
+
+
+
+
+
+
diff --git a/docs/content/en/news/0.38.2-relnotes/index.md b/docs/content/en/news/0.38.2-relnotes/index.md
@@ -0,0 +1,26 @@
+
+---
+date: 2018-04-09
+title: "Hugo 0.38.2: Two Bugfixes"
+description: "0.38.2 fixes `--contentDir` flag handling and \".\" in content filenames."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+
+
+This is a bug-fix release with a couple of important fixes:
+
+
+* Fix handling of the `--contentDir` and possibly other related flags [080302eb](https://github.com/gohugoio/hugo/commit/080302eb8757fd94ccbd6bf99103432cd98e716c) [@bep](https://github.com/bep) [#4589](https://github.com/gohugoio/hugo/issues/4589)
+* Fix handling of content files with "." in them [2817e842](https://github.com/gohugoio/hugo/commit/2817e842407c8dcbfc738297ab634392fcb41ce1) [@bep](https://github.com/bep) [#4559](https://github.com/gohugoio/hugo/issues/4559)
+
+
+Also in this release:
+
+* Set .Parent in bundled pages to its owner [6792d86a](https://github.com/gohugoio/hugo/commit/6792d86ad028571c684a776c5f00e0107838c955) [@bep](https://github.com/bep) [#4582](https://github.com/gohugoio/hugo/issues/4582)
+
+
+
diff --git a/docs/content/news/0.39-relnotes/featured-hugo-39-poster.png b/docs/content/en/news/0.39-relnotes/featured-hugo-39-poster.png
Binary files differ.
diff --git a/docs/content/en/news/0.39-relnotes/index.md b/docs/content/en/news/0.39-relnotes/index.md
@@ -0,0 +1,87 @@
+
+---
+date: 2018-04-16
+title: "Hugo 0.39: The Nat King Cole Stabilizer Edition"
+description: "Hugo 0.39: Rewrite of the /commands package, `Resource.Content`, several new template funcs, and more …"
+categories: ["Releases"]
+---
+
+
+**Nat King Cole** was a fantastic American jazz pianist. When his bass player had visited the bar a little too often, he started with his percussive piano playing to keep the tempo flowing. Oscar Peterson called it _"Nat's stabilizers"_. This release is the software equivalent of that. We have been doing frequent main releases this year, but looking back, the patch releases that followed them seemed unneeded. And looking at the regressions, most of them stem from the `commands` package, a package that before this release was filled with globals and high coupling. This package is now rewritten and accompanied with decent test coverage.
+
+But this release isn't all boring and technical: It includes several important bug fixes, several useful new template functions, and `Resource.Content` allows you to get any resource's content without having to fiddle with file paths and `readFile`.
+
+This release represents **61 contributions by 4 contributors** to the main Hugo code base. A shout-out to [@bep](https://github.com/bep) for the implementation and [@it-gro](https://github.com/it-gro) and [@RickCogley](https://github.com/RickCogley) for the help testing it.
+
+[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions and his witty Norwegian humour, but also a big shoutout to [@anthonyfok](https://github.com/anthonyfok), [@thedodobird2](https://github.com/thedodobird2), and [@neurocline](https://github.com/neurocline) for their ongoing contributions.
+And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the themes site in pristine condition and to [@kaushalmodi](https://github.com/kaushalmodi) for his great work on the documentation site.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **6 contributions by 5 contributors**. A special thanks to [@kaushalmodi](https://github.com/kaushalmodi), [@regisphilibert](https://github.com/regisphilibert), [@bep](https://github.com/bep), and [@tomanistor](https://github.com/tomanistor) for their work on the documentation site.
+
+Hugo now has:
+
+* 24911+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 446+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 218+ [themes](http://themes.gohugo.io/)
+
+## Notes
+
+* The `main.Execute` function now returns a `Response` object and the global `Hugo` variable is removed. This is only relevant for people building some kind of API around Hugo.
+* Remove deprecated `File.Bytes` [94c8b29c](https://github.com/gohugoio/hugo/commit/94c8b29c39d0c485ee91d98c08fd615c28802496) [@bep](https://github.com/bep)
+
+## Enhancements
+
+### Templates
+
+* Add `anchorize` template func [4dba6ce1](https://github.com/gohugoio/hugo/commit/4dba6ce15ae9b5208b1e2d68c96d7b1dce0a07ab) [@bep](https://github.com/bep)
+* Add `path.Join` [880ca19f](https://github.com/gohugoio/hugo/commit/880ca19f209e68e6a8daa6686b361515ecacc91e) [@bep](https://github.com/bep)
+* Add `path.Split` template func [01b72eb5](https://github.com/gohugoio/hugo/commit/01b72eb592d0e0aefc5f7ae42f9f6ff112883bb6) [@bep](https://github.com/bep)
+
+### Other
+
+* Implement `Resource.Content` [0e7716a4](https://github.com/gohugoio/hugo/commit/0e7716a42450401c7998aa81ad2ed98c8ab109e8) [@bep](https://github.com/bep) [#4622](https://github.com/gohugoio/hugo/issues/4622)
+* Make `Page.Content` a method that returns interface{} [417c5e2b](https://github.com/gohugoio/hugo/commit/417c5e2b67b97fa80a0b6f77d259966f03b95344) [@bep](https://github.com/bep) [#4622](https://github.com/gohugoio/hugo/issues/4622)
+* Remove accidental and breaking space in baseURL flag [1b4e0c41](https://github.com/gohugoio/hugo/commit/1b4e0c4161fb631add62e77f494a7e62c3619020) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
+* Properly handle CLI slice arguments [27a524b0](https://github.com/gohugoio/hugo/commit/27a524b0905ec73c1eef233f94700feb9f465011) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
+* Correctly handle destination and i18n-warnings [bede93de](https://github.com/gohugoio/hugo/commit/bede93de005dcf934f3ec9be6388310ac6c57acd) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
+* Allow "*/" inside commented out shortcodes [14c35c8a](https://github.com/gohugoio/hugo/commit/14c35c8a56c4dc9a1ee0053e9ff976be7715ba99) [@bep](https://github.com/bep) [#4608](https://github.com/gohugoio/hugo/issues/4608)
+* Make commands.Execute return a Response object [96689a5c](https://github.com/gohugoio/hugo/commit/96689a5c319f720368491226f034d0ff9585217c) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Remove some TODOs [e7010c1b](https://github.com/gohugoio/hugo/commit/e7010c1b621d68ee53411a5ba8143d07b976d9fe) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Add basic server test [a7d00fc3](https://github.com/gohugoio/hugo/commit/a7d00fc39e87a5cac99b3a2380f5cc8c135d2b4b) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Remove the Hugo global [b110d0ae](https://github.com/gohugoio/hugo/commit/b110d0ae04e13fb45c739bcebb580709745082e6) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the limit command work again [73825cfc](https://github.com/gohugoio/hugo/commit/73825cfc1c0b007830b24bb1947a565175b52d36) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Move the commands related logic to its own file [a8f7fbbb](https://github.com/gohugoio/hugo/commit/a8f7fbbb10aa78f3ebac008d29d9969bb197393c) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Add CLI tests [e8d6ca95](https://github.com/gohugoio/hugo/commit/e8d6ca9531d19e4e898c57d77d2fd627ea38ade0) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the hugo command non-global [4d32f2fa](https://github.com/gohugoio/hugo/commit/4d32f2fa8969f368b088dc9bcedb45f2c986cb27) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Extract some common types into its own file [018602c4](https://github.com/gohugoio/hugo/commit/018602c46db8d729af2871bd5f4c1e7480420f09) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the server command non-global [2f0d98a1](https://github.com/gohugoio/hugo/commit/2f0d98a19b021d03930003217b0519afaef3a391) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the gen commands non-global [e0621d20](https://github.com/gohugoio/hugo/commit/e0621d207ce3278a82f8a60607e9cdd304149029) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the list commands non-global [e26a8b24](https://github.com/gohugoio/hugo/commit/e26a8b242a6434117d089a0799238add7025dbf4) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the import commands non-global [2a2c9838](https://github.com/gohugoio/hugo/commit/2a2c9838671b5401331d20f8c72e2b934fe34e8d) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the config command non-global [15b1e269](https://github.com/gohugoio/hugo/commit/15b1e269ade91ddc6a74c552bc61b0c5e527d268) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make the new commands non-global [56a13080](https://github.com/gohugoio/hugo/commit/56a13080446283ed1cde6b69fc6f4fac85076c84) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make convert command non-global [4b780ca7](https://github.com/gohugoio/hugo/commit/4b780ca778ee7f25af808da38ede964a01698c70) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make more commands non-global [7bc5e89f](https://github.com/gohugoio/hugo/commit/7bc5e89fbaa5c613b8853ff7b69fae570bd0b56d) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Make benchmark non-global [fdf1d94e](https://github.com/gohugoio/hugo/commit/fdf1d94ebc7d1aa4855c62237f2edbd4bdade1a7) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Start of flag cleaning [1157fef8](https://github.com/gohugoio/hugo/commit/1157fef85908ea54883fe0dba6adc4861ba02162) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Use short date format in CLI docs [e614d8a5](https://github.com/gohugoio/hugo/commit/e614d8a57c2ff5eef9270d51fcc6518398d7ff88) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Update README.md [fca49d6c](https://github.com/gohugoio/hugo/commit/fca49d6c608d227049cb2f26895cfecc685f1c89) [@thedodobird2](https://github.com/thedodobird2)
+* Sync dependencies [0e8b3cbc](https://github.com/gohugoio/hugo/commit/0e8b3cbcd274e1f2e14be694c794a544f49efb56) [@bep](https://github.com/bep)
+* Bump Go versions [230f2b8c](https://github.com/gohugoio/hugo/commit/230f2b8c4fce03f14847de2b22402e64d4d69783) [@bep](https://github.com/bep) [#4545](https://github.com/gohugoio/hugo/issues/4545)
+* Add bash completion [874159b5](https://github.com/gohugoio/hugo/commit/874159b5436bc9080aec71a9c26d35f8f62c9fd0) [@anthonyfok](https://github.com/anthonyfok)
+* Handle mass content etc. edits in server mode [730b66b6](https://github.com/gohugoio/hugo/commit/730b66b6520f263af16f555d1d7be51205a8e51d) [@bep](https://github.com/bep) [#4563](https://github.com/gohugoio/hugo/issues/4563)
+
+## Fixes
+
+* Fix `livereload` of bundled pages [f3775877](https://github.com/gohugoio/hugo/commit/f3775877c61c11ab7c8fd1fc3e15470bf5da4820) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
+* Do not reset `.Page.Scratch` on rebuilds [61d52f14](https://github.com/gohugoio/hugo/commit/61d52f146297950e283ae086d8b1af61099d22a0) [@bep](https://github.com/bep) [#4627](https://github.com/gohugoio/hugo/issues/4627)
+* Fix failing Travis server test [9c782d51](https://github.com/gohugoio/hugo/commit/9c782d5147bfea0dd85cf3374f598f0176f204eb) [@bep](https://github.com/bep)
+* Fix the config command [f396cffa](https://github.com/gohugoio/hugo/commit/f396cffa239e948075af2224208671956d8b4a84) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Fix some flag diff [24d5c219](https://github.com/gohugoio/hugo/commit/24d5c219424a9777bb1dd366b43e68e6f47e1adb) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Fix TestFixURL [1e233b1c](https://github.com/gohugoio/hugo/commit/1e233b1c4598fd8cbce7da8a67bf2c4918c6047e) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
+* Disable shallow clone to fix TestPageWithLastmodFromGitInfo [094ec171](https://github.com/gohugoio/hugo/commit/094ec171420e659cdf962a19dd90105912ce9901) [@anthonyfok](https://github.com/anthonyfok) [#4584](https://github.com/gohugoio/hugo/issues/4584)
+* Fix livereload for the home page bundle [f87239e4](https://github.com/gohugoio/hugo/commit/f87239e4cab958bf59ecfb1beb8cac439441a553) [@bep](https://github.com/bep) [#4576](https://github.com/gohugoio/hugo/issues/4576)
+* Fix empty `BuildDate` in "hugo version" [294c0f80](https://github.com/gohugoio/hugo/commit/294c0f8001fe598278c1eb8015deb6b98e8de686) [@anthonyfok](https://github.com/anthonyfok)
+* Fix some livereload content regressions [a4deaeff](https://github.com/gohugoio/hugo/commit/a4deaeff0cfd70abfbefa6d40c0b86839a216f6d) [@bep](https://github.com/bep) [#4566](https://github.com/gohugoio/hugo/issues/4566)
+* Fix two tests that are broken on Windows [26f34fd5](https://github.com/gohugoio/hugo/commit/26f34fd59da1ce1885d4f2909c5d9ef9c1726944) [@neurocline](https://github.com/neurocline)
diff --git a/docs/content/en/news/0.40-relnotes/featured-hugo-40-poster.png b/docs/content/en/news/0.40-relnotes/featured-hugo-40-poster.png
Binary files differ.
diff --git a/docs/content/en/news/0.40-relnotes/index.md b/docs/content/en/news/0.40-relnotes/index.md
@@ -0,0 +1,76 @@
+
+---
+date: 2018-04-23
+title: "Hugo 0.40: The Revival of the Shortcodes"
+description: "Hugo 0.40: Shortcodes with `.Content` (almost) always available, processed in order of appearance, several new template funcs …"
+categories: ["Releases"]
+---
+
+Hugo `0.40` is **The Revival of the Shortcodes**. Shortcodes is one of the prime features in Hugo. Really useful, but it has had some known shortcomings. [@bep](https://github.com/bep) has been really busy the last week to address those.
+
+In summary:
+
+* `.Content` for a page retrieved in a query in a shortcode is now _almost_ always available. Note that shortcodes can include content that can include shortcodes that can include content... It is possible to bite your tail. See more below.
+* Shortcodes are now processed and rendered in their order of appearance.
+* Related to the above, we have now added a zero-based `.Ordinal` to the shortcode.
+
+
+The first bullet above resolves some surprising behaviour when reading other pages' content from shortcodes. Before this release, that behaviour was undefined. Note that this has never been an issue from regular templates.
+
+It will still not be possible to get **the current shortcode's page's rendered content**. That would have impressed Einstein.
+
+The new and well defined rules are:
+
+* `.Page.Content` from a shortcode will be empty. The related `.Page.Truncated` `.Page.Summary`, `.Page.WordCount`, `.Page.ReadingTime`, `.Page.Plain` and `.Page.PlainWords` will also have empty values.
+* For _other pages_ (retrieved via `.Page.Site.GetPage`, `.Site.Pages` etc.) the `.Content` is there to use as you please as long as you don't have infinite content recursion in your shortcode/content setup. See below.
+* `.Page.TableOfContents` is good to go (but does not support shortcodes in headlines; this is unchanged)
+
+If you get into a situation of infinite recursion, the `.Content` will be empty. Run `hugo -v` for more information.
+
+This release represents **19 contributions by 3 contributors** to the main Hugo code base.
+
+Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
+which has received **13 contributions by 6 contributors**. A special thanks to [@kaushalmodi](https://github.com/kaushalmodi), [@anthonyfok](https://github.com/anthonyfok), [@bep](https://github.com/bep), and [@regisphilibert](https://github.com/regisphilibert) for their work on the documentation site.
+
+
+Hugo now has:
+
+* 25071+ [stars](https://github.com/gohugoio/hugo/stargazers)
+* 446+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
+* 222+ [themes](http://themes.gohugo.io/)
+
+## Notes
+
+* We have added a `timeout` configuration setting. This is currently only used to time out the `.Content` creation, to bail out of recursive recursions. Run `hugo -v` to see potential warnings about this. The `timeout` is set default to `10000` (10 seconds).
+
+## Enhancements
+
+### Templates
+
+* Add `path.Ext`, `path.Dir` and `path.Base` [47e7788b](https://github.com/gohugoio/hugo/commit/47e7788b3c30de6fb895522096baf2c13598c317) [@bep](https://github.com/bep)
+* Make `fileExist` use the same filesystem as `readFile` [51af1d2e](https://github.com/gohugoio/hugo/commit/51af1d2eadcad89e8c2906c05549352ef69ab016) [@bep](https://github.com/bep) [#4633](https://github.com/gohugoio/hugo/issues/4633)
+
+### Other
+
+* Add `.Page.BundleType` [402f6788](https://github.com/gohugoio/hugo/commit/402f6788ee955ad2aace84e8fba1625db7b356d9) [@bep](https://github.com/bep) [#4662](https://github.com/gohugoio/hugo/issues/4662)
+* Add zero-based `Ordinal` to shortcode [3decf4a3](https://github.com/gohugoio/hugo/commit/3decf4a327157e98d3da3502b6d777de63437c39) [@bep](https://github.com/bep) [#3359](https://github.com/gohugoio/hugo/issues/3359)
+* Process and render shortcodes in their order of appearance [85535084](https://github.com/gohugoio/hugo/commit/85535084dea4d3e3adf1ebd08ae57b39d76e1904) [@bep](https://github.com/bep) [#3359](https://github.com/gohugoio/hugo/issues/3359)
+* Init the content and shortcodes early [19084eaf](https://github.com/gohugoio/hugo/commit/19084eaf74246feac61d618c55031369520dfa8e) [@bep](https://github.com/bep) [#4632](https://github.com/gohugoio/hugo/issues/4632)
+* Prepare child page resources before the page itself [3238e14f](https://github.com/gohugoio/hugo/commit/3238e14fdfeedf189a5af122e20bff040ac059bd) [@bep](https://github.com/bep) [#4632](https://github.com/gohugoio/hugo/issues/4632)
+* Make .Content (almost) always available in shortcodes [4d26ab33](https://github.com/gohugoio/hugo/commit/4d26ab33dcef704086f43828d1dfb4b8beae2593) [@bep](https://github.com/bep) [#4632](https://github.com/gohugoio/hugo/issues/4632)[#4653](https://github.com/gohugoio/hugo/issues/4653)[#4655](https://github.com/gohugoio/hugo/issues/4655)
+* Add language merge support for Pages in resource.Resources [47c05c47](https://github.com/gohugoio/hugo/commit/47c05c47e0b663632a649ee5d256acc1a32fe9e4) [@bep](https://github.com/bep) [#4644](https://github.com/gohugoio/hugo/issues/4644)
+* Improve .Content vs shortcodes [e590cc26](https://github.com/gohugoio/hugo/commit/e590cc26eb1363a4b84603f051b20bd43fd1f7bd) [@bep](https://github.com/bep) [#4632](https://github.com/gohugoio/hugo/issues/4632)
+* Improve .Get docs [74520d2c](https://github.com/gohugoio/hugo/commit/74520d2cfd39bb4428182e26c57afa9df83ce7b5) [@paulcmal](https://github.com/paulcmal)
+* Update missing positional parameter test for .Get [e2b277bb](https://github.com/gohugoio/hugo/commit/e2b277bba5935c0686cb83f132eae021ef2dc5e1) [@paulcmal](https://github.com/paulcmal)
+* Improve error message in metadata parse [d681ea55](https://github.com/gohugoio/hugo/commit/d681ea55a0a59b7096dacd194ee0cb8fe15b0757) [@bep](https://github.com/bep) [#3696](https://github.com/gohugoio/hugo/issues/3696)
+* Add some context to front matter parse error [159bed34](https://github.com/gohugoio/hugo/commit/159bed34c3a850d58d08a36ddc40372ed96af2db) [@bep](https://github.com/bep) [#4638](https://github.com/gohugoio/hugo/issues/4638)
+* Updated GetCSV error message (#4636) [5cc944ff](https://github.com/gohugoio/hugo/commit/5cc944ffd77289ab0b8efd69d628fb11d1280993) [@CubeLuke](https://github.com/CubeLuke)
+* .Get doesn't crash on missing positional param fixes #4619 [236f0c84](https://github.com/gohugoio/hugo/commit/236f0c840b45e0c41fcbb2fb6ee556c0fb2d4859) [@paulcmal](https://github.com/paulcmal)
+* fix syntax signature [cd6a2612](https://github.com/gohugoio/hugo/commit/cd6a261242b63555ac2c3ca7a8462b874b490701) [@paulcmal](https://github.com/paulcmal)
+
+
+
+
+
+
+
diff --git a/docs/content/en/news/0.40.1-relnotes/index.md b/docs/content/en/news/0.40.1-relnotes/index.md
@@ -0,0 +1,19 @@
+
+---
+date: 2018-04-25
+title: "Hugo 0.40.1: One Bug Fix"
+description: "Fixes some shortcode vs .Content corner cases."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+
+
+This release fixes some shortcode vs `.Content` corner cases introduced in Hugo `0.40` [288c3964](https://github.com/gohugoio/hugo/commit/288c39643906b4194a0a6acfbaf87cb0fbdeb361) [@bep](https://github.com/bep) [#4632](https://github.com/gohugoio/hugo/issues/4632)[#4664](https://github.com/gohugoio/hugo/issues/4664).
+
+
+
+
+
diff --git a/docs/content/en/news/0.40.2-relnotes/index.md b/docs/content/en/news/0.40.2-relnotes/index.md
@@ -0,0 +1,20 @@
+
+---
+date: 2018-04-30
+title: "Hugo 0.40.2: Two Bug fixes"
+description: "Fixes some regressions introduced in 0.40."
+categories: ["Releases"]
+images:
+- images/blog/hugo-bug-poster.png
+
+---
+
+This release fixes some regressions introduced in Hugo `0.40`. See the [milestone](https://github.com/gohugoio/hugo/milestone/62?closed=1) for an issue list.
+
+* Reset .Page.Scratch on live-reload [655983a2](https://github.com/gohugoio/hugo/commit/655983a22dc35b2ee5119dcc4acb9918498d2d68) [@bep](https://github.com/bep) [#4683](https://github.com/gohugoio/hugo/issues/4683)
+* Fix .WordCount, .FuzzyWordCount, .ReadingTime when summary marker is set [001a28c2](https://github.com/gohugoio/hugo/commit/001a28c2f9ed121b33df18fe792859ab378784c6) [@bep](https://github.com/bep) [#4675](https://github.com/gohugoio/hugo/issues/4675)[#4682](https://github.com/gohugoio/hugo/issues/4682)
+
+
+
+
+
diff --git a/docs/content/news/_index.md b/docs/content/en/news/_index.md
diff --git a/docs/content/news/http2-server-push-in-hugo.md b/docs/content/en/news/http2-server-push-in-hugo.md
diff --git a/docs/content/readfiles/README.md b/docs/content/en/readfiles/README.md
diff --git a/docs/content/readfiles/bfconfig.md b/docs/content/en/readfiles/bfconfig.md
diff --git a/docs/content/readfiles/dateformatting.md b/docs/content/en/readfiles/dateformatting.md
diff --git a/docs/content/readfiles/index.md b/docs/content/en/readfiles/index.md
diff --git a/docs/content/readfiles/menuvars.md b/docs/content/en/readfiles/menuvars.md
diff --git a/docs/content/readfiles/sectionvars.md b/docs/content/en/readfiles/sectionvars.md
diff --git a/docs/content/readfiles/testing.txt b/docs/content/en/readfiles/testing.txt
diff --git a/docs/content/showcase/1password-support/bio.md b/docs/content/en/showcase/1password-support/bio.md
diff --git a/docs/content/showcase/1password-support/featured.png b/docs/content/en/showcase/1password-support/featured.png
Binary files differ.
diff --git a/docs/content/showcase/1password-support/index.md b/docs/content/en/showcase/1password-support/index.md
diff --git a/docs/content/en/showcase/flesland-flis/bio.md b/docs/content/en/showcase/flesland-flis/bio.md
@@ -0,0 +1,8 @@
+
+A business page for Flesland Flis AS. A Norwegian Tiler located in Bergen.
+
+The page is designed and developed by Sindre Gusdal:
+
+* [Absoluttweb AS](http://www.absoluttweb.no)
+* [Sindre Gusdal](https://www.linkedin.com/in/sindregusdal/)
+
diff --git a/docs/content/en/showcase/flesland-flis/featured.png b/docs/content/en/showcase/flesland-flis/featured.png
Binary files differ.
diff --git a/docs/content/en/showcase/flesland-flis/index.md b/docs/content/en/showcase/flesland-flis/index.md
@@ -0,0 +1,24 @@
+---
+
+title: Flesland Flis AS
+date: 2018-04-24
+description: "showcase: Business Page for a tile shop in Bergen, Norway"
+siteURL: https://www.fleslandflis.no
+byline: "[Sindre Gusdal](http://www.absoluttweb.no), Absoluttweb AS"
+
+---
+
+For **Flesland Flis** I use a combination of **Hugo, Forestry.io and Netlify**. Static Site Generators and Hugo has been on my radar for a long time, and with all the nice features released in Hugo the last years, it's now my preferred solution for new clients. Also a huge thanks to the guys at [Forestry.io](https://forestry.io), for making such a smooth CMS for Hugo.
+
+The #1 reason why I love Hugo is the logic between content and layout, and of course the speed. Compared to solutions like Jekyll, Hugo is just better at all the stuff I value the most - speed, flexibility, theming and more.
+
+### Thanks, Hugo!
+
+Today I use Hugo in a combination with GULP and Foundation 6 + my own Hugo starter theme. This works great for me, and gives me all the flexibility I need. Then I can include FancyBox, Responsive Text and other Node Modules when needed.
+
+In the past I had to do a lot of changes to layout, content and css, if the client f.ex needed an extra PDF or an image-gallery to a certain page. Just small details not fitting in the template, would be a hassle. So updating existing webpages was boring and time consuming.
+
+Today I just copy-paste a new layout file, adds some frontmatter, Pushes to GIT and that special page is done.
+
+**Gotta love it:)**
+
diff --git a/docs/content/showcase/forestry/bio.md b/docs/content/en/showcase/forestry/bio.md
diff --git a/docs/content/showcase/forestry/featured.png b/docs/content/en/showcase/forestry/featured.png
Binary files differ.
diff --git a/docs/content/showcase/forestry/index.md b/docs/content/en/showcase/forestry/index.md
diff --git a/docs/content/showcase/hartwell-insurance/bio.md b/docs/content/en/showcase/hartwell-insurance/bio.md
diff --git a/docs/content/showcase/hartwell-insurance/featured.png b/docs/content/en/showcase/hartwell-insurance/featured.png
Binary files differ.
diff --git a/docs/content/showcase/hartwell-insurance/hartwell-columns.png b/docs/content/en/showcase/hartwell-insurance/hartwell-columns.png
Binary files differ.
diff --git a/docs/content/showcase/hartwell-insurance/hartwell-lighthouse.png b/docs/content/en/showcase/hartwell-insurance/hartwell-lighthouse.png
Binary files differ.
diff --git a/docs/content/showcase/hartwell-insurance/hartwell-webpagetest.png b/docs/content/en/showcase/hartwell-insurance/hartwell-webpagetest.png
Binary files differ.
diff --git a/docs/content/showcase/hartwell-insurance/index.md b/docs/content/en/showcase/hartwell-insurance/index.md
diff --git a/docs/content/showcase/letsencrypt/bio.md b/docs/content/en/showcase/letsencrypt/bio.md
diff --git a/docs/content/showcase/letsencrypt/featured.png b/docs/content/en/showcase/letsencrypt/featured.png
Binary files differ.
diff --git a/docs/content/showcase/letsencrypt/index.md b/docs/content/en/showcase/letsencrypt/index.md
diff --git a/docs/content/showcase/linode/bio.md b/docs/content/en/showcase/linode/bio.md
diff --git a/docs/content/showcase/linode/featured.png b/docs/content/en/showcase/linode/featured.png
Binary files differ.
diff --git a/docs/content/showcase/linode/index.md b/docs/content/en/showcase/linode/index.md
diff --git a/docs/content/showcase/pace-revenue-management/bio.md b/docs/content/en/showcase/pace-revenue-management/bio.md
diff --git a/docs/content/showcase/pace-revenue-management/featured.png b/docs/content/en/showcase/pace-revenue-management/featured.png
Binary files differ.
diff --git a/docs/content/showcase/pace-revenue-management/index.md b/docs/content/en/showcase/pace-revenue-management/index.md
diff --git a/docs/content/showcase/quiply-employee-communications-app/bio.md b/docs/content/en/showcase/quiply-employee-communications-app/bio.md
diff --git a/docs/content/showcase/quiply-employee-communications-app/featured.png b/docs/content/en/showcase/quiply-employee-communications-app/featured.png
Binary files differ.
diff --git a/docs/content/showcase/quiply-employee-communications-app/index.md b/docs/content/en/showcase/quiply-employee-communications-app/index.md
diff --git a/docs/content/showcase/small-multiples/bio.md b/docs/content/en/showcase/small-multiples/bio.md
diff --git a/docs/content/showcase/small-multiples/featured-small-multiples.png b/docs/content/en/showcase/small-multiples/featured-small-multiples.png
Binary files differ.
diff --git a/docs/content/showcase/small-multiples/index.md b/docs/content/en/showcase/small-multiples/index.md
diff --git a/docs/content/showcase/stackimpact/bio.md b/docs/content/en/showcase/stackimpact/bio.md
diff --git a/docs/content/showcase/stackimpact/featured.png b/docs/content/en/showcase/stackimpact/featured.png
Binary files differ.
diff --git a/docs/content/showcase/stackimpact/index.md b/docs/content/en/showcase/stackimpact/index.md
diff --git a/docs/content/showcase/template/bio.md b/docs/content/en/showcase/template/bio.md
diff --git a/docs/content/showcase/template/featured-template.png b/docs/content/en/showcase/template/featured-template.png
Binary files differ.
diff --git a/docs/content/showcase/template/index.md b/docs/content/en/showcase/template/index.md
diff --git a/docs/content/templates/404.md b/docs/content/en/templates/404.md
diff --git a/docs/content/templates/_index.md b/docs/content/en/templates/_index.md
diff --git a/docs/content/templates/alternatives.md b/docs/content/en/templates/alternatives.md
diff --git a/docs/content/templates/base.md b/docs/content/en/templates/base.md
diff --git a/docs/content/templates/data-templates.md b/docs/content/en/templates/data-templates.md
diff --git a/docs/content/en/templates/files.md b/docs/content/en/templates/files.md
@@ -0,0 +1,115 @@
+---
+title: Local File Templates
+linktitle: Local File Templates
+description: Hugo's `readerDir` and `readFile` functions make it easy to traverse your project's directory structure and write file contents to your templates.
+godocref: https://golang.org/pkg/os/#FileInfo
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [templates]
+keywords: [files,directories]
+menu:
+ docs:
+ parent: "templates"
+ weight: 110
+weight: 110
+sections_weight: 110
+draft: false
+aliases: [/extras/localfiles/,/templates/local-files/]
+toc: true
+---
+
+## Traverse Local Files
+
+With Hugo's [`readDir`][readDir] and [`readFile`][readFile] template functions, you can traverse your website's files on your server.
+
+## Use `readDir`
+
+The [`readDir` function][readDir] returns an array of [`os.FileInfo`][osfileinfo]. It takes the file's `path` as a single string argument. This path can be to any directory of your website (i.e., as found on your server's file system).
+
+Whether the path is absolute or relative does not matter because---at least for `readDir`---the root of your website (typically `./public/`) in effect becomes both:
+
+1. The file system root
+2. The current working directory
+
+### `readDir` Example: List Directory Files
+
+This shortcode creates a link to each of the files in a directory---display as the file's basename---along with the file's size in bytes.
+
+{{< code file="layouts/shortcodes/directoryindex.html" download="directoryindex.html" >}}
+{{< readfile file="/themes/gohugoioTheme/layouts/shortcodes/directoryindex.html" >}}
+{{< /code >}}
+
+You can then call the shortcode as follows inside of your content's markup:
+
+```
+{{</* directoryindex path="/static/css" pathURL="/css" */>}}
+```
+
+The above shortcode [is part of the code for the Hugo docs][dirindex]. Here it lists this site's CSS files:
+
+{{< directoryindex path="/themes/gohugoioTheme/static/dist" pathURL="/css" >}}
+
+{{% note "Slashes are Important" %}}
+The initial slash `/` in `pathURL` is important in the `directoryindex` shortcode. Otherwise, `pathURL` becomes relative to the current web page.
+{{% /note %}}
+
+## Use `readFile`
+
+The [`readfile` function][readFile] reads a file from disk and converts it into a string to be manipulated by other Hugo functions or added as-is. `readFile` takes the file, including path, as an argument passed to the function.
+
+To use the `readFile` function in your templates, make sure the path is relative to your *Hugo project's root directory*:
+
+```
+{{ readFile "/content/templates/local-file-templates" }}
+```
+
+### `readFile` Example: Add a Project File to Content
+
+As `readFile` is a function, it is only available to you in your templates and not your content. However, we can create a simple [shortcode template][sct] that calls `readFile`, passes the first argument through the function, and then allows an optional second argument to send the file through the Blackfriday markdown processor. The pattern for adding this shortcode to your content will be as follows:
+
+```
+{{</* readfile file="/path/to/local/file.txt" markdown="true" */>}}
+```
+
+{{% warning %}}
+If you are going to create [custom shortcodes](/templates/shortcode-templates/) with `readFile` for a theme, note that usage of the shortcode will refer to the project root and *not* your `themes` directory.
+{{% /warning %}}
+
+Here is the templating for our new `readfile` shortcode:
+
+{{< code file="layouts/shortcodes/readfile.html" download="readfile.html" >}}
+{{< readfile file="/themes/gohugoioTheme/layouts/shortcodes/readfile.html">}}
+{{< /code >}}
+
+This `readfile` shortcode is [also part of the Hugo docs][readfilesource]. So is [`testing.txt`][testfile], which we will call in this example by passing it into our new `readfile` shortcode as follows:
+
+```
+{{</* readfile file="/content/en/readfiles/testing.txt" */>}}
+```
+
+The output "string" for this shortcode declaration will be the following:
+
+```
+{{< readfile file="/content/en/readfiles/testing.txt" >}}
+```
+
+However, if we want Hugo to pass this string through Blackfriday, we should add the `markdown="true"` optional parameter:
+
+```
+{{</* readfile file="/content/en/readfiles/testing.txt" markdown="true" */>}}
+```
+
+And here is the result as [called directly in the Hugo docs][] and rendered for display:
+
+{{< readfile file="/content/en/readfiles/testing.txt" markdown="true">}}
+
+[called directly in the Hugo docs]: https://github.com/gohugoio/hugo/blob/master/docs/content/templates/files.md
+[dirindex]: https://github.com/gohugoio/hugo/blob/master/docs/layouts/shortcodes/directoryindex.html
+[osfileinfo]: https://golang.org/pkg/os/#FileInfo
+[readDir]: /functions/readdir/
+[readFile]: /functions/readfile/
+[sc]: /content-management/shortcodes/
+[sct]: /templates/shortcode-templates/
+[readfilesource]: https://github.com/gohugoio/hugo/blob/master/
+[testfile]: https://github.com/gohugoio/hugo/blob/master/docs/testfile
diff --git a/docs/content/templates/homepage.md b/docs/content/en/templates/homepage.md
diff --git a/docs/content/templates/internal.md b/docs/content/en/templates/internal.md
diff --git a/docs/content/templates/introduction.md b/docs/content/en/templates/introduction.md
diff --git a/docs/content/templates/lists.md b/docs/content/en/templates/lists.md
diff --git a/docs/content/templates/lookup-order.md b/docs/content/en/templates/lookup-order.md
diff --git a/docs/content/templates/menu-templates.md b/docs/content/en/templates/menu-templates.md
diff --git a/docs/content/templates/ordering-and-grouping.md b/docs/content/en/templates/ordering-and-grouping.md
diff --git a/docs/content/templates/output-formats.md b/docs/content/en/templates/output-formats.md
diff --git a/docs/content/templates/pagination.md b/docs/content/en/templates/pagination.md
diff --git a/docs/content/templates/partials.md b/docs/content/en/templates/partials.md
diff --git a/docs/content/templates/robots.md b/docs/content/en/templates/robots.md
diff --git a/docs/content/en/templates/rss.md b/docs/content/en/templates/rss.md
@@ -0,0 +1,127 @@
+---
+title: RSS Templates
+linktitle: RSS Templates
+description: Hugo ships with its own RSS 2.0 template that requires almost no configuration, or you can create your own RSS templates.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+keywords: [rss, xml, templates]
+categories: [templates]
+menu:
+ docs:
+ parent: "templates"
+ weight: 150
+weight: 150
+sections_weight: 150
+draft: false
+aliases: [/templates/rss/]
+toc: true
+---
+
+## RSS Template Lookup Order
+
+See [Template Lookup Order](/templates/lookup-order/) for the complete reference.
+
+{{% note "Hugo Ships with an RSS Template" %}}
+Hugo ships with its own [RSS 2.0 template](#the-embedded-rss-xml). The embedded template will be sufficient for most use cases.
+{{% /note %}}
+
+RSS pages are of the type `Page` and have all the [page variables](/variables/page/) available to use in the templates.
+
+### Section RSS
+
+A [section’s][section] RSS will be rendered at `/<SECTION>/index.xml` (e.g., http://spf13.com/project/index.xml).
+
+Hugo provides the ability for you to define any RSS type you wish and can have different RSS files for each section and taxonomy.
+
+## Lookup Order for RSS Templates
+
+The table below shows the RSS template lookup order for the different page kinds. The first listing shows the lookup order when running with a theme (`demoTheme`).
+
+{{< datatable-filtered "output" "layouts" "OutputFormat == RSS" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
+
+## Configure RSS
+
+By default, Hugo will create an unlimited number of RSS entries. You can limit the number of articles included in the built-in RSS templates by assigning a numeric value to `rssLimit:` field in your project's [`config` file][config].
+
+The following values will also be included in the RSS output if specified in your site’s configuration:
+
+```toml
+languageCode = "en-us"
+copyright = "This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License."
+
+[author]
+ name = "My Name Here"
+```
+
+## The Embedded rss.xml
+
+This is the default RSS template that ships with Hugo. It adheres to the [RSS 2.0 Specification][RSS 2.0].
+
+```xml
+<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
+ <channel>
+ <title>{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title>
+ <link>{{ .Permalink }}</link>
+ <description>Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}</description>
+ <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }}
+ <language>{{.}}</language>{{end}}{{ with .Site.Author.email }}
+ <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }}
+ <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
+ <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }}
+ <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
+ {{ with .OutputFormats.Get "RSS" }}
+ {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
+ {{ end }}
+ {{ range .Data.Pages }}
+ <item>
+ <title>{{ .Title }}</title>
+ <link>{{ .Permalink }}</link>
+ <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
+ {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}}
+ <guid>{{ .Permalink }}</guid>
+ <description>{{ .Summary | html }}</description>
+ </item>
+ {{ end }}
+ </channel>
+</rss>
+```
+
+{{% warning "XML Header" %}}
+Hugo will automatically add the following header line to this file on render. Please do *not* include this in the template as it's not valid HTML.
+```
+<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
+```
+{{% /warning %}}
+
+## Reference your RSS Feed in `<head>`
+
+In your `header.html` template, you can specify your RSS feed in your `<head></head>` tag using Hugo's [Output Formats][Output Formats] like this:
+
+```go-html-template
+{{ range .AlternativeOutputFormats -}}
+ {{ printf `<link rel="%s" type="%s+%s" href="%s" title="%s" />` .Rel .MediaType.Type .MediaType.Suffix .Permalink $.Site.Title | safeHTML }}
+{{ end -}}
+```
+
+If you only want the RSS link, you can query the formats:
+
+```go-html-template
+{{ with .OutputFormats.Get "rss" -}}
+ {{ printf `<link rel="%s" type="%s+%s" href="%s" title="%s" />` .Rel .MediaType.Type .MediaType.Suffix .Permalink $.Site.Title | safeHTML }}
+{{ end -}}
+```
+
+Either of the two snippets above will generate the below `link` tag on the site homepage for RSS output:
+
+```html
+<link rel="alternate" type="application/rss+xml" href="https://example.com/index.xml" title="Site Title">
+```
+
+_We are assuming `BaseURL` to be `https://example.com/` and `$.Site.Title` to be `"Site Title"` in this example._
+
+[config]: /getting-started/configuration/
+[embedded]: #the-embedded-rss-xml
+[RSS 2.0]: http://cyber.law.harvard.edu/rss/rss.html "RSS 2.0 Specification"
+[section]: /content-management/sections/
+[Output Formats]: /templates/output-formats/#link-to-output-formats
diff --git a/docs/content/templates/section-templates.md b/docs/content/en/templates/section-templates.md
diff --git a/docs/content/templates/shortcode-templates.md b/docs/content/en/templates/shortcode-templates.md
diff --git a/docs/content/templates/single-page-templates.md b/docs/content/en/templates/single-page-templates.md
diff --git a/docs/content/templates/sitemap-template.md b/docs/content/en/templates/sitemap-template.md
diff --git a/docs/content/templates/taxonomy-templates.md b/docs/content/en/templates/taxonomy-templates.md
diff --git a/docs/content/templates/template-debugging.md b/docs/content/en/templates/template-debugging.md
diff --git a/docs/content/templates/views.md b/docs/content/en/templates/views.md
diff --git a/docs/content/themes/_index.md b/docs/content/en/themes/_index.md
diff --git a/docs/content/themes/creating.md b/docs/content/en/themes/creating.md
diff --git a/docs/content/themes/customizing.md b/docs/content/en/themes/customizing.md
diff --git a/docs/content/themes/installing-and-using-themes.md b/docs/content/en/themes/installing-and-using-themes.md
diff --git a/docs/content/tools/_index.md b/docs/content/en/tools/_index.md
diff --git a/docs/content/tools/editors.md b/docs/content/en/tools/editors.md
diff --git a/docs/content/tools/frontends.md b/docs/content/en/tools/frontends.md
diff --git a/docs/content/tools/migrations.md b/docs/content/en/tools/migrations.md
diff --git a/docs/content/tools/other.md b/docs/content/en/tools/other.md
diff --git a/docs/content/tools/search.md b/docs/content/en/tools/search.md
diff --git a/docs/content/tools/starter-kits.md b/docs/content/en/tools/starter-kits.md
diff --git a/docs/content/troubleshooting/_index.md b/docs/content/en/troubleshooting/_index.md
diff --git a/docs/content/troubleshooting/build-performance.md b/docs/content/en/troubleshooting/build-performance.md
diff --git a/docs/content/troubleshooting/faq.md b/docs/content/en/troubleshooting/faq.md
diff --git a/docs/content/variables/_index.md b/docs/content/en/variables/_index.md
diff --git a/docs/content/variables/files.md b/docs/content/en/variables/files.md
diff --git a/docs/content/variables/git.md b/docs/content/en/variables/git.md
diff --git a/docs/content/variables/hugo.md b/docs/content/en/variables/hugo.md
diff --git a/docs/content/variables/menus.md b/docs/content/en/variables/menus.md
diff --git a/docs/content/en/variables/page.md b/docs/content/en/variables/page.md
@@ -0,0 +1,286 @@
+---
+title: Page Variables
+linktitle:
+description: Page-level variables are defined in a content file's front matter, derived from the content's file location, or extracted from the content body itself.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [variables and params]
+keywords: [pages]
+draft: false
+menu:
+ docs:
+ title: "variables defined by a page"
+ parent: "variables"
+ weight: 20
+weight: 20
+sections_weight: 20
+aliases: [/variables/page/]
+toc: true
+---
+
+The following is a list of page-level variables. Many of these will be defined in the front matter, derived from file location, or extracted from the content itself.
+
+{{% note "`.Scratch`" %}}
+See [`.Scratch`](/functions/scratch/) for page-scoped, writable variables.
+{{% /note %}}
+
+## Page Variables
+
+.AlternativeOutputFormats
+: contains all alternative formats for a given page; this variable is especially useful `link rel` list in your site's `<head>`. (See [Output Formats](/templates/output-formats/).)
+
+.Content
+: the content itself, defined below the front matter.
+
+.Data
+: the data specific to this type of page.
+
+.Date
+: the date associated with the page; `.Date` pulls from the `date` field in a content's front matter. See also `.ExpiryDate`, `.PublishDate`, and `.Lastmod`.
+
+.Description
+: the description for the page.
+
+.Dir
+: the path of the folder containing this content file. The path is relative to the `content` folder.
+
+.Draft
+: a boolean, `true` if the content is marked as a draft in the front matter.
+
+.ExpiryDate
+: the date on which the content is scheduled to expire; `.ExpiryDate` pulls from the `expirydate` field in a content's front matter. See also `.PublishDate`, `.Date`, and `.Lastmod`.
+
+.File
+: filesystem-related data for this content file. See also [File Variables][].
+
+.FuzzyWordCount
+: the approximate number of words in the content.
+
+.Hugo
+: see [Hugo Variables](/variables/hugo/).
+
+.IsHome
+: `true` in the context of the [homepage](/templates/homepage/).
+
+.IsNode
+: always `false` for regular content pages.
+
+.IsPage
+: always `true` for regular content pages.
+
+.IsTranslated
+: `true` if there are translations to display.
+
+.Keywords
+: the meta keywords for the content.
+
+.Kind
+: the page's *kind*. Possible return values are `page`, `home`, `section`, `taxonomy`, or `taxonomyTerm`. Note that there are also `RSS`, `sitemap`, `robotsTXT`, and `404` kinds, but these are only available during the rendering of each of these respective page's kind and therefore *not* available in any of the `Pages` collections.
+
+.Lang
+: language taken from the language extension notation.
+
+.Language
+: a language object that points to the language's definition in the site
+`config`.
+
+.Lastmod
+: the date the content was last modified. `.Lastmod` pulls from the `lastmod` field in a content's front matter.
+
+ - If `lastmod` is not set, and `.GitInfo` feature is disabled, the front matter `date` field will be used.
+ - If `lastmod` is not set, and `.GitInfo` feature is enabled, `.GitInfo.AuthorDate` will be used instead.
+
+See also `.ExpiryDate`, `.Date`, `.PublishDate`, and [`.GitInfo`][gitinfo].
+
+.LinkTitle
+: access when creating links to the content. If set, Hugo will use the `linktitle` from the front matter before `title`.
+
+.Next
+: pointer to the following content (based on the `publishdate` field in front matter).
+
+.NextInSection
+: pointer to the following content within the same section (based on `publishdate` field in front matter).
+
+.OutputFormats
+: 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`.
+
+.Permalink
+: the Permanent link for this page; see [Permalinks](/content-management/urls/)
+
+.Plain
+: the Page content stripped of HTML tags and presented as a string.
+
+.PlainWords
+: the Page content stripped of HTML as a `[]string` using Go's [`strings.Fields`](https://golang.org/pkg/strings/#Fields) to split `.Plain` into a slice.
+
+.Prev
+: Pointer to the previous content (based on `publishdate` in front matter).
+
+.PrevInSection
+: Pointer to the previous content within the same section (based on `publishdate` in front matter). For example, `{{if .PrevInSection}}{{.PrevInSection.Permalink}}{{end}}`.
+
+.PublishDate
+: the date on which the content was or will be published; `.Publishdate` pulls from the `publishdate` field in a content's front matter. See also `.ExpiryDate`, `.Date`, and `.Lastmod`.
+
+.RSSLink
+: link to the taxonomies' RSS link.
+
+.RawContent
+: raw markdown content without the front matter. Useful with [remarkjs.com](
+http://remarkjs.com)
+
+.ReadingTime
+: the estimated time, in minutes, it takes to read the content.
+
+.Ref
+: returns the permalink for a given reference (e.g., `.Ref "sample.md"`). `.Ref` does *not* handle in-page fragments correctly. See [Cross References](/content-management/cross-references/).
+
+.RelPermalink
+: the relative permanent link for this page.
+
+.RelRef
+: returns the relative permalink for a given reference (e.g., `RelRef
+"sample.md"`). `.RelRef` does *not* handle in-page fragments correctly. See [Cross References](/content-management/cross-references/).
+
+.Site
+: see [Site Variables](/variables/site/).
+
+.Summary
+: a generated summary of the content for easily showing a snippet in a summary view. The breakpoint can be set manually by inserting <code><!--more--></code> at the appropriate place in the content page. See [Content Summaries](/content-management/summaries/) for more details.
+
+.TableOfContents
+: the rendered [table of contents](/content-management/toc/) for the page.
+
+.Title
+: the title for this page.
+
+.Translations
+: a list of translated versions of the current page. See [Multilingual Mode](/content-management/multilingual/) for more information.
+
+.Truncated
+: a boolean, `true` if the `.Summary` is truncated. Useful for showing a "Read more..." link only when necessary. See [Summaries](/content-management/summaries/) for more information.
+
+.Type
+: the [content type](/content-management/types/) of the content (e.g., `post`).
+
+.URL
+: the URL for the page relative to the web root. Note that a `url` set directly in front matter overrides the default relative URL for the rendered page.
+
+.UniqueID
+: the MD5-checksum of the content file's path.
+
+.Weight
+: assigned weight (in the front matter) to this content, used in sorting.
+
+.WordCount
+: the number of words in the content.
+
+## Section Variables and Methods
+
+Also see [Sections](/content-management/sections/).
+
+{{< readfile file="/content/en/readfiles/sectionvars.md" markdown="true" >}}
+
+## Page-level Params
+
+Any other value defined in the front matter in a content file, including taxonomies, will be made available as part of the `.Params` variable.
+
+```
+---
+title: My First Post
+date: 2017-02-20T15:26:23-06:00
+categories: [one]
+tags: [two,three,four]
+```
+
+With the above front matter, the `tags` and `categories` taxonomies are accessible via the following:
+
+* `.Params.tags`
+* `.Params.categories`
+
+{{% note "Casing of Params" %}}
+Page-level `.Params` are *only* accessible in lowercase.
+{{% /note %}}
+
+The `.Params` variable is particularly useful for the introduction of user-defined front matter fields in content files. For example, a Hugo website on book reviews could have the following front matter in `/content/review/book01.md`:
+
+```
+---
+...
+affiliatelink: "http://www.my-book-link.here"
+recommendedby: "My Mother"
+...
+---
+```
+
+These fields would then be accessible to the `/themes/yourtheme/layouts/review/single.html` template through `.Params.affiliatelink` and `.Params.recommendedby`, respectively.
+
+Two common situations where this type of front matter field could be introduced is as a value of a certain attribute like `href=""` or by itself to be displayed as text to the website's visitors.
+
+{{< code file="/themes/yourtheme/layouts/review/single.html" >}}
+<h3><a href={{ printf "%s" $.Params.affiliatelink }}>Buy this book</a></h3>
+<p>It was recommended by {{ .Params.recommendedby }}.</p>
+{{< /code >}}
+
+This template would render as follows, assuming you've set [`uglyURLs`](/content-management/urls/) to `false` in your [site `config`](/getting-started/configuration/):
+
+{{< output file="yourbaseurl/review/book01/index.html" >}}
+<h3><a href="http://www.my-book-link.here">Buy this book</a></h3>
+<p>It was recommended by my Mother.</p>
+{{< /output >}}
+
+{{% note %}}
+See [Archetypes](/content-management/archetypes/) for consistency of `Params` across pieces of content.
+{{% /note %}}
+
+### The `.Param` Method
+
+In Hugo, you can declare params in individual pages and globally for your entire website. A common use case is to have a general value for the site param and a more specific value for some of the pages (i.e., a header image):
+
+```
+{{ $.Param "header_image" }}
+```
+
+The `.Param` method provides a way to resolve a single value according to it's definition in a page parameter (i.e. in the content's front matter) or a site parameter (i.e., in your `config`).
+
+### Access Nested Fields in Front Matter
+
+When front matter contains nested fields like the following:
+
+```
+---
+author:
+ given_name: John
+ family_name: Feminella
+ display_name: John Feminella
+---
+```
+`.Param` can access these fields by concatenating the field names together with a dot:
+
+```
+{{ $.Param "author.display_name" }}
+```
+
+If your front matter contains a top-level key that is ambiguous with a nested key, as in the following case:
+
+```
+---
+favorites.flavor: vanilla
+favorites:
+ flavor: chocolate
+---
+```
+
+The top-level key will be preferred. Therefore, the following method, when applied to the previous example, will print `vanilla` and not `chocolate`:
+
+```
+{{ $.Param "favorites.flavor" }}
+=> vanilla
+```
+
+[gitinfo]: /variables/git/
+[File Variables]: /variables/files/
diff --git a/docs/content/variables/shortcodes.md b/docs/content/en/variables/shortcodes.md
diff --git a/docs/content/variables/site.md b/docs/content/en/variables/site.md
diff --git a/docs/content/variables/sitemap.md b/docs/content/en/variables/sitemap.md
diff --git a/docs/content/variables/taxonomy.md b/docs/content/en/variables/taxonomy.md
diff --git a/docs/content/functions/delimit.md b/docs/content/functions/delimit.md
@@ -1,64 +0,0 @@
----
-title: delimit
-description: Loops through any array, slice, or map and returns a string of all the values separated by a delimiter.
-godocref:
-workson: []
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-02-01
-categories: [functions]
-menu:
- docs:
- parent: "functions"
-keywords: [iteration]
-toc: false
-signature: ["delimit COLLECTION DELIMIT LAST"]
-workson: [lists,taxonomies,terms]
-hugoversion:
-relatedfuncs: []
-deprecated: false
-draft: false
-aliases: []
----
-
-`delimit` called in your template takes the form of
-
-```
-{{ delimit array/slice/map delimiter optionallastdelimiter}}
-```
-
-`delimit` loops through any array, slice, or map and returns a string of all the values separated by a delimiter, the second argument in the function call. There is an optional third parameter that lets you choose a different delimiter to go between the last two values in the loop.
-
-To maintain a consistent output order, maps will be sorted by keys and only a slice of the values will be returned.
-
-The examples of `delimit` that follow all use the same front matter:
-
-{{< code file="delimit-example-front-matter.toml" nocopy="true" >}}
-+++
-title: I love Delimit
-keywords: [ "tag1", "tag2", "tag3" ]
-+++
-{{< /code >}}
-
-{{< code file="delimit-page-tags-input.html" >}}
-<p>Tags: {{ delimit .Params.tags ", " }}</p>
-{{< /code >}}
-
-{{< output file="delimit-page-tags-output.html" >}}
-<p>Tags: tag1, tag2, tag3</p>
-{{< /output >}}
-
-Here is the same example but with the optional "last" delimiter:
-
-{{< code file="delimit-page-tags-final-and-input.html" >}}
-Tags: {{ delimit .Params.tags ", " ", and " }}
-{{< /code >}}
-
-{{< output file="delimit-page-tags-final-and-output.html" >}}
-<p>Tags: tag1, tag2, and tag3</p>
-{{< /output >}}
-
-
-[lists]: /templates/lists/
-[taxonomies]: /templates/taxonomy-templates/#taxonomy-list-templates
-[terms]: /templates/taxonomy-templates/#terms-list-templates
diff --git a/docs/content/functions/now.md b/docs/content/functions/now.md
@@ -1,44 +0,0 @@
----
-title: now
-linktitle: now
-description: Returns the current local time
-godocref: https://godoc.org/time#Time
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-04-30
-categories: [functions]
-menu:
- docs:
- parent: "functions"
-keywords: [dates,time]
-signature: ["now"]
-workson: []
-hugoversion:
-relatedfuncs: [Unix,dateFormat]
-deprecated: false
-aliases: []
----
-
-See [`time.Time`](https://godoc.org/time#Time).
-
-For example, building your site on June 24, 2017 with the following templating:
-
-```
-<div>
- <small>© {{ now.Format "2006"}}</small>
-</div>
-```
-
-Which will produce the following:
-
-```
-<div>
- <small>© 2017</small>
-</div>
-```
-
-The above example uses the [`.Format` function](/functions/format), which page includes a full listing of date formatting using Golang's layout string.
-
-{{% note %}}
-Older Hugo themes may use the deprecated `.Now` (uppercase). Be sure to use the lowercase `.now` in your templating.
-{{% /note %}}
diff --git a/docs/content/getting-started/configuration.md b/docs/content/getting-started/configuration.md
@@ -1,404 +0,0 @@
----
-title: Configure Hugo
-linktitle: Configuration
-description: How to configure your Hugo site.
-date: 2013-07-01
-publishdate: 2017-01-02
-lastmod: 2017-03-05
-categories: [getting started,fundamentals]
-keywords: [configuration,toml,yaml,json]
-menu:
- docs:
- parent: "getting-started"
- weight: 60
-weight: 60
-sections_weight: 60
-draft: false
-aliases: [/overview/source-directory/,/overview/configuration/]
-toc: true
----
-
-Hugo uses the `config.toml`, `config.yaml`, or `config.json` (if found in the
-site root) as the default site config file.
-
-The user can choose to override that default with one or more site config files
-using the command line `--config` switch.
-
-Examples:
-
-```
-hugo --config debugconfig.toml
-hugo --config a.toml,b.toml,c.toml
-```
-
-{{% note %}}
-Multiple site config files can be specified as a comma-separated string to the `--config` switch.
-{{% /note %}}
-
-## All Configuration Settings
-
-The following is the full list of Hugo-defined variables with their default
-value in parentheses. Users may choose to override those values in their site
-config file(s).
-
-archetypeDir ("archetypes")
-: The directory where Hugo finds archetype files (content templates).
-
-baseURL
-: Hostname (and path) to the root, e.g. http://bep.is/
-
-blackfriday
-: See [Configure Blackfriday](/getting-started/configuration/#configure-blackfriday)
-
-buildDrafts (false)
-: Include drafts when building.
-
-buildExpired (false)
-: Include content already expired.
-
-buildFuture (false)
-: Include content with publishdate in the future.
-
-canonifyURLs (false)
-: Enable to turn relative URLs into absolute.
-
-contentDir ("content")
-: The directory from where Hugo reads content files.
-
-dataDir ("data")
-: The directory from where Hugo reads data files.
-
-defaultContentLanguage ("en")
-: Content without language indicator will default to this language.
-
-defaultContentLanguageInSubdir (false)
-: Render the default content language in subdir, e.g. `content/en/`. The site root `/` will then redirect to `/en/`.
-
-disableHugoGeneratorInject (false)
-: Hugo will, by default, inject a generator meta tag in the HTML head on the _home page only_. You can turn it off, but we would really appreciate if you don't, as this is a good way to watch Hugo's popularity on the rise.
-
-disableKinds ([])
-: Enable disabling of all pages of the specified *Kinds*. Allowed values in this list: `"page"`, `"home"`, `"section"`, `"taxonomy"`, `"taxonomyTerm"`, `"RSS"`, `"sitemap"`, `"robotsTXT"`, `"404"`.
-
-disableLiveReload (false)
-: Disable automatic live reloading of browser window.
-
-disablePathToLower (false)
-: Do not convert the url/path to lowercase.
-
-enableEmoji (false)
-: Enable Emoji emoticons support for page content; see the [Emoji Cheat Sheet](https://www.webpagefx.com/tools/emoji-cheat-sheet/).
-
-enableGitInfo (false)
-: Enable `.GitInfo` object for each page (if the Hugo site is versioned by Git). This will then update the `Lastmod` parameter for each page using the last git commit date for that content file.
-
-enableMissingTranslationPlaceholders (false)
-: Show a placeholder instead of the default value or an empty string if a translation is missing.
-
-enableRobotsTXT (false)
-: Enable generation of `robots.txt` file.
-
-frontmatter
-
-: See [Front matter Configuration](#configure-front-matter).
-
-footnoteAnchorPrefix ("")
-: Prefix for footnote anchors.
-
-footnoteReturnLinkContents ("")
-: Text to display for footnote return links.
-
-googleAnalytics ("")
-: Google Analytics tracking ID.
-
-hasCJKLanguage (false)
-: If true, auto-detect Chinese/Japanese/Korean Languages in the content. This will make `.Summary` and `.WordCount` behave correctly for CJK languages.
-
-imaging
-: See [Image Processing Config](/content-management/image-processing/#image-processing-config).
-
-languages
-: See [Configure Languages](/content-management/multilingual/#configure-languages).
-
-languageCode ("")
-: The site's language code.
-
-disableLanguages
-: See [Disable a Language](/content-management/multilingual/#disable-a-language)
-
-layoutDir ("layouts")
-: The directory from where Hugo reads layouts (templates).
-
-log (false)
-: Enable logging.
-
-logFile ("")
-: Log File path (if set, logging enabled automatically).
-
-menu
-: See [Add Non-content Entries to a Menu](/content-management/menus/#add-non-content-entries-to-a-menu).
-
-metaDataFormat ("toml")
-: Front matter meta-data format. Valid values: `"toml"`, `"yaml"`, or `"json"`.
-
-newContentEditor ("")
-: The editor to use when creating new content.
-
-noChmod (false)
-: Don't sync permission mode of files.
-
-noTimes (false)
-: Don't sync modification time of files.
-
-paginate (10)
-: Default number of pages per page in [pagination](/templates/pagination/).
-
-paginatePath ("page")
-: The path element used during pagination (https://example.com/page/2).
-
-permalinks
-: See [Content Management](/content-management/urls/#permalinks).
-
-pluralizeListTitles (true)
-: Pluralize titles in lists.
-
-preserveTaxonomyNames (false)
-: Preserve special characters in taxonomy names ("Gérard Depardieu" vs "Gerard Depardieu").
-
-publishDir ("public")
-: The directory to where Hugo will write the final static site (the HTML files etc.).
-
-pygmentsCodeFencesGuessSyntax (false)
-: Enable syntax guessing for code fences without specified language.
-
-pygmentsStyle ("monokai")
-: Color-theme or style for syntax highlighting. See [Pygments Color Themes](https://help.farbox.com/pygments.html).
-
-pygmentsUseClasses (false)
-: Enable using external CSS for syntax highlighting.
-
-related
-: See [Related Content](/content-management/related/#configure-related-content).
-
-relativeURLs (false)
-: Enable this to make all relative URLs relative to content root. Note that this does not affect absolute URLs.
-
-rssLimit (unlimited)
-: Maximum number of items in the RSS feed.
-
-sectionPagesMenu ("")
-: See ["Section Menu for Lazy Bloggers"](/templates/menu-templates/#section-menu-for-lazy-bloggers).
-
-sitemap
-: Default [sitemap configuration](/templates/sitemap-template/#configure-sitemap-xml).
-
-staticDir ("static")
-: Relative directory from where Hugo reads static files.
-
-stepAnalysis (false)
-: Display memory and timing of different steps of the program.
-
-summaryLength (70)
-: The length of text to show in a [`.Summary`](/content-management/summaries/#hugo-defined-automatic-summary-splitting).
-
-taxonomies
-: See [Configure Taxonomies](/content-management/taxonomies#configure-taxonomies).
-
-theme ("")
-: Theme to use (located by default in `/themes/THEMENAME/`).
-
-themesDir ("themes")
-: The directory where Hugo reads the themes from.
-
-title ("")
-: Site title.
-
-uglyURLs (false)
-: When enabled, creates URL of the form `/filename.html` instead of `/filename/`.
-
-verbose (false)
-: Enable verbose output.
-
-verboseLog (false)
-: Enable verbose logging.
-
-watch (false)
-: Watch filesystem for changes and recreate as needed.
-
-{{% note %}}
-If you are developing your site on a \*nix machine, here is a handy shortcut for finding a configuration option from the command line:
-```
-cd ~/sites/yourhugosite
-hugo config | grep emoji
-```
-
-which shows output like
-
-```
-enableemoji: true
-```
-{{% /note %}}
-
-## Configuration Lookup Order
-
-Similar to the template [lookup order][], Hugo has a default set of rules for searching for a configuration file in the root of your website's source directory as a default behavior:
-
-1. `./config.toml`
-2. `./config.yaml`
-3. `./config.json`
-
-In your `config` file, you can direct Hugo as to how you want your website rendered, control your website's menus, and arbitrarily define site-wide parameters specific to your project.
-
-
-## Example Configuration
-
-The following is a typical example of a configuration file. The values nested under `params:` will populate the [`.Site.Params`][] variable for use in [templates][]:
-
-{{< code-toggle file="config">}}
-baseURL: "https://yoursite.example.com/"
-title: "My Hugo Site"
-footnoteReturnLinkContents: "↩"
-permalinks:
- post: /:year/:month/:title/
-params:
- Subtitle: "Hugo is Absurdly Fast!"
- AuthorName: "Jon Doe"
- GitHubUser: "spf13"
- ListOfFoo:
- - "foo1"
- - "foo2"
- SidebarRecentLimit: 5
-{{< /code-toggle >}}
-
-## Configure with Environment Variables
-
-In addition to the 3 config options already mentioned, configuration key-values can be defined through operating system environment variables.
-
-For example, the following command will effectively set a website's title on Unix-like systems:
-
-```
-$ env HUGO_TITLE="Some Title" hugo
-```
-
-This is really useful if you use a service such as Netlify to deploy your site. Look at the Hugo docs [Netlify configuration file](https://github.com/gohugoio/hugoDocs/blob/master/netlify.toml) for an example.
-
-{{% note "Setting Environment Variables" %}}
-Names must be prefixed with `HUGO_` and the configuration key must be set in uppercase when setting operating system environment variables.
-{{% /note %}}
-
-{{< todo >}}
-Test and document setting params via JSON env var.
-{{< /todo >}}
-
-## Ignore Files When Rendering
-
-The following statement inside `./config.toml` will cause Hugo to ignore files ending with `.foo` and `.boo` when rendering:
-
-```
-ignoreFiles = [ "\\.foo$", "\\.boo$" ]
-```
-
-The above is a list of regular expressions. Note that the backslash (`\`) character is escaped in this example to keep TOML happy.
-
-## Configure Front Matter
-
-### Configure Dates
-
-Dates are important in Hugo, and you can configure how Hugo assigns dates to your content pages. You do this by adding a `frontmatter` section to your `config.toml`.
-
-
-The default configuration is:
-
-```toml
-[frontmatter]
-date = ["date","publishDate", "lastmod"]
-lastmod = [":git" "lastmod", "date","publishDate"]
-publishDate = ["publishDate", "date"]
-expiryDate = ["expiryDate"]
-```
-
-If you, as an example, have a non-standard date parameter in some of your content, you can override the setting for `date`:
-
- ```toml
-[frontmatter]
-date = [ "myDate", ":default"]
-```
-
-The `:default` is a shortcut to the default settings. The above will set `.Date` to the date value in `myDate` if present, if not we will look in `date`,`publishDate`, `lastmod` and pick the first valid date.
-
-In the list to the right, values starting with ":" are date handlers with a special meaning (see below). The others are just names of date parameters (case insensitive) in your front matter configuration. Also note that Hugo have some built-in aliases to the above: `lastmod` => `modified`, `publishDate` => `pubdate`, `published` and `expiryDate` => `unpublishdate`. With that, as an example, using `pubDate` as a date in front matter, will, by default, be assigned to `.PublishDate`.
-
-The special date handlers are:
-
-
-`:fileModTime`
-: Fetches the date from the content file's last modification timestamp.
-
-An example:
-
- ```toml
-[frontmatter]
-lastmod = ["lastmod" ,":fileModTime", ":default"]
-```
-
-
-The above will try first to extract the value for `.Lastmod` starting with the `lastmod` front matter parameter, then the content file's modification timestamp. The last, `:default` should not be needed here, but Hugo will finally look for a valid date in `:git`, `date` and then `publishDate`.
-
-
-`:filename`
-: Fetches the date from the content file's filename. For example, `218-02-22-mypage.md` will extract the date `218-02-22`. Also, if `slug` is not set, `mypage` will be used as the value for `.Slug`.
-
-An example:
-
-```toml
-[frontmatter]
-date = [":filename", ":default"]
-```
-
-The above will try first to extract the value for `.Date` from the filename, then it will look in front matter parameters `date`, `publishDate` and lastly `lastmod`.
-
-
-`:git`
-: This is the Git author date for the last revision of this content file. This will only be set if `--enableGitInfo` is set or `enableGitInfo = true` is set in site config.
-
-## Configure Blackfriday
-
-[Blackfriday](https://github.com/russross/blackfriday) is Hugo's built-in Markdown rendering engine.
-
-Hugo typically configures Blackfriday with sane default values that should fit most use cases reasonably well.
-
-However, if you have specific needs with respect to Markdown, Hugo exposes some of its Blackfriday behavior options for you to alter. The following table lists these Hugo options, paired with the corresponding flags from Blackfriday's source code ( [html.go](https://github.com/russross/blackfriday/blob/master/html.go) and [markdown.go](https://github.com/russross/blackfriday/blob/master/markdown.go)).
-
-{{< readfile file="/content/readfiles/bfconfig.md" markdown="true" >}}
-
-{{% note %}}
-1. Blackfriday flags are *case sensitive* as of Hugo v0.15.
-2. Blackfriday flags must be grouped under the `blackfriday` key and can be set on both the site level *and* the page level. Any setting on a page will override its respective site setting.
-{{% /note %}}
-
-{{< code-toggle file="config" >}}
-[blackfriday]
- angledQuotes = true
- fractions = false
- plainIDAnchors = true
- extensions = ["hardLineBreak"]
-{{< /code-toggle >}}
-
-## Configure Additional Output Formats
-
-Hugo v0.20 introduced the ability to render your content to multiple output formats (e.g., to JSON, AMP html, or CSV). See [Output Formats][] for information on how to add these values to your Hugo project's configuration file.
-
-## Configuration Format Specs
-
-* [TOML Spec][toml]
-* [YAML Spec][yaml]
-* [JSON Spec][json]
-
-[`.Site.Params`]: /variables/site/
-[directory structure]: /getting-started/directory-structure
-[json]: https://www.ecma-international.org/publications/files/ECMA-ST/ECMA-404.pdf "Specification for JSON, JavaScript Object Notation"
-[lookup order]: /templates/lookup-order/
-[Output Formats]: /templates/output-formats/
-[templates]: /templates/
-[toml]: https://github.com/toml-lang/toml
-[yaml]: http://yaml.org/spec/
diff --git a/docs/content/news/0-16.md b/docs/content/news/0-16.md
@@ -1,250 +0,0 @@
----
-date: 2016-06-06T13:54:06-04:00
-description: "Hugo 0.16 is our best and biggest release ever. The Hugo community has outdone itself with continued performance improvements, beautiful themes and increased stability."
-title: "Hugo 0.16"
-categories: ["Releases"]
----
-
-Hugo 0.16 is our best and biggest release ever. The Hugo community has
-outdone itself with continued performance improvements,
-[beautiful themes](http://themes.gohugo.io) for all types of sites from project
-sites to documentation to blogs to portfolios, and increased stability.
-
-This release represents **over 550 contributions by over 110 contributors** to
-the main Hugo code base. Since last release Hugo has **gained 3500 stars, 90
-contributors and 23 additional themes.**
-
-This release celebrates 3 years since {{< gh "@spf13" >}} wrote the first lines
-of Hugo. During those 3 years Hugo has accomplished some major milestones
-including...
-
-* 10,000+ stars on GitHub
-* 320+ contributors
-* 90+ themes
-* 1000s of happy websites
-* Many subprojects like {{< gh "@spf13/cobra">}}, {{< gh "@spf13/viper">}} and
- {{< gh "@spf13/afero">}} which have experienced broad usage across the Go
- ecosystem.
-
-{{< gh "@bep" >}} led the development of Hugo for the 3rd consecutive release
-with nearly half of the contributions to 0.16 in addition to his considerable
-contributions as lead maintainer. {{< gh "@anthonyfok" >}}, {{< gh
-"@DigitalCraftsman" >}}, {{< gh "@MooreReason" >}} all made significant
-contributions. A special thanks to {{< gh "@abourget" >}} for his considerable
-work on multilingual support. Due to its broad impact we wanted to spend more
-time testing it and it will be included in Hugo's next release.
-
-### Highlights
-
-**Partial Builds:** Prior to this release Hugo would always reread and rebuild
-the entire site. This release introduces support for reactive site building
-while watching (`hugo server`). Hugo will watch the filesystem for changes and
-only re-read the changed files. Depending on the files change Hugo will
-intelligently re-render only the needed portion of the site. Performance gains
-depend on the operation performed and size of the site. In our testing build
-times decreased anywhere from 10% to 99%.
-
-**Template Improvements:** Template improvements continue to be a mainstay of each Hugo release. Hugo 0.16 adds support for the new `block` keyword introduced in Go 1.6 -- think base templates with default sections -- as well as many new template functions.
-
-**Polish:** As Hugo matures releases will inevitably contain fewer huge new features. This release represents hundreds of small improvements across ever facet of Hugo which will make for a much better experience for all of our users. Worth mentioning here is the curious bug where live reloading didn't work in some editors on OS X, including the popular TextMate 2. This is now fixed. Oh, and now any error will exit with an error code, a big thing for automated deployments.
-
-### New Features
-* Support reading configuration variables from the OS environment {{<gh 2090 >}}
-* Add emoji support {{<gh 1892>}}
-* Add `themesDir` option to configuration {{<gh 1556>}}
-* Add support for Go 1.6 `block` keyword in templates {{<gh 1832>}}
-* Partial static sync {{<gh 1644>}}
-* Source file based relative linking (à la GitHub) {{<gh 0x0f6b334b6715253b030c4e783b88e911b6e53e56>}}
-* Add `ByLastmod` sort function to pages. {{<gh 0xeb627ca16de6fb5e8646279edd295a8bf0f72bf1 >}}
-* New templates functions:
- * `readFile` {{<gh 1551 >}}
- * `countwords` and `countrunes` {{<gh 1440>}}
- * `default` {{<gh 1943>}}
- * `hasPrefix` {{<gh 1243>}}
- * `humanize` {{<gh 1818>}}
- * `jsonify` {{<gh 0x435e996c4fd48e9009ffa9f83a19fb55f0777dbd>}}
- * `md5` and `sha1` {{<gh 1932>}}
- * `replaceRE` {{<gh 1845>}}
- * `findRE` {{<gh 2048>}}
- * `shuffle` {{<gh 1942>}}
- * `slice` {{<gh 1902>}}
- * `plainify` {{<gh 1915>}}
-
-### Enhancements
-
-* Hugo now exits with error code on any error. This is a big thing for
- automated deployments. {{<gh 740 >}}
-* Print error when `/index.html` is zero-length {{<gh 947>}}
-* Enable dirname and filename bash autocompletion for more flags {{<gh
- 0x666ddd237791b56fd048992dca9a27d1af50a10e>}}
-* Improve error handling in commands {{<gh 1502>}}
-* Add sanity checks for `hugo import jekyll` {{<gh 1625 >}}
-* Add description to `Page.Params` {{<gh 1484>}}
-* Add async version of Google Analytics internal template {{<gh 1711>}}
-* Add autostart option to YouTube shortcode {{<gh 1784>}}
-* Set Date and Lastmod for main home page {{<gh 1903>}}
-* Allow URL with extension in front matter {{<gh 1923>}}
-* Add list support in Scratch {{<gh
- 0xeaba04e82bdfc5d4c29e970f11b4aab9cc0efeaa>}}
-* Add file option to gist shortcode {{<gh 1955>}}
-* Add config layout and content directory CLI options {{<gh 1698>}}
-* Add boolean value comparison to `where` template function {{<gh
- 0xf3c74c9db484c8961e70cb3458f9e41e7832fa12>}}
-* Do not write to cache when `ignoreCache` is set {{<gh 2067>}}
-* Add option to disable rendering of 404 page {{<gh 2037>}}
-* Mercurial is no longer needed to build Hugo {{<gh 2062 >}}
-* Do not create `robots.txt` by default {{<gh 2049>}}
-* Disable syntax guessing for PygmentsCodeFences by default. To enable syntax
- guessing again, add the following to your config file:
- `PygmentsCodeFencesGuessSyntax = true` {{<gh 2034>}}
-* Make `ByCount` sort consistently {{<gh 1930>}}
-* Add `Scratch` to shortcode {{<gh 2000>}}
-* Add support for symbolic links for content, layout, static, theme {{<gh 1855
- >}}
-* Add '+' as one of the valid characters in URLs specified in the front matter
- {{<gh 1290 >}}
-* Make alias redirect output URLs relative when `RelativeURLs = true` {{<gh
- 2093 >}}
-* Hugo injects meta generator tag on homepage if missing {{<gh
- 2182 >}}
-
-### Fixes
-* Fix file change watcher for TextMate 2 and friends on OS X {{<gh 1053 >}}
-* Make dynamic reloading of config file reliable on all platform {{<gh 1684 >}}
-* Hugo now works on Linux/arm64 {{<gh 1772 >}}
-* `plainIDAnchors` now defaults to `true` {{<gh 2057>}}
-* Win32 and ARM builds fixed {{<gh 1716>}}
-* Copy static dir files without theme's static dir {{<gh 1656>}}
-* Make `noTimes` command flag work {{<gh 1657>}}
-* Change most global CLI flags into local ones {{<gh 1624>}}
-* Remove transformation of menu URLs {{<gh 1239>}}
-* Do not fail on unknown Jekyll file {{<gh 1705>}}
-* Use absolute path when editing with editor {{<gh 1589>}}
-* Fix hugo server "Watching for changes" path display {{<gh 1721>}}
-* Do not strip special characters out of URLs {{<gh 1292>}}
-* Fix `RSSLink` when uglyURLs are enabled {{<gh 175>}}
-* Get BaseURL from viper in server mode {{<gh 1821>}}
-* Fix shortcode handling in RST {{<gh 1904>}}
-* Use default sitemap configuration for homepage {{<gh 1304>}}
-* Exit if specific port is unavailable in server mode {{<gh 1901>}}
-* Fix regression in "section menus for lazy blogger" {{<gh 2065>}}
-
-****
-
-## **0.15.0** November 25, 2015
-
-The v0.15.0 Hugo release brings a lot of polish to Hugo. Exactly 6 months after
-the 0.14 release, Hugo has seen massive growth and changes. Most notably, this
-is Hugo's first release under the Apache 2.0 license. With this license change
-we hope to expand the great community around Hugo and make it easier for our
-many users to contribute. This release represents over **377 contributions by
-87 contributors** to the main Hugo repo and hundreds of improvements to the
-libraries Hugo uses. Hugo also launched a [new theme
-showcase](http://themes.gohugo.io) and participated in
-[Hacktoberfest](https://hacktoberfest.digitalocean.com).
-
-Hugo now has:
-
-* 6700 (+2700) stars on GitHub
-* 235 (+75) contributors
-* 65 (+30) themes
-
-
-**Template Improvements:** This release takes Hugo to a new level of speed and
-usability. Considerable work has been done adding features and performance to
-the template system which now has full support of Ace, Amber and Go Templates.
-
-**Hugo Import:** Have a Jekyll site, but dreaming of porting it to Hugo? This
-release introduces a new `hugo import jekyll`command that makes this easier
-than ever.
-
-**Performance Improvements:** Just when you thought Hugo couldn't get any faster,
-Hugo continues to improve in speed while adding features. Notably Hugo 0.15
-introduces the ability to render and serve directly from memory resulting in
-30%+ lower render times.
-
-Huge thanks to all who participated in this release. A special thanks to
-{{< gh "@bep" >}} who led the development of Hugo this release again,
-{{< gh "@anthonyfok" >}},
-{{< gh "@eparis" >}},
-{{< gh "@tatsushid" >}} and
-{{< gh "@DigitalCraftsman" >}}.
-
-
-### New features
-* new `hugo import jekyll` command. {{< gh 1469 >}}
-* The new `Param` convenience method on `Page` and `Node` can be used to get the most specific parameter value for a given key. {{< gh 1462 >}}
-* Several new information elements have been added to `Page` and `Node`:
- * `RuneCount`: The number of [runes](http://blog.golang.org/strings) in the content, excluding any whitespace. This may be a good alternative to `.WordCount` for Japanese and other CJK languages where a word-split by spaces makes no sense. {{< gh 1266 >}}
- * `RawContent`: Raw Markdown as a string. One use case may be of embedding remarkjs.com slides.
- * `IsHome`: tells the truth about whether you're on the home page or not.
-
-### Improvements
-* `hugo server` now builds ~30%+ faster by rendering to memory instead of disk. To get the old behavior, start the server with `--renderToDisk=true`.
-* Hugo now supports dynamic reloading of the config file when watching.
-* We now use a custom-built `LazyFileReader` for reading file contents, which means we don't read media files in `/content` into memory anymore -- and file reading is now performed in parallel on multicore PCs. {{< gh 1181 >}}
-* Hugo is now built with `Go 1.5` which, among many other improvements, have fixed the last known data race in Hugo. {{< gh 917 >}}
-* Paginator now also supports page groups. {{< gh 1274 >}}
-* Markdown improvements:
- * Hugo now supports GitHub-flavoured markdown code fences for highlighting for `md`-files (Blackfriday rendered markdown) and `mmark` files (MMark rendered markdown). {{< gh 362 1258 >}}
- * Several new Blackfriday options are added:
- * Option to disable Blackfriday's `Smartypants`.
- * Option for Blackfriday to open links in a new window/tab. {{< gh 1220 >}}
- * Option to disable Blackfriday's LaTeX style dashes {{< gh 1231 >}}
- * Definition lists extension support.
-* `Scratch` now has built-in `map` support.
-* We now fall back to `link title` for the default page sort. {{< gh 1299 >}}
-* Some notable new configuration options:
- * `IgnoreFiles` can be set with a list of Regular Expressions that matches files to be ignored during build. {{< gh 1189 >}}
- * `PreserveTaxonomyNames`, when set to `true`, will preserve what you type as the taxonomy name both in the folders created and the taxonomy `key`, but it will be normalized for the URL. {{< gh 1180 >}}
-* `hugo gen` can now generate man files, bash auto complete and markdown documentation
-* Hugo will now make suggestions when a command is mistyped
-* Shortcodes now have a boolean `.IsNamedParams` property. {{< gh 1597 >}}
-
-### New Template Features
-* All template engines:
- * The new `dict` function that could be used to pass maps into a template. {{< gh 1463 >}}
- * The new `pluralize` and `singularize` template funcs.
- * The new `base64Decode` and `base64Encode` template funcs.
- * The `sort` template func now accepts field/key chaining arguments and pointer values. {{< gh 1330 >}}
- * Several fixes for `slicestr` and `substr`, most importantly, they now have full `utf-8`-support. {{< gh 1190 1333 1347 >}}
- * The new `last` template function allows the user to select the last `N` items of a slice. {{< gh 1148 >}}
- * The new `after` func allows the user to select the items after the `Nth` item. {{< gh 1200 >}}
- * Add `time.Time` type support to the `where`, `ge`, `gt`, `le`, and `lt` template functions.
- * It is now possible to use constructs like `where Values ".Param.key" nil` to filter pages that doesn't have a particular parameter. {{< gh 1232 >}}
- * `getJSON`/`getCSV`: Add retry on invalid content. {{< gh 1166 >}}
- * The new `readDir` func lists local files. {{< gh 1204 >}}
- * The new `safeJS` function allows the embedding of content into JavaScript contexts in Go templates.
- * Get the main site RSS link from any page by accessing the `.Site.RSSLink` property. {{< gh 1566 >}}
-* Ace templates:
- * Base templates now also works in themes. {{< gh 1215 >}}.
- * And now also on Windows. {{< gh 1178 >}}
-* Full support for Amber templates including all template functions.
-* A built-in template for Google Analytics. {{< gh 1505 >}}
-* Hugo is now shipped with new built-in shortcodes: {{< gh 1576 >}}
- * `youtube` for YouTube videos
- * `vimeo` for Vimeo videos
- * `gist` for GitHub gists
- * `tweet` for Twitter Tweets
- * `speakerdeck` for Speakerdeck slides
-
-
-### Bugfixes
-* Fix data races in page sorting and page reversal. These operations are now also cached. {{< gh 1293 >}}
-* `page.HasMenuCurrent()` and `node.HasMenuCurrent()` now work correctly in multi-level nested menus.
-* Support `Fish and Chips` style section titles. Previously, this would end up as `Fish And Chips`. Now, the first character is made toupper, but the rest are preserved as-is. {{< gh 1176 >}}
-* Hugo now removes superfluous p-tags around shortcodes. {{< gh 1148 >}}
-
-### Notices
-* `hugo server` will watch by default now.
-* Some fields and methods were deprecated in `0.14`. These are now removed, so the error message isn't as friendly if you still use the old values. So please change:
- * `getJson` to `getJSON`, `getCsv` to `getCSV`, `safeHtml` to
- `safeHTML`, `safeCss` to `safeCSS`, `safeUrl` to `safeURL`, `Url` to `URL`,
- `UrlPath` to `URLPath`, `BaseUrl` to `BaseURL`, `Recent` to `Pages`.
-
-### Known Issues
-
-Using the Hugo v0.15 32-bit Windows or ARM binary, running `hugo server` would crash or hang due to a [memory alignment issue](https://golang.org/pkg/sync/atomic/#pkg-note-BUG) in [Afero](https://github.com/spf13/afero). The bug was discovered shortly after the v0.15.0 release and has since been [fixed](https://github.com/spf13/afero/pull/23) by {{< gh "@tpng" >}}. If you encounter this bug, you may either compile Hugo v0.16-DEV from source, or use the following solution/workaround:
-
-* **64-bit Windows users: Please use [hugo_0.15_windows_amd64.zip](https://github.com/gohugoio/hugo/releases/download/v0.15/hugo_0.15_windows_amd64.zip)** (amd64 == x86-64). It is only the 32-bit hugo_0.15_windows_386.zip that crashes/hangs (see {{< gh 1621 >}} and {{< gh 1628 >}}).
-* **32-bit Windows and ARM users: Please run `hugo server --renderToDisk` as a workaround** until Hugo v0.16 is released (see [“hugo server” returns runtime error on armhf](https://discourse.gohugo.io/t/hugo-server-returns-runtime-error-on-armhf/2293) and {{< gh 1716 >}}).
diff --git a/docs/content/news/0-17.md b/docs/content/news/0-17.md
@@ -1,92 +0,0 @@
----
-author: bep
-categories: ["Releases"]
-date: 2016-10-07T13:54:06-04:00
-description: "Hugo now supports multilingual sites with the most simple and elegant experience."
-link: ""
-title: "0.17: Hugo is going global"
-draft: false
----
-Hugo is going global with our 0.17 release. We put a lot of thought into how we could extend Hugo
-to support multilingual websites with the most simple and elegant experience. Hugo's multilingual
-capabilities rival the best web and documentation software, but Hugo's experience is unmatched.
-If you have a single language website, the simple Hugo experience you already love is unchanged.
-Adding additional languages to your website is simple and straightforward. Hugo has been completely
-internally rewritten to be multilingual aware with translation and internationalization features
-embedded throughout Hugo.
-
-Hugo continues its trend of each release being faster than the last. It's quite a challenge to consistently add
-significant new functionality and simultaneously dramatically improve performance. {{<gh "@bep">}} has made it
-his personal mission to apply the Go mantra of "Enable more. Do less" to Hugo. Hugo's consistent improvement
-is a testament to his brilliance and his dedication to his craft. Hugo additionally benefits from the
-performance improvements from the Go team in the Go 1.7 release.
-
-This release represents **over 300 contributions by over 70 contributors** to
-the main Hugo code base. Since last release Hugo has **gained 2000 stars, 50 new
-contributors and 20 additional themes.**
-
-Hugo now has:
-
-* 12,000 stars on GitHub
-* 370+ contributors
-* 110+ themes
-
-{{<gh "@bep" >}} continues to lead the project with the lionshare of contributions
-and reviews. A special thanks to {{<gh "@bep" >}} and {{<gh "@abourget" >}} for their
-considerable work on multilingual support.
-
-A big welcome to newcomers {{<gh "@MarkDBlackwell" >}}, {{<gh "@bogem" >}} and
-{{<gh "@g3wanghc" >}} for their critical contributions.
-
-### Highlights
-
-**Multilingual Support:**
-Hugo now supports multiple languages side-by-side. A single site can now have multiple languages rendered with
-full support for translation and i18n.
-
-**Performance:**
-Hugo is faster than ever! Hugo 0.17 is not only our fastest release, it's also the most efficient.
-Hugo 0.17 is **nearly twice as fast as Hugo 0.16** and uses about 10% less memory.
-This means that the same site will build in nearly half the time it took with Hugo 0.16.
-For the first time Hugo sites are averaging well under 1ms per rendered content.
-
-**Docs overhaul:**
-This release really focused on improving the documentation. [Gohugo.io](http://gohugo.io) is
-more accurate and complete than ever.
-
-**Support for macOS Sierra**
-
-### New Features
-* Multilingual support {{<gh 2303>}}
-* Allow content expiration {{<gh 2137 >}}
-* New templates functions:
- * `querify` function to generate query strings inside templates {{<gh 2257>}}
- * `htmlEscape` and `htmlUnescape` template functions {{<gh 2287>}}
- * `time` converts a timestamp string into a time.Time structure {{<gh 2329>}}
-
-### Enhancements
-
-* Render the shortcodes as late as possible {{<gh 0xed0985404db4630d1b9d3ad0b7e41fb186ae0112>}}
-* Remove unneeded casts in page.getParam {{<gh 2186 >}}
-* Automatic page date fallback {{<gh 2239>}}
-* Enable safeHTMLAttr {{<gh 2234>}}
-* Add TODO list support for markdown {{<gh 2296>}}
-* Make absURL and relURL accept any type {{<gh 2352>}}
-* Suppress 'missing static' error {{<gh 2344>}}
-* Make summary, wordcount etc. more efficient {{<gh 2378>}}
-* Better error reporting in `hugo convert` {{<gh 2440>}}
-* Reproducible builds thanks to govendor {{<gh 2461>}}
-
-### Fixes
-
-* Fix shortcode in markdown headers {{<gh 2210 >}}
-* Explicitly bind livereload to hugo server port {{<gh 2205>}}
-* Fix Emojify for certain text patterns {{<gh 2198>}}
-* Normalize file name to NFC {{<gh 2259>}}
-* Ignore emacs temp files {{<gh 2266>}}
-* Handle symlink change event {{<gh 2273>}}
-* Fix panic when using URLize {{<gh 2274>}}
-* `hugo import jekyll`: Fixed target path location check {{<gh 2293>}}
-* Return all errors from casting in templates {{<gh 2356>}}
-* Fix paginator counter on x86-32 {{<gh 2420>}}
-* Fix half-broken self-closing shortcodes {{<gh 2499>}}
diff --git a/docs/content/news/0-18.md b/docs/content/news/0-18.md
@@ -1,113 +0,0 @@
----
-date: 2016-12-30T13:54:02-04:00
-categories: ["Releases"]
-description: "The primary new feature in Hugo 0.18 is that every piece of content is now a Page."
-link: ""
-title: "Hugo 0.18"
-draft: false
-author: bep
----
-
-Hugo 0.18.1 is a bug fix release fixing some issues introduced in Hugo 0.18:
-
-* Fix 32-bit binaries {{<gh 2847 >}}
-* Fix issues with `preserveTaxonomyNames` {{<gh 2809 >}}
-* Fix `.URL` for taxonomy pages when `uglyURLs=true` {{<gh 2819 >}}
-* Fix `IsTranslated` and `Translations` for node pages {{<gh 2812 >}}
-* Make template error messages more verbose {{<gh 2820 >}}
-
-## **0.18.0** December 19th 2016
-
-Today, we're excited to release the much-anticipated Hugo 0.18!
-
-We're heading towards the end of the year 2016, and we can look back on three releases and a steady growing community around the project.
-This release includes **over 220 contributions by nearly 50 contributors** to the main codebase.
-Since the last release, Hugo has **gained 1750 stars and 27 additional themes**.
-
-Hugo now has:
-
-- 13750+ stars
-- 408+ contributors
-- 137+ themes
-
-{{< gh "@bep" >}} once again took the lead of Hugo and contributed a significant amount of additions.
-Also a big shoutout to {{< gh "@digitalcraftsman" >}} for his relentless work on keeping the documentation and the themes site in pristine condition,
-and also a big thanks to {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for their contributions.
-
-We wish you all a Merry Christmas and a Happy New Year.<br>
-*The Hugo team*
-
-### Highlights
-
-The primary new feature in Hugo 0.18 is that every piece of content is now a `Page` ({{<gh 2297>}}). This means that every page, including the homepage, can have a content file with front matter.
-
-Not only is this a much simpler model to understand, it is also faster and paved the way for several important new features:
-
-* Enable proper titles for Nodes {{<gh 1051>}}
-* Sitemap.xml should include nodes, as well as pages {{<gh 1303>}}
-* Document homepage content workaround {{<gh 2240>}}
-* Allow home page to be easily authored in markdown {{<gh 720>}}
-* Minimalist website with homepage as content {{<gh 330>}}
-
-Hugo again continues its trend of each release being faster than the last. It's quite a challenge to consistently add significant new functionality and simultaneously dramatically improve performance. Running [this benchmark]( https://github.com/bep/hugo-benchmark) with [these sites](https://github.com/bep/hugo-benchmark/tree/master/sites) (renders to memory) shows about 60% reduction in time spent and 30% reduction in memory usage compared to Hugo 0.17.
-
-### Other New Features
-
-* Every `Page` now has a `Kind` property. Since everything is a `Page` now, the `Kind` is used to differentiate different kinds of pages.
- Possible values are `page`, `home`, `section`, `taxonomy`, and `taxonomyTerm`.
- (Internally, we also define `RSS`, `sitemap`, `robotsTXT`, and `404`, but those have no practical use for end users at the moment since they are not included in any collections.)
-* Add a `GitInfo` object to `Page` if `enableGitInfo` is set. It then also sets `Lastmod` for the given `Page` to the author date provided by Git. {{<gh 2291>}}
-* Implement support for alias templates {{<gh 2533 >}}
-* New template functions:
- * Add `imageConfig` function {{<gh 2677>}}
- * Add `sha256` function {{<gh 2762>}}
- * Add `partialCached` template function {{<gh 1368>}}
-* Add shortcode to display Instagram images {{<gh 2690>}}
-* Add `noChmod` option to disable perm sync {{<gh 2749>}}
-* Add `quiet` build mode {{<gh 1218>}}
-
-
-### Notices
-
-* `.Site.Pages` will now contain *several kinds of pages*, including regular pages, sections, taxonomies, and the home page.
- If you want a specific kind of page, you can filter it with `where` and `Kind`.
- `.Site.RegularPages` is a shortcut to the page collection you have been used to getting.
-* `RSSlink` is now deprecated. Use `RSSLink` instead.
- Note that in Hugo 0.17 both of them existed, so there is a fifty-fifty chance you will not have to do anything
- (if you use a theme, the chance is close to 0), and `RSSlink` will still work for two Hugo versions.
-
-### Fixes
-
-* Revise the `base` template lookup logic so it now better matches the behavior of regular templates, making it easier to override the master templates from the theme {{<gh 2783>}}
-* Add workaround for `block` template crash.
- Block templates are very useful, but there is a bug in Go 1.6 and 1.7 which makes the template rendering crash if you use the block template in more complex scenarios.
- This is fixed in the upcoming Go 1.8, but Hugo adds a temporary workaround in Hugo 0.18. {{<gh 2549>}}
-* All the `Params` configurations are now case insensitive {{<gh 1129>}} {{<gh 2590>}} {{<gh 2615>}}
-* Make RawContent raw again {{<gh 2601>}}
-* Fix archetype title and date handling {{<gh 2750>}}
-* Fix TOML archetype parsing in `hugo new` {{<gh 2745>}}
-* Fix page sorting when weight is zero {{<gh 2673>}}
-* Fix page names that contain dot {{<gh 2555>}}
-* Fix RSS Title regression {{<gh 2645>}}
-* Handle ToC before handling shortcodes {{<gh 2433>}}
-* Only watch relevant themes dir {{<gh 2602>}}
-* Hugo new content creates TOML slices with closing bracket on new line {{<gh 2800>}}
-
-### Improvements
-
-* Add page information to error logging in rendering {{<gh 2570>}}
-* Deprecate `RSSlink` in favor of `RSSLink`
-* Make benchmark command more useful {{<gh 2432>}}
-* Consolidate the `Param` methods {{<gh 2590>}}
-* Allow to set cache dir in config file
-* Performance improvements:
- * Avoid repeated Viper loads of `sectionPagesMenu` {{<gh 2728>}}
- * Avoid reading from Viper for path and URL funcs {{<gh 2495>}}
- * Add `partialCached` template function. This can be a significant performance boost if you have complex partials that does not need to be rerendered for every page. {{<gh 1368>}}
-
-### Documentation Updates
-
-* Update roadmap {{<gh 2666>}}
-* Update multilingual example {{<gh 2417>}}
-* Add a "Deployment with rsync" tutorial page {{<gh 2658>}}
-* Refactor `/docs` to use the `block` keyword {{<gh 2226>}}
diff --git a/docs/content/news/0-19.md b/docs/content/news/0-19.md
@@ -1,82 +0,0 @@
----
-date: 2017-02-27T13:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.19 brings native Emacs Org-mode content support, and Hugo has its own Twitter account"
-link: ""
-title: "Hugo 0.19"
-draft: false
-author: budparr
----
-
-We're happy to announce the first release of Hugo in 2017.
-
-This release represents **over 180 contributions by over 50 contributors** to the main Hugo code base. Since last release Hugo has **gained 1450 stars, 35 new contributors, and 15 additional themes.**
-
-Hugo now has:
-
-* 15200+ stars
-* 470+ contributors
-* 151+ themes
-
-Furthermore, Hugo has its own Twitter account ([@gohugoio](https://twitter.com/gohugoio)) where we share bite-sized news and themes from the Hugo community.
-
-{{< gh "@bep" >}} leads the Hugo development and once again contributed a significant amount of additions. Also a big shoutout to {{< gh "@chaseadamsio" >}} for the Emacs Org-mode support, {{< gh "@digitalcraftsman" >}} for his relentless work on keeping the documentation and the themes site in pristine condition, {{< gh "@fj" >}}for his work on revising the `params` handling in Hugo, and {{< gh "@moorereason" >}} and {{< gh "@bogem" >}} for their ongoing contributions.
-
-### Highlights
-
-Hugo `0.19` brings native Emacs Org-mode content support ({{<gh 1483>}}), big thanks to {{< gh "@chaseadamsio" >}}.
-
-Also, a considerably amount of work have been put into cleaning up the Hugo source code, in an issue titled [Refactor the globals out of site build](https://github.com/gohugoio/hugo/issues/2701). This is not immediately visible to the Hugo end user, but will speed up future development.
-
-Hugo `0.18` was bringing full-parallel page rendering, so workarounds depending on rendering order did not work anymore, and pages with duplicate target paths (common examples would be `/index.md` or `/about/index.md`) would now conflict with the home page or the section listing.
-
-With Hugo `0.19`, you can control this behaviour by turning off page types you do not want ({{<gh 2534 >}}). In its most extreme case, if you put the below setting in your [`config.toml`](/getting-started/configuration/), you will get **nothing!**:
-
-```
-disableKinds = ["page", "home", "section", "taxonomy", "taxonomyTerm", "RSS", "sitemap", "robotsTXT", "404"]
-```
-
-### Other New Features
-
-* Add ability to sort pages by front matter parameters, enabling easy custom "top 10" page lists. {{<gh 3022 >}}
-* Add `truncate` template function {{<gh 2882 >}}
-* Add `now` function, which replaces the now deprecated `.Now` {{<gh 2859 >}}
-* Make RSS item limit configurable {{<gh 3035 >}}
-
-### Enhancements
-
-* Enhance `.Param` to permit arbitrarily nested parameter references {{<gh 2598 >}}
-* Use `Page.Params` more consistently when adding metadata {{<gh 3033 >}}
-* The `sectionPagesMenu` feature ("Section menu for the lazy blogger") is now integrated with the section content pages. {{<gh 2974 >}}
-* Hugo `0.19` is compiled with Go 1.8!
-* Make template funcs like `findRE` and friends more liberal in what argument types they accept {{<gh 3018 >}} {{<gh 2822 >}}
-* Improve generation of OpenGraph date tags {{<gh 2979 >}}
-
-### Notes
-
-* `sourceRelativeLinks` is now deprecated and will be removed in Hugo `0.21` if no one is stepping up to the plate and fixes and maintains this feature. {{<gh 3028 >}}
-
-### Fixes
-
-* Fix `.Site.LastChange` on sites where the default sort order is not chronological. {{<gh 2909 >}}
-* Fix regression of `.Truncated` evaluation in manual summaries. {{<gh 2989 >}}
-* Fix `preserveTaxonomyNames` regression {{<gh 3070 >}}
-* Fix issue with taxonomies when only some have content page {{<gh 2992 >}}
-* Fix instagram shortcode panic on invalid ID {{<gh 3048 >}}
-* Fix subtle data race in `getJSON` {{<gh 3045 >}}
-* Fix deadlock in cached partials {{<gh 2935 >}}
-* Avoid double-encoding of paginator URLs {{<gh 2177 >}}
-* Allow tilde in URLs {{<gh 2177 >}}
-* Fix `.Site.Pages` handling on live reloads {{<gh 2869 >}}
-* `UniqueID` now correctly uses the fill file path from the content root to calculate the hash, and is finally ... unique!
-* Discard current language based on `.Lang()`, go get translations correct for paginated pages. {{<gh 2972 >}}
-* Fix infinite loop in template AST handling for recursive templates {{<gh 2927 >}}
-* Fix issue with watching when config loading fails {{<gh 2603 >}}
-* Correctly flush the imageConfig on live-reload {{<gh 3016 >}}
-* Fix parsing of TOML arrays in front matter {{<gh 2752 >}}
-
-### Docs
-
-* Add tutorial "How to use Google Firebase to host a Hugo site" {{<gh 3007 >}}
-* Improve documentation for menu rendering {{<gh 3056 >}}
-* Revise GitHub Pages deployment tutorial {{<gh 2930 >}}
diff --git a/docs/content/news/0-20-1.md b/docs/content/news/0-20-1.md
@@ -1,14 +0,0 @@
----
-date: 2017-04-13T13:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.20.1 is a bug fix release, fixing some important regressions introduced in 0.20"
-link: ""
-title: "Hugo 0.20.1"
-draft: false
-author: bep
----
-
-* Fix logic for base template in work dir vs in the theme [#3323](//github.com/gohugoio/hugo/issues/3323)
-* camelCased templates (partials, shortcodes etc.) not found [#3333](//github.com/gohugoio/hugo/issues/3333)
-* Live-reload fails with `_index.md` with paginator [#3315](//github.com/gohugoio/hugo/issues/3315)
-* `rssURI` WARNING always shown [#3319](//github.com/gohugoio/hugo/issues/3319)-
\ No newline at end of file
diff --git a/docs/content/news/0-20-2.md b/docs/content/news/0-20-2.md
@@ -1,44 +0,0 @@
----
-date: 2017-04-16T13:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.20.2 adds support for plain text partials included into HTML templates"
-link: ""
-title: "Hugo 0.20.2"
-draft: false
-author: bep
----
-
-Hugo `0.20.2` adds support for plain text partials included into `HTML` templates. This was a side-effect of the big new [Custom Output Format](https://gohugo.io/extras/output-formats/) feature in `0.20`, and while the change was intentional and there was an ongoing discussion about fixing it in [#3273](//github.com/gohugoio/hugo/issues/3273), it did break some themes. There were valid workarounds for these themes, but we might as well get it right.
-
-The most obvious use case for this is inline `CSS` styles, which you now can do without having to name your partials with a `html` suffix.
-
-A simple example:
-
-In `layouts/partials/mystyles.css`:
-
- body {
- background-color: {{ .Param "colors.main" }}
- }
-
-Then in `config.toml` (note that by using the `.Param` lookup func, we can override the color in a page’s front matter if we want):
-
- [params]
- [params.colors]
- main = "green"
- text = "blue"
-
-And then in `layouts/partials/head.html` (or the partial used to include the head section into your layout):
-
- <head>
- <style type="text/css">
- {{ partial "mystyles.css" . | safeCSS }}
- </style>
- </head>
-
-Of course, `0.20` also made it super-easy to create external `CSS` stylesheets based on your site and page configuration. A simple example:
-
-Add “CSS” to your home page’s `outputs` list, create the template `/layouts/index.css` using Go template syntax for the dynamic parts, and then include it into your `HTML` template with:
-
- {{ with .OutputFormats.Get "css" }}
- <link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | safeURL }}">
- {{ end }}`-
\ No newline at end of file
diff --git a/docs/content/news/0-20-3.md b/docs/content/news/0-20-3.md
@@ -1,25 +0,0 @@
----
-date: 2017-04-24T13:53:58-04:00
-categories: ["Releases"]
-description: "This is a bug-fix release with one important fix. But it also adds some harness around GoReleaser"
-link: ""
-title: "Hugo 0.20.3"
-draft: false
-author: bep
----
-
-This is a bug-fix release with one important fix. But it also adds some harness around [GoReleaser](https://github.com/goreleaser/goreleaser) to automate the Hugo release process. Big thanks to [@caarlos0](https://github.com/caarlos0) for great and super-fast support fixing issues along the way.
-
-Hugo now has:
-
-* 16619+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 458+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 156+ [themes](http://themes.gohugo.io/)
-
-## Enhancement
-
-* Automate the Hugo release process [550eba64](https://github.com/gohugoio/hugo/commit/550eba64705725eb54fdb1042e0fb4dbf6f29fd0) [@bep](https://github.com/bep) [#3358](https://github.com/gohugoio/hugo/issues/3358)
-
-## Fix
-
-* Fix handling of zero-length files [9bf5c381](https://github.com/gohugoio/hugo/commit/9bf5c381b6b3e69d4d8dbfd7a40074ac44792bbf) [@bep](https://github.com/bep) [#3355](https://github.com/gohugoio/hugo/issues/3355) -
\ No newline at end of file
diff --git a/docs/content/news/0-20-4.md b/docs/content/news/0-20-4.md
@@ -1,23 +0,0 @@
----
-date: 2017-04-24T17:53:58-04:00
-categories: ["Releases"]
-description: "This is the second bug-fix release of the day, fixing a couple of issues related to the new release scripts"
-link: ""
-title: "Hugo 0.20.4"
-draft: false
-author: bep
----
-
-This is the second bug-fix release of the day, fixing a couple of issues related to the new release scripts.
-
-Hugo now has:
-
-* 16626+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 457+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 156+ [themes](http://themes.gohugo.io/)
-
-## Fixes
-
-* Fix statically linked binaries [275bcf56](https://github.com/gohugoio/hugo/commit/275bcf566c7cb72367d4423cf4810319311ff680) [@munnerz](https://github.com/munnerz) [#3382](https://github.com/gohugoio/hugo/issues/3382)
-* Filename change in Hugo 0.20.3 binaries [#3385](https://github.com/gohugoio/hugo/issues/3385)
-* Fix version calculation [cb3c6b6f](https://github.com/gohugoio/hugo/commit/cb3c6b6f7670f85189a4a3637e7132901d1ed6e9) [@bep](https://github.com/bep) -
\ No newline at end of file
diff --git a/docs/content/news/0-20-5.md b/docs/content/news/0-20-5.md
@@ -1,11 +0,0 @@
----
-date: 2017-04-25T17:53:58-04:00
-categories: ["Releases"]
-description: ""
-link: ""
-title: "Hugo 0.20.5"
-draft: false
-author: bep
----
-
-This is a bug-fix release which fixes the version number of `0.20.4` (which wrongly shows up as `0.21-DEV`) ([#3388](https://github.com/gohugoio/hugo/issues/3388)).-
\ No newline at end of file
diff --git a/docs/content/news/0-20-6.md b/docs/content/news/0-20-6.md
@@ -1,23 +0,0 @@
----
-date: 2017-04-27T17:53:58-04:00
-categories: ["Releases"]
-description: ""
-link: ""
-title: "Hugo 0.20.6"
-draft: false
-author: bep
----
-
-There have been some [shouting on discuss.gohugo.io](https://discuss.gohugo.io/t/index-md-is-generated-in-subfolder-index-index-html-hugo-0-20/6338/15) about some broken sites after the release of Hugo `0.20`. This release reintroduces the old behaviour, making `/my-blog-post/index.md` work as expected.
-
-Hugo now has:
-
-* 16675+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 456+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 156+ [themes](http://themes.gohugo.io/)
-
-## Fixes
-
-* Avoid index.md in /index/index.html [#3396](https://github.com/gohugoio/hugo/issues/3396)
-* Make missing GitInfo a WARNING [b30ca4be](https://github.com/gohugoio/hugo/commit/b30ca4bec811dbc17e9fd05925544db2b75e0e49) [@bep](https://github.com/bep) [#3376](https://github.com/gohugoio/hugo/issues/3376)
-* Fix some of the fpm fields for deb [3bd1d057](https://github.com/gohugoio/hugo/commit/3bd1d0571d5f2f6bf0dc8f90a8adf2dbfcb2fdfd) [@anthonyfok](https://github.com/anthonyfok) -
\ No newline at end of file
diff --git a/docs/content/news/0-20-7.md b/docs/content/news/0-20-7.md
@@ -1,22 +0,0 @@
----
-date: 2017-05-03T17:53:58-04:00
-categories: ["Releases"]
-description: "This just fixes an issue with the release scripts, no change in the binaries"
-link: ""
-title: "Hugo 0.20.7"
-draft: false
-author: bep
----
-
-This just fixes an issue with the release scripts, no change in the binaries.
-
-
-Hugo now has:
-
-* 16782+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 458+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 156+ [themes](http://themes.gohugo.io/)
-
-## Fix
-
-* Push the tag before goreleaser is run [3682bf52](https://github.com/gohugoio/hugo/commit/3682bf527989e86d9da32d76809306cb576383e8) [@bep](https://github.com/bep) [#3405](https://github.com/gohugoio/hugo/issues/3405) -
\ No newline at end of file
diff --git a/docs/content/news/0-20.md b/docs/content/news/0-20.md
@@ -1,71 +0,0 @@
----
-date: 2017-04-10T13:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.20 introduces the powerful and long sought after feature Custom Output Formats"
-link: ""
-title: "Hugo 0.20"
-draft: false
-author: bep
----
-
-Hugo `0.20` introduces the powerful and long sought after feature [Custom Output Formats](http://gohugo.io/extras/output-formats/); Hugo isn’t just that “static HTML with an added RSS feed” anymore. _Say hello_ to calendars, e-book formats, Google AMP, and JSON search indexes, to name a few ( [#2828](//github.com/gohugoio/hugo/issues/2828) ).
-
-This release represents **over 180 contributions by over 30 contributors** to the main Hugo code base. Since last release Hugo has **gained 1100 stars, 20 new contributors and 5 additional themes.**
-
-Hugo now has:
-
-* 16300+ stars
-* 495+ contributors
-* 156+ themes
-
-[@bep](//github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. Also a big shoutout to [@digitalcraftsman](//github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition, and [@moorereason](//github.com/moorereason) and [@bogem](//github.com/bogem) for their ongoing contributions.
-
-## Other Highlights
-
-[@bogem](//github.com/bogem) has also contributed TOML as an alternative and much simpler format for language/i18n files ([#3200](//github.com/gohugoio/hugo/issues/3200)). A feature you will appreciate when you start to work on larger translations.
-
-Also, there have been some important updates in the Emacs Org-mode handling: [@chaseadamsio](//github.com/chaseadamsio) has fixed the newline-handling ( [#3126](//github.com/gohugoio/hugo/issues/3126) ) and [@clockoon](//github.com/clockoon) has added basic footnote support.
-
-Worth mentioning is also the ongoing work that [@rdwatters](//github.com/rdwatters) and [@budparr](//github.com/budparr) is doing to re-do the [gohugo.io](https://gohugo.io/) site, including a total restructuring and partial rewrite of the documentation. It is getting close to finished, and it looks fantastic!
-
-## Notes
-
-* `RSS` description in the built-in template is changed from full `.Content` to `.Summary`. This is a somewhat breaking change, but is what most people expect from their RSS feeds. If you want full content, please provide your own RSS template.
-* The deprecated `.RSSlink` is now removed. Use `.RSSLink`.
-* `RSSUri` is deprecated and will be removed in a future Hugo version, replace it with an output format definition.
-* The deprecated `.Site.GetParam` is now removed, use `.Site.Param`.
-* Hugo does no longer append missing trailing slash to `baseURL` set as a command line parameter, making it consistent with how it behaves from site config. [#3262](//github.com/gohugoio/hugo/issues/3262)
-
-## Enhancements
-
-* Hugo `0.20` is built with Go 1.8.1.
-* Add `.Site.Params.mainSections` that defaults to the section with the most pages. Plan is to get themes to use this instead of the hardcoded `blog` in `where` clauses. [#3206](//github.com/gohugoio/hugo/issues/3206)
-* File extension is now configurable. [#320](//github.com/gohugoio/hugo/issues/320)
-* Impove `markdownify` template function performance. [#3292](//github.com/gohugoio/hugo/issues/3292)
-* Add taxonomy terms’ pages to `.Data.Pages` [#2826](//github.com/gohugoio/hugo/issues/2826)
-* Change `RSS` description from full `.Content` to `.Summary`.
-* Ignore “.” dirs in `hugo --cleanDestinationDir` [#3202](//github.com/gohugoio/hugo/issues/3202)
-* Allow `jekyll import` to accept both `2006-01-02` and `2006-1-2` date format [#2738](//github.com/gohugoio/hugo/issues/2738)
-* Raise the default `rssLimit` [#3145](//github.com/gohugoio/hugo/issues/3145)
-* Unify section list vs single template lookup order [#3116](//github.com/gohugoio/hugo/issues/3116)
-* Allow `apply` to be used with the built-in Go template funcs `print`, `printf` and `println`. [#3139](//github.com/gohugoio/hugo/issues/3139)
-
-## Fixes
-
-* Fix deadlock in `getJSON` [#3211](//github.com/gohugoio/hugo/issues/3211)
-* Make sure empty terms pages are created. [#2977](//github.com/gohugoio/hugo/issues/2977)
-* Fix base template lookup order for sections [#2995](//github.com/gohugoio/hugo/issues/2995)
-* `URL` fixes:
- * Fix pagination URLs with `baseURL` with sub-root and `canonifyUrls=false` [#1252](//github.com/gohugoio/hugo/issues/1252)
- * Fix pagination URL for resources with “.” in name [#2110](//github.com/gohugoio/hugo/issues/2110) [#2374](//github.com/gohugoio/hugo/issues/2374) [#1885](//github.com/gohugoio/hugo/issues/1885)
- * Handle taxonomy names with period [#3169](//github.com/gohugoio/hugo/issues/3169)
- * Handle `uglyURLs` ambiguity in `Permalink` [#3102](//github.com/gohugoio/hugo/issues/3102)
- * Fix `Permalink` for language-roots wrong when `uglyURLs` is `true` [#3179](//github.com/gohugoio/hugo/issues/3179)
- * Fix misc case issues for `URLs` [#1641](//github.com/gohugoio/hugo/issues/1641)
- * Fix for taxonomies URLs when `uglyUrls=true` [#1989](//github.com/gohugoio/hugo/issues/1989)
- * Fix empty `RSSLink` for list pages with content page. [#3131](//github.com/gohugoio/hugo/issues/3131)
-* Correctly identify regular pages on the form “my_index_page.md” [#3234](//github.com/gohugoio/hugo/issues/3234)
-* `Exit -1` on `ERROR` in global logger [#3239](//github.com/gohugoio/hugo/issues/3239)
-* Document hugo `help command` [#2349](//github.com/gohugoio/hugo/issues/2349)
-* Fix internal `Hugo` version handling for bug fix releases. [#3025](//github.com/gohugoio/hugo/issues/3025)
-* Only return `RSSLink` for pages that actually have a RSS feed. [#1302](//github.com/gohugoio/hugo/issues/1302)-
\ No newline at end of file
diff --git a/docs/content/news/0-21.md b/docs/content/news/0-21.md
@@ -1,104 +0,0 @@
----
-date: 2017-05-22T17:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.21 brings full support for shortcodes per Output Format, the last vital piece of that puzzle"
-link: ""
-title: "Hugo 0.21"
-draft: false
-author: bep
----
-
-Hugo `0.21` brings full support for shortcodes per [Output Format](https://gohugo.io/extras/output-formats/) ([#3220](https://github.com/gohugoio/hugo/issues/3220)), the last vital piece of that puzzle. This is especially useful for `Google AMP` with its many custom media tags.
-
-This release represents **126 contributions by 29 contributors** to the main Hugo code base. Since last main release Hugo has **gained 850 stars and 7 additional themes**.
-
-Hugo now has:
-
-* 17156+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 457+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 163+ [themes](http://themes.gohugo.io/)
-
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@bogem](https://github.com/bogem), and [@munnerz](https://github.com/munnerz) for their ongoing contributions. And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-## Other Highlights
-
-On a more technical side, [@moorereason](https://github.com/moorereason) and [@bep](https://github.com/bep) have introduced namespaces for Hugo's many template funcs ([#3042](https://github.com/gohugoio/hugo/issues/3042) ). There are so many now, and adding more into that big pile would be a sure path toward losing control. Now they are nicely categorised into namespaces with its own tests and examples, with an API that the documentation site can use to make sure it is correct and up-to-date.
-
-## Notes
-
-* The deprecated `.Extension`, `.Now` and `.TargetPath` will now `ERROR` [544f0a63](https://github.com/gohugoio/hugo/commit/544f0a6394b0e085d355e8217fc5bb3d96c12a98) [@bep](https://github.com/bep)
-* The config settings and flags `disable404`, `disableRSS`, `disableSitemap`, `disableRobotsTXT` are now deprecated. Use `disableKinds`. [5794a265](https://github.com/gohugoio/hugo/commit/5794a265b41ffdeebfd8485eecf65cf4088d49d6) [@bep](https://github.com/bep) [#3345](https://github.com/gohugoio/hugo/issues/3345)
-
-## Enhancements
-
-### Templates
-
-* Log a WARNING on wrong usage of `IsSet` [38661c17](https://github.com/gohugoio/hugo/commit/38661c17bb8c31c9f31ee18f8eba5e3bfddd5574) [@moorereason](https://github.com/moorereason) [#3092](https://github.com/gohugoio/hugo/issues/3092)
-* Add support for ellipsed paginator navigator, making paginators with lots of pages more compact [b6ea492b](https://github.com/gohugoio/hugo/commit/b6ea492b7a6325d04d44eeb00a990a3a0e29e0c0) [@bep](https://github.com/bep) [#3466](https://github.com/gohugoio/hugo/issues/3466)
-* Add support for interfaces to `intersect` [f1c29b01](https://github.com/gohugoio/hugo/commit/f1c29b017bbd88e701cd5151dd186e868672ef89) [@moorereason](https://github.com/moorereason) [#1952](https://github.com/gohugoio/hugo/issues/1952)
-* Add `NumFmt` function [93b3b138](https://github.com/gohugoio/hugo/commit/93b3b1386714999d716e03b131f77234248f1724) [@moorereason](https://github.com/moorereason) [#1444](https://github.com/gohugoio/hugo/issues/1444)
-* Add template function namespaces [#3418](https://github.com/gohugoio/hugo/issues/3418) [#3042](https://github.com/gohugoio/hugo/issues/3042) [@moorereason](https://github.com/moorereason) [@bep](https://github.com/bep)
-* Add translation links to the default sitemap template [90d3fbf1](https://github.com/gohugoio/hugo/commit/90d3fbf1da93a279cfe994a226ae82cf5441deab) [@rayjolt](https://github.com/rayjolt) [#2569](https://github.com/gohugoio/hugo/issues/2569)
-* Allow text partials in HTML templates and the other way around [1cf29200](https://github.com/gohugoio/hugo/commit/1cf29200b4bb0a9c006155ec76759b7f4b1ad925) [@bep](https://github.com/bep) [#3273](https://github.com/gohugoio/hugo/issues/3273)
-
-### Output
-
-* Refactor site rendering with an "output format context". In this release, this is used for shortcode handling only, but this paves the way for future niceness [1e4d082c](https://github.com/gohugoio/hugo/commit/1e4d082cf5b92fedbc60b1b4f0e9d1ee6ec45e33) [@bep](https://github.com/bep) [#3397](https://github.com/gohugoio/hugo/issues/3397) [2bcbf104](https://github.com/gohugoio/hugo/commit/2bcbf104006e0ec03be4fd500f2519301d460f8c) [@bep](https://github.com/bep) [#3220](https://github.com/gohugoio/hugo/issues/3220)
-
-
-### Core
-
-* Handle `shortcode` per `Output Format` [af72db80](https://github.com/gohugoio/hugo/commit/af72db806f2c1c0bf1dfe5832275c41eeba89906) [@bep](https://github.com/bep) [#3220](https://github.com/gohugoio/hugo/issues/3220)
-* Improve shortcode error message [58d9cbd3](https://github.com/gohugoio/hugo/commit/58d9cbd31bcf7c296a39860fd7e566d10faaff28) [@bep](https://github.com/bep)
-* Avoid `index.md` in `/index/index.html` [fea4fd86](https://github.com/gohugoio/hugo/commit/fea4fd86a324bf9679df23f8289887d91b42e919) [@bep](https://github.com/bep) [#3396](https://github.com/gohugoio/hugo/issues/3396)
-* Make missing `GitInfo` a `WARNING` [5ad2f176](https://github.com/gohugoio/hugo/commit/5ad2f17693a9860be76ef8089c8728d2b59d6b04) [@bep](https://github.com/bep) [#3376](https://github.com/gohugoio/hugo/issues/3376)
-* Prevent decoding `pageParam` in common cases [e98f885b](https://github.com/gohugoio/hugo/commit/e98f885b8af27f5473a89d31d0b1f02e61e8a5ec) [@bogem](https://github.com/bogem)
-* Ignore non-source files on partial rebuild [b5b6e81c](https://github.com/gohugoio/hugo/commit/b5b6e81c0269abf9b0f4bc6a127744a25344e5c6) [@xofyarg](https://github.com/xofyarg) [#3325](https://github.com/gohugoio/hugo/issues/3325)
-* Log `WARNING` only on unknown `/data` files [ab692e73](https://github.com/gohugoio/hugo/commit/ab692e73dea3ddfe979c88ee236cc394e47e82f1) [@bep](https://github.com/bep) [#3361](https://github.com/gohugoio/hugo/issues/3361)
-* Avoid processing the same notify event twice [3b677594](https://github.com/gohugoio/hugo/commit/3b67759495c9268c30e6ba2d8c7e3b75d52d2960) [@bep](https://github.com/bep)
-* Only show `rssURI` deprecation `WARNING` if it is actually set [cfd3af8e](https://github.com/gohugoio/hugo/commit/cfd3af8e691119461effa4385251b9d3818e2291) [@bep](https://github.com/bep) [#3319](https://github.com/gohugoio/hugo/issues/3319)
-
-### Docs
-
-* Add documentation on slug translation [635b3bb4](https://github.com/gohugoio/hugo/commit/635b3bb4eb873978c7d52e6c0cb85da0c4d25299) [@xavib](https://github.com/xavib)
-* Replace `cdn.mathjax.org` with `cdnjs.cloudflare.com` [4b637ac0](https://github.com/gohugoio/hugo/commit/4b637ac041d17b22187f5ccd0f65461f0065aaa9) [@takuti](https://github.com/takuti)
-* Add notes about some output format behaviour [162d3a58](https://github.com/gohugoio/hugo/commit/162d3a586d36cabf6376a76b096fd8b6414487ae) [@jpatters](https://github.com/jpatters)
-* Add `txtpen` as alternative commenting service [7cdc244a](https://github.com/gohugoio/hugo/commit/7cdc244a72de4c08edc0008e37aec83d945dccdf) [@rickyhan](https://github.com/rickyhan)
-
-### Other
-
-* Embed `Page` in `WeightedPage` [ebf677a5](https://github.com/gohugoio/hugo/commit/ebf677a58360126d8b9a1e98d086aa4279f53181) [@bep](https://github.com/bep) [#3435](https://github.com/gohugoio/hugo/issues/3435)
-* Improve the detection of untranslated strings [a40d1f6e](https://github.com/gohugoio/hugo/commit/a40d1f6ed2aedddc99725658993258cd557640ed) [@bogem](https://github.com/bogem) [#2607](https://github.com/gohugoio/hugo/issues/2607)
-* Make first letter of the Hugo commands flags' usage lowercase [f0f69d03](https://github.com/gohugoio/hugo/commit/f0f69d03c551acb8ac2eeedaad579cf0b596f9ef) [@bogem](https://github.com/bogem)
-* Import `Octopress` image tag in `Jekyll importer` [5f3ad1c3](https://github.com/gohugoio/hugo/commit/5f3ad1c31985450fab8d6772e9cbfcb57cf5cc53) [@buynov](https://github.com/buynov)
-
-## Fixes
-
-### Templates
-
-* Do not lower case template names [6d2ea0f7](https://github.com/gohugoio/hugo/commit/6d2ea0f7d7e8a54b8edfc36e52ff74266c30dc27) [@bep](https://github.com/bep) [#3333](https://github.com/gohugoio/hugo/issues/3333)
-
-### Output
-
-* Fix output format mixup in example [10287263](https://github.com/gohugoio/hugo/commit/10287263f529181d3169668b044cb84e2e3b049a) [@bep](https://github.com/bep) [#3481](https://github.com/gohugoio/hugo/issues/3481)
-* Fix base theme vs project base template logic [077005e5](https://github.com/gohugoio/hugo/commit/077005e514b1ed50d84ceb90c7c72f184cb04521) [@bep](https://github.com/bep) [#3323](https://github.com/gohugoio/hugo/issues/3323)
-
-### Core
-* Render `404` in default language only [154e18dd](https://github.com/gohugoio/hugo/commit/154e18ddb9ad205055d5bd4827c87f3f0daf499f) [@mitchchn](https://github.com/mitchchn) [#3075](https://github.com/gohugoio/hugo/issues/3075)
-* Fix `RSSLink` vs `RSS` `Output Format` [e682fcc6](https://github.com/gohugoio/hugo/commit/e682fcc62233b47cf5bdcaf598ac0657ef089471) [@bep](https://github.com/bep) [#3450](https://github.com/gohugoio/hugo/issues/3450)
-* Add default config for `ignoreFiles`, making that option work when running in server mode [42f4ce15](https://github.com/gohugoio/hugo/commit/42f4ce15a9d68053da36f9efcf7a7d975cc59559) [@chaseadamsio](https://github.com/chaseadamsio)
-* Fix output formats override when no outputs definition given [6e2f2dd8](https://github.com/gohugoio/hugo/commit/6e2f2dd8d3ca61c92a2ee8824fbf05cadef08425) [@bep](https://github.com/bep) [#3447](https://github.com/gohugoio/hugo/issues/3447)
-* Fix handling of zero-length files [0e87b18b](https://github.com/gohugoio/hugo/commit/0e87b18b66d2c8ba9e2abc429630cb03f5b093d6) [@bep](https://github.com/bep) [#3355](https://github.com/gohugoio/hugo/issues/3355)
-* Must recreate `Paginator` on live-reload [45c74526](https://github.com/gohugoio/hugo/commit/45c74526686f6a2afa02bcee767d837d6b9dd028) [@bep](https://github.com/bep) [#3315](https://github.com/gohugoio/hugo/issues/3315)
-
-### Docs
-
-* Fix incorrect path in `templates/list` [27e88154](https://github.com/gohugoio/hugo/commit/27e88154af2dd9af6d0523d6e67b612e6336f91c) [@MunifTanjim](https://github.com/MunifTanjim)
-* Fixed incorrect specification of directory structure [a28fbca6](https://github.com/gohugoio/hugo/commit/a28fbca6dcfa80b6541f5ef6c8c12cd1804ae9ed) [@TejasQ](https://github.com/TejasQ)
-* Fix `bash` command in `tutorials/github-pages-blog` [c9976155](https://github.com/gohugoio/hugo/commit/c99761555c014e4d041438d5d7e53a6cbaee4492) [@hansott](https://github.com/hansott)
-* Fix `.Data.Pages` range in example [b5e32eb6](https://github.com/gohugoio/hugo/commit/b5e32eb60993b4656918af2c959ae217a68c461e) [@hxlnt](https://github.com/hxlnt)
-
-### Other
-
-* Fix data race in live-reload close, avoiding some rare panics [355736ec](https://github.com/gohugoio/hugo/commit/355736ec357c81dfb2eb6851ee019d407090c5ec) [@bep](https://github.com/bep) [#2625](https://github.com/gohugoio/hugo/issues/2625)
-* Skip `.git` directories in file scan [94b5be67](https://github.com/gohugoio/hugo/commit/94b5be67fc73b87d114d94a7bb1a33ab997f30f1) [@bogem](https://github.com/bogem) [#3468](https://github.com/gohugoio/hugo/issues/3468) -
\ No newline at end of file
diff --git a/docs/content/news/0-22-1.md b/docs/content/news/0-22-1.md
@@ -1,36 +0,0 @@
----
-date: 2017-06-13T17:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.22.1 fixes a couple of issues reported after the 0.22 release"
-link: ""
-title: "Hugo 0.22.1"
-draft: false
-author: bep
----
-
-Hugo `0.22.1` fixes a couple of issues reported after the [0.22 release](https://github.com/gohugoio/hugo/releases/tag/v0.22) Monday. Most importantly a fix for detecting regular subfolders below the root-sections.
-
-Also, we forgot to adapt the `permalink settings` with support for nested sections, which made that feature less useful than it could be.
-
-With this release you can configure **permalinks with sections** like this:
-
-**First level only:**
-
-```
-[permalinks]
-blog = ":section/:title"
-```
-
-**Nested (all levels):**
-
-```
-[permalinks]
-blog = ":sections/:title"
-```
-## Fixes
-
-* Fix section logic for root folders with subfolders [a30023f5](https://github.com/gohugoio/hugo/commit/a30023f5cbafd06034807255181a5b7b17f3c25f) [@bep](https://github.com/bep) [#3586](https://github.com/gohugoio/hugo/issues/3586)
-* Support sub-sections in permalink settings [1f26420d](https://github.com/gohugoio/hugo/commit/1f26420d392a5ab4c7b7fe1911c0268b45d01ab8) [@bep](https://github.com/bep) [#3580](https://github.com/gohugoio/hugo/issues/3580)
-* Adjust rlimit to 64000 [ff54b6bd](https://github.com/gohugoio/hugo/commit/ff54b6bddcefab45339d8dc2b13776b92bdc04b9) [@bep](https://github.com/bep) [#3582](https://github.com/gohugoio/hugo/issues/3582)
-* Make error on setting rlimit a warning only [629e1439](https://github.com/gohugoio/hugo/commit/629e1439e819a7118ae483381d4634f16d3474dd) [@bep](https://github.com/bep) [#3582](https://github.com/gohugoio/hugo/issues/3582)
-* Revert: Remove the rlimit tweaking on macOS [26aa06a3](https://github.com/gohugoio/hugo/commit/26aa06a3db57ab7134a900d641fa2976f7971520) [@bep](https://github.com/bep) [#3582](https://github.com/gohugoio/hugo/issues/3582)-
\ No newline at end of file
diff --git a/docs/content/news/0-22.md b/docs/content/news/0-22.md
@@ -1,88 +0,0 @@
----
-date: 2017-06-12T17:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.22 brings nested sections, by popular demand and a long sought after feature"
-link: ""
-title: "Hugo 0.22"
-draft: false
-author: bep
----
-
-
-Hugo `0.22` brings **nested sections**, by popular demand and a long sought after feature ([#465](https://github.com/gohugoio/hugo/issues/465)). We are still low on documentation for this great feature, but [@bep](https://github.com/bep) has been kind enough to accompany his implementation with a [demo site](http://hugotest.bep.is/).
-
-This release represents **58 contributions by 10 contributors** to the main Hugo code base. Since last release Hugo has **gained 420 stars and 2 additional themes.**
-
-[@bep](https://github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. But also a big shoutout to [@bogem](https://github.com/bogem), [@moorereason](https://github.com/moorereason), and [@onedrawingperday](https://github.com/onedrawingperday) for their ongoing contributions. And as always big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Hugo now has:
-
-* 17576+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 165+ [themes](http://themes.gohugo.io/)
-
-## Other Highlights
-
-`.Site.GetPage` can now also be used to get regular pages ([#2844](https://github.com/gohugoio/hugo/issues/2844)):
-
-```
-{{ (.Site.GetPage "page" "blog" "mypost.md" ).Title }}
-```
-
-Also, considerable work has been put into writing automated benchmark tests for the site builds, and we're happy to report that although this release comes with fundamental structural changes, this version is -- in general -- even faster than the previous. It’s quite a challenge to consistently add significant new functionality and simultaneously maintain the stellar performance Hugo is famous for.
-
-
-
-## Notes
-
-`.Site.Sections` is replaced. We have reworked how sections work in Hugo, they can now be nested and are no longer taxonomies. If you use the old collection, you should get detailed upgrade instructions in the log when you run `hugo`. For more information, see this [demo site](http://hugotest.bep.is/).
-
-## Enhancements
-
-### Templates
-
-* Add `uint` support to `In` [b82cd82f](https://github.com/gohugoio/hugo/commit/b82cd82f1198a371ed94bda7faafe22813f4cb29) [@moorereason](https://github.com/moorereason)
-* Support interfaces in `union` [204c3a9e](https://github.com/gohugoio/hugo/commit/204c3a9e32fcf6617ede978e35d3e2e89a5b491c) [@moorereason](https://github.com/moorereason) [#3411](https://github.com/gohugoio/hugo/issues/3411)
-* Add `uniq` function [e28d9aa4](https://github.com/gohugoio/hugo/commit/e28d9aa42c3429d22fe254e69e4605aaf1e684f3) [@adiabatic](https://github.com/adiabatic)
-* Handle `template.HTML` and friends in `ToInt` [4113693a](https://github.com/gohugoio/hugo/commit/4113693ac1b275f3a40aa5c248269340ef9b57f6) [@moorereason](https://github.com/moorereason) [#3308](https://github.com/gohugoio/hugo/issues/3308)
-
-
-### Core
-
-* Make the `RSS feed` use the date for the node it represents [f1da5a15](https://github.com/gohugoio/hugo/commit/f1da5a15a37666ee59350d6600a8c14c1383f5bc) [@bep](https://github.com/bep) [#2708](https://github.com/gohugoio/hugo/issues/2708)
-* Enable `nested sections` [b3968939](https://github.com/gohugoio/hugo/commit/b39689393ccb8434d9a57658a64b77568c718e99) [@bep](https://github.com/bep) [#465](https://github.com/gohugoio/hugo/issues/465)
-* Add test for "no 404" in `sitemap` [8aaec644](https://github.com/gohugoio/hugo/commit/8aaec644a90d09bd7f079d35d382f76bb4ed35db) [@bep](https://github.com/bep) [#3563](https://github.com/gohugoio/hugo/issues/3563)
-* Support regular pages in `.Site.GetPage` [e0c2e798](https://github.com/gohugoio/hugo/commit/e0c2e798201f75ae6e9a81a7442355288c2d141b) [@bep](https://github.com/bep) [#2844](https://github.com/gohugoio/hugo/issues/2844)
-[#3082](https://github.com/gohugoio/hugo/issues/3082)
-
-### Performance
-* Add site building benchmarks [8930e259](https://github.com/gohugoio/hugo/commit/8930e259d78cba4041b550cc51a7f40bc91d7c20) [@bep](https://github.com/bep) [#3535](https://github.com/gohugoio/hugo/issues/3535)
-* Add a cache to `GetPage` which makes it much faster [50d11138](https://github.com/gohugoio/hugo/commit/50d11138f3e18b545c15fadf52f7b0b744bf3e7c) [@bep](https://github.com/bep)
-* Speed up `GetPage` [fbb78b89](https://github.com/gohugoio/hugo/commit/fbb78b89df8ccef8f0ab26af00aa45d35c1ee2cf) [@bep](https://github.com/bep) [#3503](https://github.com/gohugoio/hugo/issues/3503)
-* Add BenchmarkFrontmatterTags [3d9c4f51](https://github.com/gohugoio/hugo/commit/3d9c4f513b0443648d7e88995e351df1739646d2) [@bep](https://github.com/bep) [#3464](https://github.com/gohugoio/hugo/issues/3464)
-* Add `benchSite.sh` to make it easy to run Hugo performance benchmarks [d74452cf](https://github.com/gohugoio/hugo/commit/d74452cfe8f69a85ec83e05481e16bebf199a5cb) [@bep](https://github.com/bep)
-* Cache language config [4aff2b6e](https://github.com/gohugoio/hugo/commit/4aff2b6e7409a308f30cff1825fec02991e0d56a) [@bep](https://github.com/bep)
-* Temporarily revert to BurntSushi for `TOML` front matter handling; it is currently much faster [0907a5c1](https://github.com/gohugoio/hugo/commit/0907a5c1c293755e6bf297246f07888448d81f8b) [@bep](https://github.com/bep) [#3541](https://github.com/gohugoio/hugo/issues/3541) [#3464](https://github.com/gohugoio/hugo/issues/3464)
-* Add a simple partitioned lazy cache [87203139](https://github.com/gohugoio/hugo/commit/87203139c38e0b992c96d7b8a23c7730649c68e5) [@bep](https://github.com/bep)
-
-### Other
-
-* Add `noindex` tag to HTML generated by Hugo aliases [d5ab7f08](https://github.com/gohugoio/hugo/commit/d5ab7f087d967b30e7de7d789e6ad3091b42f1f7) [@onedrawingperday](https://github.com/onedrawingperday)
-* Update Go versions [bde807bd](https://github.com/gohugoio/hugo/commit/bde807bd1e560fb4cc765c0fc22132db7f8a0801) [@bep](https://github.com/bep)
-* Remove the `rlimit` tweaking on `macOS` [bcd32f10](https://github.com/gohugoio/hugo/commit/bcd32f1086c8c604fb22a7496924e41cc46b1605) [@bep](https://github.com/bep) [#3512](https://github.com/gohugoio/hugo/issues/3512)
-
-### Docs
-* Rewrite “Archetypes” article [@davidturnbull](https://github.com/davidturnbull) [#3543](https://github.com/gohugoio/hugo/pull/3543/)
-* Remove Unmaintaned Frontends from Tools. [f41f7282](https://github.com/gohugoio/hugo/commit/f41f72822251c9a31031fd5b3dda585c57c8b028) [@onedrawingperday](https://github.com/onedrawingperday)
-
-## Fixes
-
-### Core
-* Improve `live-reload` on directory structure changes making removal of directories or pasting new content directories into `/content` just work [fe901b81](https://github.com/gohugoio/hugo/commit/fe901b81191860b60e6fcb29f8ebf87baef2ee79) [@bep](https://github.com/bep) [#3570](https://github.com/gohugoio/hugo/issues/3570)
-* Respect `disableKinds=["sitemap"]` [69d92dc4](https://github.com/gohugoio/hugo/commit/69d92dc49cb8ab9276ab013d427ba2d9aaf9135d) [@bep](https://github.com/bep) [#3544](https://github.com/gohugoio/hugo/issues/3544)
-* Fix `disablePathToLower` regression [5be04486](https://github.com/gohugoio/hugo/commit/5be0448635fdf5fe6b1ee673e869f2b9baf1a5c6) [@bep](https://github.com/bep) [#3374](https://github.com/gohugoio/hugo/issues/3374)
-* Fix `ref`/`relref` issue with duplicate base filenames [612f6e3a](https://github.com/gohugoio/hugo/commit/612f6e3afe0510c31f70f3621f3dc8ba609dade4) [@bep](https://github.com/bep) [#2507](https://github.com/gohugoio/hugo/issues/2507)
-
-### Docs
-
-* Fix parameter name in `YouTube` shortcode section [37e37877](https://github.com/gohugoio/hugo/commit/37e378773fbc127863f2b7a389d5ce3a14674c73) [@zivbk1](https://github.com/zivbk1) -
\ No newline at end of file
diff --git a/docs/content/news/0-23.md b/docs/content/news/0-23.md
@@ -1,45 +0,0 @@
----
-date: 2017-06-16T17:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.23 is mainly a release that handles all the small changes needed to get Hugo moved to a GitHub organisation"
-link: ""
-title: "Hugo 0.23"
-draft: false
-author: bep
----
-
-Hugo `0.23` is mainly a release that handles all the small changes needed to get Hugo moved to a GitHub organisation: [gohugoio](https://github.com/gohugoio), but it also contains a couple of important fixes that makes this an update worth-while for all.
-
-Hugo now has:
-
-* 17739+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 494+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 165+ [themes](http://themes.gohugo.io/)
-
-## Fixes
-
-* Fix handling of duplicate footnotes [a9e551a1](https://github.com/gohugoio/hugo/commit/a9e551a100e60a603210ee083103dd73369d6a98) [@bep](https://github.com/bep) [#1912](https://github.com/gohugoio/hugo/issues/1912)
-* Add support for spaces in project folder for `GitInfo` #3533 #3552
-
-## GitHub organisation related changes
-
-* Update layout references to gohugoio/hugo [66d4850b](https://github.com/gohugoio/hugo/commit/66d4850b89db293dc58e828de784037f06c6c8dc) [@bep](https://github.com/bep)
-* Update content references to gohugoio/hugo [715ff1f8](https://github.com/gohugoio/hugo/commit/715ff1f87406edf27738c8c0f52fe185fa974ee8) [@bep](https://github.com/bep)
-* Add note on updates for rpm-based distros [52a0cea6](https://github.com/gohugoio/hugo/commit/52a0cea65de7b75ae1662abe3dec36fca3604617) [@daftaupe](https://github.com/daftaupe)
-* Update logo link in README [ccb8300d](https://github.com/gohugoio/hugo/commit/ccb8300d380636d75a39f4133284eb0109e836c3) [@bep](https://github.com/bep)
-* Remove docs building from CI builds [214dbdfb](https://github.com/gohugoio/hugo/commit/214dbdfb6f016d21415bc1ed511a37a084238878) [@bep](https://github.com/bep)
-* Adjust docs path [729be807](https://github.com/gohugoio/hugo/commit/729be8074bddb58c9111f32c55cc769e49cd0d5a) [@bep](https://github.com/bep)
-* Add docs as submodule [6cee0dfe](https://github.com/gohugoio/hugo/commit/6cee0dfe53899d433afc3c173a87d56265904cb0) [@bep](https://github.com/bep)
-* Update Gitter link in README [fbb25014](https://github.com/gohugoio/hugo/commit/fbb25014e1306ce7127d53e5fc4fc49867790336) [@bep](https://github.com/bep)
-* Change Windows build badge link, take #3 [86543d6a](https://github.com/gohugoio/hugo/commit/86543d6a50251b40540ebd0b851d45eb99d017c7) [@bep](https://github.com/bep)
-* Update Windows build link [e6ae32a0](https://github.com/gohugoio/hugo/commit/e6ae32a0ba75b9894418227e87391defbb1b3b49) [@bep](https://github.com/bep)
-* Update links in CONTRIBUTING.md due to the org transition [95386544](https://github.com/gohugoio/hugo/commit/95386544e858949a2baa414f395f30aaf66a6257) [@digitalcraftsman](https://github.com/digitalcraftsman)
-* Update source path in Dockerfile due to the org transition [7b99fb9f](https://github.com/gohugoio/hugo/commit/7b99fb9f1ca8381457afe9d8e953a388b8ada182) [@digitalcraftsman](https://github.com/digitalcraftsman)
-* Update clone folder in appveyor.yml due to the org transition [d531d17b](https://github.com/gohugoio/hugo/commit/d531d17b3be0b14faf4934611e01ac3289e37835) [@digitalcraftsman](https://github.com/digitalcraftsman)
-* Update import path in snapcraft.yaml due to the org transition [9266bf9d](https://github.com/gohugoio/hugo/commit/9266bf9d4c24592b875a7f6b92f761b4cea40879) [@digitalcraftsman](https://github.com/digitalcraftsman)
-* Run gofmt to get imports in line vs gohugoio/hugo [873a6f18](https://github.com/gohugoio/hugo/commit/873a6f18851bcda79d562ff6c02e1109e8e31a88) [@bep](https://github.com/bep)
-* Update Makefile vs gohugoio/hugo [f503d76a](https://github.com/gohugoio/hugo/commit/f503d76a3b2719bbb65ab9df5595d0dbc871fae9) [@bep](https://github.com/bep)
-* Update README to point to gohugoio/hugo [93643860](https://github.com/gohugoio/hugo/commit/93643860c9db10c6c32176b17cc83f1c317279bd) [@bep](https://github.com/bep)
-* Update examples to point to gohugoio/hugo [db46bcf8](https://github.com/gohugoio/hugo/commit/db46bcf82d060656d4bc731550e63ec9cf8576f2) [@bep](https://github.com/bep)
-* Update textual references in Go source to point to gohugoio/hugo [c17ad675](https://github.com/gohugoio/hugo/commit/c17ad675e8fcdb2db40fc50816b8f016bc14294c) [@bep](https://github.com/bep)
-* Update import paths to gohugoio/hugo [d8717cd4](https://github.com/gohugoio/hugo/commit/d8717cd4c74e80ea8e20adead9321412a2d76022) [@bep](https://github.com/bep) -
\ No newline at end of file
diff --git a/docs/content/news/0-24-1.md b/docs/content/news/0-24-1.md
@@ -1,21 +0,0 @@
----
-date: 2017-06-24T17:53:58-04:00
-categories: ["Releases"]
-description: "This release fixes some important archetype-related regressions from Hugo 0.24"
-link: ""
-title: "Hugo 0.24.1"
-draft: false
-author: bep
----
-
-This release fixes some important **archetype-related regressions** from the recent Hugo 0.24-release.
-
-## Fixes
-
-* Fix archetype regression when no archetype file [4294dd8d](https://github.com/gohugoio/hugo/commit/4294dd8d9d22bd8107b7904d5389967da1f83f27) [@bep](https://github.com/bep) [#3626](https://github.com/gohugoio/hugo/issues/3626)
-* Preserve shortcodes in archetype templates [b63e4ee1](https://github.com/gohugoio/hugo/commit/b63e4ee198c875b73a6a9af6bb809589785ed589) [@bep](https://github.com/bep) [#3623](https://github.com/gohugoio/hugo/issues/3623)
-* Fix handling of timezones with positive UTC offset (e.g., +0800) in TOML [0744f81e](https://github.com/gohugoio/hugo/commit/0744f81ec00bb8888f59d6c8b5f57096e07e70b1) [@bep](https://github.com/bep) [#3628](https://github.com/gohugoio/hugo/issues/3628)
-
-## Enhancements
-
-* Create default archetype on new site [bfa336d9](https://github.com/gohugoio/hugo/commit/bfa336d96173377b9bbe2298dbd101f6a718c174) [@bep](https://github.com/bep) [#3626](https://github.com/gohugoio/hugo/issues/3626) -
\ No newline at end of file
diff --git a/docs/content/news/0-24.md b/docs/content/news/0-24.md
@@ -1,73 +0,0 @@
----
-date: 2017-06-17T17:53:58-04:00
-categories: ["Releases"]
-description: "The Revival of the Archetypes!"
-link: ""
-title: "Hugo 0.24"
-draft: false
-author: bep
----
-
-> "A feature that could be the name of the next Indiana Jones movie deserves its own release," says [@bep](https://github.com/bep).
-
-Hugo now handles the **archetype files as Go templates**. This means that the issues with sorting and lost comments are long gone. This also means that you will have to supply all values, including title and date. But this also opens up a lot of new windows.
-
-A fictional example for the section `newsletter` and the archetype file `archetypes/newsletter.md`:
-
-```
----
-title: "{{ replace .TranslationBaseName "-" " " | title }}"
-date: {{ .Date }}
-draft: true
----
-
-**Insert Lead paragraph here.**
-
-<!--more-->
-
-## New Cool Posts
-
-{{ range first 10 ( where .Site.RegularPages "Type" "cool" ) }}
-* {{ .Title }}
-{{ end }}
-```
-
-And then create a new post with:
-
-```
-hugo new newsletter/the-latest-cool.stuff.md
-```
-
-**Note:** the site will only be built if the `.Site` is in use in the archetype file, and this can be time consuming for big sites.
-
-**Hot Tip:** If you set the `newContentEditor` configuration variable to an editor on your `PATH`, the newly created article will be opened.
-
-The above _newsletter type archetype_ illustrates the possibilities: The full Hugo `.Site` and all of Hugo's template funcs can be used in the archetype file.
-
-**Also, Hugo now supports archetype files for all content formats, not just markdown.**
-
-Hugo now has:
-
-* 17839+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 493+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 166+ [themes](http://themes.gohugo.io/)
-
-## Notes
-
-* Archetype files now need to be complete, including `title` and `date`.
-* The `-f` (format) flag in `hugo new` is removed: Now use the archetype files as is.
-
-## Enhancements
-
-* Support extension-less media types. The motivation behind this change is to support Netlify's `_redirects` files, so we can generate server-side redirects for the Hugo docs site. See [this commit](https://github.com/gohugoio/hugoDocs/commit/c1ab9894e8292e0a74c43bbca2263b1fb3840f9e) to see how we configured that. [0f40e1fa](https://github.com/gohugoio/hugo/commit/0f40e1fadfca2276f65adefa6d7d5d63aef9160a) [@bep](https://github.com/bep) [#3614](https://github.com/gohugoio/hugo/issues/3614)
-* Add `disableAliases` [516e6c6d](https://github.com/gohugoio/hugo/commit/516e6c6dc5733cdaf985317d58eedbc6ec0ef2f7) [@bep](https://github.com/bep) [#3613](https://github.com/gohugoio/hugo/issues/3613)
-* Support non-md files as archetype files [19f2e729](https://github.com/gohugoio/hugo/commit/19f2e729135af700c5d4aa06e7b3540e6d4847fd) [@bep](https://github.com/bep) [#3597](https://github.com/gohugoio/hugo/issues/3597) [#3618](https://github.com/gohugoio/hugo/issues/3618)
-* Identify extension-less text types as text [c43b512b](https://github.com/gohugoio/hugo/commit/c43b512b4700f76ac77f12d632bb030c3a241393) [@bep](https://github.com/bep) [#3614](https://github.com/gohugoio/hugo/issues/3614)
-* Add `.Site` to the archetype templates [662e12f3](https://github.com/gohugoio/hugo/commit/662e12f348a638a6fcc92a416ee7f7c2a7ef8792) [@bep](https://github.com/bep) [#1629](https://github.com/gohugoio/hugo/issues/1629)
-* Use archetype template as-is as a Go template [422057f6](https://github.com/gohugoio/hugo/commit/422057f60709696bbbd1c38c9ead2bf114d47e31) [@bep](https://github.com/bep) [#452](https://github.com/gohugoio/hugo/issues/452) [#1629](https://github.com/gohugoio/hugo/issues/1629)
-* Update links to new discuss URL [4aa12390](https://github.com/gohugoio/hugo/commit/4aa1239070bb9d4324d3582f3e809b702a59d3ac) [@bep](https://github.com/bep)
-
-## Fixes
-
-* Fix error handling for `JSON` front matter [fb53987a](https://github.com/gohugoio/hugo/commit/fb53987a4ff2acb9da8dec6ec7b11924d37352ce) [@bep](https://github.com/bep) [#3610](https://github.com/gohugoio/hugo/issues/3610)
-* Fix handling of quoted brackets in `JSON` front matter [3183b9a2](https://github.com/gohugoio/hugo/commit/3183b9a29d8adac962fbc73f79b04542f4c4c55d) [@bep](https://github.com/bep) [#3511](https://github.com/gohugoio/hugo/issues/3511) -
\ No newline at end of file
diff --git a/docs/content/news/0-25-1.md b/docs/content/news/0-25-1.md
@@ -1,24 +0,0 @@
----
-date: 2017-07-10T17:53:58-04:00
-categories: ["Releases"]
-description: "This is a bug-fix release with a couple of important fixes"
-link: ""
-title: "Hugo 0.25.1"
-draft: false
-author: bep
----
-
-This is a bug-fix release with a couple of important fixes.
-
-Hugo now has:
-
-* 18277+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 456+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 170+ [themes](http://themes.gohugo.io/)
-
-## Fixes
-
-* Fix union when the first slice is empty [dbbc5c48](https://github.com/gohugoio/hugo/commit/dbbc5c4810a04ac06fad7500d88cf5c3bfe0c7fd) [@bep](https://github.com/bep) [#3686](https://github.com/gohugoio/hugo/issues/3686)
-* Navigate to changed on CREATE When working with content from IntelliJ IDE, like WebStorm, every file save is followed by two events: "RENAME" and then "CREATE". [7bcc1ce6](https://github.com/gohugoio/hugo/commit/7bcc1ce659710f2220b400ce3b76e50d2e48b241) [@miltador](https://github.com/miltador)
-* Final (!) fix for issue with escaped JSON front matter [7f82b41a](https://github.com/gohugoio/hugo/commit/7f82b41a24af0fd04d28fbfebf9254766a3c6e6f) [@bep](https://github.com/bep) [#3682](https://github.com/gohugoio/hugo/issues/3682)
-* Fix issue with escaped JSON front matter [84db6c74](https://github.com/gohugoio/hugo/commit/84db6c74a084d2b52117b999d4ec343cd3389a68) [@bep](https://github.com/bep) [#3682](https://github.com/gohugoio/hugo/issues/3682)-
\ No newline at end of file
diff --git a/docs/content/news/0-25.md b/docs/content/news/0-25.md
@@ -1,77 +0,0 @@
----
-date: 2017-07-07T17:53:58-04:00
-categories: ["Releases"]
-description: "Hugo 0.25 automatically opens the page you're working on in the browser"
-link: ""
-title: "Hugo 0.25"
-draft: false
-author: bep
----
-
-Hugo `0.25` is the **Kinder Surprise**: It automatically opens the page you're working on in the browser, it adds full `AND` and `OR` support in page queries, and you can now have templates per language.
-
-
-
-If you start with `hugo server --navigateToChanged`, Hugo will navigate to the relevant page on save (see animated GIF). This is extremely useful for site-wide edits. Another very useful feature in this version is the added support for `AND` (`intersect`) and `OR` (`union`) filters when combined with `where`.
-
-Example:
-
-```
-{{ $pages := where .Site.RegularPages "Type" "not in" (slice "page" "about") }}
-{{ $pages := $pages | union (where .Site.RegularPages "Params.pinned" true) }}
-{{ $pages := $pages | intersect (where .Site.RegularPages "Params.images" "!=" nil) }}
-```
-
-The above fetches regular pages not of `page` or `about` type unless they are pinned. And finally, we exclude all pages with no `images` set in Page params.
-
-This release represents **36 contributions by 12 contributors** to the main Hugo code base. [@bep](https://github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. But also a big shoutout to [@yihui](https://github.com/yihui), [@anthonyfok](https://github.com/anthonyfok), and [@kropp](https://github.com/kropp) for their ongoing contributions. And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Hugo now has:
-
-* 18209+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 168+ [themes](http://themes.gohugo.io/)
-
-## Enhancements
-
-### Templates
-
-* Add `Pages` support to `intersect` (`AND`) and `union`(`OR`). This makes the `where` template func even more powerful. [ccdd08d5](https://github.com/gohugoio/hugo/commit/ccdd08d57ab64441e93d6861ae126b5faacdb92f) [@bep](https://github.com/bep) [#3174](https://github.com/gohugoio/hugo/issues/3174)
-* Add `math.Log` function. This is very handy for creating tag clouds. [34c56677](https://github.com/gohugoio/hugo/commit/34c566773a1364077e1397daece85b22948dc721) [@artem-sidorenko](https://github.com/artem-sidorenko)
-* Add `WebP` images support [8431c8d3](https://github.com/gohugoio/hugo/commit/8431c8d39d878c18c6b5463d9091a953608df10b) [@bep](https://github.com/bep) [#3529](https://github.com/gohugoio/hugo/issues/3529)
-* Only show post's own keywords in schema.org [da72805a](https://github.com/gohugoio/hugo/commit/da72805a4304a57362e8e79a01cc145767b027c5) [@brunoamaral](https://github.com/brunoamaral) [#2635](https://github.com/gohugoio/hugo/issues/2635)[#2646](https://github.com/gohugoio/hugo/issues/2646)
-* Simplify the `Disqus` template a little bit (#3655) [eccb0647](https://github.com/gohugoio/hugo/commit/eccb0647821e9db20ba9800da1b4861807cc5205) [@yihui](https://github.com/yihui)
-* Improve the built-in Disqus template (#3639) [2e1e4934](https://github.com/gohugoio/hugo/commit/2e1e4934b60ce8081a7f3a79191ed204f3098481) [@yihui](https://github.com/yihui)
-
-### Output
-
-* Support templates per site/language. This is for both regular templates and shortcode templates. [aa6b1b9b](https://github.com/gohugoio/hugo/commit/aa6b1b9be7c9d7322333893b642aaf8c7a5f2c2e) [@bep](https://github.com/bep) [#3360](https://github.com/gohugoio/hugo/issues/3360)
-
-### Core
-
-* Extend the sections API [a1d260b4](https://github.com/gohugoio/hugo/commit/a1d260b41a6673adef679ec4e262c5f390432cf5) [@bep](https://github.com/bep) [#3591](https://github.com/gohugoio/hugo/issues/3591)
-* Make `.Site.Sections` return the top level sections [dd9b1baa](https://github.com/gohugoio/hugo/commit/dd9b1baab0cb860a3eb32fd9043bac18cab3f9f0) [@bep](https://github.com/bep) [#3591](https://github.com/gohugoio/hugo/issues/3591)
-* Render `404.html` for all languages [41805dca](https://github.com/gohugoio/hugo/commit/41805dca9e40e9b0952e04d06074e6fc91140495) [@mitchchn](https://github.com/mitchchn) [#3598](https://github.com/gohugoio/hugo/issues/3598)
-
-### Other
-
-* Support human-readable `YAML` boolean values in `undraft` [1039356e](https://github.com/gohugoio/hugo/commit/1039356edf747f044c989a5bc0e85d792341ed5d) [@kropp](https://github.com/kropp)
-* `hugo import jekyll` support nested `_posts` directories [7ee1f25e](https://github.com/gohugoio/hugo/commit/7ee1f25e9ef3be8f99c171e8e7982f4f82c13e16) [@coderzh](https://github.com/coderzh) [#1890](https://github.com/gohugoio/hugo/issues/1890)[#1911](https://github.com/gohugoio/hugo/issues/1911)
-* Update `Dockerfile` and add Docker optimizations [118f8f7c](https://github.com/gohugoio/hugo/commit/118f8f7cf22d756d8a894ff93551974a806f2155) [@ellerbrock](https://github.com/ellerbrock)
-* Add Blackfriday `joinLines` extension support (#3574) [a5440496](https://github.com/gohugoio/hugo/commit/a54404968a4b36579797f2e7ff7f5eada94866d9) [@choueric](https://github.com/choueric)
-* add `--initial-header-level=2` to rst2html (#3528) [bfce30d8](https://github.com/gohugoio/hugo/commit/bfce30d85972c27c27e8a2caac9db6315f813298) [@frankbraun](https://github.com/frankbraun)
-* Support open "current content page" in browser [c825a731](https://github.com/gohugoio/hugo/commit/c825a7312131b4afa67ee90d593640dee3525d98) [@bep](https://github.com/bep) [#3643](https://github.com/gohugoio/hugo/issues/3643)
-* Make `--navigateToChanged` more robust on Windows [30e14cc3](https://github.com/gohugoio/hugo/commit/30e14cc31678ddc204b082ab362f86b6b8063881) [@anthonyfok](https://github.com/anthonyfok) [#3645](https://github.com/gohugoio/hugo/issues/3645)
-* Remove the docs submodule [31393f60](https://github.com/gohugoio/hugo/commit/31393f6024416ea1b2e61d1080dfd7104df36eda) [@bep](https://github.com/bep) [#3647](https://github.com/gohugoio/hugo/issues/3647)
-* Use `example.com` as homepage for new theme [aff1ac32](https://github.com/gohugoio/hugo/commit/aff1ac3235b6c075d01f7237addf44fecdd36d82) [@anthonyfok](https://github.com/anthonyfok)
-
-## Fixes
-
-### Templates
-
-* Fix `in` function for JSON arrays [d12cf5a2](https://github.com/gohugoio/hugo/commit/d12cf5a25df00fa16c59f0b2ae282187a398214c) [@bep](https://github.com/bep) [#1468](https://github.com/gohugoio/hugo/issues/1468)
-
-### Other
-
-* Fix handling of `JSON` front matter with escaped quotes [e10e51a0](https://github.com/gohugoio/hugo/commit/e10e51a00827b9fdc1bee51439fef05afc529831) [@bep](https://github.com/bep) [#3661](https://github.com/gohugoio/hugo/issues/3661)
-* Fix typo in code comment [56d82aa0](https://github.com/gohugoio/hugo/commit/56d82aa025f4d2edb1dc6315132cd7ab52df649a) [@dvic](https://github.com/dvic) -
\ No newline at end of file
diff --git a/docs/content/news/0.27-relnotes-ready.md b/docs/content/news/0.27-relnotes-ready.md
@@ -1,93 +0,0 @@
-
----
-date: 2017-09-11
-title: "0.27"
-description: "0.27"
-categories: ["Releases"]
----
-
-
-Hugo `0.27`comes with fast and flexible **Related Content** ([3b4f17bb](https://github.com/gohugoio/hugo/commit/3b4f17bbc9ff789faa581ac278ad109d1ac5b816) [@bep](https://github.com/bep) [#98](https://github.com/gohugoio/hugo/issues/98)). To add this to your site, put something like this in your single page template:
-
-```go-html-template
-{{ $related := .Site.RegularPages.Related . | first 5 }}
-{{ with $related }}
-<h3>See Also</h3>
-<ul>
- {{ range . }}
- <li><a href="{{ .RelPermalink }}">{{ .Title }}</a></li>
- {{ end }}
-</ul>
-{{ end }}
-```
-
-The above translates to _list the five regular pages mostly related to the current page_. See the [Related Content Documentation](https://gohugo.io/content-management/related/) for details and configuration options.
-
-This release represents **37 contributions by 9 contributors** to the main Hugo code base.
-
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@yihui](https://github.com/yihui), and [@oneleaftea](https://github.com/oneleaftea) for their ongoing contributions.
-
-And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **44 contributions by 30 contributors**. A special thanks to [@bep](https://github.com/bep), [@sdomino](https://github.com/sdomino), [@gotgenes](https://github.com/gotgenes), and [@digitalcraftsman](https://github.com/digitalcraftsman) for their work on the documentation site.
-
-
-Hugo now has:
-
-* 19464+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 178+ [themes](http://themes.gohugo.io/)
-
-## Notes
-
-* We now only strip p tag in `markdownify` if there is only one paragraph. This allows blocks of paragraphs to be "markdownified" [33ae10b6](https://github.com/gohugoio/hugo/commit/33ae10b6ade67cd9618970121d7de5fd2ce7d781) [@bep](https://github.com/bep) [#3040](https://github.com/gohugoio/hugo/issues/3040)
-
-## Enhancements
-
-### Templates
-
-* Add `time.Duration` and `time.ParseDuration` template funcs [f4bf2141](https://github.com/gohugoio/hugo/commit/f4bf214137ebd24a0d12f16d3a98d9038e6eabd3) [@bep](https://github.com/bep) [#3828](https://github.com/gohugoio/hugo/issues/3828)
-* Add `cond` (ternary) template func [0462c96a](https://github.com/gohugoio/hugo/commit/0462c96a5a9da3e8adc78d96acd39575a8b46c40) [@bep](https://github.com/bep) [#3860](https://github.com/gohugoio/hugo/issues/3860)
-* Prepare for template metrics [d000cf60](https://github.com/gohugoio/hugo/commit/d000cf605091c6999b72d6c632752289bc680223) [@bep](https://github.com/bep)
-* Add `strings.TrimLeft` and `TrimRight` [7674ad73](https://github.com/gohugoio/hugo/commit/7674ad73825c61eecc4003475fe0577f225fe579) [@moorereason](https://github.com/moorereason)
-* compare, hugolib, tpl: Add `Eqer` interface [08f48b91](https://github.com/gohugoio/hugo/commit/08f48b91d68d3002b887ddf737456ff0cc4e786d) [@bep](https://github.com/bep) [#3807](https://github.com/gohugoio/hugo/issues/3807)
-* Only strip p tag in `markdownify` if only one paragraph [33ae10b6](https://github.com/gohugoio/hugo/commit/33ae10b6ade67cd9618970121d7de5fd2ce7d781) [@bep](https://github.com/bep) [#3040](https://github.com/gohugoio/hugo/issues/3040)
-* Cleanup `strings.TrimPrefix` and `TrimSuffix` [29a2da05](https://github.com/gohugoio/hugo/commit/29a2da0593b081cdd61b93c6328af2c9ea4eb20f) [@moorereason](https://github.com/moorereason)
-
-### Output
-
-* Improve the base template (aka `baseof.html`) identification [0019ce00](https://github.com/gohugoio/hugo/commit/0019ce002449d671a20a69406da37b10977f9493) [@bep](https://github.com/bep)
-
-### Core
-
-* Implement "related content" [3b4f17bb](https://github.com/gohugoio/hugo/commit/3b4f17bbc9ff789faa581ac278ad109d1ac5b816) [@bep](https://github.com/bep) [#98](https://github.com/gohugoio/hugo/issues/98)
-* Add `Page.Equals` [f0f49ed9](https://github.com/gohugoio/hugo/commit/f0f49ed9b0c9b4545a45c95d56340fcbf4aafbef) [@bep](https://github.com/bep)
-* Rewrite `replaceDivider` to reduce memory allocation [71ae9b45](https://github.com/gohugoio/hugo/commit/71ae9b4533083be185c5314c9c5b273cc3bd07bd) [@bep](https://github.com/bep)
-
-
-### Other
-
-* Set up Hugo release flow on `CircleCI` [d2249c50](https://github.com/gohugoio/hugo/commit/d2249c50991ba7b00b092aca6e315ca1a4de75a1) [@bep](https://github.com/bep) [#3779](https://github.com/gohugoio/hugo/issues/3779)
-* Maintain the scroll position if possible [7231d5a8](https://github.com/gohugoio/hugo/commit/7231d5a829f8d97336a2120afde1260db6ee6541) [@yihui](https://github.com/yihui) [#3824](https://github.com/gohugoio/hugo/issues/3824)
-* Add an `iFrame` title to the `YouTube` shortcode [919bc921](https://github.com/gohugoio/hugo/commit/919bc9210a69c801c7304c0b529df93d1dca27aa) [@nraboy](https://github.com/nraboy)
-* Remove the theme submodule from /docs [ea2cc26b](https://github.com/gohugoio/hugo/commit/ea2cc26b390476f1c605405604f8c92afd09b6ee) [@bep](https://github.com/bep) [#3791](https://github.com/gohugoio/hugo/issues/3791)
-* Add support for multiple config files via `--config a.toml,b.toml,c.toml` [0f9f73cc](https://github.com/gohugoio/hugo/commit/0f9f73cce5c3f1f05be20bcf1d23b2332623d7f9) [@jgielstra](https://github.com/jgielstra)
-* Render task list item inside `label` for correct accessibility [c8257f8b](https://github.com/gohugoio/hugo/commit/c8257f8b726478ca70dc8984cdcc17b31e4bdc0c) [@danieka](https://github.com/danieka) [#3303](https://github.com/gohugoio/hugo/issues/3303)
-* Normalize `UniqueID` between Windows & Linux [0abdeeef](https://github.com/gohugoio/hugo/commit/0abdeeef6740a3cbba0db95374853d040f2022b8) [@Shywim](https://github.com/Shywim)
-
-
-## Fixes
-
-### Output
-
-* Fix taxonomy term base template lookup [f88fe312](https://github.com/gohugoio/hugo/commit/f88fe312cb35f7de1615c095edd2f898303dd23b) [@bep](https://github.com/bep) [#3856](https://github.com/gohugoio/hugo/issues/3856)
-* Fix `published` front matter handling [202510fd](https://github.com/gohugoio/hugo/commit/202510fdc92d52a20baeaa7edb1091f6882bd95f) [@bep](https://github.com/bep) [#3867](https://github.com/gohugoio/hugo/issues/3867)
-
-
-
-
-
-
-
-
diff --git a/docs/content/news/0.27.1-relnotes-ready.md b/docs/content/news/0.27.1-relnotes-ready.md
@@ -1,19 +0,0 @@
-
----
-date: 2017-09-13
-title: "0.27.1"
-description: "0.27.1"
-categories: ["Releases"]
----
-
-
-
-This fixes a regression introduced in [Go 1.9](https://github.com/golang/go/issues/21844) which lead to HTML in shortcodes in multi output Hugo sites being wrongly escaped in some cases.
-
-* Fix escaped HTML Go 1.9 multioutput issue (#3880) [2d613dd9](https://github.com/gohugoio/hugo/commit/2d613dd905bb8eeb8af57e30ddd749a0f04fbd3c) [@bep](https://github.com/bep) [#3876](https://github.com/gohugoio/hugo/issues/3876)
-
-* Bump to Go 1.9 in the Snap build [642ba6ca](https://github.com/gohugoio/hugo/commit/642ba6cab24c558b16378178fe829cbc45845424) [@bep](https://github.com/bep)
-
-
-
-
diff --git a/docs/content/news/0.27.1-relnotes.md b/docs/content/news/0.27.1-relnotes.md
@@ -1,21 +0,0 @@
-
----
-date: 2017-09-13
-title: "0.27.1: One bugfix"
-description: "Hugo 0.27.1 fixes an issue introduced in Go 1.9 with HTML escaping of shortcodes in multi output sites."
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
----
-
-
-
-This fixes a regression introduced in [Go 1.9](https://github.com/golang/go/issues/21844) which lead to HTML in shortcodes in multi output Hugo sites being wrongly escaped in some cases.
-
-* Fix escaped HTML Go 1.9 multioutput issue (#3880) [2d613dd9](https://github.com/gohugoio/hugo/commit/2d613dd905bb8eeb8af57e30ddd749a0f04fbd3c) [@bep](https://github.com/bep) [#3876](https://github.com/gohugoio/hugo/issues/3876)
-
-* Bump to Go 1.9 in the Snap build [642ba6ca](https://github.com/gohugoio/hugo/commit/642ba6cab24c558b16378178fe829cbc45845424) [@bep](https://github.com/bep)
-
-
-
-
diff --git a/docs/content/news/0.28-relnotes-ready.md b/docs/content/news/0.28-relnotes-ready.md
@@ -1,65 +0,0 @@
-
----
-date: 2017-09-25
-title: "Hugo 0.28: High-speed Syntax Highlighting!"
-description: "Chroma is the new default syntax highlighter in Hugo."
-categories: ["Releases"]
-slug: "0.28-relnotes"
-images:
-- images/blog/hugo-28-poster.png
----
-
- Hugo `0.28` brings **blistering fast and native syntax highlighting** from [Chroma](https://github.com/alecthomas/chroma) ([fb33d828](https://github.com/gohugoio/hugo/commit/fb33d8286d78a78a74deb44355b621852a1c4033) [@bep](https://github.com/bep) [#3888](https://github.com/gohugoio/hugo/issues/3888)). A big thank you to [Alec Thomas](https://github.com/alecthomas) for taking on this massive task of porting the popular python highlighter Pygments to Go.
-
-Hugo has been caching the highlighter output to disk, so for repeated builds it has been fine, but this little snippet, showing a build of the [gohugo.io](https://gohugo.io/) site without cache and with both Pygments and Chroma, should illustrate the improvement:
-
-{{< asciicast Lc5iwTVny2kuUC8lqvNnL6oDU >}}
-
-See the [Updated Documentation](https://gohugo.io/content-management/syntax-highlighting/) for more information about how this works.
-
-Worth mentioning is also the `liveReloadPort` flag on `hugo server`, which makes it possible to do "live reloads" behind a HTTPS proxy, which makes for very cool remote customer demos.
-
-One example would be a Hugo server running behind a [ngrok](https://ngrok.com) tunnel:
-
-```bash
-ngrok http 1313
-```
-Then start the Hugo server with:
-
-```bash
-hugo server -b https://youridhere.ngrok.io --appendPort=false --liveReloadPort=443 --navigateToChanged
-```
-
-The `navigateToChanged` flag is slightly unrelated, but it is super cool ...
-
-This release represents **15 contributions by 2 contributors** to the main Hugo code base.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **9 contributions by 7 contributors**. A special thanks to [@bep](https://github.com/bep), [@i-give-up](https://github.com/i-give-up), [@muhajirframe](https://github.com/muhajirframe), and [@icannotfly](https://github.com/icannotfly) for their work on the documentation site.
-
-Hugo now has:
-
-* 19771+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 180+ [themes](http://themes.gohugo.io/)
-
-## Notes
-* Hugo now uses Chroma as new default syntax highlighter. This should in most cases work out-of-the box or with very little adjustments. But if you want to continue to use Pygments, set `pygmentsUseClassic=true` in your site config.
-* We now add a set of "no cache" headers to the responses for `hugo server`, which makes the most sense in most development scenarios. Run with `hugo server --noHTTPCache=false` to get the old behaviour.
-
-## Enhancements
-
-### Templates
-
-* Add `urls.Parse` function [81ed5647](https://github.com/gohugoio/hugo/commit/81ed564793609a32be20a569cc15da2cc02dd734) [@moorereason](https://github.com/moorereason) [#3849](https://github.com/gohugoio/hugo/issues/3849)
-* Add `math.Ceil`, `Floor`, and `Round` [19c59104](https://github.com/gohugoio/hugo/commit/19c5910485242838d6678c2aacd8501f7e646a53) [@moorereason](https://github.com/moorereason) [#3883](https://github.com/gohugoio/hugo/issues/3883)
-
-### Other
-
-* Use Chroma as new default syntax highlighter [fb33d828](https://github.com/gohugoio/hugo/commit/fb33d8286d78a78a74deb44355b621852a1c4033) [@bep](https://github.com/bep) [#3888](https://github.com/gohugoio/hugo/issues/3888)
-* Trim newlines in the hightlight shortcode [0d29a0f7](https://github.com/gohugoio/hugo/commit/0d29a0f7819e8d73149701052c29f090cd6db42b) [@bep](https://github.com/bep) [#3898](https://github.com/gohugoio/hugo/issues/3898)
-* Update `goorgeous` [b8fabce2](https://github.com/gohugoio/hugo/commit/b8fabce217fcb52e3f273491bef95c7977058732) [@bep](https://github.com/bep) [#3899](https://github.com/gohugoio/hugo/issues/3899)
-* Add `liveReloadPort` flag to server [b1804776](https://github.com/gohugoio/hugo/commit/b180477631555824a06293053e2b6e63c5f07361) [@bep](https://github.com/bep) [#3882](https://github.com/gohugoio/hugo/issues/3882)
-* Add `noHTTPCache` flag to hugo server (default on) [0b34af21](https://github.com/gohugoio/hugo/commit/0b34af216154367af7f53ce93d44e6b3d58c3f34) [@bep](https://github.com/bep) [#3897](https://github.com/gohugoio/hugo/issues/3897)
-* Make `noHTTPCache` default on [80c7ea60](https://github.com/gohugoio/hugo/commit/80c7ea60a0e0f488563a6b7311f3d4c23457aac7) [@bep](https://github.com/bep) [#3897](https://github.com/gohugoio/hugo/issues/3897)
-
diff --git a/docs/content/news/0.29-relnotes-ready.md b/docs/content/news/0.29-relnotes-ready.md
@@ -1,47 +0,0 @@
-
----
-date: 2017-09-26
-title: "Hugo 0.29: Template Metrics"
-description: "Makes it easy to find template bottle necks."
-categories: ["Releases"]
-slug: "0.29-relnotes"
-images:
-- images/blog/hugo-29-poster.png
----
-
-Hugo `0.29` brings Template Metrics by [@moorereason](https://github.com/moorereason). Hugo is very fast, but it is still possible to write ineffective templates. Now these should be easy to identify. Just run:
-
-```bash
-hugo --templateMetrics
-```
-Now, that was the tasty carrot. The real reason this release comes so fast after the last one is to change the default value for the new `noHTTPCache` flag, which gives away too much performance to make sense as a default value.
-
-Hugo now has:
-
-* 19817+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 180+ [themes](http://themes.gohugo.io/)
-
-## Notes
-* Make `noHTTPCache` default false [e94d4f01](https://github.com/gohugoio/hugo/commit/e94d4f0177852b357f40fb9686a0ff3667d86351) [@bep](https://github.com/bep)
-
-## Enhancements
-
-### Templates
-* Add simple template metrics feature [b4a14c25](https://github.com/gohugoio/hugo/commit/b4a14c25fe85c41b79497be27ead128502a4dd7b) [@moorereason](https://github.com/moorereason)
-* Set Metrics at creation time [b5e1dc58](https://github.com/gohugoio/hugo/commit/b5e1dc5892f81da798d0d4e964a1f3328532f45e) [@bep](https://github.com/bep)
-* Fix sort order [d3681f51](https://github.com/gohugoio/hugo/commit/d3681f51c08fb11e8addcf9f0b484848d20d46cc) [@bep](https://github.com/bep)
-* Add math.Ceil, Floor, and Round to method mappings [8a69d235](https://github.com/gohugoio/hugo/commit/8a69d2356703d9f2fcb75bce0ae514e70ebd8e01) [@moorereason](https://github.com/moorereason)
-
-### Other
-* Split go build in Dockerfile [d9697e27](https://github.com/gohugoio/hugo/commit/d9697e275ecb038958b3dcea2b43e11dcba28fc9) [@tjamet](https://github.com/tjamet)
-* Update Dockerfile to benefit build cache [09d960f1](https://github.com/gohugoio/hugo/commit/09d960f17396eb7fd2c8fe6527db9503d59f0b4f) [@tjamet](https://github.com/tjamet)
-* Add git to snap package for GitInfo [a3a3f5b8](https://github.com/gohugoio/hugo/commit/a3a3f5b86114213a23337499551f000662b26022) [@ghalse](https://github.com/ghalse)
-
-
-
-
-
-
-
-
diff --git a/docs/content/news/0.30-relnotes-ready.md b/docs/content/news/0.30-relnotes-ready.md
@@ -1,64 +0,0 @@
-
----
-date: 2017-10-16
-title: "Hugo 0.30: Race Car Edition!"
-description: "Fast Render Mode boosts live reloading!"
-categories: ["Releases"]
-slug: "0.30-relnotes"
-images:
-- images/blog/hugo-30-poster.png
----
-
-
-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.
-
-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).
-
-This release also more or less makes the really fast Chroma highlighter a complete alternative to Pygments. Most notable is the new table `linenos` support ([7c30e2cb](https://github.com/gohugoio/hugo/commit/7c30e2cbb08fdf0e61f80c7f1aa29909aeca4211) [@bep](https://github.com/bep) [#3915](https://github.com/gohugoio/hugo/issues/3915)), which makes copy-and-paste code blocks much easier.
-
-This release represents **31 contributions by 10 contributors** to the main Hugo code base.
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contribution, but also a big shoutout to [@moorereason](https://github.com/moorereason), [@digitalcraftsman](https://github.com/digitalcraftsman), and [@bmon](https://github.com/bmon) for their ongoing contributions.
-And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **26 contributions by 15 contributors**. A special thanks to [@bep](https://github.com/bep), [@digitalcraftsman](https://github.com/digitalcraftsman), [@moorereason](https://github.com/moorereason), and [@kaushalmodi](https://github.com/kaushalmodi) for their work on the documentation site.
-
-Hugo now has:
-
-* 20195+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 180+ [themes](http://themes.gohugo.io/)
-
-## Notes
-
-* Running `hugo server` will now run with the new "Fast Render Mode" default on. To turn it off, run `hugo server --disableFastRender` or set `disableFastRender=true` in your site config.
-* There have been several fixes and enhancements in the Chroma highlighter. One is that it now creates Pygments compatible CSS classes, which means that you may want to re-generate the stylesheet. See the [Syntax Highlighting Doc](https://gohugo.io/content-management/syntax-highlighting/).
-
-## Enhancements
-
-### Performance
-* Only re-render the view(s) you're working on [60bd332c](https://github.com/gohugoio/hugo/commit/60bd332c1f68e49e6ac439047e7c660865189380) [@bep](https://github.com/bep) [#3962](https://github.com/gohugoio/hugo/issues/3962)
-* Detect `partialCached` candidates [5800a20a](https://github.com/gohugoio/hugo/commit/5800a20a258378440e203a6c4a4343f5077755df) [@bep](https://github.com/bep)
-* Move metrics output to the end of the site build [b277cb33](https://github.com/gohugoio/hugo/commit/b277cb33e4dfa7440fca3b7888026944ce056154) [@moorereason](https://github.com/moorereason)
-
-### Templates
-
-* Output `xmlns:xhtml` only if there are translations available [0859d9df](https://github.com/gohugoio/hugo/commit/0859d9dfe647db3b8a192da38ad7efb5480a29a1) [@jamieconnolly](https://github.com/jamieconnolly)
-* Add `errorf` template function [4fc67fe4](https://github.com/gohugoio/hugo/commit/4fc67fe44a3c65fc7faaed21d5fa5bb5f87edf2c) [@bmon](https://github.com/bmon) [#3817](https://github.com/gohugoio/hugo/issues/3817)
-* Add `os.FileExists` template function [28188789](https://github.com/gohugoio/hugo/commit/2818878994e906c292cbe00cb2a83f1531a21f32) [@digitalcraftsman](https://github.com/digitalcraftsman) [#3839](https://github.com/gohugoio/hugo/issues/3839)
-* Add `float` template function [57adc539](https://github.com/gohugoio/hugo/commit/57adc539fc98dcb6fba8070b9611b8bd545f6f7f) [@x3ro](https://github.com/x3ro) [#3307](https://github.com/gohugoio/hugo/issues/3307)
-* Rework the partial test and benchmarks [e2e8bcbe](https://github.com/gohugoio/hugo/commit/e2e8bcbec34702a27047b91b6b007a15f1fc0797) [@bep](https://github.com/bep)
-
-### Other
-
-* Change `SummaryLength` to be configurable (#3924) [8717a60c](https://github.com/gohugoio/hugo/commit/8717a60cc030f4310c1779c0cdd51db37ad636cd) [@bmon](https://github.com/bmon) [#3734](https://github.com/gohugoio/hugo/issues/3734)
-* Replace `make` with `mage` in CircleCI build [fe71cb6f](https://github.com/gohugoio/hugo/commit/fe71cb6f5f83cdc8374cf1fc35a6d48102bd4b12) [@bep](https://github.com/bep) [#3969](https://github.com/gohugoio/hugo/issues/3969)
-* Add table `linenos` support for Chroma highlighter [7c30e2cb](https://github.com/gohugoio/hugo/commit/7c30e2cbb08fdf0e61f80c7f1aa29909aeca4211) [@bep](https://github.com/bep) [#3915](https://github.com/gohugoio/hugo/issues/3915)
-* Replace `make` with `mage` [8d2580f0](https://github.com/gohugoio/hugo/commit/8d2580f07c0253e12524a4b5c13165f876d00b21) [@bep](https://github.com/bep) [#3937](https://github.com/gohugoio/hugo/issues/3937)
-* Create `magefile` from `Makefile` [384a6ac4](https://github.com/gohugoio/hugo/commit/384a6ac4bd2de16fcd6a1c952e7ca41b66023a12) [@natefinch](https://github.com/natefinch)
-* Clean up lint in various packages [47fdfd51](https://github.com/gohugoio/hugo/commit/47fdfd5196cd24a23b30afe1d88969ffb413ab59) [@moorereason](https://github.com/moorereason)
-
-## Fixes
-
-* Make sure `Date` and `PublishDate` are always set to a value if one is available [6a30874f](https://github.com/gohugoio/hugo/commit/6a30874f19610a38e846e120aac03c68e12f9b7b) [@bep](https://github.com/bep) [#3854](https://github.com/gohugoio/hugo/issues/3854)
-* Add correct config file name to verbose server log [15ec031d](https://github.com/gohugoio/hugo/commit/15ec031d9818d239bfbff525c00cd99cc3118a96) [@mdhender](https://github.com/mdhender)
diff --git a/docs/content/news/0.30.1-relnotes-ready.md b/docs/content/news/0.30.1-relnotes-ready.md
@@ -1,24 +0,0 @@
-
----
-date: 2017-10-19T00:00:00+02:00
-title: "0.30.1: Two Important Bugfixes!"
-description: "Fixes `hugo -w` and validator-broken Sitemap."
-categories: ["Releases"]
-slug: 0.30.1-relnotes
-images:
-- images/blog/hugo-bug-poster.png
----
-
-
-
-This is a bug-fix release with two important fixes.
-
-* Fix hugo -w [fa53b13c](https://github.com/gohugoio/hugo/commit/fa53b13ca0ffb1db6ed20f5353661d3f8a5fd455) [@bep](https://github.com/bep) [#3980](https://github.com/gohugoio/hugo/issues/3980)
-* Revert sitemap template change to make the Google validator happy [5109ed520](https://github.com/gohugoio/hugo/commit/5109ed520f2ddde815d50e7b31acbbfc57ce7719) [@bep](https://github.com/bep) [#3978](https://github.com/gohugoio/hugo/issues/3978)
-
-
-Hugo now has:
-
-* 20285+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 180+ [themes](http://themes.gohugo.io/)
diff --git a/docs/content/news/0.30.2-relnotes-ready.md b/docs/content/news/0.30.2-relnotes-ready.md
@@ -1,15 +0,0 @@
-
----
-date: 2017-10-19T12:00:00+02:00
-title: "0.30.2: One More Bugfix"
-description: "Fixes Fast Render mode when having sub-path in `baseURL`."
-slug: "0.30.2"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
----
-This release fixes Fast Render mode with sub-path in baseURL [31641033](https://github.com/gohugoio/hugo/commit/3164103310fbca1211cfa9ce4a5eb7437854b6ad) [@bep](https://github.com/bep) [#3981](https://github.com/gohugoio/hugo/issues/3981).
-
-
-
-
diff --git a/docs/content/news/0.31-relnotes-ready.md b/docs/content/news/0.31-relnotes-ready.md
@@ -1,80 +0,0 @@
-
----
-date: 2017-11-20
-title: "Hugo 0.31: Language Multihost Edition!"
-description: "Hugo 0.31: Multihost, smart union static dirs, and more ..."
-slug: "0.31-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-31-poster.png
----
-
- Hugo `0.31` is the **Language Multihost Edition!**
-
-> <img src="https://esolia.com/img/eSolia-Logo-Flat-2015.svg" alt="eSolia" width="100px" align="top" style="width:100px" />The Multihost feature is sponsored by [eSolia](https://esolia.com/), [@rickcogley](https://github.com/rickcogley)'s company.
-
-[Multihost](https://gohugo.io/content-management/multilingual/#configure-multilingual-multihost) means that you can have a **`baseURL` per language**, for example, `https://no.example.com` and `https://en.example.com`. This is seamlessly integrated, and the built-in web server with live reload and `navigateToChanged` etc. just works. A related enhancement in this release is the support for **as many static dirs as you need**, with intelligent language overrides, forming a big union file system. Add to that several other language related fixes and enhancements, it is safe to say that this is the version you want for multilingual Hugo sites!
-
-This release represents **44 contributions by 7 contributors** to the main Hugo code base.
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@kaushalmodi](https://github.com/kaushalmodi), [@natefinch](https://github.com/natefinch), and [@betaveros](https://github.com/betaveros) for their ongoing contributions.
-And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **13 contributions by 9 contributors**. A special thanks to [@oncletom](https://github.com/oncletom), [@kaushalmodi](https://github.com/kaushalmodi), [@XhmikosR](https://github.com/XhmikosR), and [@digitalcraftsman](https://github.com/digitalcraftsman) for their work on the documentation site.
-
-
-Hugo now has:
-
-* 21105+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 184+ [themes](http://themes.gohugo.io/)
-
-## Notes
-
-* For mapping of translated content, Hugo now considers the full path of the content file, which makes it possible with translation of duplicate content filenames such as `index.md`. A specific translation key can be specified with the new `translationKey` front matter variable. See [#2699](https://github.com/gohugoio/hugo/issues/2699).
-
-
-## Enhancements
-
-### Language related
-
-* Support unknown language codes [23ba779f](https://github.com/gohugoio/hugo/commit/23ba779fab90ce45cddd68b4f49a2515ce6d4878) [@bep](https://github.com/bep) [#3564](https://github.com/gohugoio/hugo/issues/3564)
-* Fix `.IsTranslated` with identical filenames [b3daa1f4](https://github.com/gohugoio/hugo/commit/b3daa1f4bf1b84bcc5da028257ba609be74e3ecc) [@bep](https://github.com/bep) [#2699](https://github.com/gohugoio/hugo/issues/2699)
-* Fall back to unstranslated base template [0a81a6b4](https://github.com/gohugoio/hugo/commit/0a81a6b4bae3de53aa9c179b855c671a2d30eec7) [@bep](https://github.com/bep) [#3893](https://github.com/gohugoio/hugo/issues/3893)
-* Add support for multiple static dirs [60dfb9a6](https://github.com/gohugoio/hugo/commit/60dfb9a6e076200ab3ca3fd30e34bb3c14e0a893) [@bep](https://github.com/bep) [#36](https://github.com/gohugoio/hugo/issues/36)[#4027](https://github.com/gohugoio/hugo/issues/4027)
-* Add multilingual multihost support [2e046576](https://github.com/gohugoio/hugo/commit/2e0465764b5dacc511b977b1c9aa07324ad0ee9c) [@bep](https://github.com/bep) [#4027](https://github.com/gohugoio/hugo/issues/4027)
-
-### Templates
-
-* Refactor `Mod` with `cast` [76dc811c](https://github.com/gohugoio/hugo/commit/76dc811c6539b2ed8b4d3b22693e5088b9f6ecfe) [@artem-sidorenko](https://github.com/artem-sidorenko)
-* Add support for height argument to figure shortcode [488631fe](https://github.com/gohugoio/hugo/commit/488631fe0abc3667355345c7eb98ba7a2204deb5) [@kaushalmodi](https://github.com/kaushalmodi) [#4014](https://github.com/gohugoio/hugo/issues/4014)
-
-### Core
-
-* Use ms precision for static change logging [bb048d81](https://github.com/gohugoio/hugo/commit/bb048d811d3977adb10656335cd339cd8c945a25) [@bep](https://github.com/bep)
-* Update Chroma to get the latest SASS lexer [b32ffed6](https://github.com/gohugoio/hugo/commit/b32ffed6abc67646cad89e163846f3ffef29cec8) [@bep](https://github.com/bep) [#4069](https://github.com/gohugoio/hugo/issues/4069)
-* Bump to Go 1.9.2 [9299a16c](https://github.com/gohugoio/hugo/commit/9299a16c9952a284d3ac3f31d2662f1812f77768) [@bep](https://github.com/bep) [#4064](https://github.com/gohugoio/hugo/issues/4064)
-* Update Travis and snapcraft to Go 1.9.2 [77cbd001](https://github.com/gohugoio/hugo/commit/77cbd001ff6b2e0aaa48566ef2af49ca68e19af9) [@bep](https://github.com/bep) [#4064](https://github.com/gohugoio/hugo/issues/4064)
-* Handle Taxonomy permalinks [d9a78b61](https://github.com/gohugoio/hugo/commit/d9a78b61adefe8e1803529f4774185874af85148) [@betaveros](https://github.com/betaveros) [#1208](https://github.com/gohugoio/hugo/issues/1208)
-
-
-### Other
-
-* Support Fast Render mode with sub-path in baseURL [31641033](https://github.com/gohugoio/hugo/commit/3164103310fbca1211cfa9ce4a5eb7437854b6ad) [@bep](https://github.com/bep) [#3981](https://github.com/gohugoio/hugo/issues/3981)
-* Simplify Site benchmarks [c3c10f2c](https://github.com/gohugoio/hugo/commit/c3c10f2c7ce4ee11186f51161943efc8b37a28c9) [@bep](https://github.com/bep)
-* Replace `make` with `mage` to build Hugo [#3969](https://github.com/gohugoio/hugo/issues/3969)
-* Convert to `dep` as dependency/vendor manager for Hugo [#3988](https://github.com/gohugoio/hugo/issues/3988)
-* Pre-allocate some slices [a9be687b](https://github.com/gohugoio/hugo/commit/a9be687b81df01c7343f78f0d3760042f467baa4) [@bep](https://github.com/bep)
-
-## Fixes
-
-### Templates
-
-* Make sure only one instance of a cached partial is rendered [#4086](https://github.com/gohugoio/hugo/issues/4086)
-
-### Other
-
-* Fix broken shortcodes for `Ace` and `Amber` [503ca6de](https://github.com/gohugoio/hugo/commit/503ca6de6ceb0b4af533f9efeff917d6f3871278) [@bep](https://github.com/bep) [#4051](https://github.com/gohugoio/hugo/issues/4051)
-* Fix error handling in `mage` build [c9c19d79](https://github.com/gohugoio/hugo/commit/c9c19d794537cf76ff281788c3d6cf5f2beac54d) [@natefinch](https://github.com/natefinch)
-* Fix `hugo -w` [fa53b13c](https://github.com/gohugoio/hugo/commit/fa53b13ca0ffb1db6ed20f5353661d3f8a5fd455) [@bep](https://github.com/bep) [#3980](https://github.com/gohugoio/hugo/issues/3980)
-
diff --git a/docs/content/news/0.31.1-relnotes-ready.md b/docs/content/news/0.31.1-relnotes-ready.md
@@ -1,20 +0,0 @@
-
----
-date: 2017-11-27
-title: "Hugo 0.31.1: One Bugfix!"
-description: "Fixes broken `--appendPort=false`."
-slug: "0.31.1"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
-
----
-
-This is a bug-fix release with one important bug fix:
-
-* Fix broken `--appendPort=false` [8afd7d9c](https://github.com/gohugoio/hugo/commit/8afd7d9ceb0d168300e3399c6e87a355a88c9a28) [@bep](https://github.com/bep) [#4111](https://github.com/gohugoio/hugo/issues/4111)
-
-
-
-
-
diff --git a/docs/content/news/0.32-relnotes-ready.md b/docs/content/news/0.32-relnotes-ready.md
@@ -1,95 +0,0 @@
-
----
-date: 2017-12-31
-title: "Hugo 0.32: Page Bundles and Image Processing!"
-description: "Images and other resources with page-relative links, resize, scale and crop images, and much more."
-slug: "0.32-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-32-poster.png
----
-
- Hugo `0.32` features **Page Bundles and Image Processing** by [@bep](https://github.com/bep), which is very cool and useful on so many levels. Read about it in more detail in the [Hugo documentation](https://gohugo.io/about/new-in-032/), but some of the highlights include:
-
-* Automatic bundling of a content page with its resources. Resources can be anything: Images, `JSON` files ... and also other content pages.
-* A `Resource` will have its `RelPermalink` and `Permalink` relative to the "owning page". This makes the complete article with both text and images portable (just send a ZIP file with a folder to your editor), and it can be previewed directly on GitHub.
-* Powerful and simple to use image processing with the new `.Resize`, `.Fill`, and `.Fit` methods on the new `Image` resource.
-* Full support for symbolic links inside `/content`, both for regular files and directories.
-
-The built-in benchmarks in Hugo show that this is also the [fastest and most memory effective](https://gist.github.com/bep/2a9bbd221de2da5d39c8b32085c658f7) Hugo version to date. But note that the build time total reported in the console is now adjusted to be the *real total*, including the copy of static files. So, if it reports more milliseconds, it is still most likely faster ...
-
-This release represents **30 contributions by 7 contributors** to the main Hugo code base.
-
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@betaveros](https://github.com/betaveros), [@chaseadamsio](https://github.com/chaseadamsio), and [@kropp](https://github.com/kropp). And as always big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **17 contributions by 7 contributors**. A special thanks to [@bep](https://github.com/bep), [@felicianotech](https://github.com/felicianotech), [@maiki](https://github.com/maiki), and [@carlchengli](https://github.com/carlchengli) for their work on the documentation site.
-
-Hugo now has:
-
-* 22061+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 454+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 193+ [themes](http://themes.gohugo.io/)
-
-Today is **New Year's Eve.** It is the last day of 2017, a year that have seen a **string of pearls of Hugo releases**, making Hugo _the_ top choice for website development:
-
-* 0.32, December 2017: **Page Bundles and Image Processing** edition.
-* 0.31, November 2017: The Language **Multihost Edition!** with one `baseURL` per language.
-* 0.30, October 2017: The Race Car Edition with the **Fast Render Mode**.
-* 0.29, September 2017: Added **Template Metrics**.
-* 0.28, September 2017: **Blistering fast and native syntax highlighting** from [Chroma](https://github.com/alecthomas/chroma).
-* 0.27, September 2017: Fast and flexible **Related Content.**
-* 0.26, August 2017: The **Language Style Edition** with AP Style or Chicago Style Title Case and « French Guillemets ».
-* 0.25, July 2017: The **Kinder Surprise** edition added, among other cool things, `hugo server --navigateToChanged` which navigates to the content page you start editing.
-* 0.24, June 2017: Was **The Revival of the Archetypes!** Now archetype files, i.e. the content file templates, can include template syntax with all of Hugo's functions and variables.
-* 0.23, June 2017: Hugo moved to it's own GitHub organization, **gohugoio**.
-* 0.22, June 2017: Added **nested sections**, a long sought after feature.
-* 0.21, May 2017: Full support for shortcodes per output format (think **AMP**).
-* 0.20, April 2017: Was all about **Custom Output Formats**.
-* 0.19, February 2017: Native Emacs Org-mode content support and lots of internal upgrades.
-
-## Notes
-
-* The build total in the console is now the ... total (i.e. it now includes both the copy of the static files and the Hugo build). So if your Hugo site seems to build slightly slower, it is in reality probably slightly faster than before this release.
-* Images and other static resources in folders with "_index.md" will have its `RelPermalink` relative to its page.
-* Images and other static resources in or below "index.md" folders will have its `RelPermalink` relative to its page (respecting permalink settings etc.)
-* Content pages in or below "index.md" will not get their own `URL`, but will be part of the `.Resources` collection of its page.
-* `.Site.Files` is deprecated.
-* Hugo no longer minfies CSS files inside `/content`. This was an undocumented "proof of concept feature". We may revisit the "assets handling" in a future release.
-* `Page.GetParam`does not lowercase your result anymore. If you really want to lowercase your params, do it with `.GetParam "myparam" | lower` or similar.
-
-Previously deprecated that will now `ERROR`:
-
-* `disable404`: Use `disableKinds=["404"]`
-* `disableRSS`: Use `disableKinds=["RSS"]`
-* `disableSitemap`: Use `disableKinds=["sitemap"]`
-* `disableRobotsTXT`: Use `disableKinds=["robotsTXT"]`
-
-## Enhancements
-
-* Add `.Title` and `.Page` to `MenuEntry` [9df3736f](https://github.com/gohugoio/hugo/commit/9df3736fec164c51d819797416dc263f2869be77) [@rmetzler](https://github.com/rmetzler) [#2784](https://github.com/gohugoio/hugo/issues/2784)
-* Add `Pandoc` support [e69da7a4](https://github.com/gohugoio/hugo/commit/e69da7a4cb725987f153707bf2fc59c135007e2a) [@betaveros](https://github.com/betaveros) [#234](https://github.com/gohugoio/hugo/issues/234)
-* Implement Page bundling and image handling [3cdf19e9](https://github.com/gohugoio/hugo/commit/3cdf19e9b7e46c57a9bb43ff02199177feb55768) [@bep](https://github.com/bep) [#3651](https://github.com/gohugoio/hugo/issues/3651)[#3158](https://github.com/gohugoio/hugo/issues/3158)[#1014](https://github.com/gohugoio/hugo/issues/1014)[#2021](https://github.com/gohugoio/hugo/issues/2021)[#1240](https://github.com/gohugoio/hugo/issues/1240)[#3757](https://github.com/gohugoio/hugo/issues/3757)
-* Make `chomp` return the type it receives [22cd89ad](https://github.com/gohugoio/hugo/commit/22cd89adc4792a3b55389d38acd4acfae3786775) [@kropp](https://github.com/kropp) [#2187](https://github.com/gohugoio/hugo/issues/2187)
-* Reuse the `BlackFriday` config instance when possible [db4b7a5c](https://github.com/gohugoio/hugo/commit/db4b7a5c6742c75f9cd9627d3b054d3a72802ec8) [@bep](https://github.com/bep)
-* Remove the goroutines from the shortcode lexer [24369410](https://github.com/gohugoio/hugo/commit/243694102a60da2fb1050020f68384539f9f9ef5) [@bep](https://github.com/bep)
-* Improve site benchmarks [051fa343](https://github.com/gohugoio/hugo/commit/051fa343d06d6c070df742f7cbd125432fcab665) [@bep](https://github.com/bep)
-* Update `Chroma` to `v0.2.0` [79892101](https://github.com/gohugoio/hugo/commit/7989210120dbde78da3741e2ef01b13f4aa78692) [@bep](https://github.com/bep) [#4087](https://github.com/gohugoio/hugo/issues/4087)
-* Update `goorgeous` to `v1.1.0` [7f2ae3ef](https://github.com/gohugoio/hugo/commit/7f2ae3ef39f27a9bd26ddb9258b073a840faf491) [@chaseadamsio](https://github.com/chaseadamsio)
-* Add test for homepage content for all rendering engines [407c2402](https://github.com/gohugoio/hugo/commit/407c24020ef2db90cf33fd07e7522b2257013722) [@bep](https://github.com/bep) [#4166](https://github.com/gohugoio/hugo/issues/4166)
-* Add output formats definition to benchmarks [a2d81ce9](https://github.com/gohugoio/hugo/commit/a2d81ce983d45b5742c93bd472503c88286f099a) [@bep](https://github.com/bep)
-
-## Fixes
-
-### Templates
-
-* Do not unescape input to `highlight` [c067f345](https://github.com/gohugoio/hugo/commit/c067f34558b82455b63b9ce8f5983b4b4849c7cf) [@bep](https://github.com/bep) [#4179](https://github.com/gohugoio/hugo/issues/4179)
-* Properly close image file in `imageConfig` [6d79beb5](https://github.com/gohugoio/hugo/commit/6d79beb5f67dbb54d7714c3195addf9d8e3924e8) [@bep](https://github.com/bep)
- * Fix `opengraph` video range template [23f69efb](https://github.com/gohugoio/hugo/commit/23f69efb3914946b39ce673fcc0f2e3a9ed9d878) [@drlogout](https://github.com/drlogout) [#4136](https://github.com/gohugoio/hugo/issues/4136)
-* Fix `humanize` for multi-byte runes [e7652180](https://github.com/gohugoio/hugo/commit/e7652180a13ce149041c48a1c2754c471df569c8) [@bep](https://github.com/bep) [#4133](https://github.com/gohugoio/hugo/issues/4133)
-
-### Other
-
-* Fix broken live reload without a server port. [25114986](https://github.com/gohugoio/hugo/commit/25114986086e5877a0b4108d8cf5e4e95f377241) [@sainaen](https://github.com/sainaen) [#4141](https://github.com/gohugoio/hugo/issues/4141)
-* Make sure all language homes are always re-rendered in fast render mode [72903be5](https://github.com/gohugoio/hugo/commit/72903be587e9c4e3644f60b11e26238ec03da2db) [@bep](https://github.com/bep) [#4125](https://github.com/gohugoio/hugo/issues/4125)
-* Do not `tolower` result from Page.GetParam [1c114d53](https://github.com/gohugoio/hugo/commit/1c114d539b0755724443fe28c90b12fe2a19085a) [@bep](https://github.com/bep) [#4187](https://github.com/gohugoio/hugo/issues/4187)
diff --git a/docs/content/news/0.32.1-relnotes-ready.md b/docs/content/news/0.32.1-relnotes-ready.md
@@ -1,19 +0,0 @@
-
----
-date: 2018-01-02
-title: "0.32.1: Two bugfixes"
-description: "Fixes image processing in shortcodes."
-slug: "0.32.1-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
----
-
-This fixes 2 bugs from the Hugo 0.32 release.
-
-* Fix image processing from shortcodes in non-server mode. [@bep](https://github.com/bep) [#4202](https://github.com/gohugoio/hugo/issues/4202)
-* Fix broken `hugo --renderToMemory`. Note that this is only useful for benchmark testing, as there is no easy way to actually view the result. [d36d71ed](https://github.com/gohugoio/hugo/commit/d36d71edd3b04df3b34edf4d108e3995a244c4f0) [@bep](https://github.com/bep) [#4212](https://github.com/gohugoio/hugo/issues/4212)
-
-
-
-
diff --git a/docs/content/news/0.32.2-relnotes-ready.md b/docs/content/news/0.32.2-relnotes-ready.md
@@ -1,24 +0,0 @@
-
----
-date: 2018-01-03
-title: "0.32.2: One bugfix"
-description: "Fixes one issue with publishing of processed images when no cache."
-slug: "0.32.2-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
-
----
-
-
-
-This is a bug-fix release with one important fix.
-
-
-* Handle publish of processed images to /public on fresh build with no image cache in /resources (as reported by one person in a Netlify build) [196da49c](https://github.com/gohugoio/hugo/commit/196da49c9d906fbae6d389fdd32b80c27cb38de4) [@bep](https://github.com/bep) [#4213](https://github.com/gohugoio/hugo/issues/4213)
-
-
-
-
-
-
diff --git a/docs/content/news/0.32.3-relnotes-ready.md b/docs/content/news/0.32.3-relnotes-ready.md
@@ -1,31 +0,0 @@
-
----
-date: 2018-01-08
-title: "Hugo 0.32.3: Some important bug fixes"
-description: "Fixes multilingual resource (images etc.) handling etc."
-slug: "0.32.3-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
-
----
-
-
-
-Hugo `0.32` was a big and [really cool](https://gohugo.io/news/0.32-relnotes/) release, and the [Hugo Forum](https://discourse.gohugo.io/) has been filled with questions from people wanting to upgrade their Hugo sites to be able to use the new image processing feature etc.
-
-And with that we have discovered some issues, which this release should fix, mostly releated to multilingual sites:
-
-* Fix multihost detection for sites without language definition [8969331f](https://github.com/gohugoio/hugo/commit/8969331f5be352939883074034adac6b7086ddc8) [@bep](https://github.com/bep) [#4221](https://github.com/gohugoio/hugo/issues/4221)
-* Fix hugo benchmark --renderToMemory [059e8458](https://github.com/gohugoio/hugo/commit/059e8458d690dbb9fcd3ebd58cfc61b062d3138e) [@bep](https://github.com/bep) [#4218](https://github.com/gohugoio/hugo/issues/4218)
-* Fix URLs for bundle resources in multihost mode [ab82a27d](https://github.com/gohugoio/hugo/commit/ab82a27d055c3aa177821d81a45a5c6e972aa29e) [@bep](https://github.com/bep) [#4217](https://github.com/gohugoio/hugo/issues/4217)
-* Fix sub-folder baseURL handling for Page resources [f25d8a9e](https://github.com/gohugoio/hugo/commit/f25d8a9e17fb65fa41dafdcbf0358853d68eaf45) [@bep](https://github.com/bep) [#4228](https://github.com/gohugoio/hugo/issues/4228)
-* Avoid processing and storing same image for each language [4b04db0f](https://github.com/gohugoio/hugo/commit/4b04db0f0855a1f54895d6c93c52dcea4b1ce3ca) [@bep](https://github.com/bep) [#4231](https://github.com/gohugoio/hugo/issues/4231)
-* Resources.ByType should return Resources [97c1866e](https://github.com/gohugoio/hugo/commit/97c1866e322284dec46db6f3d235807507f5b69f) [@bep](https://github.com/bep) [#4234](https://github.com/gohugoio/hugo/issues/4234)
-* Report build time on config.toml change [6feb1387](https://github.com/gohugoio/hugo/commit/6feb138785eeb9e813428d0df30010d9b5fb1059) [@bep](https://github.com/bep) [#4232](https://github.com/gohugoio/hugo/issues/4232)[#4224](https://github.com/gohugoio/hugo/issues/4224)
-* Fix handling of mixed-case taxonomy folders with content file [2d3189b2](https://github.com/gohugoio/hugo/commit/2d3189b22760e0a8995dae082a6bc5480f770bfe) [@bep](https://github.com/bep) [#4238](https://github.com/gohugoio/hugo/issues/4238)
-
-
-
-
-
diff --git a/docs/content/news/0.32.4-relnotes-ready.md b/docs/content/news/0.32.4-relnotes-ready.md
@@ -1,21 +0,0 @@
-
----
-date: 2018-01-11
-title: "0.32.4: Two bugfixes"
-description: "Fixes non-ASCII path handling for Page resources."
-slug: "0.32.4-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
----
-
-This is a bug-fix release with two of important fixes.
-
-* Fix non-ASCII path handling for Page resources [f0eecc6a](https://github.com/gohugoio/hugo/commit/f0eecc6a4f541838e9930c98bc982546f65c7a4f) [@bep](https://github.com/bep) [#4241](https://github.com/gohugoio/hugo/issues/4241)
-* Fix `--cleanDestinationDir` [5235a5bf](https://github.com/gohugoio/hugo/commit/5235a5bf5ef44b3789341e1d25b681a7bb14771a) [@biodranik](https://github.com/biodranik) [#4246](https://github.com/gohugoio/hugo/issues/4246)[#4248](https://github.com/gohugoio/hugo/issues/4248)
-
-
-
-
-
-
diff --git a/docs/content/news/0.35-relnotes-ready.md b/docs/content/news/0.35-relnotes-ready.md
@@ -1,102 +0,0 @@
-
----
-date: 2018-01-31
-title: "0.35"
-description: "0.35"
-slug: "0.35"
-categories: ["Releases"]
----
-
- The most notable new feature in Hugo `0.35` is perhaps **Headless Bundles**.
-
-This means that you in your `index.md` front matter can say:
-
-```yaml
-headless: true
-```
-And
-* it will have no `Permalink` and no rendered HTML in `/public`
-* it will not be part of `.Site.RegularPages` etc.
-
-But you can get it by:
-
-* `.Site.GetPage ...`
-
-The use cases are many:
-
-* Shared media libraries
-* Reusable page content "snippets"
-* ...
-
-But this release contains more goodies than possible to sum up in one paragraph, so study the release notes carefully. It represents **42 contributions by 8 contributors** to the main Hugo code base.
-
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@vassudanagunta](https://github.com/vassudanagunta), [@yanzay](https://github.com/yanzay), and [@robertbasic](https://github.com/robertbasic) for their ongoing contributions.
-
-And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **28 contributions by 5 contributors**. A special thanks to [@bep](https://github.com/bep), [@kaushalmodi](https://github.com/kaushalmodi), [@regisphilibert](https://github.com/regisphilibert), and [@salim-b](https://github.com/salim-b) for their work on the documentation site.
-
-
-Hugo now has:
-
-* 22967+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 448+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 197+ [themes](http://themes.gohugo.io/)
-
-
-## Notes
-
-* Deprecate `useModTimeAsFallback` [adfd4370](https://github.com/gohugoio/hugo/commit/adfd4370b67fd7181178bd6b3b1d07356beaac71) [@bep](https://github.com/bep) [#4351](https://github.com/gohugoio/hugo/issues/4351)
-* Deprecate CLI flags `canonifyURLs`, `pluralizeListTitles`, `preserveTaxonomyNames`, `uglyURLs` [f08ea02d](https://github.com/gohugoio/hugo/commit/f08ea02d24d42929676756950f3affaca7fd8c01) [@bep](https://github.com/bep) [#4347](https://github.com/gohugoio/hugo/issues/4347)
-* Remove undraft command [2fa70c93](https://github.com/gohugoio/hugo/commit/2fa70c9344b231c9d999bbafdfa4acbf27ed9f6e) [@robertbasic](https://github.com/robertbasic) [#4353](https://github.com/gohugoio/hugo/issues/4353)
-
-## Enhancements
-
-### Templates
-
-* Update Twitter card to also consider images in `.Resources` [25d691da](https://github.com/gohugoio/hugo/commit/25d691daff57d7c6d7d0f63af3991d22e3f788fe) [@bep](https://github.com/bep) [#4349](https://github.com/gohugoio/hugo/issues/4349)
-* Seed random on init only [83c761b7](https://github.com/gohugoio/hugo/commit/83c761b71a980aee6331179b271c7e24e999e8eb) [@liguoqinjim](https://github.com/liguoqinjim)
-* Remove duplicate layout lookup layouts [b2fcbb1f](https://github.com/gohugoio/hugo/commit/b2fcbb1f9774aa1e929b8575c0e1ac366ab2fb73) [@bep](https://github.com/bep) [#4319](https://github.com/gohugoio/hugo/issues/4319)
-* Add "removable-media" interface to `snapcraft.yaml` [f0c0ece4](https://github.com/gohugoio/hugo/commit/f0c0ece44d55b6c2997cbd106d1bc099ea1a2fa7) [@anthonyfok](https://github.com/anthonyfok) [#3837](https://github.com/gohugoio/hugo/issues/3837)
-
-### Other
-
-* Add a way to disable one or more languages [6413559f](https://github.com/gohugoio/hugo/commit/6413559f7575e2653d76227a8037a7edbaae82aa) [@bep](https://github.com/bep) [#4297](https://github.com/gohugoio/hugo/issues/4297)[#4329](https://github.com/gohugoio/hugo/issues/4329)
-* Handle newly created files in Fast Render Mode [1707dae8](https://github.com/gohugoio/hugo/commit/1707dae8d3634006017eb6d040df4dbafc53d92f) [@yanzay](https://github.com/yanzay) [#4339](https://github.com/gohugoio/hugo/issues/4339)
-* Extract the Fast Render Mode logic into a method [94e736c5](https://github.com/gohugoio/hugo/commit/94e736c5e167a0ee70a528e1c19d64a47e7929c2) [@bep](https://github.com/bep) [#4339](https://github.com/gohugoio/hugo/issues/4339)
-* Remove unused code [ae5a45be](https://github.com/gohugoio/hugo/commit/ae5a45be6f0ee4d5c52b38fd28b22b55d9cd7b2d) [@bep](https://github.com/bep)
-* Add the last lookup variant for the `GetPage` index [3446fe9b](https://github.com/gohugoio/hugo/commit/3446fe9b8937610b8b628b2c212eb25888a7c1bb) [@bep](https://github.com/bep) [#4312](https://github.com/gohugoio/hugo/issues/4312)
-* Simplify bundle lookup via `.Site.GetPage`, `ref`, `relref` [517b6b62](https://github.com/gohugoio/hugo/commit/517b6b62389d23bfe41fe3ae551a691b11bdcaa7) [@bep](https://github.com/bep) [#4312](https://github.com/gohugoio/hugo/issues/4312)
-* Remove some now superflous Fast Render Mode code [feeed073](https://github.com/gohugoio/hugo/commit/feeed073c3320b09fb38168ce272ac88b987f1d2) [@bep](https://github.com/bep) [#4339](https://github.com/gohugoio/hugo/issues/4339)
-* Make resource counters for `name` and `title` independent [df20b054](https://github.com/gohugoio/hugo/commit/df20b05463fef42aba93d5208e410a7ecc56da5d) [@bep](https://github.com/bep) [#4335](https://github.com/gohugoio/hugo/issues/4335)
-* Provide .Name to the archetype templates [863a812e](https://github.com/gohugoio/hugo/commit/863a812e07193541b42732b0e227f3d320433f01) [@bep](https://github.com/bep) [#4348](https://github.com/gohugoio/hugo/issues/4348)
-* Only set `url` if permalink in metadata and remove duplicate confirm msg [3752348e](https://github.com/gohugoio/hugo/commit/3752348ef13ced8f6f528b42ee7d76a12a97ae5c) [@lildude](https://github.com/lildude) [#1887](https://github.com/gohugoio/hugo/issues/1887)
-* Start Resources :counter first time they're used [7b472e46](https://github.com/gohugoio/hugo/commit/7b472e46084b603045b87cea870ffc73ac1cf7e7) [@bep](https://github.com/bep) [#4335](https://github.com/gohugoio/hugo/issues/4335)
-* Update to Go 1.9.3 [a91aba1c](https://github.com/gohugoio/hugo/commit/a91aba1c1562259dffd321a608f38c38dd4d5aeb) [@bep](https://github.com/bep) [#4328](https://github.com/gohugoio/hugo/issues/4328)
-* Support pages without front matter [91bb774a](https://github.com/gohugoio/hugo/commit/91bb774ae4e129f7ed0624754b31479c960ef774) [@vassudanagunta](https://github.com/vassudanagunta) [#4320](https://github.com/gohugoio/hugo/issues/4320)[#4320](https://github.com/gohugoio/hugo/issues/4320)
-* Add page metadata dates tests [3f0379ad](https://github.com/gohugoio/hugo/commit/3f0379adb72389954ca2be6a9f2ebfcd65c6c440) [@vassudanagunta](https://github.com/vassudanagunta)
-* Re-generate CLI docs [1e27d058](https://github.com/gohugoio/hugo/commit/1e27d0589118a114e49c032e4bd68b4798e44a5b) [@bep](https://github.com/bep)
-* Remove and update deprecation status [d418c2c2](https://github.com/gohugoio/hugo/commit/d418c2c2eacdc1dc6fffe839e0a90600867878ca) [@bep](https://github.com/bep)
-* Shorten the stale setup [4a7c2b36](https://github.com/gohugoio/hugo/commit/4a7c2b3695fe7b88861f2155ea7ef635fe425cd4) [@bep](https://github.com/bep)
-* Add a `GetPage` to the site benchmarks [a1956391](https://github.com/gohugoio/hugo/commit/a19563910eec5fed08f3b02563b9a7b38026183d) [@bep](https://github.com/bep)
-* Add headless bundle support [0432c64d](https://github.com/gohugoio/hugo/commit/0432c64dd22e4610302162678bb93661ba68d758) [@bep](https://github.com/bep) [#4311](https://github.com/gohugoio/hugo/issues/4311)
-* Merge matching resources params maps [5a0819b9](https://github.com/gohugoio/hugo/commit/5a0819b9b5eb9e79826cfa0a65f235d9821b1ac4) [@bep](https://github.com/bep) [#4315](https://github.com/gohugoio/hugo/issues/4315)
-* Add some general code contribution criterias [78c86330](https://github.com/gohugoio/hugo/commit/78c863305f337ed4faf3cf0a23675f28b0ae5641) [@bep](https://github.com/bep)
-* Tighten page kind logic, introduce tests [8125b4b0](https://github.com/gohugoio/hugo/commit/8125b4b03d10eb73f8aea3f9ea41172aba8df082) [@vassudanagunta](https://github.com/vassudanagunta)
-
-## Fixes
-* Fix `robots.txt` in multihost mode [4d912e2a](https://github.com/gohugoio/hugo/commit/4d912e2aad39bfe8d76672cf53b01317792e02c5) [@bep](https://github.com/bep) [#4193](https://github.com/gohugoio/hugo/issues/4193)
-* Fix `--uglyURLs` from comand line regression [016398ff](https://github.com/gohugoio/hugo/commit/016398ffe2e0a073453cf46a9d6bf72d693c11e5) [@bep](https://github.com/bep) [#4343](https://github.com/gohugoio/hugo/issues/4343)
-* Avoid unescape in `highlight` [ebdd8cba](https://github.com/gohugoio/hugo/commit/ebdd8cba3f5965a8ac897833f313d772271de649) [@bep](https://github.com/bep) [#4219](https://github.com/gohugoio/hugo/issues/4219)
-* Fix Docker build [a34213f0](https://github.com/gohugoio/hugo/commit/a34213f0b5624de101272aab469ca9b6fe0c273f) [@skoblenick](https://github.com/skoblenick) [#4076](https://github.com/gohugoio/hugo/issues/4076)[#4077](https://github.com/gohugoio/hugo/issues/4077)
-* Fix language params handling [ae742cb1](https://github.com/gohugoio/hugo/commit/ae742cb1bdf35b81aa0ede5453da6b0c4a4fccf2) [@bep](https://github.com/bep) [#4356](https://github.com/gohugoio/hugo/issues/4356)[#4352](https://github.com/gohugoio/hugo/issues/4352)
-* Fix handling of top-level page bundles [4eb2fec6](https://github.com/gohugoio/hugo/commit/4eb2fec67c3a72a3ac98aa834dc56fd4504626d8) [@bep](https://github.com/bep) [#4332](https://github.com/gohugoio/hugo/issues/4332)
-* Fix `baseURL` server regression for multilingual sites [ed4a00e4](https://github.com/gohugoio/hugo/commit/ed4a00e46f2344320a22f07febe5aec4075cb3fb) [@bep](https://github.com/bep) [#4333](https://github.com/gohugoio/hugo/issues/4333)
-* Fix "date" page param [322c5672](https://github.com/gohugoio/hugo/commit/322c567220aa4123a5d707629c1bebd375599912) [@vassudanagunta](https://github.com/vassudanagunta) [#4323](https://github.com/gohugoio/hugo/issues/4323)
-* Fix typo in comment [912147ab](https://github.com/gohugoio/hugo/commit/912147ab896e69a450b7100c3d6bf81a7bf78b5a) [@yanzay](https://github.com/yanzay)
-
-
-
-
-
diff --git a/docs/content/news/0.36.1-relnotes-ready.md b/docs/content/news/0.36.1-relnotes-ready.md
@@ -1,44 +0,0 @@
-
----
-date: 2018-02-15
-title: "Hugo 0.36.1: One Bugfix"
-description: "Fixes a multi-thread image processing issue."
-slug: "0.36.1-relnotes"
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
-
----
- This release fixes a multi-thread issue when reprocessing and reusing images across pages. When doing something like this with the same image from a partial used in, say, both the home page and the single page:
-
-```bash
-{{ with $img }}
-{{ $big := .Fill "1024x512 top" }}
-{{ $small := $big.Resize "512x" }}
-{{ end }}
-```
-
-There would be timing issues making Hugo in some cases trying to process the same image twice at the same time.
-
-You would experience errors of type:
-
-```bash
-png: invalid format: not enough pixel data
-```
-
-This commit fixes that by adding a mutex per image. This should also improve the performance, sligthly, as it avoids duplicate work.
-
-The current workaround before this fix is to always operate on the original:
-
-```bash
-{{ with $img }}
-{{ $big := .Fill "1024x512 top" }}
-{{ $small := .Fill "512x256 top" }}
-{{ end }}
-```
-This error was rare (no reports on GitHub or the discussion forum), but very hard to debug for the end user.
-
-* Fix multi-threaded image processing issue [d8fdffb5](https://github.com/gohugoio/hugo/commit/d8fdffb55268464d54558d6f9cd3874b612dc7c7) [@bep](https://github.com/bep) [#4404](https://github.com/gohugoio/hugo/issues/4404)
-* Improve error message in .Render [08521dac](https://github.com/gohugoio/hugo/commit/08521dac8323403933a8fd11acfd16930af5f17d) [@bep](https://github.com/bep)
-* Bump Travis/Snapcraft to Go 1.9.4 [fc23a80f](https://github.com/gohugoio/hugo/commit/fc23a80ffd3878b9ba9a160ce37e0e1d8703faf3) [@bep](https://github.com/bep)
-* Improve error processing error message [2851af02](https://github.com/gohugoio/hugo/commit/2851af0225cdf6c4e47058979cd22949ed6d1fc0) [@bep](https://github.com/bep)
diff --git a/docs/content/news/0.38-relnotes/index.md b/docs/content/news/0.38-relnotes/index.md
@@ -1,66 +0,0 @@
-
----
-date: 2018-04-02
-title: "The Easter Egg Edition"
-description: "Hugo 0.38: Date and slug from filenames, multiple content dirs, config from themes, language merge func …"
-categories: ["Releases"]
----
-
-Hugo `0.38` is an **Easter egg** filled with good stuff. We now support fetching **date and slug from the content filename**, making the move from Jekyll even easier. And you can now set `contentDir` per language with intelligent merging, and themes can now provide configuration ... Also worth mentioning is several improvements in the [Chroma](https://github.com/alecthomas/chroma) highlighter, most notable support for Go templates.
-
-We are working hard to get the documentation up-to-date with the new features, but you can also see them in action with the full source at [hugotest.bep.is](http://hugotest.bep.is/).
-
-This release represents **39 contributions by 4 contributors** to the main Hugo code base.
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions, but also a big shoutout to [@anthonyfok](https://github.com/anthonyfok), [@felicianotech](https://github.com/felicianotech), and [@paulcmal](https://github.com/paulcmal) for their ongoing contributions.
-
-And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the themes site in pristine condition and to [@kaushalmodi](https://github.com/kaushalmodi) for his great work on the documentation site.
-
-Also, a shoutout to [@regisphilibert](https://github.com/regisphilibert) for his work on the new [Code Toggle Shortcode](https://gohugo.io/getting-started/code-toggle/) on the Hugo docs site, which we will put to good use to improve all the configuration samples.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **55 contributions by 18 contributors**. A special thanks to [@kaushalmodi](https://github.com/kaushalmodi), [@bep](https://github.com/bep), [@xa0082249956](https://github.com/xa0082249956), and [@paulcmal](https://github.com/paulcmal) for their work on the documentation site.
-
-
-Hugo now has:
-
-* 24547+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 447+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 213+ [themes](http://themes.gohugo.io/)
-
-## Notes
-
-* Hugo now allows partial redefinition `outputs` in your site configuration. This is what most people would expect, but it is still a change in behaviour. For details, see [#4487](https://github.com/gohugoio/hugo/issues/4487)
-* Before this release, Hugo flattened URLs of processed images in sub-folders. This worked fine but was not intentional. See [#4502](https://github.com/gohugoio/hugo/issues/4502).
-
-## Enhancements
-
-* Allow themes to define output formats, media types and params [e9c7b620](https://github.com/gohugoio/hugo/commit/e9c7b6205f94a7edac0e0df2cd18d1456cb26a06) [@bep](https://github.com/bep) [#4490](https://github.com/gohugoio/hugo/issues/4490)
-* Allow partial redefinition of the `ouputs` config [f8dc47ee](https://github.com/gohugoio/hugo/commit/f8dc47eeffa847fd0b51e376da355e3d957848a6) [@bep](https://github.com/bep) [#4487](https://github.com/gohugoio/hugo/issues/4487)
-* Add a way to merge pages by language [ffaec4ca](https://github.com/gohugoio/hugo/commit/ffaec4ca8c4c6fd05b195879ccd65acf2fd5a6ac) [@bep](https://github.com/bep) [#4463](https://github.com/gohugoio/hugo/issues/4463)
-* Extract `date` and `slug` from filename [68bf1511](https://github.com/gohugoio/hugo/commit/68bf1511f2be39b6576d882d071196e477c72c9f) [@bep](https://github.com/bep) [#285](https://github.com/gohugoio/hugo/issues/285)[#3310](https://github.com/gohugoio/hugo/issues/3310)[#3762](https://github.com/gohugoio/hugo/issues/3762)[#4340](https://github.com/gohugoio/hugo/issues/4340)
-* Add `Delete` method to delete key from `Scratch` [e46ab29b](https://github.com/gohugoio/hugo/commit/e46ab29bd24caa9e2cfa51f24ba15037750850d6) [@paulcmal](https://github.com/paulcmal)
-* Simplify Prev/Next [79dd7cb3](https://github.com/gohugoio/hugo/commit/79dd7cb31a941d7545df33b938ca3ed46593ddfd) [@bep](https://github.com/bep)
-* List Chroma lexers [2c54f1ad](https://github.com/gohugoio/hugo/commit/2c54f1ad48fe2a2f7504117d351d45abc89dcb1f) [@bep](https://github.com/bep) [#4554](https://github.com/gohugoio/hugo/issues/4554)
-* Add support for a `contentDir` set per language [eb42774e](https://github.com/gohugoio/hugo/commit/eb42774e587816b1fbcafbcea59ed65df703882a) [@bep](https://github.com/bep) [#4523](https://github.com/gohugoio/hugo/issues/4523)[#4552](https://github.com/gohugoio/hugo/issues/4552)[#4553](https://github.com/gohugoio/hugo/issues/4553)
-* Update Chroma [7a634898](https://github.com/gohugoio/hugo/commit/7a634898c359a6af0da52be17df07cae97c7937c) [@bep](https://github.com/bep) [#4549](https://github.com/gohugoio/hugo/issues/4549)
-* Add `.Site.IsServer` [1823c053](https://github.com/gohugoio/hugo/commit/1823c053c8900cb6ee53b8e5c02939c7398e34dd) [@felicianotech](https://github.com/felicianotech) [#4478](https://github.com/gohugoio/hugo/issues/4478)
-* Move to Ubuntu Trusty image [511d5d3b](https://github.com/gohugoio/hugo/commit/511d5d3b7681cb76822098f430ed6862232ca529) [@anthonyfok](https://github.com/anthonyfok)
-* Bump some deprecations [b6798ee8](https://github.com/gohugoio/hugo/commit/b6798ee8676c48f86b0bd8581ea244f4be4ef3fa) [@bep](https://github.com/bep)
-* Update Chroma to get `Go template support` [904a3d9d](https://github.com/gohugoio/hugo/commit/904a3d9ddf523d452d04d0b5814503e0ff17bd2e) [@bep](https://github.com/bep) [#4515](https://github.com/gohugoio/hugo/issues/4515)
-* Recover from error in server [f0052b6d](https://github.com/gohugoio/hugo/commit/f0052b6d0f8e113a50aeb6cd7bd34555dbf34a00) [@bep](https://github.com/bep) [#4516](https://github.com/gohugoio/hugo/issues/4516)
-* Spring test cleaning, take 2 [da880157](https://github.com/gohugoio/hugo/commit/da88015776645cc68b96e8b94030c95905df53ae) [@bep](https://github.com/bep)
-* Add docs for `lang.Merge` [70005364](https://github.com/gohugoio/hugo/commit/70005364a245ea3bc59c74192e1f4c56cb6879cf) [@bep](https://github.com/bep)
-* Remove archetype title/date warning [ac12d51e](https://github.com/gohugoio/hugo/commit/ac12d51e7ea3a0ffb7d8053a10b6bf6acf1235ae) [@bep](https://github.com/bep) [#4504](https://github.com/gohugoio/hugo/issues/4504)
-* Add docs on the new front matter configuration [0dbf79c2](https://github.com/gohugoio/hugo/commit/0dbf79c2f8cd5b1a5c91c04a8d677f956b0b8fe8) [@bep](https://github.com/bep) [#4495](https://github.com/gohugoio/hugo/issues/4495)
-* Refactor the GitInfo into the date handlers [ce6e4310](https://github.com/gohugoio/hugo/commit/ce6e4310febf5659392a41b543594382441f3681) [@bep](https://github.com/bep) [#4495](https://github.com/gohugoio/hugo/issues/4495)
-* Do not print build total when `--quiet` is set [50a03a5a](https://github.com/gohugoio/hugo/commit/50a03a5acc7c200c795590c3f4b964fdc56085f2) [@bep](https://github.com/bep) [#4456](https://github.com/gohugoio/hugo/issues/4456)
-
-## Fixes
-
-* Fix freeze in invalid front matter error case [93e24a03](https://github.com/gohugoio/hugo/commit/93e24a03ce98d3212a2d49ad04739141229d0809) [@bep](https://github.com/bep) [#4526](https://github.com/gohugoio/hugo/issues/4526)
-* Fix path duplication/flattening in processed images [3fbc7553](https://github.com/gohugoio/hugo/commit/3fbc75534d1acda2be1c597aa77c919d3a02659d) [@bep](https://github.com/bep) [#4502](https://github.com/gohugoio/hugo/issues/4502)[#4501](https://github.com/gohugoio/hugo/issues/4501)
-* Fix SVG and similar resource handling [ba94abbf](https://github.com/gohugoio/hugo/commit/ba94abbf5dd90f989242af8a7027d67a572a6128) [@bep](https://github.com/bep) [#4455](https://github.com/gohugoio/hugo/issues/4455)
-
-
-
-
diff --git a/docs/content/news/0.38.1-relnotes/index.md b/docs/content/news/0.38.1-relnotes/index.md
@@ -1,32 +0,0 @@
-
----
-date: 2018-04-05
-title: "Some Live Reload Fixes"
-description: "Hugo 0.38.1 fixes some live reload issues introduced in 0.38."
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
-
----
-
-
-
-This is a bug-fix that is mainly motivated by some issues with server live reloading introduced in Hugo 0.38.
-
-* Fix livereload for the home page bundle [f87239e4](https://github.com/gohugoio/hugo/commit/f87239e4cab958bf59ecfb1beb8cac439441a553) [@bep](https://github.com/bep) [#4576](https://github.com/gohugoio/hugo/issues/4576)
-* Fix empty BuildDate in "hugo version" [294c0f80](https://github.com/gohugoio/hugo/commit/294c0f8001fe598278c1eb8015deb6b98e8de686) [@anthonyfok](https://github.com/anthonyfok)
-* Fix some livereload content regressions [a4deaeff](https://github.com/gohugoio/hugo/commit/a4deaeff0cfd70abfbefa6d40c0b86839a216f6d) [@bep](https://github.com/bep) [#4566](https://github.com/gohugoio/hugo/issues/4566)
-* Update github.com/bep/gitmap to fix snap build [4d115c56](https://github.com/gohugoio/hugo/commit/4d115c56fac9060230fbac6181a05f7cc6d10b42) [@anthonyfok](https://github.com/anthonyfok) [#4538](https://github.com/gohugoio/hugo/issues/4538)
-* Fix two tests that are broken on Windows [26f34fd5](https://github.com/gohugoio/hugo/commit/26f34fd59da1ce1885d4f2909c5d9ef9c1726944) [@neurocline](https://github.com/neurocline)
-
-
-This release also contains some improvements:
-
-* Add bash completion [874159b5](https://github.com/gohugoio/hugo/commit/874159b5436bc9080aec71a9c26d35f8f62c9fd0) [@anthonyfok](https://github.com/anthonyfok)
-* Handle mass content etc. edits in server mode [730b66b6](https://github.com/gohugoio/hugo/commit/730b66b6520f263af16f555d1d7be51205a8e51d) [@bep](https://github.com/bep) [#4563](https://github.com/gohugoio/hugo/issues/4563)
-
-
-
-
-
-
diff --git a/docs/content/news/0.38.2-relnotes/index.md b/docs/content/news/0.38.2-relnotes/index.md
@@ -1,26 +0,0 @@
-
----
-date: 2018-04-09
-title: "Hugo 0.38.2: Two Bugfixes"
-description: "0.38.2 fixes --contentDir flag handling and \".\" in content filenames."
-categories: ["Releases"]
-images:
-- images/blog/hugo-bug-poster.png
-
----
-
-
-
-This is a bug-fix release with a couple of important fixes:
-
-
-* Fix handling of the `--contentDir` and possibly other related flags [080302eb](https://github.com/gohugoio/hugo/commit/080302eb8757fd94ccbd6bf99103432cd98e716c) [@bep](https://github.com/bep) [#4589](https://github.com/gohugoio/hugo/issues/4589)
-* Fix handling of content files with "." in them [2817e842](https://github.com/gohugoio/hugo/commit/2817e842407c8dcbfc738297ab634392fcb41ce1) [@bep](https://github.com/bep) [#4559](https://github.com/gohugoio/hugo/issues/4559)
-
-
-Also in this release:
-
-* Set .Parent in bundled pages to its owner [6792d86a](https://github.com/gohugoio/hugo/commit/6792d86ad028571c684a776c5f00e0107838c955) [@bep](https://github.com/bep) [#4582](https://github.com/gohugoio/hugo/issues/4582)
-
-
-
diff --git a/docs/content/news/0.39-relnotes/index.md b/docs/content/news/0.39-relnotes/index.md
@@ -1,87 +0,0 @@
-
----
-date: 2018-04-16
-title: "The Nat King Cole Stabilizer Edition"
-description: "Hugo 0.39: Rewrite of the /commands package, `Resource.Content`, several new template funcs, and more …"
-categories: ["Releases"]
----
-
-
-**Nat King Cole** was a fantastic American jazz pianist. When his bass player had visited the bar a little too often, he started with his percussive piano playing to keep the tempo flowing. Oscar Peterson called it _"Nat's stabilizers"_. This release is the software equivalent of that. We have been doing frequent main releases this year, but looking back, the patch releases that followed them seemed unneeded. And looking at the regressions, most of them stem from the `commands` package, a package that before this release was filled with globals and high coupling. This package is now rewritten and accompanied with decent test coverage.
-
-But this release isn't all boring and technical: It includes several important bug fixes, several useful new template functions, and `Resource.Content` allows you to get any resource's content without having to fiddle with file paths and `readFile`.
-
-This release represents **61 contributions by 4 contributors** to the main Hugo code base. A shout-out to [@bep](https://github.com/bep) for the implementation and [@it-gro](https://github.com/it-gro) and [@RickCogley](https://github.com/RickCogley) for the help testing it.
-
-[@bep](https://github.com/bep) leads the Hugo development with a significant amount of contributions and his witty Norwegian humour, but also a big shoutout to [@anthonyfok](https://github.com/anthonyfok), [@thedodobird2](https://github.com/thedodobird2), and [@neurocline](https://github.com/neurocline) for their ongoing contributions.
-And a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the themes site in pristine condition and to [@kaushalmodi](https://github.com/kaushalmodi) for his great work on the documentation site.
-
-Many have also been busy writing and fixing the documentation in [hugoDocs](https://github.com/gohugoio/hugoDocs),
-which has received **6 contributions by 5 contributors**. A special thanks to [@kaushalmodi](https://github.com/kaushalmodi), [@regisphilibert](https://github.com/regisphilibert), [@bep](https://github.com/bep), and [@tomanistor](https://github.com/tomanistor) for their work on the documentation site.
-
-Hugo now has:
-
-* 24911+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 446+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 218+ [themes](http://themes.gohugo.io/)
-
-## Notes
-
-* The `main.Execute` function now returns a `Response` object and the global `Hugo` variable is removed. This is only relevant for people building some kind of API around Hugo.
-* Remove deprecated `File.Bytes` [94c8b29c](https://github.com/gohugoio/hugo/commit/94c8b29c39d0c485ee91d98c08fd615c28802496) [@bep](https://github.com/bep)
-
-## Enhancements
-
-### Templates
-
-* Add `anchorize` template func [4dba6ce1](https://github.com/gohugoio/hugo/commit/4dba6ce15ae9b5208b1e2d68c96d7b1dce0a07ab) [@bep](https://github.com/bep)
-* Add `path.Join` [880ca19f](https://github.com/gohugoio/hugo/commit/880ca19f209e68e6a8daa6686b361515ecacc91e) [@bep](https://github.com/bep)
-* Add `path.Split` template func [01b72eb5](https://github.com/gohugoio/hugo/commit/01b72eb592d0e0aefc5f7ae42f9f6ff112883bb6) [@bep](https://github.com/bep)
-
-### Other
-
-* Implement `Resource.Content` [0e7716a4](https://github.com/gohugoio/hugo/commit/0e7716a42450401c7998aa81ad2ed98c8ab109e8) [@bep](https://github.com/bep) [#4622](https://github.com/gohugoio/hugo/issues/4622)
-* Make `Page.Content` a method that returns interface{} [417c5e2b](https://github.com/gohugoio/hugo/commit/417c5e2b67b97fa80a0b6f77d259966f03b95344) [@bep](https://github.com/bep) [#4622](https://github.com/gohugoio/hugo/issues/4622)
-* Remove accidental and breaking space in baseURL flag [1b4e0c41](https://github.com/gohugoio/hugo/commit/1b4e0c4161fb631add62e77f494a7e62c3619020) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
-* Properly handle CLI slice arguments [27a524b0](https://github.com/gohugoio/hugo/commit/27a524b0905ec73c1eef233f94700feb9f465011) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
-* Correctly handle destination and i18n-warnings [bede93de](https://github.com/gohugoio/hugo/commit/bede93de005dcf934f3ec9be6388310ac6c57acd) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
-* Allow "*/" inside commented out shortcodes [14c35c8a](https://github.com/gohugoio/hugo/commit/14c35c8a56c4dc9a1ee0053e9ff976be7715ba99) [@bep](https://github.com/bep) [#4608](https://github.com/gohugoio/hugo/issues/4608)
-* Make commands.Execute return a Response object [96689a5c](https://github.com/gohugoio/hugo/commit/96689a5c319f720368491226f034d0ff9585217c) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Remove some TODOs [e7010c1b](https://github.com/gohugoio/hugo/commit/e7010c1b621d68ee53411a5ba8143d07b976d9fe) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Add basic server test [a7d00fc3](https://github.com/gohugoio/hugo/commit/a7d00fc39e87a5cac99b3a2380f5cc8c135d2b4b) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Remove the Hugo global [b110d0ae](https://github.com/gohugoio/hugo/commit/b110d0ae04e13fb45c739bcebb580709745082e6) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the limit command work again [73825cfc](https://github.com/gohugoio/hugo/commit/73825cfc1c0b007830b24bb1947a565175b52d36) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Move the commands related logic to its own file [a8f7fbbb](https://github.com/gohugoio/hugo/commit/a8f7fbbb10aa78f3ebac008d29d9969bb197393c) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Add CLI tests [e8d6ca95](https://github.com/gohugoio/hugo/commit/e8d6ca9531d19e4e898c57d77d2fd627ea38ade0) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the hugo command non-global [4d32f2fa](https://github.com/gohugoio/hugo/commit/4d32f2fa8969f368b088dc9bcedb45f2c986cb27) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Extract some common types into its own file [018602c4](https://github.com/gohugoio/hugo/commit/018602c46db8d729af2871bd5f4c1e7480420f09) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the server command non-global [2f0d98a1](https://github.com/gohugoio/hugo/commit/2f0d98a19b021d03930003217b0519afaef3a391) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the gen commands non-global [e0621d20](https://github.com/gohugoio/hugo/commit/e0621d207ce3278a82f8a60607e9cdd304149029) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the list commands non-global [e26a8b24](https://github.com/gohugoio/hugo/commit/e26a8b242a6434117d089a0799238add7025dbf4) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the import commands non-global [2a2c9838](https://github.com/gohugoio/hugo/commit/2a2c9838671b5401331d20f8c72e2b934fe34e8d) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the config command non-global [15b1e269](https://github.com/gohugoio/hugo/commit/15b1e269ade91ddc6a74c552bc61b0c5e527d268) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make the new commands non-global [56a13080](https://github.com/gohugoio/hugo/commit/56a13080446283ed1cde6b69fc6f4fac85076c84) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make convert command non-global [4b780ca7](https://github.com/gohugoio/hugo/commit/4b780ca778ee7f25af808da38ede964a01698c70) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make more commands non-global [7bc5e89f](https://github.com/gohugoio/hugo/commit/7bc5e89fbaa5c613b8853ff7b69fae570bd0b56d) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Make benchmark non-global [fdf1d94e](https://github.com/gohugoio/hugo/commit/fdf1d94ebc7d1aa4855c62237f2edbd4bdade1a7) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Start of flag cleaning [1157fef8](https://github.com/gohugoio/hugo/commit/1157fef85908ea54883fe0dba6adc4861ba02162) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Use short date format in CLI docs [e614d8a5](https://github.com/gohugoio/hugo/commit/e614d8a57c2ff5eef9270d51fcc6518398d7ff88) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Update README.md [fca49d6c](https://github.com/gohugoio/hugo/commit/fca49d6c608d227049cb2f26895cfecc685f1c89) [@thedodobird2](https://github.com/thedodobird2)
-* Sync dependencies [0e8b3cbc](https://github.com/gohugoio/hugo/commit/0e8b3cbcd274e1f2e14be694c794a544f49efb56) [@bep](https://github.com/bep)
-* Bump Go versions [230f2b8c](https://github.com/gohugoio/hugo/commit/230f2b8c4fce03f14847de2b22402e64d4d69783) [@bep](https://github.com/bep) [#4545](https://github.com/gohugoio/hugo/issues/4545)
-* Add bash completion [874159b5](https://github.com/gohugoio/hugo/commit/874159b5436bc9080aec71a9c26d35f8f62c9fd0) [@anthonyfok](https://github.com/anthonyfok)
-* Handle mass content etc. edits in server mode [730b66b6](https://github.com/gohugoio/hugo/commit/730b66b6520f263af16f555d1d7be51205a8e51d) [@bep](https://github.com/bep) [#4563](https://github.com/gohugoio/hugo/issues/4563)
-
-## Fixes
-
-* Fix `livereload` of bundled pages [f3775877](https://github.com/gohugoio/hugo/commit/f3775877c61c11ab7c8fd1fc3e15470bf5da4820) [@bep](https://github.com/bep) [#4607](https://github.com/gohugoio/hugo/issues/4607)
-* Do not reset `.Page.Scratch` on rebuilds [61d52f14](https://github.com/gohugoio/hugo/commit/61d52f146297950e283ae086d8b1af61099d22a0) [@bep](https://github.com/bep) [#4627](https://github.com/gohugoio/hugo/issues/4627)
-* Fix failing Travis server test [9c782d51](https://github.com/gohugoio/hugo/commit/9c782d5147bfea0dd85cf3374f598f0176f204eb) [@bep](https://github.com/bep)
-* Fix the config command [f396cffa](https://github.com/gohugoio/hugo/commit/f396cffa239e948075af2224208671956d8b4a84) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Fix some flag diff [24d5c219](https://github.com/gohugoio/hugo/commit/24d5c219424a9777bb1dd366b43e68e6f47e1adb) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Fix TestFixURL [1e233b1c](https://github.com/gohugoio/hugo/commit/1e233b1c4598fd8cbce7da8a67bf2c4918c6047e) [@bep](https://github.com/bep) [#4598](https://github.com/gohugoio/hugo/issues/4598)
-* Disable shallow clone to fix TestPageWithLastmodFromGitInfo [094ec171](https://github.com/gohugoio/hugo/commit/094ec171420e659cdf962a19dd90105912ce9901) [@anthonyfok](https://github.com/anthonyfok) [#4584](https://github.com/gohugoio/hugo/issues/4584)
-* Fix livereload for the home page bundle [f87239e4](https://github.com/gohugoio/hugo/commit/f87239e4cab958bf59ecfb1beb8cac439441a553) [@bep](https://github.com/bep) [#4576](https://github.com/gohugoio/hugo/issues/4576)
-* Fix empty `BuildDate` in "hugo version" [294c0f80](https://github.com/gohugoio/hugo/commit/294c0f8001fe598278c1eb8015deb6b98e8de686) [@anthonyfok](https://github.com/anthonyfok)
-* Fix some livereload content regressions [a4deaeff](https://github.com/gohugoio/hugo/commit/a4deaeff0cfd70abfbefa6d40c0b86839a216f6d) [@bep](https://github.com/bep) [#4566](https://github.com/gohugoio/hugo/issues/4566)
-* Fix two tests that are broken on Windows [26f34fd5](https://github.com/gohugoio/hugo/commit/26f34fd59da1ce1885d4f2909c5d9ef9c1726944) [@neurocline](https://github.com/neurocline)
diff --git a/docs/content/release-notes/0.25-relnotes.md b/docs/content/release-notes/0.25-relnotes.md
@@ -1,78 +0,0 @@
-
----
-date: 2017-07-07
-title: 0.25
----
-
- Hugo `0.25` is the **Kinder Surprise**: It automatically opens the page you're working on in the browser, it adds full `AND` and `OR` support in page queries, and you can now have templates per language.
-
-
-
-If you start with `hugo server --navigateToChanged`, Hugo will navigate to the relevant page on save (see animated GIF). This is extremely useful for site-wide edits. Another very useful feature in this version is the added support for `AND` (`intersect`) and `OR` (`union`) filters when combined with `where`.
-
-Example:
-
-```go
-{{ $pages := where .Site.RegularPages "Type" "not in" (slice "page" "about") }}
-{{ $pages := $pages | union (where .Site.RegularPages "Params.pinned" true) }}
-{{ $pages := $pages | intersect (where .Site.RegularPages "Params.images" "!=" nil) }}
-```
-
-The above fetches regular pages not of `page` or `about` type unless they are pinned. And finally, we exclude all pages with no `images` set in Page params.
-
-This release represents **36 contributions by 12 contributors** to the main Hugo code base. [@bep](https://github.com/bep) still leads the Hugo development with his witty Norwegian humor, and once again contributed a significant amount of additions. But also a big shoutout to [@yihui](https://github.com/yihui), [@anthonyfok](https://github.com/anthonyfok), and [@kropp](https://github.com/kropp) for their ongoing contributions. And as always a big thanks to [@digitalcraftsman](https://github.com/digitalcraftsman) for his relentless work on keeping the documentation and the themes site in pristine condition.
-
-Hugo now has:
-
-* 18209+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 455+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 168+ [themes](http://themes.gohugo.io/)
-
-## Enhancements
-
-### Templates
-
-* Add `Pages` support to `intersect` (`AND`) and `union`(`ÒR`). This makes the `where` template func even more powerful. [ccdd08d5](https://github.com/gohugoio/hugo/commit/ccdd08d57ab64441e93d6861ae126b5faacdb92f) [@bep](https://github.com/bep) [#3174](https://github.com/gohugoio/hugo/issues/3174)
-* Add `math.Log` function. This is very handy for creating tag clouds. [34c56677](https://github.com/gohugoio/hugo/commit/34c566773a1364077e1397daece85b22948dc721) [@artem-sidorenko](https://github.com/artem-sidorenko)
-* Add `WebP` images support [8431c8d3](https://github.com/gohugoio/hugo/commit/8431c8d39d878c18c6b5463d9091a953608df10b) [@bep](https://github.com/bep) [#3529](https://github.com/gohugoio/hugo/issues/3529)
-* Only show post's own keywords in schema.org [da72805a](https://github.com/gohugoio/hugo/commit/da72805a4304a57362e8e79a01cc145767b027c5) [@brunoamaral](https://github.com/brunoamaral) [#2635](https://github.com/gohugoio/hugo/issues/2635)[#2646](https://github.com/gohugoio/hugo/issues/2646)
-* Simplify the `Disqus` template a little bit (#3655) [eccb0647](https://github.com/gohugoio/hugo/commit/eccb0647821e9db20ba9800da1b4861807cc5205) [@yihui](https://github.com/yihui)
-* Improve the built-in Disqus template (#3639) [2e1e4934](https://github.com/gohugoio/hugo/commit/2e1e4934b60ce8081a7f3a79191ed204f3098481) [@yihui](https://github.com/yihui)
-
-### Output
-
-* Support templates per site/language. This is for both regular templates and shortcode templates. [aa6b1b9b](https://github.com/gohugoio/hugo/commit/aa6b1b9be7c9d7322333893b642aaf8c7a5f2c2e) [@bep](https://github.com/bep) [#3360](https://github.com/gohugoio/hugo/issues/3360)
-
-### Core
-
-* Extend the sections API [a1d260b4](https://github.com/gohugoio/hugo/commit/a1d260b41a6673adef679ec4e262c5f390432cf5) [@bep](https://github.com/bep) [#3591](https://github.com/gohugoio/hugo/issues/3591)
-* Make `.Site.Sections` return the top level sections [dd9b1baa](https://github.com/gohugoio/hugo/commit/dd9b1baab0cb860a3eb32fd9043bac18cab3f9f0) [@bep](https://github.com/bep) [#3591](https://github.com/gohugoio/hugo/issues/3591)
-* Render `404.html` for all languages [41805dca](https://github.com/gohugoio/hugo/commit/41805dca9e40e9b0952e04d06074e6fc91140495) [@mitchchn](https://github.com/mitchchn) [#3598](https://github.com/gohugoio/hugo/issues/3598)
-
-### Other
-
-* Support human-readable `YAML` boolean values in `undraft` [1039356e](https://github.com/gohugoio/hugo/commit/1039356edf747f044c989a5bc0e85d792341ed5d) [@kropp](https://github.com/kropp)
-* `hugo import jekyll` support nested `_posts` directories [7ee1f25e](https://github.com/gohugoio/hugo/commit/7ee1f25e9ef3be8f99c171e8e7982f4f82c13e16) [@coderzh](https://github.com/coderzh) [#1890](https://github.com/gohugoio/hugo/issues/1890)[#1911](https://github.com/gohugoio/hugo/issues/1911)
-* Update `Dockerfile` and add Docker optimizations [118f8f7c](https://github.com/gohugoio/hugo/commit/118f8f7cf22d756d8a894ff93551974a806f2155) [@ellerbrock](https://github.com/ellerbrock)
-* Add Blackfriday `joinLines` extension support (#3574) [a5440496](https://github.com/gohugoio/hugo/commit/a54404968a4b36579797f2e7ff7f5eada94866d9) [@choueric](https://github.com/choueric)
-* add `--initial-header-level=2` to rst2html (#3528) [bfce30d8](https://github.com/gohugoio/hugo/commit/bfce30d85972c27c27e8a2caac9db6315f813298) [@frankbraun](https://github.com/frankbraun)
-* Support open "current content page" in browser [c825a731](https://github.com/gohugoio/hugo/commit/c825a7312131b4afa67ee90d593640dee3525d98) [@bep](https://github.com/bep) [#3643](https://github.com/gohugoio/hugo/issues/3643)
-* Make `--navigateToChanged` more robust on Windows [30e14cc3](https://github.com/gohugoio/hugo/commit/30e14cc31678ddc204b082ab362f86b6b8063881) [@anthonyfok](https://github.com/anthonyfok) [#3645](https://github.com/gohugoio/hugo/issues/3645)
-* Remove the docs submodule [31393f60](https://github.com/gohugoio/hugo/commit/31393f6024416ea1b2e61d1080dfd7104df36eda) [@bep](https://github.com/bep) [#3647](https://github.com/gohugoio/hugo/issues/3647)
-* Use `example.com` as homepage for new theme [aff1ac32](https://github.com/gohugoio/hugo/commit/aff1ac3235b6c075d01f7237addf44fecdd36d82) [@anthonyfok](https://github.com/anthonyfok)
-
-## Fixes
-
-### Templates
-
-* Fix `in` function for JSON arrays [d12cf5a2](https://github.com/gohugoio/hugo/commit/d12cf5a25df00fa16c59f0b2ae282187a398214c) [@bep](https://github.com/bep) [#1468](https://github.com/gohugoio/hugo/issues/1468)
-
-### Other
-
-* Fix handling of `JSON` front matter with escaped quotes [e10e51a0](https://github.com/gohugoio/hugo/commit/e10e51a00827b9fdc1bee51439fef05afc529831) [@bep](https://github.com/bep) [#3661](https://github.com/gohugoio/hugo/issues/3661)
-* Fix typo in code comment [56d82aa0](https://github.com/gohugoio/hugo/commit/56d82aa025f4d2edb1dc6315132cd7ab52df649a) [@dvic](https://github.com/dvic)
-
-
-
-
-
diff --git a/docs/content/release-notes/0.25.1-relnotes.md b/docs/content/release-notes/0.25.1-relnotes.md
@@ -1,28 +0,0 @@
-
----
-date: 2017-07-10
-title: 0.25.1
----
-
-
-
-This is a bug-fix release with a couple of important fixes.
-
-
-Hugo now has:
-
-* 18277+ [stars](https://github.com/gohugoio/hugo/stargazers)
-* 456+ [contributors](https://github.com/gohugoio/hugo/graphs/contributors)
-* 170+ [themes](http://themes.gohugo.io/)
-
-## Fixes
-
-* Fix union when the first slice is empty [dbbc5c48](https://github.com/gohugoio/hugo/commit/dbbc5c4810a04ac06fad7500d88cf5c3bfe0c7fd) [@bep](https://github.com/bep) [#3686](https://github.com/gohugoio/hugo/issues/3686)
-* Navigate to changed on CREATE When working with content from IntelliJ IDE, like WebStorm, every file save is followed by two events: "RENAME" and then "CREATE". [7bcc1ce6](https://github.com/gohugoio/hugo/commit/7bcc1ce659710f2220b400ce3b76e50d2e48b241) [@miltador](https://github.com/miltador)
-* Final (!) fix for issue with escaped JSON front matter [7f82b41a](https://github.com/gohugoio/hugo/commit/7f82b41a24af0fd04d28fbfebf9254766a3c6e6f) [@bep](https://github.com/bep) [#3682](https://github.com/gohugoio/hugo/issues/3682)
-* Fix issue with escaped JSON front matter [84db6c74](https://github.com/gohugoio/hugo/commit/84db6c74a084d2b52117b999d4ec343cd3389a68) [@bep](https://github.com/bep) [#3682](https://github.com/gohugoio/hugo/issues/3682)
-
-
-
-
-
diff --git a/docs/content/templates/files.md b/docs/content/templates/files.md
@@ -1,115 +0,0 @@
----
-title: Local File Templates
-linktitle: Local File Templates
-description: Hugo's `readerDir` and `readFile` functions make it easy to traverse your project's directory structure and write file contents to your templates.
-godocref: https://golang.org/pkg/os/#FileInfo
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-02-01
-categories: [templates]
-keywords: [files,directories]
-menu:
- docs:
- parent: "templates"
- weight: 110
-weight: 110
-sections_weight: 110
-draft: false
-aliases: [/extras/localfiles/,/templates/local-files/]
-toc: true
----
-
-## Traverse Local Files
-
-With Hugo's [`readDir`][readDir] and [`readFile`][readFile] template functions, you can traverse your website's files on your server.
-
-## Use `readDir`
-
-The [`readDir` function][readDir] returns an array of [`os.FileInfo`][osfileinfo]. It takes the file's `path` as a single string argument. This path can be to any directory of your website (i.e., as found on your server's file system).
-
-Whether the path is absolute or relative does not matter because---at least for `readDir`---the root of your website (typically `./public/`) in effect becomes both:
-
-1. The file system root
-2. The current working directory
-
-### `readDir` Example: List Directory Files
-
-This shortcode creates a link to each of the files in a directory---display as the file's basename---along with the file's size in bytes.
-
-{{< code file="layouts/shortcodes/directoryindex.html" download="directoryindex.html" >}}
-{{< readfile file="/themes/gohugoioTheme/layouts/shortcodes/directoryindex.html" >}}
-{{< /code >}}
-
-You can then call the shortcode as follows inside of your content's markup:
-
-```
-{{</* directoryindex path="/static/css" pathURL="/css" */>}}
-```
-
-The above shortcode [is part of the code for the Hugo docs][dirindex]. Here it lists this site's CSS files:
-
-{{< directoryindex path="/themes/gohugoioTheme/static/dist" pathURL="/css" >}}
-
-{{% note "Slashes are Important" %}}
-The initial slash `/` in `pathURL` is important in the `directoryindex` shortcode. Otherwise, `pathURL` becomes relative to the current web page.
-{{% /note %}}
-
-## Use `readFile`
-
-The [`readfile` function][readFile] reads a file from disk and converts it into a string to be manipulated by other Hugo functions or added as-is. `readFile` takes the file, including path, as an argument passed to the function.
-
-To use the `readFile` function in your templates, make sure the path is relative to your *Hugo project's root directory*:
-
-```
-{{ readFile "/content/templates/local-file-templates" }}
-```
-
-### `readFile` Example: Add a Project File to Content
-
-As `readFile` is a function, it is only available to you in your templates and not your content. However, we can create a simple [shortcode template][sct] that calls `readFile`, passes the first argument through the function, and then allows an optional second argument to send the file through the Blackfriday markdown processor. The pattern for adding this shortcode to your content will be as follows:
-
-```
-{{</* readfile file="/path/to/local/file.txt" markdown="true" */>}}
-```
-
-{{% warning %}}
-If you are going to create [custom shortcodes](/templates/shortcode-templates/) with `readFile` for a theme, note that usage of the shortcode will refer to the project root and *not* your `themes` directory.
-{{% /warning %}}
-
-Here is the templating for our new `readfile` shortcode:
-
-{{< code file="layouts/shortcodes/readfile.html" download="readfile.html" >}}
-{{< readfile file="/themes/gohugoioTheme/layouts/shortcodes/readfile.html">}}
-{{< /code >}}
-
-This `readfile` shortcode is [also part of the Hugo docs][readfilesource]. So is [`testing.txt`][testfile], which we will call in this example by passing it into our new `readfile` shortcode as follows:
-
-```
-{{</* readfile file="/content/readfiles/testing.txt" */>}}
-```
-
-The output "string" for this shortcode declaration will be the following:
-
-```
-{{< readfile file="/content/readfiles/testing.txt" >}}
-```
-
-However, if we want Hugo to pass this string through Blackfriday, we should add the `markdown="true"` optional parameter:
-
-```
-{{</* readfile file="/content/readfiles/testing.txt" markdown="true" */>}}
-```
-
-And here is the result as [called directly in the Hugo docs][] and rendered for display:
-
-{{< readfile file="/content/readfiles/testing.txt" markdown="true">}}
-
-[called directly in the Hugo docs]: https://github.com/gohugoio/hugo/blob/master/docs/content/templates/files.md
-[dirindex]: https://github.com/gohugoio/hugo/blob/master/docs/layouts/shortcodes/directoryindex.html
-[osfileinfo]: https://golang.org/pkg/os/#FileInfo
-[readDir]: /functions/readdir/
-[readFile]: /functions/readfile/
-[sc]: /content-management/shortcodes/
-[sct]: /templates/shortcode-templates/
-[readfilesource]: https://github.com/gohugoio/hugo/blob/master/
-[testfile]: https://github.com/gohugoio/hugo/blob/master/docs/testfile
diff --git a/docs/content/templates/rss.md b/docs/content/templates/rss.md
@@ -1,119 +0,0 @@
----
-title: RSS Templates
-linktitle: RSS Templates
-description: Hugo ships with its own RSS 2.0 template that requires almost no configuration, or you can create your own RSS templates.
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-02-01
-keywords: [rss, xml, templates]
-categories: [templates]
-menu:
- docs:
- parent: "templates"
- weight: 150
-weight: 150
-sections_weight: 150
-draft: false
-aliases: [/templates/rss/]
-toc: true
----
-
-## RSS Template Lookup Order
-
-See [Template Lookup Order](/templates/lookup-order/) for the complete reference.
-
-{{% note "Hugo Ships with an RSS Template" %}}
-Hugo ships with its own [RSS 2.0 template](#the-embedded-rss-xml). The embedded template will be sufficient for most use cases.
-{{% /note %}}
-
-RSS pages are of the type `Page` and have all the [page variables](/variables/page/) available to use in the templates.
-
-### Section RSS
-
-A [section’s][section] RSS will be rendered at `/<SECTION>/index.xml` (e.g., http://spf13.com/project/index.xml).
-
-Hugo provides the ability for you to define any RSS type you wish and can have different RSS files for each section and taxonomy.
-
-## Lookup Order for RSS Templates
-
-The table below shows the RSS template lookup order for the different page kinds. The first listing shows the lookup order when running with a theme (`demoTheme`).
-
-{{< datatable-filtered "output" "layouts" "OutputFormat == RSS" "Example" "OutputFormat" "Suffix" "Template Lookup Order" >}}
-
-## Configure RSS
-
-By default, Hugo will create an unlimited number of RSS entries. You can limit the number of articles included in the built-in RSS templates by assigning a numeric value to `rssLimit:` field in your project's [`config` file][config].
-
-The following values will also be included in the RSS output if specified in your site’s configuration:
-
-```toml
-languageCode = "en-us"
-copyright = "This work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International License."
-
-[author]
- name = "My Name Here"
-```
-
-## The Embedded rss.xml
-
-This is the default RSS template that ships with Hugo. It adheres to the [RSS 2.0 Specification][RSS 2.0].
-
-```xml
-<rss version="2.0" xmlns:atom="http://www.w3.org/2005/Atom">
- <channel>
- <title>{{ if eq .Title .Site.Title }}{{ .Site.Title }}{{ else }}{{ with .Title }}{{.}} on {{ end }}{{ .Site.Title }}{{ end }}</title>
- <link>{{ .Permalink }}</link>
- <description>Recent content {{ if ne .Title .Site.Title }}{{ with .Title }}in {{.}} {{ end }}{{ end }}on {{ .Site.Title }}</description>
- <generator>Hugo -- gohugo.io</generator>{{ with .Site.LanguageCode }}
- <language>{{.}}</language>{{end}}{{ with .Site.Author.email }}
- <managingEditor>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</managingEditor>{{end}}{{ with .Site.Author.email }}
- <webMaster>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</webMaster>{{end}}{{ with .Site.Copyright }}
- <copyright>{{.}}</copyright>{{end}}{{ if not .Date.IsZero }}
- <lastBuildDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</lastBuildDate>{{ end }}
- {{ with .OutputFormats.Get "RSS" }}
- {{ printf "<atom:link href=%q rel=\"self\" type=%q />" .Permalink .MediaType | safeHTML }}
- {{ end }}
- {{ range .Data.Pages }}
- <item>
- <title>{{ .Title }}</title>
- <link>{{ .Permalink }}</link>
- <pubDate>{{ .Date.Format "Mon, 02 Jan 2006 15:04:05 -0700" | safeHTML }}</pubDate>
- {{ with .Site.Author.email }}<author>{{.}}{{ with $.Site.Author.name }} ({{.}}){{end}}</author>{{end}}
- <guid>{{ .Permalink }}</guid>
- <description>{{ .Summary | html }}</description>
- </item>
- {{ end }}
- </channel>
-</rss>
-```
-
-{{% warning "XML Header" %}}
-Hugo will automatically add the following header line to this file on render. Please do *not* include this in the template as it's not valid HTML.
-```
-<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
-```
-{{% /warning %}}
-
-## Reference your RSS Feed in `<head>`
-
-In your `header.html` template, you can specify your RSS feed in your `<head></head>` tag using Hugo's [Output Formats][Output Formats] like this:
-
-```
-{{ range .AlternativeOutputFormats -}}
- <link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | safeURL }}" title="{{ $.Site.Title }}">
-{{ end -}}
-```
-
-If you only want the RSS link, you can query the formats:
-
-```
-{{ with .OutputFormats.Get "rss" -}}
- <link rel="{{ .Rel }}" type="{{ .MediaType.Type }}" href="{{ .Permalink | safeURL }}" title="{{ $.Site.Title }}">
-{{ end -}
-```
-
-[config]: /getting-started/configuration/
-[embedded]: #the-embedded-rss-xml
-[RSS 2.0]: http://cyber.law.harvard.edu/rss/rss.html "RSS 2.0 Specification"
-[section]: /content-management/sections/
-[Output Formats]: /templates/output-formats/#link-to-output-formats-
\ No newline at end of file
diff --git a/docs/content/variables/page.md b/docs/content/variables/page.md
@@ -1,286 +0,0 @@
----
-title: Page Variables
-linktitle:
-description: Page-level variables are defined in a content file's front matter, derived from the content's file location, or extracted from the content body itself.
-date: 2017-02-01
-publishdate: 2017-02-01
-lastmod: 2017-02-01
-categories: [variables and params]
-keywords: [pages]
-draft: false
-menu:
- docs:
- title: "variables defined by a page"
- parent: "variables"
- weight: 20
-weight: 20
-sections_weight: 20
-aliases: [/variables/page/]
-toc: true
----
-
-The following is a list of page-level variables. Many of these will be defined in the front matter, derived from file location, or extracted from the content itself.
-
-{{% note "`.Scratch`" %}}
-See [`.Scratch`](/functions/scratch/) for page-scoped, writable variables.
-{{% /note %}}
-
-## Page Variables
-
-.AlternativeOutputFormats
-: contains all alternative formats for a given page; this variable is especially useful `link rel` list in your site's `<head>`. (See [Output Formats](/templates/output-formats/).)
-
-.Content
-: the content itself, defined below the front matter.
-
-.Data
-: the data specific to this type of page.
-
-.Date
-: the date associated with the page; `.Date` pulls from the `date` field in a content's front matter. See also `.ExpiryDate`, `.PublishDate`, and `.Lastmod`.
-
-.Description
-: the description for the page.
-
-.Dir
-: the path of the folder containing this content file. The path is relative to the `content` folder.
-
-.Draft
-: a boolean, `true` if the content is marked as a draft in the front matter.
-
-.ExpiryDate
-: the date on which the content is scheduled to expire; `.ExpiryDate` pulls from the `expirydate` field in a content's front matter. See also `.PublishDate`, `.Date`, and `.Lastmod`.
-
-.File
-: filesystem-related data for this content file. See also [File Variables][].
-
-.FuzzyWordCount
-: the approximate number of words in the content.
-
-.Hugo
-: see [Hugo Variables](/variables/hugo/).
-
-.IsHome
-: `true` in the context of the [homepage](/templates/homepage/).
-
-.IsNode
-: always `false` for regular content pages.
-
-.IsPage
-: always `true` for regular content pages.
-
-.IsTranslated
-: `true` if there are translations to display.
-
-.Keywords
-: the meta keywords for the content.
-
-.Kind
-: the page's *kind*. Possible return values are `page`, `home`, `section`, `taxonomy`, or `taxonomyTerm`. Note that there are also `RSS`, `sitemap`, `robotsTXT`, and `404` kinds, but these are only available during the rendering of each of these respective page's kind and therefore *not* available in any of the `Pages` collections.
-
-.Lang
-: language taken from the language extension notation.
-
-.Language
-: a language object that points to the language's definition in the site
-`config`.
-
-.Lastmod
-: the date the content was last modified. `.Lastmod` pulls from the `lastmod` field in a content's front matter.
-
- - If `lastmod` is not set, and `.GitInfo` feature is disabled, the front matter `date` field will be used.
- - If `lastmod` is not set, and `.GitInfo` feature is enabled, `.GitInfo.AuthorDate` will be used instead.
-
-See also `.ExpiryDate`, `.Date`, `.PublishDate`, and [`.GitInfo`][gitinfo].
-
-.LinkTitle
-: access when creating links to the content. If set, Hugo will use the `linktitle` from the front matter before `title`.
-
-.Next
-: pointer to the following content (based on the `publishdate` field in front matter).
-
-.NextInSection
-: pointer to the following content within the same section (based on `publishdate` field in front matter).
-
-.OutputFormats
-: 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`.
-
-.Permalink
-: the Permanent link for this page; see [Permalinks](/content-management/urls/)
-
-.Plain
-: the Page content stripped of HTML tags and presented as a string.
-
-.PlainWords
-: the Page content stripped of HTML as a `[]string` using Go's [`strings.Fields`](https://golang.org/pkg/strings/#Fields) to split `.Plain` into a slice.
-
-.Prev
-: Pointer to the previous content (based on `publishdate` in front matter).
-
-.PrevInSection
-: Pointer to the previous content within the same section (based on `publishdate` in front matter). For example, `{{if .PrevInSection}}{{.PrevInSection.Permalink}}{{end}}`.
-
-.PublishDate
-: the date on which the content was or will be published; `.Publishdate` pulls from the `publishdate` field in a content's front matter. See also `.ExpiryDate`, `.Date`, and `.Lastmod`.
-
-.RSSLink
-: link to the taxonomies' RSS link.
-
-.RawContent
-: raw markdown content without the front matter. Useful with [remarkjs.com](
-http://remarkjs.com)
-
-.ReadingTime
-: the estimated time, in minutes, it takes to read the content.
-
-.Ref
-: returns the permalink for a given reference (e.g., `.Ref "sample.md"`). `.Ref` does *not* handle in-page fragments correctly. See [Cross References](/content-management/cross-references/).
-
-.RelPermalink
-: the relative permanent link for this page.
-
-.RelRef
-: returns the relative permalink for a given reference (e.g., `RelRef
-"sample.md"`). `.RelRef` does *not* handle in-page fragments correctly. See [Cross References](/content-management/cross-references/).
-
-.Site
-: see [Site Variables](/variables/site/).
-
-.Summary
-: a generated summary of the content for easily showing a snippet in a summary view. The breakpoint can be set manually by inserting <code><!--more--></code> at the appropriate place in the content page. See [Content Summaries](/content-management/summaries/) for more details.
-
-.TableOfContents
-: the rendered [table of contents](/content-management/toc/) for the page.
-
-.Title
-: the title for this page.
-
-.Translations
-: a list of translated versions of the current page. See [Multilingual Mode](/content-management/multilingual/) for more information.
-
-.Truncated
-: a boolean, `true` if the `.Summary` is truncated. Useful for showing a "Read more..." link only when necessary. See [Summaries](/content-management/summaries/) for more information.
-
-.Type
-: the [content type](/content-management/types/) of the content (e.g., `post`).
-
-.URL
-: the URL for the page relative to the web root. Note that a `url` set directly in front matter overrides the default relative URL for the rendered page.
-
-.UniqueID
-: the MD5-checksum of the content file's path.
-
-.Weight
-: assigned weight (in the front matter) to this content, used in sorting.
-
-.WordCount
-: the number of words in the content.
-
-## Section Variables and Methods
-
-Also see [Sections](/content-management/sections/).
-
-{{< readfile file="/content/readfiles/sectionvars.md" markdown="true" >}}
-
-## Page-level Params
-
-Any other value defined in the front matter in a content file, including taxonomies, will be made available as part of the `.Params` variable.
-
-```
----
-title: My First Post
-date: 2017-02-20T15:26:23-06:00
-categories: [one]
-tags: [two,three,four]
-```
-
-With the above front matter, the `tags` and `categories` taxonomies are accessible via the following:
-
-* `.Params.tags`
-* `.Params.categories`
-
-{{% note "Casing of Params" %}}
-Page-level `.Params` are *only* accessible in lowercase.
-{{% /note %}}
-
-The `.Params` variable is particularly useful for the introduction of user-defined front matter fields in content files. For example, a Hugo website on book reviews could have the following front matter in `/content/review/book01.md`:
-
-```
----
-...
-affiliatelink: "http://www.my-book-link.here"
-recommendedby: "My Mother"
-...
----
-```
-
-These fields would then be accessible to the `/themes/yourtheme/layouts/review/single.html` template through `.Params.affiliatelink` and `.Params.recommendedby`, respectively.
-
-Two common situations where this type of front matter field could be introduced is as a value of a certain attribute like `href=""` or by itself to be displayed as text to the website's visitors.
-
-{{< code file="/themes/yourtheme/layouts/review/single.html" >}}
-<h3><a href={{ printf "%s" $.Params.affiliatelink }}>Buy this book</a></h3>
-<p>It was recommended by {{ .Params.recommendedby }}.</p>
-{{< /code >}}
-
-This template would render as follows, assuming you've set [`uglyURLs`](/content-management/urls/) to `false` in your [site `config`](/getting-started/configuration/):
-
-{{< output file="yourbaseurl/review/book01/index.html" >}}
-<h3><a href="http://www.my-book-link.here">Buy this book</a></h3>
-<p>It was recommended by my Mother.</p>
-{{< /output >}}
-
-{{% note %}}
-See [Archetypes](/content-management/archetypes/) for consistency of `Params` across pieces of content.
-{{% /note %}}
-
-### The `.Param` Method
-
-In Hugo, you can declare params in individual pages and globally for your entire website. A common use case is to have a general value for the site param and a more specific value for some of the pages (i.e., a header image):
-
-```
-{{ $.Param "header_image" }}
-```
-
-The `.Param` method provides a way to resolve a single value according to it's definition in a page parameter (i.e. in the content's front matter) or a site parameter (i.e., in your `config`).
-
-### Access Nested Fields in Front Matter
-
-When front matter contains nested fields like the following:
-
-```
----
-author:
- given_name: John
- family_name: Feminella
- display_name: John Feminella
----
-```
-`.Param` can access these fields by concatenating the field names together with a dot:
-
-```
-{{ $.Param "author.display_name" }}
-```
-
-If your front matter contains a top-level key that is ambiguous with a nested key, as in the following case:
-
-```
----
-favorites.flavor: vanilla
-favorites:
- flavor: chocolate
----
-```
-
-The top-level key will be preferred. Therefore, the following method, when applied to the previous example, will print `vanilla` and not `chocolate`:
-
-```
-{{ $.Param "favorites.flavor" }}
-=> vanilla
-```
-
-[gitinfo]: /variables/git/
-[File Variables]: /variables/files/
diff --git a/docs/content/zh/_index.md b/docs/content/zh/_index.md
@@ -0,0 +1,49 @@
+---
+title: "世界上最快的网站构建框架 The world’s fastest framework for building websites"
+date: 2017-03-02T12:00:00-05:00
+features:
+ - heading: Blistering Speed
+ image_path: /images/icon-fast.svg
+ tagline: What's modern about waiting for your site to build?
+ copy: Hugo is the fastest tool of its kind. At <1 ms per page, the average site builds in less than a second.
+
+ - heading: Robust Content Management
+ image_path: /images/icon-content-management.svg
+ tagline: Flexibility rules. Hugo is a content strategist's dream.
+ copy: Hugo supports unlimited content types, taxonomies, menus, dynamic API-driven content, and more, all without plugins.
+
+ - heading: Shortcodes
+ image_path: /images/icon-shortcodes.svg
+ tagline: Hugo's shortcodes are Markdown's hidden superpower.
+ copy: We love the beautiful simplicity of markdown’s syntax, but there are times when we want more flexibility. Hugo shortcodes allow for both beauty and flexibility.
+
+ - heading: Built-in Templates
+ image_path: /images/icon-built-in-templates.svg
+ tagline: Hugo has common patterns to get your work done quickly.
+ copy: Hugo ships with pre-made templates to make quick work of SEO, commenting, analytics and other functions. One line of code, and you're done.
+
+ - heading: Multilingual and i18n
+ image_path: /images/icon-multilingual2.svg
+ tagline: Polyglot baked in.
+ copy: Hugo provides full i18n support for multi-language sites with the same straightforward development experience Hugo users love in single-language sites.
+
+ - heading: Custom Outputs
+ image_path: /images/icon-custom-outputs.svg
+ tagline: HTML not enough?
+ copy: Hugo allows you to output your content in multiple formats, including JSON or AMP, and makes it easy to create your own.
+sections:
+ - heading: "100s of Themes"
+ cta: Check out the Hugo's themes.
+ link: http://themes.gohugo.io/
+ color_classes: bg-accent-color white
+ image: /images/homepage-screenshot-hugo-themes.jpg
+ copy: "Hugo provides a robust theming system that is easy to implement but capable of producing even the most complicated websites."
+ - heading: "Capable Templating"
+ cta: Get Started.
+ link: templates/
+ color_classes: bg-primary-color-light black
+ image: /images/home-page-templating-example.png
+ copy: "Hugo's Go-based templating provides just the right amount of logic to build anything from the simple to complex. If you prefer Jade/Pug-like syntax, you can also use Amber, Ace, or any combination of the three."
+---
+
+Hugo is one of the most popular open-source static site generators. With its amazing speed and flexibility, Hugo makes building websites fun again.
diff --git a/docs/content/zh/about/_index.md b/docs/content/zh/about/_index.md
@@ -0,0 +1,20 @@
+---
+title: 关于 Hugo
+linktitle: 概览
+description: Hugo 的特色、规划、许可和动力。
+date: 2018-04-26
+publishdate: 2018-04-26
+lastmod: 2018-04-26
+categories: []
+keywords: []
+menu:
+ docs:
+ parent: "about"
+ weight: 1
+weight: 1
+draft: false
+aliases: [/about-hugo/,/docs/]
+toc: false
+---
+
+Hugo 不是一般的静态网站生成器。
diff --git a/docs/content/zh/content-management/_index.md b/docs/content/zh/content-management/_index.md
@@ -0,0 +1,21 @@
+---
+title: 内容管理
+linktitle: 内容管理概览
+description: Hugo 可以管理大型的静态网站，支持骨架、内容类型、菜单、引用、概要等等。
+date: 2018-04-23
+publishdate: 2018-04-23
+lastmod: 2018-04-23
+menu:
+ docs:
+ parent: "content-management"
+ weight: 1
+keywords: [source, organization]
+categories: [content management]
+weight: 01 #rem
+draft: false
+aliases: [/content/,/content/organization]
+toc: false
+isCJKLanguage: true
+---
+
+一个实用的静态网站生成器，需要超越“文件头” (front matter) 和模板的等基本功能，才能兼备可伸缩性和可管理性，满足用户所需。Hugo 不仅是给开发者设计的，也同样适用于内容管理员和写作人员。
diff --git a/docs/content/zh/documentation.md b/docs/content/zh/documentation.md
@@ -0,0 +1,21 @@
+---
+title: Hugo 说明文档
+linktitle: Hugo
+description: Hugo is the world's fastest static website engine. It's written in Go (aka Golang) and developed by bep, spf13 and friends.
+date: 2017-02-01
+publishdate: 2017-02-01
+menu:
+ main:
+ parent: "section name"
+ weight: 01
+weight: 01 #rem
+draft: false
+slug:
+aliases: []
+toc: false
+layout: documentation-home
+isCJKLanguage: true
+---
+Hugo 号称**世界上最快的静态网站引擎**。它是以 Go (即 Golang) 编程语言所写成，并由 [bep](https://github.com/bep)、[spf13](https://github.com/spf13) 和[朋友们](https://github.com/gohugoio/hugo/graphs/contributors) 共同开发。
+
+下面是我们说明文档中最常用和实用的章节：
diff --git a/docs/content/zh/news/_index.md b/docs/content/zh/news/_index.md
@@ -0,0 +1,4 @@
+---
+title: "Hugo 新闻"
+aliases: [/release-notes/]
+---
diff --git a/docs/content/zh/templates/_index.md b/docs/content/zh/templates/_index.md
@@ -0,0 +1,19 @@
+---
+title: 模板 Templates
+linktitle: 模板概览
+description: Go templating, template types and lookup order, shortcodes, and data.
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+menu:
+ docs:
+ parent: "templates"
+ weight: 01
+weight: 01 #rem
+categories: [templates]
+keywords: []
+draft: false
+aliases: [/templates/overview/,/templates/content]
+toc: false
+notesforauthors:
+---
diff --git a/docs/content/zh/templates/base.md b/docs/content/zh/templates/base.md
@@ -0,0 +1,132 @@
+---
+title: Base 模板 and Blocks
+linktitle:
+description: The base and block constructs allow you to define the outer shell of your master templates (i.e., the chrome of the page).
+godocref: https://golang.org/pkg/text/template/#example_Template_block
+date: 2017-02-01
+publishdate: 2017-02-01
+lastmod: 2017-02-01
+categories: [templates,fundamentals]
+keywords: [blocks,base]
+menu:
+ docs:
+ parent: "templates"
+ weight: 20
+weight: 20
+sections_weight: 20
+draft: false
+aliases: [/templates/blocks/,/templates/base-templates-and-blocks/]
+toc: true
+---
+
+The `block` keyword allows you to define the outer shell of your pages' one or more master template(s) and then fill in or override portions as necessary.
+
+{{< youtube QVOMCYitLEc >}}
+
+## Base Template Lookup Order
+
+The [lookup order][lookup] for base templates is as follows:
+
+1. `/layouts/section/<TYPE>-baseof.html`
+2. `/themes/<THEME>/layouts/section/<TYPE>-baseof.html`
+3. `/layouts/<TYPE>/baseof.html`
+4. `/themes/<THEME>/layouts/<TYPE>/baseof.html`
+5. `/layouts/section/baseof.html`
+6. `/themes/<THEME>/layouts/section/baseof.html`
+7. `/layouts/_default/<TYPE>-baseof.html`
+8. `/themes/<THEME>/layouts/_default/<TYPE>-baseof.html`
+9. `/layouts/_default/baseof.html`
+10. `/themes/<THEME>/layouts/_default/baseof.html`
+
+Variables are denoted by capitalized text set within `<>`. Note that Hugo's default behavior is for `type` to inherit from `section` unless otherwise specified.
+
+### Example Base Template Lookup Order
+
+As an example, let's assume your site is using a theme called "mytheme" when rendering the section list for a `post` section. Hugo picks `layout/section/post.html` as the template for [rendering the section][]. The `{{define}}` block in this template tells Hugo that the template is an extension of a base template.
+
+Here is the lookup order for the `post` base template:
+
+1. `/layouts/section/post-baseof.html`
+2. `/themes/mytheme/layouts/section/post-baseof.html`
+3. `/layouts/post/baseof.html`
+4. `/themes/mytheme/layouts/post/baseof.html`
+5. `/layouts/section/baseof.html`
+6. `/themes/mytheme/layouts/section/baseof.html`
+7. `/layouts/_default/post-baseof.html`
+8. `/themes/mytheme/layouts/_default/post-baseof.html`
+9. `/layouts/_default/baseof.html`
+10. `/themes/mytheme/layouts/_default/baseof.html`
+
+## Define the Base Template
+
+The following defines a simple base template at `_default/baseof.html`. As a default template, it is the shell from which all your pages will be rendered unless you specify another `*baseof.html` closer to the beginning of the lookup order.
+
+{{< code file="layouts/_default/baseof.html" download="baseof.html" >}}
+<!DOCTYPE html>
+<html>
+ <head>
+ <meta charset="utf-8">
+ <title>{{ block "title" . }}
+ <!-- Blocks may include default content. -->
+ {{ .Site.Title }}
+ {{ end }}</title>
+ </head>
+ <body>
+ <!-- Code that all your templates share, like a header -->
+ {{ block "main" . }}
+ <!-- The part of the page that begins to differ between templates -->
+ {{ end }}
+ {{ block "footer" . }}
+ <!-- More shared code, perhaps a footer but that can be overridden if need be in -->
+ {{ end }}
+ </body>
+</html>
+{{< /code >}}
+
+## Override the Base Template
+
+From the above base template, you can define a [default list template][hugolists]. The default list template will inherit all of the code defined above and can then implement its own `"main"` block from:
+
+{{< code file="layouts/_default/list.html" download="list.html" >}}
+{{ define "main" }}
+ <h1>Posts</h1>
+ {{ range .Data.Pages }}
+ <article>
+ <h2>{{ .Title }}</h2>
+ {{ .Content }}
+ </article>
+ {{ end }}
+{{ end }}
+{{< /code >}}
+
+This replaces the contents of our (basically empty) "main" block with something useful for the list template. In this case, we didn't define a `"title"` block, so the contents from our base template remain unchanged in lists.
+
+{{% warning %}}
+Code that you put outside the block definitions *can* break your layout. This even includes HTML comments. For example:
+
+```
+<!-- Seemingly harmless HTML comment..that will break your layout at build -->
+{{ define "main" }}
+...your code here
+{{ end }}
+```
+[See this thread from the Hugo discussion forums.](https://discourse.gohugo.io/t/baseof-html-block-templates-and-list-types-results-in-empty-pages/5612/6)
+{{% /warning %}}
+
+The following shows how you can override both the `"main"` and `"title"` block areas from the base template with code unique to your [default single page template][singletemplate]:
+
+{{< code file="layouts/_default/single.html" download="single.html" >}}
+{{ define "title" }}
+ <!-- This will override the default value set in baseof.html; i.e., "{{.Site.Title}}" in the original example-->
+ {{ .Title }} – {{ .Site.Title }}
+{{ end }}
+{{ define "main" }}
+ <h1>{{ .Title }}</h1>
+ {{ .Content }}
+{{ end }}
+{{< /code >}}
+
+[hugolists]: /templates/lists
+[lookup]: /templates/lookup-order/
+[rendering the section]: /templates/section-templates/
+[singletemplate]: /templates/single-page-templates/
diff --git a/docs/netlify.toml b/docs/netlify.toml
@@ -3,7 +3,7 @@ publish = "public"
command = "hugo"
[context.production.environment]
-HUGO_VERSION = "0.39"
+HUGO_VERSION = "0.40.2"
HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true"
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --enableGitInfo"
[context.split1.environment]
-HUGO_VERSION = "0.39"
+HUGO_VERSION = "0.40.2"
HUGO_ENV = "production"
[context.deploy-preview]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment]
-HUGO_VERSION = "0.39"
+HUGO_VERSION = "0.40.2"
[context.branch-deploy]
command = "hugo -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment]
-HUGO_VERSION = "0.39"
+HUGO_VERSION = "0.40.2"
[context.next.environment]
HUGO_ENABLEGITINFO = "true"
diff --git a/docs/resources/_gen/images/news/0.39-relnotes/featured-hugo-39-poster_hu2a1fdf8d3d53aa00bce401a32585d7ec_216872_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.39-relnotes/featured-hugo-39-poster_hu2a1fdf8d3d53aa00bce401a32585d7ec_216872_640x0_resize_catmullrom_2.png
Binary files differ.
diff --git a/docs/resources/_gen/images/news/0.40-relnotes/featured-hugo-40-poster_hu20c69e2a166f65e329d8fbabe8d2cc58_69238_480x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.40-relnotes/featured-hugo-40-poster_hu20c69e2a166f65e329d8fbabe8d2cc58_69238_480x0_resize_catmullrom_2.png
Binary files differ.
diff --git a/docs/resources/_gen/images/news/0.40-relnotes/featured-hugo-40-poster_hu20c69e2a166f65e329d8fbabe8d2cc58_69238_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/news/0.40-relnotes/featured-hugo-40-poster_hu20c69e2a166f65e329d8fbabe8d2cc58_69238_640x0_resize_catmullrom_2.png
Binary files differ.
diff --git a/docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_1024x512_fill_catmullrom_top_2.png b/docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_1024x512_fill_catmullrom_top_2.png
Binary files differ.
diff --git a/docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_640x0_resize_catmullrom_2.png b/docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_640x0_resize_catmullrom_2.png
Binary files differ.
diff --git a/docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_f66ed2dc2e475b0cb21d76296890c5a2.png b/docs/resources/_gen/images/showcase/flesland-flis/featured_hue4fd3c0e7519777bd75019750a0f5391_309284_f66ed2dc2e475b0cb21d76296890c5a2.png
Binary files differ.
diff --git a/docs/static/css/hugofont.css b/docs/static/css/hugofont.css
@@ -0,0 +1,184 @@
+@font-face {
+ font-family: 'hugo';
+ src:url('../fonts/hugo.eot');
+ src:url('../fonts/hugo.eot?#iefix') format('embedded-opentype'),
+ url('../fonts/hugo.woff') format('woff'),
+ url('../fonts/hugo.ttf') format('truetype'),
+ url('../fonts/hugo.svg#hugo') format('svg');
+ font-weight: normal;
+ font-style: normal;
+}
+
+[class^="icon-"], [class*=" icon-"] {
+ font-family: 'hugo';
+ speak: none;
+ font-style: normal;
+ font-weight: normal;
+ font-variant: normal;
+ text-transform: none;
+ line-height: 1;
+
+ /* Better Font Rendering =========== */
+ -webkit-font-smoothing: antialiased;
+ -moz-osx-font-smoothing: grayscale;
+}
+
+.icon-home:before {
+ content: "\21";
+}
+.icon-html5:before {
+ content: "\23";
+}
+.icon-css3:before {
+ content: "\24";
+}
+.icon-console:before {
+ content: "\25";
+}
+.icon-link:before {
+ content: "\26";
+}
+.icon-fire:before {
+ content: "\28";
+}
+.icon-check-alt:before {
+ content: "\29";
+}
+.icon-hugo_serif:before {
+ content: "\e600";
+}
+.icon-x-altx-alt:before {
+ content: "\2a";
+}
+.icon-circlestar:before {
+ content: "\2b";
+}
+.icon-file-css:before {
+ content: "\2c";
+}
+.icon-radio-checked:before {
+ content: "\2e";
+}
+.icon-quote:before {
+ content: "\44";
+}
+.icon-airplane2:before {
+ content: "\45";
+}
+.icon-heart:before {
+ content: "\46";
+}
+.icon-rocket:before {
+ content: "\47";
+}
+.icon-house:before {
+ content: "\48";
+}
+.icon-arrow-right:before {
+ content: "\e001";
+}
+.icon-arrow-left:before {
+ content: "\e002";
+}
+.icon-flow-branch:before {
+ content: "\e004";
+}
+.icon-pen:before {
+ content: "\e005";
+}
+.icon-idea:before {
+ content: "\3b";
+}
+.icon-gears:before {
+ content: "\3c";
+}
+.icon-talking:before {
+ content: "\3d";
+}
+.icon-tag:before {
+ content: "\3e";
+}
+.icon-rocket2:before {
+ content: "\3f";
+}
+.icon-octocat:before {
+ content: "\41";
+}
+.icon-announce:before {
+ content: "\42";
+}
+.icon-edit:before {
+ content: "\43";
+}
+.icon-power-cord:before {
+ content: "\50";
+}
+.icon-apple:before {
+ content: "\51";
+}
+.icon-windows8:before {
+ content: "\52";
+}
+.icon-tux:before {
+ content: "\53";
+}
+.icon-file-xml:before {
+ content: "\54";
+}
+.icon-fork:before {
+ content: "\55";
+}
+.icon-arrow-down:before {
+ content: "\56";
+}
+.icon-pacman:before {
+ content: "\e000";
+}
+.icon-embed:before {
+ content: "\2f";
+}
+.icon-code:before {
+ content: "\30";
+}
+.icon-cc:before {
+ content: "\31";
+}
+.icon-cc-by:before {
+ content: "\32";
+}
+.icon-cc-nc:before {
+ content: "\33";
+}
+.icon-beaker-alt:before {
+ content: "\39";
+}
+.icon-w3c:before {
+ content: "\3a";
+}
+.icon-bolt:before {
+ content: "\49";
+}
+.icon-flow-tree:before {
+ content: "\4a";
+}
+.icon-twitter:before {
+ content: "\4b";
+}
+.icon-beaker:before {
+ content: "\4c";
+}
+.icon-images:before {
+ content: "\4d";
+}
+.icon-bubbles:before {
+ content: "\4e";
+}
+.icon-meter2:before {
+ content: "\4f";
+}
+.icon-hugo_sans:before {
+ content: "\68";
+}
+.icon-spf13:before {
+ content: "\27";
+}
diff --git a/docs/static/fonts/hugo.eot b/docs/static/fonts/hugo.eot
Binary files differ.
diff --git a/docs/static/fonts/hugo.svg b/docs/static/fonts/hugo.svg
@@ -0,0 +1,63 @@
+<?xml version="1.0" standalone="no"?>
+<!DOCTYPE svg PUBLIC "-//W3C//DTD SVG 1.1//EN" "http://www.w3.org/Graphics/SVG/1.1/DTD/svg11.dtd" >
+<svg xmlns="http://www.w3.org/2000/svg">
+<metadata>Generated by IcoMoon</metadata>
+<defs>
+<font id="hugo" horiz-adv-x="1024">
+<font-face units-per-em="1024" ascent="960" descent="-64" />
+<missing-glyph horiz-adv-x="1024" />
+<glyph unicode=" " d="" horiz-adv-x="512" />
+<glyph unicode="!" d="M1024 352l-192 192v288h-128v-160l-192 192-512-512v-32h128v-320h320v192h128v-192h320v320h128z" />
+<glyph unicode="#" d="M60.538 960l82.144-921.63 368.757-102.37 369.723 102.525 82.301 921.475h-902.925zM784.63 658.573h-432.541l10.302-115.75h411.968l-31.042-347.010-231.843-64.254-231.573 64.254-15.83 177.512h113.494l8.048-90.232 125.862-33.915 0.278 0.078 125.934 33.992 13.070 146.55-391.742-0.002-30.494 341.8h566.214l-10.107-113.024z" />
+<glyph unicode="$" d="M152.389 911.478l-34.362-171.926h699.749l-21.883-111.054h-700.189l-33.891-171.898h699.683l-39.018-196.064-282.013-93.422-244.4 93.422 16.728 85.042h-171.898l-40.896-206.352 404.226-154.704 466.006 154.704 153.768 772.253z" />
+<glyph unicode="%" d="M0 896v-896h1024v896h-1024zM960 64h-896v768h896v-768zM896 768h-768v-640h768v640zM448 448h-64v-64h-64v-64h-64v64h64v64h64v64h-64v64h-64v64h64v-64h64v-64h64v-64zM704 320h-192v64h192v-64z" />
+<glyph unicode="&" d="M953.395 885.358l-4.027 4.042c-94.149 94.134-248.194 94.134-342.326 0l-218.106-218.136c-94.134-94.133-94.134-248.176 0-342.31l4.026-4.026c7.832-7.848 16.146-14.925 24.736-21.458l79.848 79.85c-9.302 5.494-18.126 12.072-26.115 20.059l-4.042 4.042c-51.114 51.098-51.114 134.272 0 185.39l218.126 218.114c51.115 51.118 134.274 51.118 185.386 0l4.042-4.024c51.101-51.115 51.101-134.293 0-185.39l-98.686-98.686c17.133-42.307 25.248-87.4 24.538-132.386l152.605 152.605c94.136 94.134 94.136 248.178-0.003 342.315zM631.042 571.066c-7.832 7.832-16.146 14.922-24.736 21.44l-79.848-79.832c9.304-5.496 18.126-12.074 26.115-20.062l4.042-4.040c51.115-51.115 51.115-134.272 0-185.389l-218.128-218.133c-51.118-51.102-134.277-51.102-185.389 0l-4.042 4.042c-51.098 51.12-51.098 134.277 0 185.389l98.688 98.686c-17.134 42.306-25.246 87.402-24.538 132.386l-152.602-152.598c-94.136-94.133-94.136-248.178 0-342.325l4.026-4.032c94.152-94.128 248.192-94.128 342.328 0l218.11 218.118c94.134 94.133 94.134 248.194 0 342.326l-4.027 4.024z" />
+<glyph unicode="'" d="M512.604-54.759c-278.645 0-504.532 225.887-504.532 504.534 0 278.645 225.887 504.532 504.532 504.532 278.647 0 504.532-225.887 504.532-504.532 0-278.647-225.886-504.534-504.532-504.534zM512.604-22.58c260.876 0 472.355 211.479 472.355 472.355 0 260.874-211.479 472.355-472.355 472.355-260.874 0-472.355-211.481-472.355-472.355 0-260.876 211.481-472.355 472.355-472.355zM512.604 11.963c-241.796 0-437.81 196.016-437.81 437.812 0 241.795 196.014 437.81 437.81 437.81 241.796 0 437.81-196.016 437.81-437.81 0-241.796-196.014-437.812-437.81-437.812zM818.725 314.428c27.149 0 49.425 8.063 66.824 24.191 17.401 16.128 26.1 37.61 26.1 64.448 0 14.281-3.023 27.884-9.070 40.811-6.047 12.927-14.994 21.976-26.84 27.146 8.885 5.91 15.549 14.159 19.991 24.745 4.442 10.588 6.664 21.668 6.664 33.24 0 23.885-7.344 42.966-22.029 57.247-14.684 14.281-34.122 21.422-58.309 21.422-24.681 0-44.489-7.263-59.42-21.79-14.933-14.528-23.632-33.979-26.1-58.356h51.831c0.494 9.357 3.393 17.544 8.701 24.561 5.306 7.017 12.526 10.526 21.658 10.526 9.872 0 17.647-3.447 23.323-10.34 5.677-6.895 8.515-15.266 8.515-25.115 0-11.82-3.084-21.176-9.254-28.070-6.171-6.894-14.933-10.342-26.286-10.342h-5.923v-38.78l9.996 0.74c11.6 0.984 21.041-3.139 28.322-12.373 7.28-9.233 10.921-19.883 10.921-31.946 0-11.82-3.331-22.222-9.996-31.209-6.664-8.988-15.797-13.481-27.397-13.481-11.6 0-21.041 3.877-28.322 11.634-7.28 7.755-11.167 17.42-11.661 28.993h-54.794c1.481-25.115 10.923-46.045 28.322-62.787 17.401-16.744 38.812-25.115 64.234-25.115zM484.272 321.814h51.832v137.761h41.464v43.582h-41.464v57.431c0 1.355 0.062 3.509 0.184 6.464 0.124 2.955 0.371 5.232 0.741 6.833 0.37 1.6 0.863 3.569 1.481 5.908 0.617 2.339 1.419 4.186 2.406 5.54 0.987 1.355 2.222 2.771 3.703 4.248 1.481 1.477 3.208 2.523 5.184 3.139 1.974 0.616 4.195 0.924 6.663 0.924 5.677 0 12.711-2.093 21.102-6.28v46.167c-7.65 3.94-15.919 5.91-24.804 5.91-23.448 0-40.726-7.755-51.832-23.268-11.107-15.512-16.66-35.457-16.66-59.832v-53.184h-17.4v-43.582h17.4zM641.293 321.814h54.423v278.478h-91.074v-47.275h36.652zM181.097 315.906c19.745 0 36.466 5.848 50.164 17.544 13.699 11.694 20.549 27.268 20.549 46.719 0 14.282-3.395 25.3-10.181 33.056-6.788 7.757-15.859 14.097-27.211 19.021-2.716 1.231-6.356 2.709-10.923 4.432-4.566 1.723-8.083 3.139-10.551 4.247-2.468 1.109-5.122 2.463-7.959 4.063-2.838 1.601-4.874 3.448-6.109 5.54-1.233 2.093-1.851 4.37-1.851 6.833 0 4.186 1.727 7.817 5.184 10.896 3.455 3.077 7.404 4.616 11.846 4.616 9.378 0 18.511-4.186 27.397-12.557l22.213 29.915c-14.316 12.557-33.814 18.837-58.495 18.837-17.032 0-30.914-5.54-41.651-16.62-10.735-11.080-16.105-25.115-16.105-42.104 0-13.049 3.209-23.022 9.626-29.915 6.417-6.895 15.303-12.805 26.656-17.729 1.974-0.738 5.43-2.093 10.367-4.063 4.936-1.969 8.453-3.447 10.551-4.432 2.098-0.984 4.628-2.461 7.59-4.431 2.962-1.971 4.998-4.124 6.109-6.464 1.109-2.339 1.665-4.986 1.665-7.941 0-5.91-1.974-10.65-5.923-14.219-3.949-3.571-8.885-5.356-14.81-5.356-13.081 0-25.915 7.017-38.502 21.052l-23.694-30.655c16.782-20.191 38.132-30.285 64.049-30.285zM273.246 225.049h51.831v113.754h0.741c4.936-7.14 11.846-12.741 20.733-16.804 8.885-4.063 18.141-6.094 27.765-6.094 25.67 0 46.093 9.664 61.273 28.992 15.179 19.329 22.769 42.166 22.769 68.513 0 25.115-7.652 47.335-22.955 66.664-15.301 19.329-35.295 28.993-59.976 28.993-20.979 0-37.763-7.509-50.35-22.53v16.62h-51.831zM362.839 361.703c-12.588 0-22.891 5.232-30.912 15.696-8.023 10.464-12.034 22.222-12.034 35.271 0 13.049 4.011 24.745 12.034 35.087 8.021 10.34 18.325 15.512 30.912 15.512 12.588 0 22.893-5.172 30.914-15.512 8.021-10.342 12.032-22.038 12.032-35.087 0-13.049-4.011-24.807-12.032-35.271-8.021-10.464-18.327-15.696-30.914-15.696z" />
+<glyph unicode="(" d="M321.008-64c-68.246 142.008-31.902 223.378 20.55 300.043 57.44 83.957 72.243 167.067 72.243 167.067 0 0 45.155-58.701 27.093-150.509 79.771 88.8 94.824 230.28 82.782 284.464 180.314-126.011 257.376-398.856 153.522-601.066 552.371 312.533 137.398 780.171 65.154 832.85 24.082-52.675 28.648-141.85-20-185.126-82.352 312.277-285.971 376.277-285.971 376.277 24.082-161.045-87.296-337.144-194.696-468.73-3.774 64.216-7.782 108.528-41.55 169.979-7.581-116.656-96.733-211.747-120.874-328.627-32.702-158.286 24.494-274.181 241.747-396.622z" />
+<glyph unicode=")" d="M512 960c-282.752 0-512-229.248-512-512s229.248-512 512-512 512 229.248 512 512-229.248 512-512 512zM432.64 211.744l-235.584 235.616 90.496 90.496 145.056-145.12 307.744 307.744 90.496-90.496-398.208-398.24z" />
+<glyph unicode="*" d="M512 960c-282.752 0-512-229.248-512-512s229.248-512 512-512 512 229.248 512 512-229.248 512-512 512zM765.248 285.248l-90.496-90.496-162.752 162.752-162.752-162.752-90.496 90.496 162.752 162.752-162.752 162.752 90.496 90.496 162.752-162.752 162.752 162.752 90.496-90.496-162.752-162.752 162.752-162.752z" />
+<glyph unicode="+" d="M512 960c-282.77 0-512-229.23-512-512s229.23-512 512-512c282.77 0 512 229.23 512 512 0 282.77-229.23 512-512 512zM515.376 780.874l80.686-251.936 264.438-5.938-214.69-154.501 76.066-253.376-213.315 156.438-217.435-150.688 82.874 251.25-210.499 160.251 264.562-1.186 87.314 249.685z" />
+<glyph unicode="," d="M384 348.554v114.226c0 15.128 6.696 29.437 18.854 40.286 12.16 10.848 28.192 16.826 45.146 16.826v57.11c-70.4 0-128-51.4-128-114.222v-85.666c0-15.771-14.328-28.558-32-28.558h-32v-57.11h32c17.674 0 32-12.79 32-28.558v-85.675c0-62.814 57.6-114.214 128-114.214v57.112c-16.954 0-32.987 5.976-45.146 16.826-12.158 10.853-18.854 25.154-18.854 40.278v114.234c0 15.77-14.328 28.554-32 28.554 17.674 0 32 12.79 32 28.554zM640 291.446v-114.234c0-15.125-6.696-29.426-18.854-40.278-12.158-10.85-28.19-16.826-45.146-16.826v-57.112c70.402 0 128 51.4 128 114.214v85.675c0 15.771 14.328 28.558 32 28.558h32v57.11h-32c-17.672 0-32 12.79-32 28.558v85.666c0 62.824-57.598 114.222-128 114.222v-57.11c16.958 0 32.987-5.978 45.146-16.83 12.16-10.848 18.854-25.157 18.854-40.283v-114.227c0-15.766 14.328-28.552 32-28.552-17.672 0.002-32-12.789-32-28.552zM903.432 760.57l-142.864 142.862c-31.112 31.112-92.568 56.568-136.568 56.568h-480c-44 0-80-36-80-80v-864c0-44 36-80 80-80h736c44 0 80 36 80 80v608c0 44-25.456 105.458-56.568 136.57zM858.178 715.314c3.13-3.13 6.25-6.974 9.28-11.314h-163.458v163.456c4.339-3.030 8.184-6.15 11.314-9.28l142.864-142.862zM896 16c0-8.672-7.328-16-16-16h-736c-8.672 0-16 7.328-16 16v864c0 8.672 7.328 16 16 16h480c4.832 0 10.254-0.61 16-1.704v-254.296h254.296c1.094-5.746 1.704-11.166 1.704-16v-608z" />
+<glyph unicode="." d="M512 960c-282.77 0-512-229.23-512-512s229.23-512 512-512 512 229.23 512 512-229.23 512-512 512zM512 64c-212.078 0-384 171.922-384 384s171.922 384 384 384c212.078 0 384-171.922 384-384 0-212.078-171.922-384-384-384zM320 448c0-106.039 85.961-192 192-192s192 85.961 192 192c0 106.039-85.961 192-192 192-106.039 0-192-85.961-192-192z" />
+<glyph unicode="/" d="M288 704l-256-256 256-256h128l-256 256 256 256h-128zM736 704h-128l256-256-256-256h128l256 256-256 256z" />
+<glyph unicode="0" d="M128 448l256 256h-128l-256-256 256-256h128zM768 704h-128l256-256-256-256h128l256 256zM544 832l-160-768h96l160 768z" />
+<glyph unicode="1" d="M505.446 939.469c-271.462-3.635-488.55-226.611-484.915-498.022 3.635-271.411 226.611-488.55 498.074-484.915 271.411 3.584 488.55 226.611 484.915 498.074-3.635 271.411-226.714 488.499-498.074 484.864zM517.171 60.006c-214.323-2.918-390.349 168.499-393.216 382.822-2.867 214.323 168.55 390.349 382.874 393.216 214.272 2.867 390.298-168.55 393.165-382.822s-168.499-390.298-382.822-393.216zM391.731 364.698c-20.736 0-36.454 7.578-47.104 22.733-10.701 15.155-15.974 35.328-15.974 60.57 0 55.501 21.043 83.251 63.078 83.251 8.397 0 17.51-2.816 27.341-8.397 9.779-5.632 18.074-15.462 24.832-29.44l63.027 32.819c-25.19 45.414-67.021 68.147-125.338 68.147-39.834 0-72.704-13.158-98.816-39.526-26.061-26.368-39.117-62.003-39.117-106.854 0-45.978 12.902-81.92 38.707-107.725 25.754-25.805 59.75-38.707 101.786-38.707 26.317 0 50.432 6.605 72.294 19.814s39.014 31.283 51.354 54.323l-58.061 29.44c-11.213-26.931-30.566-40.448-58.010-40.448zM663.398 364.698c-20.787 0-36.506 7.578-47.104 22.733-10.701 15.104-15.974 35.328-15.974 60.57 0 55.501 20.992 83.251 63.078 83.251 9.011 0 18.381-2.816 28.211-8.397 9.779-5.632 18.125-15.462 24.781-29.44l62.208 32.819c-24.678 45.414-66.099 68.147-124.518 68.147-39.782 0-72.704-13.158-98.765-39.526-26.112-26.368-39.117-61.952-39.117-106.803 0-45.978 12.749-81.92 38.246-107.725 25.549-25.805 59.648-38.707 102.246-38.707 25.805 0 49.613 6.605 71.475 19.814 21.811 13.21 39.219 31.283 52.122 54.323l-58.88 29.44c-11.213-26.982-30.515-40.499-58.010-40.499z" />
+<glyph unicode="2" d="M512 627.968c45.67 0 68.506 22.784 68.506 68.403 0 46.234-22.835 69.325-68.506 69.325s-68.454-23.091-68.454-69.325c0-45.619 22.784-68.403 68.454-68.403zM612.966 601.549h-201.882c-8.806 0-16.23-3.072-22.426-9.216s-9.216-13.619-9.216-22.374v-201.011h56.166v-238.746h152.678v238.746h56.218v201.062c0 8.755-3.226 16.179-9.626 22.374-6.451 6.093-13.722 9.165-21.914 9.165zM512 939.52c-271.462 0-491.52-220.058-491.52-491.52s220.058-491.52 491.52-491.52 491.52 220.058 491.52 491.52-220.058 491.52-491.52 491.52zM512 46.592c-221.696 0-401.408 179.712-401.408 401.408s179.712 401.408 401.408 401.408 401.408-179.712 401.408-401.408-179.712-401.408-401.408-401.408z" />
+<glyph unicode="3" d="M512 939.52c-271.462 0-491.52-220.058-491.52-491.52s220.058-491.52 491.52-491.52 491.52 220.058 491.52 491.52-220.058 491.52-491.52 491.52zM132.864 579.789l249.344-111.667 78.080-34.202 57.958-26.368 47.411-20.224c8.806-7.578 13.21-17.51 13.21-29.798 0-17.613-6.042-30.157-18.022-37.734-11.981-7.578-26.522-11.418-43.469-11.418-41.011 0-77.568 14.899-109.773 44.749l-67.533-68.454c45.056-38.605 94.822-58.266 149.197-58.778v-75.52h57.037v75.52c33.894 2.918 63.334 14.131 88.218 33.792 24.832 19.61 40.55 44.851 46.95 75.878l182.221-81.152c-68.301-123.853-200.192-207.821-351.693-207.821-221.696 0-401.408 179.712-401.408 401.408 0 46.182 7.885 90.522 22.272 131.789zM650.803 455.014l-79.002 35.123-105.37 47.36c-2.918 4.096-4.352 8.192-4.352 12.288 0 14.029 5.99 24.013 18.022 29.85 11.93 5.837 25.549 8.806 40.806 8.806 28.672 0 56.73-9.677 84.275-28.979l64.102 65.843c-36.915 28.109-77.875 43.315-122.88 45.67v75.418h-57.088v-75.469c-30.464-1.741-57.088-10.445-79.923-25.856-22.784-15.565-38.298-36.147-46.49-61.901l-187.136 83.968c71.629 109.67 195.43 182.272 336.23 182.272 221.696 0 401.408-179.712 401.408-401.408 0-35.994-4.813-70.861-13.722-103.987l-248.883 111.002z" />
+<glyph unicode="9" d="M256 672c0-17.673 14.327-32 32-32s32 14.327 32 32c0 17.673-14.327 32-32 32-17.673 0-32-14.327-32-32zM448 960h-384c-35.36 0-64-28.64-64-64v-704c0-141.376 114.624-256 256-256s256 114.624 256 256v704c0 35.36-28.64 64-64 64zM160 320c-17.664 0-32 14.304-32 32s14.336 32 32 32c17.696 0 32-14.304 32-32s-14.304-32-32-32zM320 192c-35.36 0-64 28.64-64 64s28.64 64 64 64 64-28.64 64-64-28.64-64-64-64zM384 448h-64c0 35.328-28.672 64-64 64s-64-28.672-64-64h-64v384h256v-384z" horiz-adv-x="512" />
+<glyph unicode=":" d="M916.334 422.837c2.474 9.934-0.074 20.15-9.362 23.406l-38.619 17.554c-9.544 3.984-21.693-1.398-23.406-10.531-7.454-15.958-18.022-29.022-35.107-29.258-14.824 0-26.917 7.997-36.278 23.99-9.362 15.994-14.043 36.864-14.043 62.61 0 25.746 4.682 46.813 14.043 63.197 9.362 16.384 21.454 24.576 36.278 24.576 18.701-1.358 27.574-13.168 35.107-28.086 3.994-9.8 14.859-12.102 23.406-9.362l38.619 17.554c8.944 4.707 12.928 16.362 8.192 24.576-22.626 48.373-57.734 72.558-105.326 72.558-39.79 0-71.971-15.214-96.549-45.642-24.576-30.429-36.864-70.218-36.864-119.37 0-49.152 12.288-88.746 36.864-118.784 24.576-30.038 56.758-45.056 96.549-45.056 47.592 0 83.090 25.357 106.496 76.067zM544.182 346.77c62.034 0.96 109.272 43.584 110.006 99.474-1.096 29.514-12.965 52.472-33.938 70.218 18.47 17.44 29.074 41.194 29.258 64.366-1.536 63.242-54.136 93.118-105.326 93.622-44.47 0-78.798-17.554-102.986-52.662-5.462-7.805-4.682-15.606 2.339-23.406l28.086-25.746c9.003-8.026 19.018-6.542 26.917 1.17 11.702 16.384 25.746 24.576 42.13 24.576 13.262 0 21.066-3.315 23.406-9.949 4.512-9.84 3.216-18.816 0-26.917-12.070-12.498-29.712-8.778-46.813-8.778-11.122-0.374-19.725-6.896-19.894-17.554v-42.13c0.97-12.086 9.208-20.070 19.894-17.554 12.901 0.011 45.614 1.472 50.909-9.362 2.73-6.242 4.096-11.314 4.096-15.214 0-17.944-9.752-26.917-29.258-26.917-18.725 0-34.328 8.582-46.813 25.746-7.635 9.24-19.701 9.374-26.917 2.339l-29.258-29.258c-7.022-7.022-7.802-14.434-2.339-22.237 26.522-37.31 65.134-53.506 106.496-53.834zM428.325 648.704c2.138 11.218-6.122 22.038-16.384 22.237h-51.491c-9.362 0-14.824-4.682-16.384-14.043l-24.578-125.221-25.746 125.219c-2.339 9.362-8.192 14.043-17.554 14.043h-37.45c-10.144 0-15.997-4.682-17.554-14.043l-25.747-125.219-24.576 125.219c-1.56 9.362-7.413 14.043-17.554 14.043h-50.322c-12.826-1.010-18.992-11.152-17.554-22.237l64.366-283.21c2.339-9.362 8.192-14.043 17.554-14.043h49.152c9.362 0 15.214 4.682 17.554 14.043l23.406 117.027 23.406-117.027c1.56-9.362 7.413-14.043 17.554-14.043h49.152c9.362 0 15.214 4.682 17.554 14.043zM1024 960v-784l-512-240-512 240v784z" />
+<glyph unicode=";" d="M619.733 7.493c4.4 0 8.25-1.65 11.549-4.95 3.301-3.301 4.95-7.15 4.95-11.549v-37.397c0-5.134-1.65-9.35-4.95-12.648-3.301-3.301-7.15-4.95-11.549-4.95h-214.48c-11.731 0-17.598 5.866-17.598 17.598v37.397c0 4.4 1.65 8.25 4.95 11.549 3.301 3.301 7.515 4.95 12.648 4.95zM619.733 114.182c4.4 0 8.25-1.65 11.549-4.95 3.301-3.301 4.95-7.515 4.95-12.648v-37.397c0-4.4-1.65-8.25-4.95-11.549-3.301-3.301-7.15-4.95-11.549-4.95h-214.48c-5.134 0-9.35 1.65-12.648 4.95-3.301 3.301-4.95 7.15-4.95 11.549v37.397c0 11.731 5.866 17.598 17.598 17.598zM840.811 455.149v0l91.293-14.298c9.531-1.466 17.232-5.685 23.098-12.648 5.866-6.966 8.066-14.482 6.6-22.547-1.466-8.8-5.866-15.582-13.198-20.347-7.331-4.766-16.133-6.416-26.398-4.95l-91.293 14.298c-10.266 1.466-18.147 5.866-23.648 13.198-5.501 7.331-7.515 15.032-6.050 23.098 1.466 8.066 5.866 14.482 13.198 19.248 7.331 4.766 16.133 6.416 26.398 4.95zM830.91 663.029v0l84.691 37.397c8.8 4.4 17.414 5.315 25.848 2.75 8.432-2.576 14.482-7.893 18.147-15.949 3.666-8.070 3.666-16.136 0-24.198-3.666-8.066-10.266-13.931-19.798-17.598l-84.691-38.496c-8.8-3.666-17.414-4.216-25.848-1.65-8.432 2.57-14.482 7.886-18.147 15.949-3.666 8.070-3.485 16.136 0.55 24.198 4.034 8.070 10.448 13.936 19.248 17.598zM687.925 803.814v0l50.595 78.091c5.866 8.066 13.016 13.382 21.448 15.949 8.445 2.566 16.328 1.65 23.648-2.75 7.331-5.134 11.549-12.098 12.648-20.898 1.101-8.8-0.917-17.232-6.050-25.298l-50.595-78.091c-5.866-8.077-13.016-13.392-21.448-15.949-8.432-2.566-16.314-1.65-23.648 2.75-7.334 4.4-11.731 11.182-13.198 20.347-1.466 9.166 0.734 17.782 6.6 25.848zM184.174 455.149c9.531 1.466 18.147-0.184 25.848-4.95s12.282-11.182 13.747-19.248c1.466-8.066-0.734-15.763-6.6-23.098-5.866-7.331-13.931-11.731-24.198-13.198l-91.293-14.298c-9.531-1.466-18.147 0.184-25.848 4.95-7.701 4.766-12.282 11.549-13.747 20.347-1.466 8.067 0.734 15.584 6.6 22.547 5.866 6.968 13.931 11.184 24.198 12.648zM194.075 663.029c8.8-3.666 15.214-9.531 19.248-17.598 4.040-8.066 4.224-16.133 0.55-24.198-3.666-8.066-9.901-13.382-18.698-15.949-8.8-2.566-17.598-2.016-26.398 1.65l-84.691 38.496c-8.8 3.67-15.214 9.536-19.248 17.598-4.034 8.066-4.218 16.133-0.55 24.198 3.666 8.066 9.715 13.382 18.147 15.949 8.432 2.566 17.414 1.65 26.949-2.75zM335.962 803.814c5.866-8.072 8.066-16.686 6.6-25.848-1.466-9.166-5.866-15.949-13.198-20.347-6.6-4.4-14.298-5.315-23.098-2.75-8.8 2.566-15.763 7.882-20.898 15.949l-50.595 78.091c-5.866 8.066-8.066 16.498-6.6 25.298 1.466 8.8 5.866 15.763 13.198 20.898 6.6 4.4 14.298 5.315 23.098 2.75 8.8-2.578 15.763-7.896 20.898-15.949zM543.842 832.413c0-10.266-2.934-18.698-8.8-25.298s-13.198-9.901-21.998-9.901c-8.066 0-15.032 3.301-20.898 9.901-5.866 6.6-8.8 15.032-8.8 25.298v92.39c0 10.266 2.934 18.698 8.8 25.298s12.832 9.901 20.898 9.901c8.8 0 16.133-3.301 21.998-9.901 5.866-6.6 8.8-15.032 8.8-25.298zM721.474 396.306c-14.298-29.698-29.88-61.41-46.746-95.139-26.606-43.034-25.262-93.942-41.795-138.037-2.934-7.701-8.432-12.282-16.498-13.747h-208.979c-8.066 1.466-13.563 6.050-16.498 13.747-12.744 48.162-20.482 95.064-41.795 138.037-16.864 33.73-32.446 65.445-46.746 95.139-32.968 72.878-50.19 157.211-16.498 232.627 12.098 26.398 28.963 48.762 50.595 67.094 21.632 18.331 47.296 32.080 76.992 41.246 29.698 9.166 62.144 13.747 97.341 13.747h2.202c35.195 0 67.645-4.584 97.341-13.747 29.698-9.166 55.36-22.914 76.992-41.246 21.632-18.331 38.68-40.696 51.146-67.094 31.584-79.118 18.672-157.61-17.048-232.627z" />
+<glyph unicode="<" d="M776.653 882.243l-14.434-69.166c-14.795-2.323-29.048-6.606-42.406-12.582l-49.686 50.198-56.584-45.79 38.702-59.138c-8.622-11.83-15.664-24.834-21.013-38.83l-70.698 0.32-7.6-72.422 69.166-14.434c2.323-14.787 6.61-28.926 12.582-42.278l-50.198-49.814 45.79-56.584 59.138 38.766c11.821-8.616 24.848-15.73 38.83-21.075l-0.32-70.634 72.422-7.6 14.37 69.166c14.8 2.322 29.043 6.542 42.406 12.518l49.75-50.198 56.584 45.854-38.766 59.074c8.622 11.826 15.726 24.84 21.075 38.83l70.634-0.256 7.6 72.422-69.166 14.306c-2.323 14.808-6.536 29.101-12.518 42.47l50.198 49.686-45.854 56.584-59.074-38.702c-11.834 8.629-24.89 15.726-38.894 21.075l0.32 70.634-72.358 7.6zM788.659 714.026c2.275-0.008 4.584-0.077 6.898-0.32 36.998-3.886 63.792-37.022 59.904-74.018-3.886-36.998-37.022-63.856-74.018-59.968-36.998 3.886-63.856 37.022-59.968 74.018 3.643 34.686 33.046 60.406 67.186 60.288zM268.995 708.085l-9.707-96.181c-19.802-5.278-38.558-13.078-55.882-23.118l-74.848 61.182-70.442-70.442 61.182-74.912c-10.042-17.33-17.843-36.074-23.118-55.882l-96.181-9.643v-99.627l96.181-9.707c5.275-19.79 13.086-38.502 23.118-55.818l-61.182-74.912 70.442-70.442 74.912 61.182c17.315-10.034 36.026-17.843 55.818-23.118l9.707-96.181h99.627l9.643 96.181c19.808 5.275 38.552 13.078 55.882 23.118l74.912-61.182 70.442 70.442-61.182 74.848c10.042 17.325 17.84 36.080 23.118 55.882l96.181 9.707v99.627l-96.181 9.643c-5.278 19.818-13.070 38.608-23.118 55.946l61.182 74.848-70.442 70.442-74.848-61.182c-17.338 10.050-36.126 17.84-55.946 23.118l-9.643 96.181h-99.627zM318.81 481.43c50.901 0 92.157-41.256 92.157-92.157s-41.256-92.157-92.157-92.157c-50.901 0-92.157 41.256-92.157 92.157 0 50.901 41.256 92.157 92.157 92.157zM741.784 358.365l-10.154-50.579c-10.4-1.701-20.371-4.824-29.76-9.195l-34.998 36.722-39.723-33.528 27.206-43.235c-6.059-8.654-11.058-18.182-14.816-28.421l-49.622 0.256-5.365-53.008 48.6-10.538c1.632-10.818 4.616-21.206 8.814-30.974l-35.254-36.402 32.187-41.384 41.576 28.357c8.307-6.302 17.442-11.48 27.27-15.392l-0.192-51.73 50.901-5.557 10.090 50.643c10.402 1.698 20.37 4.76 29.76 9.131l34.998-36.722 39.787 33.528-27.27 43.235c6.059 8.651 11.058 18.184 14.816 28.421l49.686-0.192 5.301 52.944-48.6 10.538c-1.634 10.834-4.61 21.258-8.814 31.038l35.254 36.338-32.187 41.448-41.512-28.357c-8.318 6.312-17.493 11.478-27.334 15.392l0.256 51.666-50.901 5.557zM750.214 235.363c1.6-0.006 3.229-0.078 4.854-0.256 26.002-2.843 44.818-27.090 42.086-54.155-2.733-27.066-25.982-46.718-51.986-43.874-26.002 2.843-44.882 27.090-42.15 54.155 2.56 25.376 23.202 44.216 47.195 44.13z" />
+<glyph unicode="=" d="M0 908.365v-622.304h180.107v-180.048l280.686 180.048h413.074v622.304h-873.869zM914.979 771.571v-78.309h30.712v-443.786h-151.048v-118.624l-184.88 118.624h-132.085l-122.050-78.309h231.070l286.251-183.534v183.533h151.048v600.402h-109.019z" />
+<glyph unicode=">" d="M927.813 960h-288.563c-52.906 0-126.797-30.606-164.203-68.014l-446.99-446.989c-37.408-37.408-37.408-98.624 0-136.032l344.91-344.906c37.408-37.41 98.622-37.41 136.030 0l446.99 446.989c37.406 37.408 68.013 111.301 68.013 164.202v288.563c0 52.904-43.286 96.187-96.187 96.187zM800 640c-53.021 0-96 42.979-96 96s42.979 96 96 96 96-42.979 96-96-42.979-96-96-96z" />
+<glyph unicode="?" d="M704 896l-320-320h-192l-192-256c0 0 203.416 56.651 322.066 30.083l-322.066-414.083 421.902 328.144c58.837-134.654-37.902-328.144-37.902-328.144l256 192v192l320 320 64 320-320-64z" />
+<glyph unicode="A" d="M512 960c-282.77 0-512-229.23-512-512s229.23-512 512-512c282.77 0 512 229.23 512 512 0 282.77-229.23 512-512 512zM512 904.25c251.981 0 456.25-204.269 456.25-456.25s-204.269-456.25-456.25-456.25c-251.981 0-456.25 204.269-456.25 456.25 0 251.981 204.269 456.25 456.25 456.25zM285.562 770.624c-12.994-37.768-17.498-78.76-5.874-114.562-14.043-15.584-24.947-33.486-32.75-53.75-20.798-65.73-15.718-149.696 29.813-200.501 15.994-17.533 37.694-31.949 65-43.25 27.306-11.298 62.402-18.506 105.312-21.624-28.8-13.458-49.102-21.682-56.187-51.438-32.125-21.466-71.19-16.344-99.499 7-22.374 16.334-32.509 45.366-57.314 56.125-1.56 1.56-6.432 2.722-14.624 3.499-8.192 0.781-14.632-1.542-19.312-7-2.342-2.334-2.168-4.834 0.562-7.562 18.778-15.272 36.853-31.459 47.438-50.874 10.141-21.042 20.64-36.448 31.562-46.189 30.298-20.474 70.934-31.125 106.501-18.125-4.149-25.027 7.042-64.11-1.189-86.501-3.122-6.234-7.586-11.698-13.438-16.374-5.213-5.086-21.384-11.451-18.123-19.25 1.56-3.506 7.011-5.658 16.373-6.437 20.611 0.525 41.126 8.858 53.251 25.125 4.291 5.845 6.438 13.461 6.438 22.813v95.811c0 10.91 2.317 18.701 7 23.376 4.682 4.677 9.787 7.816 15.25 9.374v-126.25c0-10.91-0.986-20.269-2.939-28.062-1.949-7.792-3.69-13.258-5.25-16.376-3.581-6.006-10.427-11.547-10.562-18.686 0-2.338 1.394-3.674 4.126-4.064 20.496 0.89 44.275 12.915 52.624 29.814 6.632 14.026 9.938 28.789 9.938 44.374v123.938h25.75v-123.938c0-15.586 3.539-30.349 10.562-44.374 7.022-14.027 18.742-23.042 35.126-26.938 8.579-2.338 14.378-3.264 17.499-2.877 3.12 0.39 4.514 1.726 4.125 4.064-1.88 7.080-5.794 13.141-9.939 18.686-5.461 7.014-8.186 21.838-8.186 44.438v126.25c5.461-1.558 10.741-4.698 15.813-9.374 5.069-4.675 7.562-12.466 7.562-23.376v-95.811c0-9.352 2.146-16.968 6.438-22.813 13.042-16.586 32.696-25 53.25-25.125 9.362 0.779 14.814 2.931 16.374 6.437 1.56 3.506 0.402 6.413-3.501 8.75-3.899 2.338-8.773 5.824-14.624 10.499-5.851 4.677-10.315 10.141-13.437 16.374-3.502 40.2-0.091 83.294-2.939 123.938-5.621 44.357-22.693 58.949-56.75 75.939 40.571 3.118 73.928 10.56 100.066 22.25 78.126 37.962 99.731 96.646 100.061 175.312-1.232 50.629-15.848 94.794-49.187 128.626 4.682 17.925 6.075 36.581 4.126 56.062-1.954 19.482-6.074 37.040-12.315 52.624-28.864-1.558-53.054-7.368-72.562-17.501-19.506-10.13-33.544-18.734-42.123-25.749-69.134 15.696-143.142 15.789-209.438-2.312-33.925 27.746-75.968 43.203-115.877 45.562z" />
+<glyph unicode="B" d="M875.126 875.438c-131.84-130.56-325.63-210.44-512.315-221.688h-277.25c-43.643-0.597-83.099-37.725-85.562-86.688v-125c0.595-43.643 36.598-84.224 85.562-86.688h111.126c-29.704-100.736 2.23-202.723 36.688-302.811 51.118-48.266 168.011-42.256 206.126 20.562-81.158 63.798-120.654 235.477-22.813 277.811 166.766-18.922 331.976-103.642 458.438-217.25 43.474 0.595 83.018 36.302 85.562 85v205c34.824 8.968 61.678 40.907 63.31 80.563-0.419 35.798-25.118 69.982-63.312 81.125v204.501c-0.595 43.645-36.598 83.099-85.562 85.563zM877.315 764.877v-521.189c-122.211 95.242-273.17 159.133-428.939 187.811v145.562c152.851 22.998 302.33 93.491 428.936 187.813z" />
+<glyph unicode="C" d="M997.688 797.224l-134.418 134.418c-37.064 37.064-99.781 34.64-139.974-5.654-40.194-40.195-42.819-103.011-5.656-140.075l134.418-134.418c37.064-37.064 99.778-34.64 140.074 5.656 40.194 40.296 42.72 102.91 5.554 140.074zM140.779 343.574l268.838-268.838 436.886 436.784-268.835 268.838-436.89-436.784zM0-61.906l354.578 70.998-283.582 283.581-70.995-354.579z" />
+<glyph unicode="D" d="M445.312 870.374c-181.354-12.744-442.045-41.699-442.186-396.875v-446.875h404.685v478.126h-134.373c-8.515 127.667 96.616 160.632 210.938 185.938l-39.064 179.686zM987.501 870.374c-181.357-12.744-442.045-41.699-442.189-396.875v-446.875h404.688v478.126h-134.374c-8.514 127.667 96.614 160.632 210.936 185.938l-39.061 179.686z" />
+<glyph unicode="E" d="M273.92-57.856h102.4l229.786 409.651h264.294c0 0 153.6 0 153.6 71.629 0 71.68-153.6 71.68-153.6 71.68h-264.294l-229.786 409.6h-102.4l127.386-409.6h-183.654l-115.251 102.451h-102.4l81.971-174.080-81.971-174.131h102.4l115.251 102.451h183.654l-127.386-409.651z" />
+<glyph unicode="F" d="M880.077 747.469c-85.606 78.592-224.41 78.592-310.016 0l-58.061-53.35-58.112 53.35c-85.606 78.592-224.358 78.592-309.965 0-96.307-88.371-96.307-231.629 0-320.051l368.077-337.818 368.077 337.818c96.307 88.422 96.307 231.68 0 320.051z" />
+<glyph unicode="G" d="M627.866 316.518c0 0 361.421 260.762 321.331 559.258-0.922 6.554-3.072 10.854-5.734 13.773-2.816 2.714-7.014 4.966-13.466 5.888-291.686 40.909-546.509-328.909-546.509-328.909-221.082 26.522-205.005-17.613-305.869-259.84-19.302-46.182 11.981-62.106 46.285-49.101 34.304 12.902 110.029 41.523 110.029 41.523l132.557-135.629c0 0-27.955-77.466-40.602-112.538-12.646-35.174 2.867-67.174 48.026-47.462 236.749 103.27 279.859 86.835 253.952 313.037zM679.475 619.418c-30.618 31.334-30.618 82.125 0 113.459 30.618 31.283 80.23 31.283 110.848 0 30.669-31.283 30.669-82.125 0-113.459-30.566-31.386-80.23-31.386-110.848 0z" />
+<glyph unicode="H" d="M961.024 432.64l-410.829 411.187c-20.992 21.811-55.347 21.811-76.339 0l-410.88-411.187c-21.043-21.76-13.21-39.629 17.408-39.629h85.658v-315.802c0-22.784 0.973-41.421 42.189-41.421h199.424v316.826h208.64v-316.826h209.357c31.437 0 32.307 18.586 32.307 41.421v315.802h85.606c30.566 0 38.451 17.818 17.459 39.629z" />
+<glyph unicode="I" d="M348.314-12.749c-9.882 6.502 161.485 366.592 155.546 382.413-5.888 15.821-187.597 73.574-196.506 101.376-8.858 27.802 358.81 445.747 368.435 437.658 9.626-8.038-160.205-370.586-155.546-382.362s190.925-71.987 196.506-101.325c5.581-29.44-358.554-444.211-368.435-437.76z" />
+<glyph unicode="J" d="M918.989 202.445v117.555c0 71.014-47.002 176.64-176.589 176.64h-102.4c-72.294 0-79.002 35.43-79.36 53.76v143.155c43.674 18.893 74.24 62.31 74.24 112.845 0 67.84-54.989 122.88-122.88 122.88-67.891 0-122.88-55.040-122.88-122.88 0-50.534 30.566-93.952 74.24-112.845v-143.155c0-13.261-3.84-53.76-79.36-53.76h-102.4c-129.587 0-176.64-105.626-176.64-176.64v-117.555c-43.674-18.842-74.24-62.31-74.24-112.845 0-67.84 54.989-122.88 122.88-122.88 67.84 0 122.88 55.040 122.88 122.88 0 50.534-30.566 94.003-74.24 112.845v117.555c0 13.261 3.84 79.36 79.36 79.36h102.4c31.078 0 57.293 4.71 79.36 12.698v-209.613c-43.674-18.842-74.24-62.31-74.24-112.845 0-67.84 54.989-122.88 122.88-122.88 67.891 0 122.88 55.040 122.88 122.88 0 50.534-30.618 94.003-74.291 112.845v209.613c22.067-7.987 48.282-12.698 79.36-12.698h102.4c72.294 0 79.002-61.030 79.411-79.36v-117.555c-43.674-18.842-74.24-62.31-74.24-112.845 0-67.84 54.989-122.88 122.88-122.88s122.88 55.040 122.88 122.88c0 50.534-30.566 94.003-74.291 112.845zM224.512 89.6c0-39.168-31.744-70.912-70.912-70.912s-70.912 31.744-70.912 70.912 31.744 70.912 70.912 70.912 70.912-31.744 70.912-70.912zM441.088 806.4c0 39.168 31.795 70.912 70.912 70.912s70.861-31.744 70.861-70.912-31.744-70.912-70.861-70.912c-39.117 0-70.912 31.744-70.912 70.912zM582.912 89.6c0-39.168-31.795-70.912-70.861-70.912-39.168 0-70.912 31.744-70.912 70.912s31.744 70.912 70.861 70.912c39.117 0 70.912-31.744 70.912-70.912zM870.4 18.688c-39.117 0-70.912 31.744-70.912 70.912s31.795 70.912 70.912 70.912 70.912-31.744 70.912-70.912-31.795-70.912-70.912-70.912z" />
+<glyph unicode="K" d="M983.040 740.198c-34.714-15.411-71.936-25.754-111.053-30.464 39.936 23.91 70.605 61.798 84.992 106.906-37.325-22.118-78.694-38.246-122.675-46.899-35.277 37.581-85.504 61.030-141.107 61.030-106.752 0-193.28-86.528-193.28-193.229 0-15.155 1.69-29.901 5.018-44.032-160.614 8.038-303.053 84.992-398.336 201.933-16.691-28.518-26.266-61.747-26.266-97.178 0-67.072 34.15-126.208 86.016-160.87-31.693 1.024-61.491 9.677-87.552 24.166 0-0.819 0-1.587 0-2.406 0-93.645 66.662-171.725 155.034-189.542-16.179-4.403-33.28-6.758-50.944-6.758-12.442 0-24.525 1.178-36.352 3.43 24.576-76.8 96-132.659 180.531-134.195-66.15-51.866-149.453-82.739-240.026-82.739-15.616 0-30.976 0.922-46.080 2.714 85.504-54.835 187.085-86.835 296.294-86.835 355.482 0 549.888 294.502 549.888 549.939 0 8.346-0.154 16.691-0.563 24.986 37.786 27.238 70.502 61.286 96.461 100.045z" />
+<glyph unicode="L" d="M872.571 132.571q32-50.858 12.286-87.142t-80.286-36.286h-658.286q-60.571 0-80.286 36.286t12.286 87.142l287.429 453.142v228h-36.571q-14.858 0-25.714 10.858t-10.858 25.714 10.858 25.714 25.714 10.858h292.571q14.858 0 25.714-10.858t10.858-25.714-10.858-25.714-25.714-10.858h-36.571v-228zM427.429 546.858l-155.429-245.142h406.858l-155.429 245.142-11.429 17.714v249.142h-73.142v-249.142z" horiz-adv-x="950" />
+<glyph unicode="M" d="M128 704v-640h896v640h-896zM960 170.666l-128 213.334-145.066-120.888-110.934 184.888-384-320v512h768v-469.334zM256 480c0-53.019 42.981-96 96-96s96 42.981 96 96c0 53.019-42.981 96-96 96-53.019 0-96-42.981-96-96zM896 832h-896v-640h64v576h832z" />
+<glyph unicode="N" d="M480 960v0c265.096 0 480-173.914 480-388.448s-214.904-388.448-480-388.448c-25.458 0-50.446 1.621-74.834 4.71-103.107-102.694-222.173-121.109-341.166-123.814v25.134c64.251 31.354 116 88.466 116 153.734 0 9.106-0.712 18.048-2.030 26.794-108.557 71.214-177.97 179.987-177.97 301.89 0 214.534 214.904 388.448 480 388.448zM996 89.314c0-55.942 36.314-104.898 92-131.771v-21.542c-103.126 2.318-197.786 18.102-287.142 106.126-21.139-2.65-42.794-4.040-64.858-4.040-95.47 0-183.408 25.758-253.614 69.040 144.674 0.506 281.261 46.854 384.835 130.672 52.208 42.251 93.394 91.826 122.413 147.347 30.766 58.866 46.366 121.582 46.366 186.406 0 10.448-0.45 20.835-1.258 31.168 72.57-59.934 117.258-141.622 117.258-231.677 0-104.486-60.158-197.722-154.24-258.763-1.142-7.496-1.76-15.16-1.76-22.966z" horiz-adv-x="1152" />
+<glyph unicode="O" d="M512 960c-282.77 0-512-229.23-512-512s229.23-512 512-512 512 229.23 512 512-229.23 512-512 512zM302.837 125.848c11.106 30.632 17.163 63.688 17.163 98.152 0 124.35-78.81 230.293-189.208 270.606 10.21 84.925 48.254 163.498 109.678 224.925 72.53 72.525 168.96 112.469 271.53 112.469s199-39.944 271.53-112.47c61.427-61.426 99.469-140 109.682-224.925-110.402-40.312-189.211-146.254-189.211-270.605 0-34.469 6.059-67.52 17.166-98.15-61.706-40.242-133.771-61.85-209.166-61.85-75.394 0-147.458 21.608-209.163 61.848zM551.754 319.003c13.878-3.493 24.246-16.080 24.246-31.003v-64c0-17.6-14.4-32-32-32h-64c-17.6 0-32 14.4-32 32v64c0 14.923 10.368 27.51 24.246 31.003l23.754 448.997h32l23.754-448.997z" />
+<glyph unicode="P" d="M1024 677.499l-90.506 90.501-178.746-178.752-101.501 101.502 178.75 178.749-90.501 90.501-178.749-178.75-114.749 114.75-86.626-86.624 512.002-512.002 86.624 86.624-114.752 114.752zM274.749 210.746c165.768-165.762 385.194-36.362 519.293 75.464l-443.826 443.824c-111.824-134.096-241.227-353.522-75.467-519.288zM191.998 255.997l127.994-127.997-191.992-191.992-127.995 127.994z" />
+<glyph unicode="Q" d="M791.498 415.907c-1.294 129.682 105.758 191.875 110.542 194.966-60.152 88.019-153.85 100.078-187.242 101.472-79.742 8.074-155.597-46.949-196.066-46.949-40.368 0-102.818 45.754-168.952 44.552-86.915-1.291-167.058-50.538-211.811-128.379-90.304-156.698-23.126-388.84 64.89-515.926 43.008-62.203 94.293-132.075 161.626-129.581 64.842 2.589 89.362 41.958 167.755 41.958 78.394 0 100.427-41.958 169.050-40.67 69.774 1.296 113.982 63.398 156.693 125.797 49.39 72.168 69.726 142.038 70.925 145.626-1.549 0.707-136.061 52.237-137.41 207.134zM662.562 796.478c35.739 43.357 59.861 103.512 53.28 163.522-51.478-2.096-113.878-34.29-150.81-77.55-33.142-38.376-62.149-99.626-54.374-158.437 57.466-4.483 116.128 29.205 151.904 72.466z" />
+<glyph unicode="R" d="M0.35 448l-0.35 312.074 384 52.144v-364.218zM448 821.518l511.872 74.482v-448h-511.872zM959.998 384l-0.126-448-511.872 72.016v375.984zM384 16.163l-383.688 52.595-0.021 315.242h383.709z" />
+<glyph unicode="S" d="M567.656 223.083c-81.944-38.118-158.158-37.717-209.341-34.021-61.051 4.41-110.158 21.123-131.742 35.731-13.301 9.006-31.384 5.522-40.39-7.782-9.003-13.302-5.52-31.386 7.782-40.39 34.698-23.486 96.067-40.954 160.162-45.579 10.866-0.784 22.798-1.278 35.646-1.278 55.782 0 126.626 5.315 202.419 40.57 14.563 6.778 20.878 24.074 14.104 38.64-6.774 14.57-24.074 20.875-38.64 14.11zM890.947 266.184c2.786 252.688 28.762 730.206-454.97 691.611-477.6-38.442-350.963-542.968-358.082-711.949-6.309-89.386-35.978-198.648-77.896-309.846h129.101c13.266 47.122 23.024 93.72 27.232 138.15 7.782-5.429 16.109-10.674 24.994-15.701 14.458-8.518 26.885-19.843 40.040-31.834 30.744-28.018 65.59-59.774 133.712-63.752 4.571-0.262 9.174-0.394 13.675-0.394 68.896 0 116.014 30.154 153.878 54.382 18.141 11.613 33.818 21.64 48.563 26.453 41.91 13.12 78.531 34.296 105.904 61.251 4.275 4.208 8.242 8.538 11.962 12.949 15.246-55.878 36.118-118.758 59.288-181.504l275.651-0.002c-66.174 102.224-134.437 202.374-133.053 330.184zM124.11 403.648c0 0.016 0 0.030-0.002 0.046-4.746 82.462 34.71 151.832 88.126 154.936 53.413 3.106 100.56-61.227 105.304-143.693 0-0.014 0.005-0.030 0.005-0.043 0.256-4.446 0.368-8.846 0.37-13.206-16.925-4.256-32.192-10.435-45.872-17.63-0.053 0.613-0.091 1.216-0.152 1.83 0 0.008 0 0.018 0 0.026-4.57 46.81-29.571 82.16-55.851 78.958-26.28-3.203-43.88-43.75-39.312-90.558 0-0.010 0.005-0.018 0.005-0.026 1.992-20.408 7.869-38.637 16.042-52.445-2.034-1.603-7.784-5.813-14.406-10.656-4.97-3.634-11.019-8.058-18.314-13.43-19.885 26.094-33.509 63.581-35.942 105.891zM665.261 199.822c-1.901-43.586-58.909-84.592-111.582-101.043l-0.296-0.096c-21.901-7.102-41.427-19.6-62.104-32.83-34.731-22.224-70.646-45.208-122.522-45.208-3.403 0-6.894 0.104-10.326 0.296-47.515 2.778-69.742 23.032-97.88 48.675-14.842 13.526-30.19 27.514-49.976 39.125l-0.424 0.243c-42.706 24.104-69.213 54.082-70.909 80.194-0.842 12.981 4.938 24.218 17.182 33.4 26.637 19.973 44.478 33.022 56.285 41.658 13.11 9.587 17.069 12.48 20 15.264 2.096 1.986 4.365 4.187 6.805 6.562 24.446 23.774 65.36 63.562 128.15 63.562 38.405 0 80.898-14.8 126.17-43.902 21.325-13.878 39.882-20.286 63.381-28.4 16.157-5.578 34.469-11.902 58.992-22.403l0.395-0.165c22.878-9.402 49.894-26.562 48.659-54.93zM652.646 302.194c-4.4 2.214-8.974 4.32-13.744 6.286-22.106 9.456-39.832 15.874-54.534 20.998 8.115 15.894 13.16 35.72 13.624 57.242 0 0.010 0 0.022 0 0.030 1.126 52.374-25.288 94.896-58.997 94.976-33.71 0.078-61.95-42.314-63.075-94.686 0-0.010 0-0.018 0-0.029-0.038-1.714-0.042-3.416-0.021-5.11-20.762 9.552-41.181 16.49-61.166 20.76-0.091 1.968-0.205 3.933-0.243 5.92 0 0.016 0 0.035 0 0.050-1.938 95.413 56.602 174.39 130.754 176.402 74.15 2.014 135.827-73.701 137.771-169.11 0-0.018 0-0.038 0-0.053 0.875-43.142-10.659-82.862-30.368-113.675z" />
+<glyph unicode="T" d="M448 384l-64 64-192-192 192-192 64 64-128 128zM576 128l64-64 192 192-192 192-64-64 128-128zM903.432 760.57l-142.864 142.862c-31.112 31.112-92.568 56.568-136.568 56.568h-480c-44 0-80-36-80-80v-864c0-44 36-80 80-80h736c44 0 80 36 80 80v608c0 44-25.456 105.458-56.568 136.57zM858.178 715.314c3.13-3.13 6.25-6.974 9.28-11.314h-163.458v163.456c4.339-3.030 8.184-6.15 11.314-9.28l142.864-142.862zM896 16c0-8.672-7.328-16-16-16h-736c-8.672 0-16 7.328-16 16v864c0 8.672 7.328 16 16 16h480c4.832 0 10.254-0.61 16-1.704v-254.296h254.296c1.094-5.746 1.704-11.166 1.704-16v-608z" />
+<glyph unicode="U" d="M640 960v-124c0-51.264-20-99.488-56.128-135.616l-362.112-360.128c-57.248-57.12-88.768-132.128-92.256-212.256h-129.504l192-192 192 192h-126.624c3.36 46.016 21.888 88.736 54.752 121.76l362.112 360c60.512 60.48 93.76 140.736 93.76 226.24v124h-128zM766.496 128c-3.488 80.128-35.136 155.136-92.384 212.512l-71.36 70.88-90.752-90.272 71.744-71.36c32.992-32.864 51.488-75.744 54.88-121.76h-126.624l192-192 192 192h-129.504z" horiz-adv-x="896" />
+<glyph unicode="V" d="M1024 448c0 282.77-229.23 512-512 512s-512-229.23-512-512 229.23-512 512-512 512 229.23 512 512zM96 448c0 229.75 186.25 416 416 416s416-186.25 416-416-186.25-416-416-416-416 186.25-416 416zM557.254 146.744l256 256.002c24.994 24.992 24.994 65.514 0 90.507-24.994 24.994-65.517 24.994-90.51 0l-146.744-146.742v357.49c0 35.346-28.654 64-64 64s-64-28.654-64-64v-357.49l-146.744 146.746c-24.994 24.994-65.518 24.994-90.512 0-12.496-12.498-18.744-28.878-18.744-45.256s6.248-32.758 18.744-45.254l256-256.002c24.994-24.992 65.518-24.992 90.51 0z" />
+<glyph unicode="h" d="M1024.837 959.163v-1024h-1024v1024zM401.115 875.925h-153.891v-868.578h161.011v251.921c0 25.921 0.365 43.446 1.096 52.574 0.365 14.239 1.461 25.741 3.286 34.503h0.547c1.096 8.761 2.921 15.88 5.476 21.358 2.19 6.206 4.929 11.5 8.215 15.88l0.547 0.549c4.016 6.572 9.674 12.961 16.976 19.168 6.572 5.476 14.239 10.404 23.002 14.786 10.223 4.016 19.717 7.119 28.478 9.31 10.223 2.19 21.542 3.286 33.956 3.286 17.89 0 32.676-2.19 44.36-6.572 9.857-4.016 17.708-9.674 23.549-16.976 5.476-8.033 10.041-21.176 13.692-39.431 4.016-21.907 6.024-48.195 6.024-78.863v-281.493h161.011v328.045c0 17.159-0.366 37.056-1.096 59.693-1.096 17.16-2.739 31.033-4.929 41.621-2.19 10.223-5.112 20.082-8.763 29.574-4.38 9.859-8.945 18.621-13.69 26.288-9.494 14.604-19.715 26.47-30.67 35.597-10.953 9.127-24.461 17.708-40.525 25.739h-0.549c-15.333 6.572-31.582 11.502-48.74 14.788-17.525 3.286-36.329 4.929-56.409 4.929-20.447 0-42.534-2.192-66.266-6.572-20.811-4.382-39.98-10.953-57.505-19.715-16.794-8.398-32.858-19.715-48.193-33.954z" />
+<glyph unicode="" d="M873.984 85.952c-199.872-199.936-524.096-199.936-724.032 0-200 199.936-200 524.16 0 724.096 199.936 199.936 524.16 199.936 724.032 0 200-199.936 200-524.16 0-724.096zM512 768c-176.704 0-320-143.232-320-320s143.296-320 320-320c102.528 0 192.768 49.152 251.392 124.096l-235.392 135.872 285.056 164.544c-43.52 125.184-161.152 215.488-301.056 215.488zM832 448c-35.392 0-64-28.608-64-64s28.608-64 64-64 64 28.608 64 64-28.608 64-64 64zM576 640c35.392 0 64-28.608 64-64 0-35.328-28.608-64-64-64s-64 28.672-64 64c0 35.392 28.608 64 64 64z" />
+<glyph unicode="" d="M848.512 445.013c0.128 0.299 0.171 0.64 0.299 0.939 2.858 7.296 4.522 15.104 4.522 23.381s-1.664 16.085-4.523 23.381c-0.128 0.299-0.171 0.64-0.299 0.939-3.243 7.936-8.021 15.061-13.995 21.035l-213.248 213.248c-25.003 25.003-65.493 25.003-90.496 0-25.003-24.96-25.003-65.536 0-90.496l104.066-104.107h-400.17c-35.328 0-64-28.629-64-64s28.672-64 64-64h400.171l-104.064-104.064c-25.003-24.96-25.003-65.536 0-90.496 12.458-12.544 28.842-18.773 45.226-18.773s32.768 6.229 45.269 18.731l213.248 213.248c5.974 5.973 10.752 13.141 13.995 21.034z" />
+<glyph unicode="" d="M175.488 493.653c-0.128-0.299-0.171-0.64-0.299-0.939-2.858-7.294-4.522-15.102-4.522-23.381s1.664-16.085 4.523-23.381c0.128-0.299 0.171-0.64 0.299-0.939 3.243-7.936 8.021-15.061 13.995-21.035l213.248-213.248c25.003-25.003 65.493-25.003 90.496 0 25.003 24.96 25.003 65.536 0 90.496l-104.066 104.107h400.17c35.328 0 64 28.629 64 64s-28.672 64-64 64h-400.17l104.064 104.064c25.003 24.96 25.003 65.536 0 90.496-12.459 12.544-28.843 18.774-45.227 18.774s-32.768-6.23-45.269-18.731l-213.248-213.248c-5.974-5.973-10.752-13.141-13.995-21.035z" />
+<glyph unicode="" d="M839.68 755.2c0 67.84-54.989 122.88-122.88 122.88s-122.88-55.040-122.88-122.88c0-49.818 29.696-92.621 72.294-111.923-11.622-99.738-75.878-119.859-168.704-148.838-45.056-14.080-97.434-30.464-141.67-62.31v210.227c43.674 18.893 74.24 62.31 74.24 112.845 0 67.84-55.040 122.88-122.88 122.88-67.891 0-122.88-55.040-122.88-122.88 0-50.534 30.566-93.952 74.24-112.845v-388.762c-43.674-18.79-74.24-62.208-74.24-112.794 0-67.84 54.989-122.88 122.88-122.88 67.84 0 122.88 55.040 122.88 122.88 0 49.818-29.696 92.621-72.346 111.923 11.674 99.738 75.981 119.91 168.755 148.838 94.362 29.491 221.491 69.274 237.261 240.077 44.544 18.534 75.93 62.362 75.93 113.562zM236.288 755.2c0 39.168 31.744 70.912 70.912 70.912s70.912-31.744 70.912-70.912-31.744-70.912-70.912-70.912-70.912 31.744-70.912 70.912zM307.2 69.888c-39.168 0-70.912 31.744-70.912 70.912s31.744 70.912 70.912 70.912 70.912-31.744 70.912-70.912-31.744-70.912-70.912-70.912zM716.8 684.288c-39.117 0-70.912 31.744-70.912 70.912s31.795 70.912 70.912 70.912 70.912-31.744 70.912-70.912-31.795-70.912-70.912-70.912z" />
+<glyph unicode="" d="M960.005 671.994l-223.998 223.998 64 64 223.997-223.998zM896 608l-32-352c-288 0-704-320-704-320l-53.13 53.13 273.664 273.664c10.973-4.368 22.934-6.794 35.466-6.794 53.019 0 96 42.981 96 96 0 53.019-42.981 96-96 96-53.019 0-96-42.981-96-96 0-12.533 2.426-24.49 6.794-35.466l-273.664-273.664-53.13 53.13c0 0 320 416 320 704l352 32 224-224z" />
+<glyph unicode="" d="M1024.648 963.326v-1023.809h-1023.811v1023.809zM410.696 865.988h-38.127c-14.952-1.494-32.147-3.551-51.583-6.167-19.438-2.617-38.875-5.607-58.313-8.972-19.438-3.363-37.94-7.288-55.508-11.774-17.569-4.486-31.96-8.97-43.174-13.456v-43.734l85.225-8.972v-679.56c-26.166-5.982-50.835-14.952-74.011-26.913v-43.734h297.167v43.734c-10.466 7.476-20.371 13.083-29.716 16.821s-19.998 7.103-31.96 10.093v311.744c8.97 26.913 23.923 50.65 44.855 71.208 20.932 20.559 46.351 30.839 76.255 30.839 35.884 0 59.994-15.139 72.329-45.416 12.335-30.278 18.502-77.563 18.502-141.856v-226.52c-12.708-3.738-23.922-7.851-33.641-12.335-9.718-4.486-19.063-9.345-28.035-14.579v-43.734h297.167v43.734c-11.214 7.476-23.176 13.083-35.884 16.821-12.71 3.738-25.419 7.103-38.127 10.093v268.010c0 46.351-4.113 84.666-12.337 114.942-8.222 30.278-20.184 54.387-35.884 72.329-15.7 17.943-35.323 30.466-58.873 37.567-23.549 7.103-50.275 10.653-80.178 10.653-20.933 0-40.744-3.363-59.434-10.093-18.69-6.728-36.071-15.885-52.145-27.474-16.073-11.587-30.464-25.043-43.172-40.369-12.71-15.325-22.802-31.585-30.278-48.781h-1.121z" />
+</font></defs></svg>+
\ No newline at end of file
diff --git a/docs/static/fonts/hugo.ttf b/docs/static/fonts/hugo.ttf
Binary files differ.
diff --git a/docs/static/fonts/hugo.woff b/docs/static/fonts/hugo.woff
Binary files differ.
diff --git a/docs/static/img/hugo-logo-med.png b/docs/static/img/hugo-logo-med.png
Binary files differ.
diff --git a/docs/static/img/hugo-logo.png b/docs/static/img/hugo-logo.png
Binary files differ.
diff --git a/docs/static/img/hugo.png b/docs/static/img/hugo.png
Binary files differ.
diff --git a/docs/static/img/hugoSM.png b/docs/static/img/hugoSM.png
Binary files differ.
diff --git a/docs/themes/gohugoioTheme/layouts/_default/list.html b/docs/themes/gohugoioTheme/layouts/_default/list.html
@@ -1,4 +1,5 @@
{{ define "main" }}
- {{ $section_to_display := .Sections | default .Paginator.Pages }}
+ {{ $paginator := .Paginate (.Pages | lang.Merge (where .Sites.First.RegularPages "Section" .Section)) }}
+ {{ $section_to_display := .Sections | default $paginator.Pages }}
{{ partial "pagelayout.html" (dict "context" . "section_to_display" $section_to_display ) }}
{{ end }}
diff --git a/docs/themes/gohugoioTheme/layouts/news/list.html b/docs/themes/gohugoioTheme/layouts/news/list.html
@@ -28,7 +28,8 @@
{{ $interior_classes := $.Site.Params.flex_box_interior_classes }}
<section class="flex-ns flex-wrap justify-between w-100 w-80-nsTK v-top">
- {{ range .Paginator.Pages }}
+ {{ $paginator := .Paginate (.Pages | lang.Merge (where .Sites.First.RegularPages "Section" .Section)) -}}
+ {{ range $paginator.Pages }}
{{ partial "boxes-section-summaries" (dict "context" . "classes" $interior_classes "fullcontent" false) }}
{{ end }}
</section>
diff --git a/docs/themes/gohugoioTheme/layouts/page/documentation-home.html b/docs/themes/gohugoioTheme/layouts/page/documentation-home.html
@@ -1,4 +1,4 @@
{{ define "main" }}
-{{ $section_to_display := (.Site.Taxonomies.categories.fundamentals).Pages }}
+{{ $section_to_display := (.Site.Taxonomies.categories.fundamentals).Pages | lang.Merge (.Sites.First.Taxonomies.categories.fundamentals).Pages }}
{{ partial "pagelayout.html" (dict "context" . "section_to_display" $section_to_display ) }}
{{ end }}
diff --git a/docs/themes/gohugoioTheme/layouts/partials/home-page-sections/showcase.html b/docs/themes/gohugoioTheme/layouts/partials/home-page-sections/showcase.html
@@ -5,10 +5,12 @@
<div class="w-100 overflow-x-scroll">
<div class="row nowrap mv2 pb1">
{{ $showcasePages := where .Site.RegularPages "Section" "showcase" }}
+ {{ if $showcasePages }}
{{ template "home_showcase_item" (index $showcasePages 0) }}
{{ range $p := first 10 ($showcasePages | after 1 | shuffle) }}
{{template "home_showcase_item" $p }}
{{end}}
+ {{end}}
</div>
</div>
</div>
diff --git a/docs/themes/gohugoioTheme/layouts/partials/nav-links-docs.html b/docs/themes/gohugoioTheme/layouts/partials/nav-links-docs.html
@@ -4,20 +4,20 @@
{{ range .Site.Menus.docs.ByWeight }}
{{ $post := printf "%s" .Post }}
<li class="f5 w-100 hover-bg-light-gray hover-accent-color-light fw8{{ if eq $post "break" }} mb1 bb b--moon-gray{{ end }}">
- <a href="{{ if .HasChildren }}javascript:void(0){{ else }}{{ .URL }}{{ end }}" class="js-toggle dib w-100 link mid-gray hover-accent-color-light pl2 pr2 pv2 {{if or ($currentPage.IsMenuCurrent "docs" .) ($currentPage.HasMenuCurrent "docs" .) }} primary-color{{end}}" data-target=".{{ .Name | urlize }}">{{ .Name }}</a>
+ <a href="{{ if .HasChildren }}javascript:void(0){{ else }}{{ .URL }}{{ end }}" class="js-toggle dib w-100 link mid-gray hover-accent-color-light pl2 pr2 pv2 {{if or ($currentPage.IsMenuCurrent "docs" .) ($currentPage.HasMenuCurrent "docs" .) }} primary-color{{end}}" data-target=".{{ .Identifier }}">{{ .Name }}</a>
- {{ if .HasChildren }}
- <ul class="{{ .Name | urlize }} desktopmenu animated fadeIn list pl0 bg-light-gray{{if $currentPage.HasMenuCurrent "docs" . }} db{{ else }} dn{{ end }}">
- {{ range .Children }}
- <li class="f6 fw4">
- <a href="{{.URL}}" class="db link hover-bg-gray hover-white pl3 pr2 pv2 {{if $currentPage.IsMenuCurrent "docs" . }}primary-color {{ else }}black {{end}}">
- {{ .Name }}
- </a>
- </li>
- {{ end }}
- </ul>
- {{end}}
- </li>
- {{end}}
+ {{- if .HasChildren }}
+ <ul class="{{ .Identifier }} desktopmenu animated fadeIn list pl0 bg-light-gray{{if $currentPage.HasMenuCurrent "docs" . }} db{{ else }} dn{{ end }}">
+ {{- range .Children }}
+ <li class="f6 fw4">
+ <a href="{{.URL}}" class="db link hover-bg-gray hover-white pl3 pr2 pv2 {{if $currentPage.IsMenuCurrent "docs" . }}primary-color {{ else }}black {{end}}">
+ {{ .Name }}
+ </a>
+ </li>
+ {{- end}}
+ </ul>
+ {{- end}}
+ </li>
+ {{- end}}
</ul>
</nav>
diff --git a/docs/themes/gohugoioTheme/theme.toml b/docs/themes/gohugoioTheme/theme.toml
@@ -8,7 +8,7 @@ description = ""
homepage = "https://github.com/budparr/gohugo.io"
tags = ["website"]
features = ["", ""]
-min_version = 0.18
+min_version = 0.38
[author]
name = "Bud Parr"