hugo/docs/config.toml

title = "Hugo: A Fast and Flexible Website Generator"
baseurl = "http://gohugo.io/"
MetaDataFormat = "yaml"
pluralizeListTitles = false
enableGitInfo = true

[blackfriday]
  plainIDAnchors = true

[params]
  description = "Documentation of Hugo, a fast and flexible static site generator built with love by spf13, bep and friends in Go"
  author = "Steve Francia (spf13) and friends"
  release = "0.18.1"

[taxonomies]
  tag = "tags"
  group = "groups"

[[menu.main]]
    name = "Download Hugo"
    pre = "<i class='fa fa-download'></i>"
    url = "https://github.com/spf13/hugo/releases"
    weight = -200
[[menu.main]]
    name = "Site Showcase"
    pre = "<i class='fa fa-cubes'></i>"
    url = "/showcase/"
    weight = -180
[[menu.main]]
    name = "Theme Showcase"
    pre = "<i class='fa fa-puzzle-piece'></i>"
    url = "http://themes.gohugo.io"
    weight = -170
[[menu.main]]
    name = "Press & Articles"
    pre = "<i class='fa fa-bullhorn'></i>"
    url = "/community/press/"
    weight = -160
[[menu.main]]
    name = "Discuss Hugo"
    pre = "<i class='fa fa-comments'></i>"
    url = "http://discuss.gohugo.io/"
    weight = -150
[[menu.main]]
    name = "About Hugo"
    identifier = "about"
    pre = "<i class='fa fa-heart'></i>"
    weight = -110
[[menu.main]]
    name = "Getting Started"
    identifier = "getting started"
    pre = "<i class='fa fa-road'></i>"
    weight = -100
[[menu.main]]
    name = "Content"
    identifier = "content"
    pre = "<i class='fa fa-file-text'></i>"
    weight = -90
[[menu.main]]
    name = "Themes"
    identifier = "themes"
    pre = "<i class='fa fa-desktop'></i>"
    weight = -85
[[menu.main]]
    parent = "themes"
    name = "Theme Showcase"
    url = "http://themes.gohugo.io"
    weight = -170
[[menu.main]]
    name = "Templates"
    identifier = "layout"
    pre = "<i class='fa fa-columns'></i>"
    weight = -80
[[menu.main]]
    name = "Taxonomies"
    identifier = "taxonomy"
    pre = "<i class='fa fa-tags'></i>"
    weight = -70
[[menu.main]]
    name = "Extras"
    identifier = "extras"
    pre = "<i class='fa fa-gift'></i>"
    weight = -60
[[menu.main]]
    name = "Community"
    identifier = "community"
    pre = "<i class='fa fa-group'></i>"
    weight = -50
[[menu.main]]
    parent = "community"
    name = "Discussion Forum"
    url = "http://discuss.gohugo.io"
    weight = 150
[[menu.main]]
    name = "Tutorials"
    identifier = "tutorials"
    pre = "<i class='fa fa-book'></i>"
    weight = -40
[[menu.main]]
    name = "Troubleshooting"
    identifier = "troubleshooting"
    pre = "<i class='fa fa-wrench'></i>"
    weight = -30
[[menu.main]]
    name = "Tools"
    url = "/tools/"
    pre = "<i class='fa fa-cogs'></i>"
    weight = -25
[[menu.main]]
    name = "Hugo Cmd Reference"
    identifier = "commands"
    pre = "<i class='fa fa-space-shuttle'></i>"
    weight = -20
    url = "/commands/"
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`title = "Hugo: A Fast and Flexible Website Generator"`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`baseurl = "http://gohugo.io/"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`MetaDataFormat = "yaml"`
docs: Add site title; set pluralizeListTitles = false To prevent "Showcase" from becoming "Showcases", also to have the RSS feed display correct titles, i.e. "Showcase on gohugo.io" rather than "Showcase on ". 2015-08-08 03:41:18 -04:00			`pluralizeListTitles = false`
Add GitInfo This commit adds 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. The Git integrations should be fairly performant, but it adds "some time" to the build, somewhat depending on the Git history size. If you want, you can run without during development and turn it on when deploying to the live server: `hugo --enableGitInfo`. Fixes #2102 2016-11-01 18:04:12 -04:00			`enableGitInfo = true`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00
Docs: Enable plain id anchors Making it possible to post permanent anchored links to StackExchange etc. 2016-01-14 16:59:38 -05:00			`[blackfriday]`
			`plainIDAnchors = true`

[Docs] Copyediting * Add meta author, description and generator tags * Add Hugo version beside the logo and in the footer * Suggest the user to run `go get -u -v` to update dependencies * Requires Go 1.3+ rather than Go 1.1+ * Improve rendering/formatting in some places * Add trailing slash to URLs where appropriate * GitHub redirects all http requests to https, update accordingly 2015-01-27 21:17:09 -05:00			`[params]`
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`description = "Documentation of Hugo, a fast and flexible static site generator built with love by spf13, bep and friends in Go"`
[Docs] Copyediting * Add meta author, description and generator tags * Add Hugo version beside the logo and in the footer * Suggest the user to run `go get -u -v` to update dependencies * Requires Go 1.3+ rather than Go 1.1+ * Improve rendering/formatting in some places * Add trailing slash to URLs where appropriate * GitHub redirects all http requests to https, update accordingly 2015-01-27 21:17:09 -05:00			`author = "Steve Francia (spf13) and friends"`
docs: Don't use binary version in docs site Adds a "release" Site param that will be need to be updated for each release. Fixes #2857 2017-01-02 08:08:36 -05:00			`release = "0.18.1"`
[Docs] Copyediting * Add meta author, description and generator tags * Add Hugo version beside the logo and in the footer * Suggest the user to run `go get -u -v` to update dependencies * Requires Go 1.3+ rather than Go 1.1+ * Improve rendering/formatting in some places * Add trailing slash to URLs where appropriate * GitHub redirects all http requests to https, update accordingly 2015-01-27 21:17:09 -05:00
[Docs] Complete the transition from "indexes" to "taxonomies" (almost) Also mention `.Site.Indexes` → `.Site.Taxonomies` as well as the upcoming `.Site.Recent` → `.Site.Pages` transitions. 2015-01-29 14:34:56 -05:00			`[taxonomies]`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`tag = "tags"`
			`group = "groups"`

More doc site improvements. Added documentation's new layout 2014-05-28 01:37:33 -04:00			`[[menu.main]]`
			`name = "Download Hugo"`
			`pre = "<i class='fa fa-download'></i>"`
			`url = "https://github.com/spf13/hugo/releases"`
			`weight = -200`
Bringing back the showcase 2014-08-19 21:47:38 -04:00			`[[menu.main]]`
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`name = "Site Showcase"`
Bringing back the showcase 2014-08-19 21:47:38 -04:00			`pre = "<i class='fa fa-cubes'></i>"`
			`url = "/showcase/"`
switching website to gohugo.io & adding links to discuss 2014-09-18 21:22:04 -04:00			`weight = -180`
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`[[menu.main]]`
			`name = "Theme Showcase"`
			`pre = "<i class='fa fa-puzzle-piece'></i>"`
			`url = "http://themes.gohugo.io"`
			`weight = -170`
Move press page to top level menu 2015-05-25 11:54:22 -04:00			`[[menu.main]]`
			`name = "Press & Articles"`
			`pre = "<i class='fa fa-bullhorn'></i>"`
			`url = "/community/press/"`
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`weight = -160`
switching website to gohugo.io & adding links to discuss 2014-09-18 21:22:04 -04:00			`[[menu.main]]`
			`name = "Discuss Hugo"`
			`pre = "<i class='fa fa-comments'></i>"`
[Docs] Copyediting * Add meta author, description and generator tags * Add Hugo version beside the logo and in the footer * Suggest the user to run `go get -u -v` to update dependencies * Requires Go 1.3+ rather than Go 1.1+ * Improve rendering/formatting in some places * Add trailing slash to URLs where appropriate * GitHub redirects all http requests to https, update accordingly 2015-01-27 21:17:09 -05:00			`url = "http://discuss.gohugo.io/"`
switching website to gohugo.io & adding links to discuss 2014-09-18 21:22:04 -04:00			`weight = -150`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "About Hugo"`
			`identifier = "about"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`pre = "<i class='fa fa-heart'></i>"`
			`weight = -110`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Getting Started"`
			`identifier = "getting started"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`pre = "<i class='fa fa-road'></i>"`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`weight = -100`
			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Content"`
			`identifier = "content"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`pre = "<i class='fa fa-file-text'></i>"`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`weight = -90`
			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Themes"`
			`identifier = "themes"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`pre = "<i class='fa fa-desktop'></i>"`
			`weight = -85`
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`[[menu.main]]`
			`parent = "themes"`
			`name = "Theme Showcase"`
			`url = "http://themes.gohugo.io"`
			`weight = -170`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Templates"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`identifier = "layout"`
			`pre = "<i class='fa fa-columns'></i>"`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`weight = -80`
			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Taxonomies"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`identifier = "taxonomy"`
			`pre = "<i class='fa fa-tags'></i>"`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`weight = -70`
			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Extras"`
			`identifier = "extras"`
Updating / Rewriting / Adding all of the documentation in preparation for the next release 2014-05-27 18:32:57 -04:00			`pre = "<i class='fa fa-gift'></i>"`
Creating site menu configuration and have the docs site use it 2014-04-24 18:11:08 -04:00			`weight = -60`
More doc site improvements. Added documentation's new layout 2014-05-28 01:37:33 -04:00			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Community"`
			`identifier = "community"`
More doc site improvements. Added documentation's new layout 2014-05-28 01:37:33 -04:00			`pre = "<i class='fa fa-group'></i>"`
			`weight = -50`
switching website to gohugo.io & adding links to discuss 2014-09-18 21:22:04 -04:00			`[[menu.main]]`
			`parent = "community"`
			`name = "Discussion Forum"`
			`url = "http://discuss.gohugo.io"`
			`weight = 150`
[Docs] New Troubleshooting section With two entries of frequently encountered or obscured troubles so far: - "Categories with accented characters" Unicode NFC/NFD mismatch on Mac OS X (See #739) - `hugo new` aborts with cryptic EOF error (See #776) 2015-01-08 20:21:04 -05:00			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Tutorials"`
			`identifier = "tutorials"`
[Docs] New Troubleshooting section With two entries of frequently encountered or obscured troubles so far: - "Categories with accented characters" Unicode NFC/NFD mismatch on Mac OS X (See #739) - `hugo new` aborts with cryptic EOF error (See #776) 2015-01-08 20:21:04 -05:00			`pre = "<i class='fa fa-book'></i>"`
			`weight = -40`
			`[[menu.main]]`
[Docs] Adjust sidebar menu width and capitalization Make the sidebar menu slightly wider so the arrow does not get pushed to the next line. Also remove `text-transform: capitalize;` so we can have, e.g., "Table of Contents" rather than "Table Of Contents". 2015-01-17 02:11:17 -05:00			`name = "Troubleshooting"`
			`identifier = "troubleshooting"`
[Docs] New Troubleshooting section With two entries of frequently encountered or obscured troubles so far: - "Categories with accented characters" Unicode NFC/NFD mismatch on Mac OS X (See #739) - `hugo new` aborts with cryptic EOF error (See #776) 2015-01-08 20:21:04 -05:00			`pre = "<i class='fa fa-wrench'></i>"`
			`weight = -30`
Add hugo theme site to the sidebar Also reorder the menu a bit and clarify a couple items. 2015-11-09 23:23:39 -05:00			`[[menu.main]]`
			`name = "Tools"`
			`url = "/tools/"`
			`pre = "<i class='fa fa-cogs'></i>"`
			`weight = -25`
			`[[menu.main]]`
			`name = "Hugo Cmd Reference"`
			`identifier = "commands"`
			`pre = "<i class='fa fa-space-shuttle'></i>"`
			`weight = -20`
			`url = "/commands/"`