Merge bp/theme-design branch containing Bud Parr's new design

It's a beautiful thing. A thousand thanks, Bud.

See PR rdwatters/hugo-docs-concept#118

.gitignore

@@ -1,4 +1,7 @@
 pipeline/node_modules
 ryans-notes.md
 themes/hugo-docs-concept/pipeline/node_modules
+public
 .DS_Store
+
+.netlify

.gitmodules

@@ -0,0 +1,3 @@
+[submodule "themes/gohugo-theme"]
+	path = themes/gohugo-theme
+	url = https://github.com/budparr/gohugo-theme.git

config.toml

@@ -2,6 +2,8 @@ baseurl = "https://hugodocs.info"
 canonifyurls = true
 # Pointing to this file
 config = "config.toml"
+enableGitInfo = true
+paginate=  100
 copyright = ""
 defaultContentLanguage = "en"
 # Set to true to keep url path preserve casing (eg, for sections)
@@ -28,8 +30,10 @@ relativeURLs = true
 stepAnalysis = true
 # This is the top-level, global site title
 title = "Hugo"
-# Change this to your preferred theme
-theme = "hugo-docs-concept"
+
+# Change this once you've created your theme
+theme = "gohugo-theme"
+
 # Set to true to convert mysite/section/ to mysite/section.html
 uglyURLs = false
 verbose = false
@@ -56,7 +60,7 @@ googleAnalytics = "UA-76549364-1"
   ## Gh repo for site footer (include trailing slash)
   ghrepo = "https://github.com/spf13/hugo/"
   ### Edit content repo (set to automatically enter "edit" mode; this is good for "improve this page" links)
-  ghdocsrepo = "https://github.com/rdwatters/hugo-docs-concept/tree/master"
+  ghdocsrepo = "https://github.com/spf13/hugo/tree/master/docs"
   ## Gitter URL
   gitter = "https://gitter.im/spf13/hugo"
   ## Discuss Forum URL
@@ -64,6 +68,8 @@ googleAnalytics = "UA-76549364-1"
   ## Google Tag Manager
   gtmid = ""
 
+  #sidebar_direction = "sidebar_left"
+
 # MARKDOWN
 ## Configuration for BlackFriday markdown parser: https://github.com/russross/blackfriday
 [blackfriday]
@@ -75,3 +81,160 @@ googleAnalytics = "UA-76549364-1"
 ## As of v0.20, all content files include a default "categories" value that's the same as the section. This was a cheap future-proofing method and should/could be changed accordingly.
 [taxonomies]
   tag = "tags"
+  category = "categories"
+
+
+# High level items
+
+[[menu.docs]]
+  name = "About Hugo"
+  weight = 1
+  identifier = "about"
+  url = "/about/"
+
+[[menu.docs]]
+  name = "Getting Started"
+  weight = 5
+  identifier = "getting-started"
+  url = "/getting-started/"
+
+
+[[menu.docs]]
+  name = "Themes"
+  weight = 15
+  identifier = "themes"
+  post = "break"
+  url = "/themes/"
+
+# Core Menus
+
+[[menu.docs]]
+  name = "Content Management"
+  weight = 20
+  identifier = "content-management"
+  post = "expanded"
+  url = "/content-management/"
+
+[[menu.docs]]
+  name = "Templates"
+  weight = 25
+  identifier = "templates"
+
+  url = "/templates/"
+
+[[menu.docs]]
+  name = "Functions"
+  weight = 30
+  identifier = "functions"
+  url = "/functions/"
+
+[[menu.docs]]
+  name = "Variables"
+  weight = 35
+  identifier = "variables"
+  url = "/variables/"
+
+[[menu.docs]]
+  name = "CLI"
+  weight = 40
+  post = "break"
+  identifier = "commands"
+  url = "/commands/"
+
+
+
+# LOW LEVEL ITEMS
+
+
+[[menu.docs]]
+  name = "Troubleshooting"
+  weight = 60
+  identifier = "troubleshooting"
+  url = "/troubleshooting/"
+
+[[menu.docs]]
+  name = "Tools"
+  weight = 70
+  identifier = "tools"
+  url = "/tools/"
+
+[[menu.docs]]
+  name = "Hosting & Deployment"
+  weight = 80
+  identifier = "hosting-and-deployment"
+  url = "/hosting-and-deployment/"
+
+# [[menu.docs]]
+#   name = "Showcase"
+#   weight = 90
+#   identifier = "showcase"
+#   url = "/showcase/"
+#
+
+[[menu.docs]]
+  name = "Contribute"
+  weight = 100
+  post = "break"
+  identifier = "contribute"
+  url = "/contribute/"
+
+[[menu.docs]]
+  name = "Tags"
+  weight = 120
+  identifier = "tags"
+  url = "/tags/"
+
+
+# [[menu.docs]]
+#   name = "Categories"
+#   weight = 140
+#   identifier = "categories"
+#   url = "/categories/"
+
+######## QUICKLINKS
+
+  [[menu.quicklinks]]
+    name = "Fundamentals"
+    weight = 1
+    identifier = "fundamentals"
+    url = "/tags/fundamentals/"
+
+
+
+
+######## GLOBAL ITEMS TO BE SHARED WITH THE HUGO siteaddress
+
+[[menu.global]]
+    name = "News"
+    weight = 1
+    identifier = "news"
+    url = "https://hugodocs.info/news/"
+
+  [[menu.global]]
+    name = "Docs"
+    weight = 5
+    identifier = "docs"
+    url = "/"
+
+  [[menu.global]]
+    name = "Themes"
+    weight = 10
+    identifier = "themes"
+    url = "http://themes.gohugo.io/"
+
+  # Anything with a weight > 100 gets an external icon
+  [[menu.global]]
+    name = "Community"
+    weight = 150
+    icon = true
+    identifier = "community"
+    post = "external"
+    url = "https://discuss.gohugo.io/"
+
+
+  [[menu.global]]
+    name = "Github"
+    weight = 200
+    identifier = "github"
+    post = "external"
+    url = "https://github.com/spf13/hugo"

content/_index.md

@@ -15,3 +15,4 @@ slug:
 aliases: []
 toc: false
 ---
+Hugo is the world's fastest static website engine. It's written in Golang and developed by spf13 and friends. Below you will find some of the most common and helpful pages from our documentation.

content/about/_index.md

@@ -1,6 +1,5 @@
 ---
 title: About Hugo
-linktitle: Overview
 description: Hugo's features, roadmap, license, and motivation.
 date: 2017-02-01
 publishdate: 2017-02-01
@@ -8,13 +7,13 @@ lastmod: 2017-02-01
 categories: []
 tags: []
 menu:
-  main:
-    parent: "About Hugo"
-    weight: 01
-weight: 01	#rem
+  docs:
+    parent: "about"
+    weight: 1
+weight: 1
 draft: false
 aliases: [/about-hugo/,/docs/]
 toc: false
 ---
 
-Hugo is not your average static site generator.
+Hugo is not your average static site generator.

content/about/benefits.md

@@ -7,8 +7,8 @@ publishdate: 2017-02-01
 lastmod: 2017-02-01
 tags: [ssg,static,performance,security]
 menu:
-  main:
-    parent: "About Hugo"
+  docs:
+    parent: "about"
     weight: 30
 weight: 30
 sections_weight: 30

content/about/features.md

@@ -6,8 +6,8 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 menu:
-  main:
-    parent: "About Hugo"
+  docs:
+    parent: "about"
     weight: 20
 weight: 20
 sections_weight: 20
@@ -87,4 +87,4 @@ See what's coming next in the [Hugo roadmap][].
 [Syntax highlighting]: /tools/syntax-highlighting/
 [table of contents]: /content-management/toc/
 [taxonomies]: /content-management/taxonomies/
-[URLs]: /content-management/urls/
+[URLs]: /content-management/urls/

content/about/license.md

@@ -8,8 +8,8 @@ lastmod: 2016-03-02
 categories: ["about hugo"]
 tags: ["License","apache"]
 menu:
-  main:
-    parent: "About Hugo"
+  docs:
+    parent: "about"
     weight: 60
 weight: 60
 sections_weight: 60

content/about/roadmap.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [about hugo]
 tags: [about,contribute,roadmap]
 menu:
-  main:
-    parent: "About Hugo"
+  docs:
+    parent: "about"
     weight: 50
 weight: 50
 sections_weight: 50
@@ -48,4 +48,4 @@ Feel free to [contribute to Hugo's development][devcontribute], [improve Hugo's
 [themes]: /themes/
 [themescontrib]: /contribute/themes/
 [tutorials]: /tutorials
-[***your*** best ideas!]: /contribute/
+[***your*** best ideas!]: /contribute/

content/about/what-is-hugo.md

@@ -77,4 +77,4 @@ I wanted to develop a fast and full-featured website framework without any depen
 [static site generator]: /about/benefits/
 [Rackspace]: https://www.rackspace.com/cloud/files
 [static site generator]: /about/benefits/
-[Surge]: https://surge.sh
+[Surge]: https://surge.sh

content/commands/_index.md

@@ -1,6 +1,6 @@
 ---
 title: Command Line Reference
-linktitle: Command Line Reference
+linktitle: CLI
 description: Comprehensive list of Hugo templating functions, including basic and advanced usage examples.
 date: 2017-02-01
 publishdate: 2017-02-01
@@ -8,9 +8,9 @@ lastmod: 2017-02-01
 categories: [commands]
 tags: [cli,command line]
 menu:
-  main:
-    parent: "Commands"
-    weight: 01
+  docs:
+    parent: "commands"
+    weight: 1
 weight: 01	#rem
 draft: false
 aliases: [/cli/]

content/commands/hugo.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo
 url: /commands/hugo/
 ---

content/commands/hugo_benchmark.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo benchmark"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_benchmark
 url: /commands/hugo_benchmark/
 ---

content/commands/hugo_check.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo check"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_check
 url: /commands/hugo_check/
 ---

content/commands/hugo_check_ulimit.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo check ulimit"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_check_ulimit
 url: /commands/hugo_check_ulimit/
 ---

content/commands/hugo_config.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo config"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_config
 url: /commands/hugo_config/
 ---

content/commands/hugo_convert.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo convert"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_convert
 url: /commands/hugo_convert/
 ---

content/commands/hugo_convert_toJSON.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo convert toJSON"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_convert_toJSON
 url: /commands/hugo_convert_tojson/
 ---

content/commands/hugo_convert_toTOML.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo convert toTOML"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_convert_toTOML
 url: /commands/hugo_convert_totoml/
 ---

content/commands/hugo_convert_toYAML.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo convert toYAML"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_convert_toYAML
 url: /commands/hugo_convert_toyaml/
 ---

content/commands/hugo_env.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo env"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_env
 url: /commands/hugo_env/
 ---

content/commands/hugo_gen.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo gen"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_gen
 url: /commands/hugo_gen/
 ---

content/commands/hugo_gen_autocomplete.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo gen autocomplete"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_gen_autocomplete
 url: /commands/hugo_gen_autocomplete/
 ---

content/commands/hugo_gen_doc.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo gen doc"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_gen_doc
 url: /commands/hugo_gen_doc/
 ---

content/commands/hugo_gen_man.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo gen man"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_gen_man
 url: /commands/hugo_gen_man/
 ---

content/commands/hugo_import.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo import"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_import
 url: /commands/hugo_import/
 ---

content/commands/hugo_import_jekyll.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo import jekyll"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_import_jekyll
 url: /commands/hugo_import_jekyll/
 ---

content/commands/hugo_list.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo list"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_list
 url: /commands/hugo_list/
 ---

content/commands/hugo_list_drafts.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo list drafts"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_list_drafts
 url: /commands/hugo_list_drafts/
 ---

content/commands/hugo_list_expired.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo list expired"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_list_expired
 url: /commands/hugo_list_expired/
 ---

content/commands/hugo_list_future.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo list future"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_list_future
 url: /commands/hugo_list_future/
 ---

content/commands/hugo_new.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo new"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_new
 url: /commands/hugo_new/
 ---

content/commands/hugo_new_site.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo new site"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_new_site
 url: /commands/hugo_new_site/
 ---

content/commands/hugo_new_theme.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo new theme"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_new_theme
 url: /commands/hugo_new_theme/
 ---

content/commands/hugo_server.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo server"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_server
 url: /commands/hugo_server/
 ---

content/commands/hugo_undraft.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo undraft"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_undraft
 url: /commands/hugo_undraft/
 ---

content/commands/hugo_version.md

@@ -1,6 +1,9 @@
 ---
 date: 2017-02-25T10:01:37+01:00
 title: "hugo version"
+menu:
+  docs:
+    parent: "commands"
 slug: hugo_version
 url: /commands/hugo_version/
 ---

content/content-management/_index.md

@@ -1,16 +1,16 @@
 ---
 title: Content Management
-linktitle: Overview
+linktitle: Content Mgmt.
 description: Hugo makes managing large static sites easy with support for archetypes, content types, menus, cross references, summaries, and more.
 date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
+menu:
+  docs:
+    parent: "content-management"
+    weight: 1
 tags: [source, organization]
 categories: [content management]
-menu:
-  main:
-    parent: "Content Management"
-    weight: 01
 weight: 01	#rem
 draft: false
 aliases: [/content/]

content/content-management/archetypes.md

@@ -8,9 +8,10 @@ lastmod: 2017-02-01
 tags: [archetypes,generators,metadata,front matter]
 categories: ["content management"]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 70
+  quicklinks:    
 weight: 70	#rem
 draft: false
 aliases: [/content/archetypes/]

content/content-management/authors.md

@@ -8,8 +8,8 @@ lastmod: 2017-03-12
 tags: [authors]
 categories: ["content management"]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 55
 weight: 55	#rem
 draft: true
@@ -190,4 +190,4 @@ The example above generates a simple list of all posts written by a single autho
 With a lot of content this list can quickly become very long. Consider to use the [pagination][] feature. It splits the list into smaller chunks and spreads them over multiple pages.
 
 [pagevars]: /variables/page/
-[pagination]: /templates/pagination/
+[pagination]: /templates/pagination/

content/content-management/comments.md

@@ -8,8 +8,8 @@ lastmod: 2017-03-09
 tags: [sections,content,organization, fundamentals]
 categories: [project organization]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 140
 weight: 140	#rem
 draft: false

content/content-management/cross-references.md

@@ -8,8 +8,8 @@ lastmod: 2017-03-31
 categories: [content management]
 tags: ["cross references","references", "anchors", "urls"]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 100
 weight: 100	#rem
 draft: false

content/content-management/custom-outputs.md

@@ -0,0 +1,147 @@
+---
+title: Custom Outputs
+linktitle: Custom Outputs
+description: Hugo can output content in multiple formats to make quick work of
+date: 2017-03-22
+publishdate: 2017-03-22
+lastmod: 2017-03-22
+categories: [content management]
+tags: ["amp","outputs"]
+menu:
+  docs:
+    parent: "content-management"
+    weight: 100
+  quicklinks:
+weight: 100	#rem
+draft: false
+aliases: [/extras/custom-output-types/]
+toc: true
+wip: true
+---
+
+{{% warning %}}
+Custom output formats is a major feature being released with v20. The following copy is taken from the original proposal and spec and is therefore far from complete.
+{{% /warning %}}
+
+## Media Type
+
+We add a  media type (also known as MIME type and content type). This is a two-part identifier for file formats and format contents transmitted on the Internet.
+
+For Hugo's use cases, we use the top-level type name/subtype name + suffix. An example would be `application/json+json`.
+
+Users can define their own media types by using them in an `Output Format` definition (see below).
+
+The full set of media types will be registered in Go's `mime` package, so they will be recognised by Hugo's development server.
+
+## Output Format
+
+A `Page` in Hugo can be rendered to multiple representations on the file system: All will get an HTML page and some of them will get an RSS page (home page, sections etc.).
+
+When we now create a more formal definition for these output representations, the built-ins mentioned above will be the standard set that can be extended.
+
+So an `OutputFormat`:
+
+```
+OutputFormat:
+   Name
+   MediaType
+   Path
+   IsPlainText (default false)
+   Protocol
+
+  # And then some optional options
+  NoUglyURLs
+  URI # Turn index.x into somevalue.x (similar to `RSSUri` in Hugo `0.19`)
+```
+
+So:
+
+* `Name`: The key.
+* `Path` - defaults to "", which is the root. Multiple outputs to the same suffix must be separated with a path, ie. "amp" for AMP output.
+* `IsPlainText`: Whether to parse the templates with `text/template` or `html/template`.
+* `Protocol`: I.e. `webcal://` for calendar files. Defaults to the `baseURL` protocol.
+
+## Standard Output Formats
+
+So, according to the above, the current Hugo will look like this:
+
+| Name        | MediaType           | Path  | IsPlainText
+| -------------:|-------------| -----|-----|
+| HTML     | text/html+html | ""  | false |
+| RSS     | application/rss+xml | ""  | false |
+
+## Layouts
+
+The current situation (slightly simplified):
+
+| Kind                     | Layouts
+| ----------------:|:-------------|
+| home                  | index.html, _default/list.html |
+| section               | section/SECTION.html, SECTION/list.html, _default/section.html, _default/list.html |
+| taxonomy           | taxonomy/SINGULAR.html,_default/taxonomy.html, _default/list.html |
+| taxonomyTerm  |taxonomy/SINGULAR.terms.html, _default/terms.html|
+| page                  | TYPE/LAYOUT.html, _default/LAYOUT.html, _default/single.html|
+
+The above is what the Output Format `HTML` must resolve to.
+
+So, let us make up some other Output Formats and see how that will have to look:
+
+| Name        | MediaType           | Path  | IsPlainText
+| -------------:|-------------| -----|-----|
+| JSON     | application/json+json | ""  | true |
+| AMP     |  text/html+html | amp  | false |
+
+Both of the above can be handled if we add both `Name` and the `Suffix` to the mix. Let us use the home page as an example:
+
+| Type                    | Layouts
+| -----------:|:-------------|
+| JSON          | index.json.json, index.json, _default/list.json.json, _default/list.json
+| AMP            | index.amp.html, index.html,  _default/list.amp.html, _default/list.html
+
+* The above adds the lower-case `Name` as a prefix to the lookup path.
+* The above also assumes that it makes sense to edit the templates with the same suffix as the end result (.html, .json etc.).
+
+TODO: RSS, 404 etc.
+
+## Examples
+
+`config.toml`:
+
+```
+# Add some custom output type definitions:
+[[outputFormats]]
+name = "Calendar"
+mediaType = "text/calendar+ics"
+protocol = "webcal://"
+isPlainText = true
+
+[[outputFormats]]
+name = "JSON"
+mediaType = "application/json" # Will get its file suffix from the sub-type, i.e. "json"
+isPlainText = true
+
+[[outputFormats]]
+name = "AMP"
+mediaType = "text/html"
+path = "amp"
+
+```
+
+Note that Hugo well hard code a predefined list of the most common output types (not sure what that would be, suggestions welcome) with the obvious identifiers and sensible defaults: So whenever you want them, you can just say "json, yaml, amp ..." etc.
+
+Page front matter:
+
+```
+title = "My Home Page"
+outputs = ["html", "rss", "json", "calendar", "amp" ]
+```
+
+About the `outputs` in the page front matter:
+
+* If none is provided, it defaults to the current behaviour (i.e. HTML for all pages and RSS for the list pages)
+* If some are provided, no defaults will be added. So, if you want the plain HTML representation, you must be explicit. This way you can have the home page as JSON only if you want.
+* The names used are case-insensitive and must match either a definition in `config.toml` or the standard set.
+
+{{% note %}}
+It should also be possible to set a list of default output formats in `config.toml`, avoiding the need to repeat the `outputs` list in thousands of pages, with a way to restrict each type to a set of pages (using `Kind`, probably).
+{{% /note %}}

content/content-management/formats.md

@@ -8,8 +8,8 @@ lastmod: 2017-04-06
 categories: [content management]
 tags: [markdown,asciidoc,mmark,content format]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 20
 weight: 20	#rem
 draft: false

content/content-management/front-matter.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-24
 categories: [content management]
 tags: ["front matter", "yaml", "toml", "json", "metadata", "archetypes"]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 30
 weight: 30	#rem
 draft: false

content/content-management/menus.md

@@ -9,8 +9,8 @@ categories: [content management]
 tags: [menus]
 draft: false
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 120
 weight: 120	#rem
 aliases: [/extras/menus/]
@@ -111,7 +111,7 @@ Take the advanced approach if more control is required. All of the menu entry pr
 ```yaml
 ---
 menu:
-  main:
+  docs:
     parent: 'extras'
     weight: 20
 ---
@@ -145,7 +145,7 @@ Here's the equivalent snippet in a `config.yaml`:
 ```yaml
 ---
 menu:
-  main:
+  docs:
       - Name: "about hugo"
         Pre: "<i class='fa fa-heart'></i>"
         Weight: -110

content/content-management/multilingual.md

@@ -8,8 +8,8 @@ lastmod: 2017-01-10
 categories: [content management]
 tags: [multilingual,i18n, internationalization]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 150
 weight: 150	#rem
 draft: false

content/content-management/organization.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [content management]
 tags: [sections,content,organization,fundamentals]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 10
 weight: 10	#rem
 draft: false

content/content-management/sections.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [content management]
 tags: [lists,sections,content types,organization]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 50
 weight: 50	#rem
 draft: false

content/content-management/shortcodes.md

@@ -7,8 +7,8 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-03-31
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 25
 weight: 25	#rem
 categories: [content management]

content/content-management/summaries.md

@@ -8,8 +8,8 @@ lastmod: 2017-01-10
 categories: [content management]
 tags: [summaries,abstracts,read more]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 90
 weight: 90	#rem
 draft: false

content/content-management/taxonomies.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 tags: [taxonomies,metadata,front matter,terms]
 categories: [content management]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 80
 weight: 80	#rem
 draft: false

content/content-management/toc.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [content management]
 tags: [table of contents, toc]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 130
 weight: 130	#rem
 draft: false

content/content-management/types.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [content management]
 tags: [lists,sections,content types,types,organization]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 60
 weight: 60	#rem
 draft: false

content/content-management/urls.md

@@ -8,8 +8,8 @@ lastmod: 2017-03-09
 tags: [aliases,redirects,permalinks,urls]
 categories: [content management]
 menu:
-  main:
-    parent: "Content Management"
+  docs:
+    parent: "content-management"
     weight: 110
 weight: 110	#rem
 draft: false

content/contribute/_index.md

@@ -1,6 +1,6 @@
 ---
 title: Contributing to the Hugo Project
-linktitle: Overview
+linktitle: Contributing
 description: Contribute to Hugo development and documentation.
 date: 2017-02-01
 publishdate: 2017-02-01
@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [contribute]
 tags: []
 menu:
-  main:
-    parent: "Contribute"
+  docs:
+    parent: "contribute"
     weight: 01
 weight: 01	#rem
 draft: false
@@ -20,4 +20,4 @@ toc: false
 
 Hugo relies heavily on the enthusiasm and participation of the open-source community. We need your support in both its development and documentation.
 
-Hugo's contribution guidelines are [detailed in a `CONTRIBUTING.md`](https://github.com/spf13/hugo/blob/master/CONTRIBUTING.md) in the Hugo source repository on GitHub.
+Hugo's contribution guidelines are [detailed in a `CONTRIBUTING.md`](https://github.com/spf13/hugo/blob/master/CONTRIBUTING.md) in the Hugo source repository on GitHub.

content/contribute/development.md

@@ -9,8 +9,8 @@ categories: [contribute]
 tags: [dev,open source]
 authors: [digitalcraftsman]
 menu:
-  main:
-    parent: "Contribute"
+  docs:
+    parent: "contribute"
     weight: 10
 weight: 10
 sections_weight: 10
@@ -411,4 +411,4 @@ Feel free to [open an issue][newissue] if you think you found a bug or you have
 [releases]: /getting-started/
 [setupgopath]: https://golang.org/doc/code.html#Workspaces
 [thinkful]: https://www.thinkful.com/learn/github-pull-request-tutorial/
-[trygit]: https://try.github.io/levels/1/challenges/1
+[trygit]: https://try.github.io/levels/1/challenges/1

content/contribute/documentation.md

@@ -8,8 +8,8 @@ lastmod: 2017-02-01
 categories: [contribute]
 tags: [docs,documentation,community, contribute]
 menu:
-  main:
-    parent: "Contribute"
+  docs:
+    parent: "contribute"
     weight: 20
 weight: 20
 sections_weight: 20

content/contribute/themes.md

@@ -9,8 +9,8 @@ categories: [contribute]
 tags: [contribute,themes,design]
 authors: [digitalcraftsman]
 menu:
-  main:
-    parent: "Contribute"
+  docs:
+    parent: "contribute"
     weight: 30
 weight: 30
 sections_weight: 30

content/functions/GetPage.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [sections,lists,indexes]
 ns:
 signature: ["GetPage TYPE PATH"]

content/functions/_index.md

@@ -1,6 +1,5 @@
 ---
-title: Functions Quick Reference
-linktitle: Quick Reference
+title: Functions
 description: Comprehensive list of Hugo templating functions, including basic and advanced usage examples.
 godocref:
 date: 2017-02-01
@@ -8,9 +7,8 @@ publishdate: 2017-02-01
 lastmod: 2017-02-01
 tags: []
 menu:
-  main:
-    parent: "Functions"
-    weight: 01
+  docs:
+    parent: "functions"
 weight: 01	#rem
 draft: false
 aliases: [/layout/functions/]
@@ -18,4 +16,4 @@ aliases: [/layout/functions/]
 
 Go templates are lightweight but extensible. Go itself supplies built-in functions, including comparison operators and other basic tools. These are listed in the [Go template documentation][gofuncs]. Hugo has added additional functions to the basic template logic.
 
-[gofuncs]: http://golang.org/pkg/text/template/#hdr-Functions
+[gofuncs]: http://golang.org/pkg/text/template/#hdr-Functions

content/functions/abslangurl.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [multilingual,i18n,urls]
 ns:
 signature: ["absLangURL INPUT"]

content/functions/absurl.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [urls]
 ns:
 signature: ["absURL INPUT"]

content/functions/adddate.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [dates,time]
 ns:
 signature: ["AddDate YEARS MONTHS DAYS"]

content/functions/after.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [iteration]
 ns:
 signature: ["after INDEX COLLECTION"]

content/functions/apply.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [advanced]
 ns:
 signature: ["apply COLLETION FUNCTION [PARAM...]"]

content/functions/base64.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 relatedfuncs: []
 ns:

content/functions/chomp.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [trim]
 ns:
 signature: ["chomp INPUT"]

content/functions/countrunes.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [counting, word count]
 ns:
 signature: ["countrunes INPUT"]

content/functions/countwords.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [counting, word count]
 ns:
 signature: ["countwords INPUT"]

content/functions/dateformat.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [dates,time,strings]
 ns:
 signature: ["dateFormat LAYOUT INPUT"]

content/functions/default.md

@@ -9,6 +9,9 @@ publishdate: 2017-02-01
 lastmod: 2017-02-01
 tags: [defaults]
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 toc:
 ns:
 signature: ["default DEFAULT INPUT"]
@@ -102,8 +105,3 @@ Using `with`:
 => Sane Defaults
 ```
 {{% /code %}}
-
-
-
-
-

content/functions/delimit.md

@@ -8,6 +8,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [iteration]
 toc: false
 ns:

content/functions/dict.md

@@ -8,6 +8,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-26
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [dictionary]
 ns:
 signature: ["dict KEY VALUE [KEY VALUE]..."]

content/functions/echoparam.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["echoParam DICTIONARY KEY"]

content/functions/emojify.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings,emojis]
 ns:
 signature: ["emojify INPUT"]

content/functions/eq.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [operators,logic]
 ns:
 signature: ["eq ARG1 ARG2"]

content/functions/findRe.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [regex]
 ns:
 signature: ["findRE PATTERN INPUT [LIMIT]"]

content/functions/first.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [iteration]
 ns:
 signature: ["first LIMIT COLLECTION"]

content/functions/format.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [dates,time]
 ns:
 signature: ["Format FORMAT"]

content/functions/get.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [shortcodes]
 ns:
 signature: ["Get INDEX", "Get KEY"]

content/functions/getenv.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["getenv VARIABLE"]

content/functions/hasPrefix.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["hasPrefix STRING PREFIX"]

content/functions/haschildren.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [menus]
 toc:
 ns:

content/functions/hasmenucurrent.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [menus]
 ns:
 signature: ["HasMenuCurrent"]

content/functions/highlight.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [highlighting,pygments,code blocks,syntax]
 ns:
 signature: ["highlight INPUT"]

content/functions/htmlEscape.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings, html]
 ns:
 signature: ["htmlEscape INPUT"]

content/functions/htmlUnescape.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["htmlUnescape INPUT"]

content/functions/humanize.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings,casing]
 ns:
 signature: ["humanize INPUT"]

content/functions/i18n.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [internationalization,i18n,multilingual]
 ns:
 signature: ["i18n KEY", "T KEY"]

content/functions/imageConfig.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [images]
 ns:
 signature: ["imageConfig PATH"]

content/functions/in.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings]
 ns:
 signature: ["in SET ITEM"]

content/functions/index-function.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["index COLLECTION INDEX", "index COLLECTION KEY"]

content/functions/int.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings,integers]
 ns:
 signature: ["int INPUT"]

content/functions/intersect.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["intersect SET1 SET2"]

content/functions/ismenucurrent.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [menus]
 ns:
 signature: ["IsMenuCurrent"]

content/functions/isset.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: []
 ns:
 signature: ["isset COLLECTION INDEX", "isset COLLECTION KEY"]

content/functions/jsonify.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings,json]
 ns:
 signature: ["jsonify INPUT"]

content/functions/last.md

@@ -8,6 +8,9 @@ publishdate: 2017-02-01
 lastmod: 2017-02-01
 tags: []
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 toc:
 ns:
 signature: ["last INDEX COLLECTION"]

content/functions/lower.md

@@ -7,6 +7,9 @@ date: 2017-02-01
 publishdate: 2017-02-01
 lastmod: 2017-02-01
 categories: [functions]
+menu:
+  docs:
+    parent: "functions"
 tags: [strings,casing]
 ns:
 signature: ["lower INPUT"]