diff --git a/docs/config.toml b/docs/config.toml
index 61df5b873..267167556 100644
--- a/docs/config.toml
+++ b/docs/config.toml
@@ -57,6 +57,8 @@ twitter = "GoHugoIO"
removefromexternalsearch = false
## Gh repo for site footer (include trailing slash)
ghrepo = "https://github.com/gohugoio/hugoDocs/"
+ ## GH Repo for filing a new issue
+ github_repo = "https://github.com/gohugoio/hugo/issues/new"
### Edit content repo (set to automatically enter "edit" mode; this is good for "improve this page" links)
ghdocsrepo = "https://github.com/gohugoio/hugoDocs/tree/master/docs"
## Gitter URL
diff --git a/docs/content/content-management/cross-references.md b/docs/content/content-management/cross-references.md
index 7ee81f3db..358152672 100644
--- a/docs/content/content-management/cross-references.md
+++ b/docs/content/content-management/cross-references.md
@@ -96,8 +96,8 @@ More information about document unique identifiers and headings can be found [be
### Examples
-* `{{* ref "blog/post.md" */>}}` => `http://example.com/blog/post/`
-* `{{* ref "post.md#tldr" */>}}` => `http://example.com/blog/post/#tldr:caffebad`
+* `{{* ref "blog/post.md" */>}}` => `https://example.com/blog/post/`
+* `{{* ref "post.md#tldr" */>}}` => `https://example.com/blog/post/#tldr:caffebad`
* `{{* relref "post.md" */>}}` => `/blog/post/`
* `{{* relref "blog/post.md#tldr" */>}}` => `/blog/post/#tldr:caffebad`
* `{{* ref "#tldr" */>}}` => `#tldr:badcaffe`
diff --git a/docs/content/content-management/front-matter.md b/docs/content/content-management/front-matter.md
index 070328670..22c1eb110 100644
--- a/docs/content/content-management/front-matter.md
+++ b/docs/content/content-management/front-matter.md
@@ -54,7 +54,7 @@ slug = "spf13-vim-3-0-release-and-new-website"
---
title: "spf13-vim 3.0 release and new website"
description: "spf13-vim is a cross platform distribution of vim plugins and resources for Vim."
-#tags: [ ".vimrc", "plugins", "spf13-vim", "vim" ]
+tags: [ ".vimrc", "plugins", "spf13-vim", "vim" ]
lastmod: 2015-12-23
date: "2012-04-06"
categories:
diff --git a/docs/content/content-management/menus.md b/docs/content/content-management/menus.md
index 7c877afc8..364867c67 100644
--- a/docs/content/content-management/menus.md
+++ b/docs/content/content-management/menus.md
@@ -153,7 +153,7 @@ menu:
{{< /code >}}
{{% note %}}
-The URLs must be relative to the context root. If the `baseURL` is `http://example.com/mysite/`, then the URLs in the menu must not include the context root `mysite`. Using an absolute URL will overide the baseURL. If the value used for `URL` in the above example is `http://subdomain.example.com/`, the output will be `http://subdomain.example.com`.
+The URLs must be relative to the context root. If the `baseURL` is `https://example.com/mysite/`, then the URLs in the menu must not include the context root `mysite`. Using an absolute URL will overide the baseURL. If the value used for `URL` in the above example is `https://subdomain.example.com/`, the output will be `https://subdomain.example.com`.
{{% /note %}}
## Nesting
diff --git a/docs/content/content-management/organization.md b/docs/content/content-management/organization.md
index 33780c0eb..95fd3562a 100644
--- a/docs/content/content-management/organization.md
+++ b/docs/content/content-management/organization.md
@@ -34,20 +34,20 @@ While Hugo supports content nested at any level, the top levels (i.e. `content/<
.
└── content
└── about
- | └── _index.md // <- http://example.com/about/
+ | └── _index.md // <- https://example.com/about/
├── post
- | ├── firstpost.md // <- http://example.com/post/firstpost/
+ | ├── firstpost.md // <- https://example.com/post/firstpost/
| ├── happy
- | | └── ness.md // <- http://example.com/post/happy/ness/
- | └── secondpost.md // <- http://example.com/post/secondpost/
+ | | └── ness.md // <- https://example.com/post/happy/ness/
+ | └── secondpost.md // <- https://example.com/post/secondpost/
└── quote
- ├── first.md // <- http://example.com/quote/first/
- └── second.md // <- http://example.com/quote/second/
+ ├── first.md // <- https://example.com/quote/first/
+ └── second.md // <- https://example.com/quote/second/
```
## Path Breakdown in Hugo
-The following demonstrates the relationships between your content organization and the output URL structure for your Hugo website when it renders. These examples assume you are [using pretty URLs][pretty], which is the default behavior for Hugo. The examples also assume a key-value of `baseurl = "http://example.com"` in your [site's configuration file][config].
+The following demonstrates the relationships between your content organization and the output URL structure for your Hugo website when it renders. These examples assume you are [using pretty URLs][pretty], which is the default behavior for Hugo. The examples also assume a key-value of `baseurl = "https://example.com"` in your [site's configuration file][config].
### Index Pages: `_index.md`
@@ -76,7 +76,7 @@ At build, this will output to the following destination with the associated valu
⊢--------^---------⊣⊢-^-⊣
permalink
⊢----------^-------------⊣
-http://example.com/posts/index.html
+https://example.com/posts/index.html
```
### Single Pages in Sections
@@ -102,7 +102,7 @@ At the time Hugo builds your site, the content will be output to the following d
⊢--------^--------⊣⊢-^--⊣⊢-------^---------⊣
permalink
⊢--------------------^---------------------⊣
-http://example.com/posts/my-first-hugo-post/index.html
+https://example.com/posts/my-first-hugo-post/index.html
```
### Section with Nested Directories
@@ -120,7 +120,7 @@ To continue the example, the following demonstrates destination paths for a file
⊢--------^--------⊣ ⊢------^-----⊣⊢----^------⊣
permalink
⊢----------------------^-----------------------⊣
-http://example.com/events/chicago/lollapalooza/
+https://example.com/events/chicago/lollapalooza/
```
{{% note %}}
@@ -201,9 +201,9 @@ layout: mylayout
---
{{< /code >}}
-
-`path` can be provided in the front matter. This will replace the actual path to the file on disk. Destination will create the destination with the same path, including the section. -->
+
### `url`
diff --git a/docs/content/content-management/taxonomies.md b/docs/content/content-management/taxonomies.md
index b2f785056..542bb6cfc 100644
--- a/docs/content/content-management/taxonomies.md
+++ b/docs/content/content-management/taxonomies.md
@@ -163,7 +163,7 @@ project_url = "https://github.com/gohugoio/hugo"
```
---
title: "Hugo: A fast and flexible static site generator"
-#tags: ["Development", "Go", "fast", "Blogging"]
+tags: ["Development", "Go", "fast", "Blogging"]
categories: ["Development"]
series: ["Go Web Dev"]
slug: "hugo"
@@ -216,7 +216,7 @@ categories_weight = 44
```
---
title: foo
-#tags: [ "a", "b", "c" ]
+tags: [ "a", "b", "c" ]
tags_weight: 22
categories: ["d"]
categories_weight: 44
diff --git a/docs/content/content-management/urls.md b/docs/content/content-management/urls.md
index 74f2f772e..29cd66e84 100644
--- a/docs/content/content-management/urls.md
+++ b/docs/content/content-management/urls.md
@@ -43,7 +43,7 @@ permalinks:
post = "/:year/:month/:title/"
{{< /code >}}
-Only the content under `post/` will have the new URL structure. For example, the file `content/post/sample-entry.md` with `date: 2017-02-27T19:20:00-05:00` in its front matter will render to `public/2017/02/sample-entry/index.html` at build time and therefore be reachable at `http://example.com/2013/11/sample-entry/`.
+Only the content under `post/` will have the new URL structure. For example, the file `content/post/sample-entry.md` with `date: 2017-02-27T19:20:00-05:00` in its front matter will render to `public/2017/02/sample-entry/index.html` at build time and therefore be reachable at `https://example.com/2013/11/sample-entry/`.
### Permalink Configuration Values
@@ -147,11 +147,11 @@ Assuming a `baseURL` of `example.com`, the contents of the auto-generated alias
- http://example.com/posts/my-intended-url
-
+ https://example.com/posts/my-intended-url
+
-
+
```
@@ -190,7 +190,7 @@ content/posts/post-1.md
## Ugly URLs
-If you would like to have are often referred to as "ugly URLs" (e.g., example.com/urls.html), set `uglyurls = true` or `uglyurls: true` in your site's `config.toml` or `config.yaml`, respectively. You can also use the `--uglyURLs=true` [flag from the command line][usage] with `hugo` or `hugo server`..
+If you would like to have what are often referred to as "ugly URLs" (e.g., example.com/urls.html), set `uglyurls = true` or `uglyurls: true` in your site's `config.toml` or `config.yaml`, respectively. You can also use the `--uglyURLs=true` [flag from the command line][usage] with `hugo` or `hugo server`..
If you want a specific piece of content to have an exact URL, you can specify this in the [front matter][] under the `url` key. The following are examples of the same content directory and what the eventual URL structure will be when Hugo runs with its default behavior.
@@ -200,15 +200,15 @@ See [Content Organization][contentorg] for more details on paths.
.
└── content
└── about
- | └── _index.md // <- http://example.com/about/
+ | └── _index.md // <- https://example.com/about/
├── post
- | ├── firstpost.md // <- http://example.com/post/firstpost/
+ | ├── firstpost.md // <- https://example.com/post/firstpost/
| ├── happy
- | | └── ness.md // <- http://example.com/post/happy/ness/
- | └── secondpost.md // <- http://example.com/post/secondpost/
+ | | └── ness.md // <- https://example.com/post/happy/ness/
+ | └── secondpost.md // <- https://example.com/post/secondpost/
└── quote
- ├── first.md // <- http://example.com/quote/first/
- └── second.md // <- http://example.com/quote/second/
+ ├── first.md // <- https://example.com/quote/first/
+ └── second.md // <- https://example.com/quote/second/
```
Here's the same organization run with `hugo --uglyURLs`:
@@ -217,15 +217,15 @@ Here's the same organization run with `hugo --uglyURLs`:
.
└── content
└── about
- | └── _index.md // <- http://example.com/about/index.html
+ | └── _index.md // <- https://example.com/about/index.html
├── post
- | ├── firstpost.md // <- http://example.com/post/firstpost.html
+ | ├── firstpost.md // <- https://example.com/post/firstpost.html
| ├── happy
- | | └── ness.md // <- http://example.com/post/happy/ness.html
- | └── secondpost.md // <- http://example.com/post/secondpost.html
+ | | └── ness.md // <- https://example.com/post/happy/ness.html
+ | └── secondpost.md // <- https://example.com/post/secondpost.html
└── quote
- ├── first.md // <- http://example.com/quote/first.html
- └── second.md // <- http://example.com/quote/second.html
+ ├── first.md // <- https://example.com/quote/first.html
+ └── second.md // <- https://example.com/quote/second.html
```
@@ -233,7 +233,7 @@ Here's the same organization run with `hugo --uglyURLs`:
By default, all relative URLs encountered in the input are left unmodified, e.g. `/css/foo.css` would stay as `/css/foo.css`. The `canonifyURLs` field in your site `config` has a default value of `false`.
-By setting `canonifyURLs` to `true`, all relative URLs would instead be *canonicalized* using `baseURL`. For example, assuming you have `baseURL = https://example.com/`, the relative URL `/css/foo.css` would be turned into the absolute URL `http://example.com/css/foo.css`.
+By setting `canonifyURLs` to `true`, all relative URLs would instead be *canonicalized* using `baseURL`. For example, assuming you have `baseURL = https://example.com/`, the relative URL `/css/foo.css` would be turned into the absolute URL `https://example.com/css/foo.css`.
Benefits of canonicalization include fixing all URLs to be absolute, which may aid with some parsing tasks. Note, however, that all modern browsers handle this on the client without issue.
diff --git a/docs/content/contribute/development.md b/docs/content/contribute/development.md
index 8261c0e1b..2e5b92fbd 100644
--- a/docs/content/contribute/development.md
+++ b/docs/content/contribute/development.md
@@ -139,6 +139,12 @@ So, let's clone that master repository:
go get -v -u github.com/gohugoio/hugo
```
+Hugo relies on [Testify](https://github.com/stretchr/testify) for testing Go code. If you don't already have it, get the Testify testing tools:
+
+```
+go get github.com/stretchr/testify
+```
+
### Fork the repository
If you're not fimiliar with this term, GitHub's [help pages](https://help.github.com/articles/fork-a-repo/) provide again a simple explanation:
diff --git a/docs/content/contribute/themes.md b/docs/content/contribute/themes.md
index dc8bddc3a..7055e94e8 100644
--- a/docs/content/contribute/themes.md
+++ b/docs/content/contribute/themes.md
@@ -64,7 +64,7 @@ name = ""
license = "MIT"
licenselink = "https://github.com///blob/master/LICENSE.md"
description = ""
-homepage = "http://example.com/"
+homepage = "https://example.com/"
tags = []
features = []
min_version = 0.19
diff --git a/docs/content/functions/abslangurl.md b/docs/content/functions/abslangurl.md
index 41903c61d..8a6f49854 100644
--- a/docs/content/functions/abslangurl.md
+++ b/docs/content/functions/abslangurl.md
@@ -20,9 +20,9 @@ aliases: []
Both `absLangURL` and [`relLangURL`](/functions/rellangurl/) are similar to their [`absURL`](/functions/absurl/) and [`relURL`](/functions/relurl) relatives but will add the correct language prefix when the site is configured with more than one language.
-So for a site `baseURL` set to `http://example.com/hugo/` and the current language is `en`:
+So for a site `baseURL` set to `https://example.com/hugo/` and the current language is `en`:
```
-{{ "blog/" | absLangURL }} → "http://example.com/hugo/en/blog/"
+{{ "blog/" | absLangURL }} → "https://example.com/hugo/en/blog/"
{{ "blog/" | relLangURL }} → "/hugo/en/blog/"
```
diff --git a/docs/content/functions/absurl.md b/docs/content/functions/absurl.md
index 40cc9111c..2e03ca49d 100644
--- a/docs/content/functions/absurl.md
+++ b/docs/content/functions/absurl.md
@@ -18,10 +18,10 @@ deprecated: false
aliases: []
---
-Both `absURL` and `relURL` consider the configured value of `baseURL` in your site's [`config` file][configuration]. Given a `baseURL` set to `http://example.com/hugo/`:
+Both `absURL` and `relURL` consider the configured value of `baseURL` in your site's [`config` file][configuration]. Given a `baseURL` set to `https://example.com/hugo/`:
```
-{{ "mystyle.css" | absURL }} → "http://example.com/hugo/mystyle.css"
+{{ "mystyle.css" | absURL }} → "https://example.com/hugo/mystyle.css"
{{ "mystyle.css" | relURL }} → "/hugo/mystyle.css"
{{ "http://gohugo.io/" | relURL }} → "http://gohugo.io/"
{{ "http://gohugo.io/" | absURL }} → "http://gohugo.io/"
diff --git a/docs/content/functions/math.md b/docs/content/functions/math.md
index 60b801dfa..6375ad738 100644
--- a/docs/content/functions/math.md
+++ b/docs/content/functions/math.md
@@ -38,7 +38,7 @@ You can also use the `add` function with strings. You may like this functionalit
For example, social media sharing with [Twitter Cards][cards] requires the following `meta` link in your site's `` to display Twitter's ["Summary Card with Large Image"][twtsummary]:
```
-
+
```
Let's assume you have an `image` field in the front matter of each of your content files:
diff --git a/docs/content/functions/relLangURL.md b/docs/content/functions/relLangURL.md
index 08f4511fb..2df271746 100644
--- a/docs/content/functions/relLangURL.md
+++ b/docs/content/functions/relLangURL.md
@@ -20,10 +20,10 @@ aliases: []
`absLangURL` and `relLangURL` functions are similar to their [`absURL`](/functions/absurl/) and [`relURL`](/functions/relurl/) relatives but will add the correct language prefix when the site is configured with more than one language. (See [Configuring Multilingual][multiliconfig].)
-So for a site `baseURL` set to `http://example.com/hugo/` and the current language is `en`:
+So for a site `baseURL` set to `https://example.com/hugo/` and the current language is `en`:
```
-{{ "blog/" | absLangURL }} → "http://example.com/hugo/en/blog/"
+{{ "blog/" | absLangURL }} → "https://example.com/hugo/en/blog/"
{{ "blog/" | relLangURL }} → "/hugo/en/blog/"
```
diff --git a/docs/content/functions/relurl.md b/docs/content/functions/relurl.md
index 2760d10c8..085c344f5 100644
--- a/docs/content/functions/relurl.md
+++ b/docs/content/functions/relurl.md
@@ -18,10 +18,10 @@ deprecated: false
aliases: []
---
-Both `absURL` and `relURL` consider the configured value of `baseURL` in your site's [`config` file][configuration]. Given a `baseURL` set to `http://example.com/hugo/`:
+Both `absURL` and `relURL` consider the configured value of `baseURL` in your site's [`config` file][configuration]. Given a `baseURL` set to `https://example.com/hugo/`:
```
-{{ "mystyle.css" | absURL }} → "http://example.com/hugo/mystyle.css"
+{{ "mystyle.css" | absURL }} → "https://example.com/hugo/mystyle.css"
{{ "mystyle.css" | relURL }} → "/hugo/mystyle.css"
{{ "http://gohugo.io/" | relURL }} → "http://gohugo.io/"
{{ "http://gohugo.io/" | absURL }} → "http://gohugo.io/"
diff --git a/docs/content/functions/title.md b/docs/content/functions/title.md
index 3ecf1ac34..d65552178 100644
--- a/docs/content/functions/title.md
+++ b/docs/content/functions/title.md
@@ -23,3 +23,11 @@ aliases: []
```
{{title "BatMan"}}` → "Batman"
```
+
+Can be combined in pipes. In the following snippet, the link text is cleaned up using `humanize` to remove dashes and `title` to convert the value of `$name` to Intial Caps.
+
+```
+{{ range $name, $items := .Site.Taxonomies.categories }}
+