Namespace functions and methods

.cspell.json

@@ -335,7 +335,7 @@
     "مدونتي"
   ],
   "language": "en,en-US,de,fr",
-  "allowCompoundWords": true,
+  "allowCompoundWords": false,
   "files": [
     "**/*.md"
   ],
@@ -354,7 +354,8 @@
     "**/node_modules/**",
     "*.min.*",
     "**/news/*",
-    "**/showcase/*"
+    "**/showcase/*",
+    "**/content-management/emoji-shortcodes.md"
   ],
   "useGitignore": true,
   "enabled": true

README.md

@@ -19,12 +19,11 @@ Spelling fixes are most welcomed, and if you want to contribute longer sections
 * For example, try to find short snippets that teaches people about the concept. If the example is also useful as-is (copy and paste), then great. Don't list long and similar examples just so people can use them on their sites.
 * Hugo has users from all over the world, so easy to understand and [simple English](https://simple.wikipedia.org/wiki/Basic_English) is good.
 
-
 ## Edit the theme
 
 If you want to do docs-related theme changes, the simplest way is to have both `hugoDocs` and `gohugoioTheme` cloned as sibling directories, and then run:
 
-```
+```sh
 HUGO_MODULE_WORKSPACE=hugo.work hugo server --ignoreVendorPaths "**"
 ```
 
@@ -37,15 +36,15 @@ HUGO_MODULE_WORKSPACE=hugo.work hugo server --ignoreVendorPaths "**"
 
 To view the documentation site locally, you need to clone this repository:
 
-```bash
+```sh
 git clone https://github.com/gohugoio/hugoDocs.git
 ```
 
 Also note that the documentation version for a given version of Hugo can also be found in the `/docs` sub-folder of the [Hugo source repository](https://github.com/gohugoio/hugo).
 
 Then to view the docs in your browser, run Hugo and open up the link:
 
-```bash
+```sh
 ▶ hugo server
 
 Started building sites ...

archetypes/functions.md

@@ -1,14 +1,11 @@
 ---
 title: {{ replace .File.ContentBaseName "-" " " | title }}
 description:
-categories: [functions]
+categories: []
 keywords: []
-menu:
-  docs:
-    parent: functions
-function:
+action:
   aliases: []
+  related: []
   returnType:
   signatures: []
-relatedFunctions: []
 ---

archetypes/methods.md

@@ -0,0 +1,10 @@
+---
+title: {{ replace .File.ContentBaseName "-" " " | title }}
+description:
+categories: []
+keywords: []
+action:
+  related: []
+  returnType:
+  signatures: []
+---

archetypes/showcase/bio.md

@@ -3,6 +3,5 @@ Add some **general info** about {{ replace .Name "-" " " | title }} here.
 
 The site is built by:
 
-* [Person 1](https://example.com)
-* [Person 1](https://example.com)
-
+* [Person 1](https://example.org)
+* [Person 1](https://example.org)

config/_default/menus/menus.en.toml

@@ -1,142 +1,152 @@
 [[docs]]
-  name = "About Hugo"
-  weight = 10
-  identifier = "about"
-  url = "/about/"
+identifier = 'about'
+name = 'About Hugo'
+pageRef = '/about/'
+weight = 10
 
 [[docs]]
-  name = "Installation"
-  weight = 20
-  identifier = "installation"
-  url = "/installation/"
+name = 'Installation'
+weight = 20
+identifier = 'installation'
+pageRef = '/installation/'
 
 [[docs]]
-  name = "Getting started"
-  weight = 30
-  identifier = "getting-started"
-  url = "/getting-started/"
+name = 'Getting started'
+weight = 30
+identifier = 'getting-started'
+pageRef = '/getting-started/'
 
 [[docs]]
-  name = "Hugo Modules"
-  weight = 40
-  identifier = "modules"
-  post = "break"
-  url = "/hugo-modules/"
+name = 'Hugo Modules'
+weight = 40
+identifier = 'modules'
+post = 'break'
+pageRef = '/hugo-modules/'
 
-# Core menus
+[[docs]]
+name = 'Content management'
+weight = 50
+identifier = 'content-management'
+post = 'expanded'
+pageRef = '/content-management/'
+
+[[docs]]
+name = 'Templates'
+weight = 60
+identifier = 'templates'
+pageRef = '/templates/'
 
 [[docs]]
-  name = "Content management"
-  weight = 50
-  identifier = "content-management"
-  post = "expanded"
-  url = "/content-management/"
+name = 'Functions'
+weight = 70
+identifier = 'functions'
+pageRef = '/functions/'
 
 [[docs]]
-  name = "Templates"
-  weight = 60
-  identifier = "templates"
-  url = "/templates/"
+name = 'Methods'
+weight = 80
+identifier = 'methods'
+pageRef = '/methods/'
 
 [[docs]]
-  name = "Functions"
-  weight = 70
-  identifier = "functions"
-  url = "/functions/"
+name = 'Quick reference'
+weight = 90
+identifier = 'quick-reference'
+pageRef = '/quick-reference/'
 
 [[docs]]
-  name = "Variables"
-  weight = 80
-  identifier = "variables"
-  url = "/variables/"
+name = 'Variables'
+weight = 95
+identifier = 'variables'
+pageRef = '/variables/'
 
 [[docs]]
-  name = "Hugo Pipes"
-  weight = 90
-  identifier = "hugo-pipes"
-  url = "/hugo-pipes/"
+name = 'Hugo Pipes'
+weight = 100
+identifier = 'hugo-pipes'
+pageRef = '/hugo-pipes/'
 
 [[docs]]
-  name = "CLI"
-  weight = 100
-  post = "break"
-  identifier = "commands"
-  url = "/commands/"
+name = 'CLI'
+weight = 110
+post = 'break'
+identifier = 'commands'
+pageRef = '/commands/'
 
 # Low level items
 
 [[docs]]
-  name = "Troubleshooting"
-  weight = 110
-  identifier = "troubleshooting"
-  url = "/troubleshooting/"
+name = 'Troubleshooting'
+weight = 120
+identifier = 'troubleshooting'
+pageRef = '/troubleshooting/'
 
 [[docs]]
-  name = "Developer tools"
-  weight = 120
-  identifier = "developer-tools"
-  url = "/tools/"
+name = 'Developer tools'
+weight = 130
+identifier = 'developer-tools'
+pageRef = '/tools/'
 
 [[docs]]
-  name = "Hosting and deployment"
-  weight = 130
-  identifier = "hosting-and-deployment"
-  url = "/hosting-and-deployment/"
+name = 'Hosting and deployment'
+weight = 140
+identifier = 'hosting-and-deployment'
+pageRef = '/hosting-and-deployment/'
 
 [[docs]]
-  name = "Contribute"
-  weight = 140
-  post = "break"
-  identifier = "contribute"
-  url = "/contribute/"
+name = 'Contribute'
+weight = 150
+post = 'break'
+identifier = 'contribute'
+pageRef = '/contribute/'
 
 ######## QUICKLINKS
 
 [[quicklinks]]
-  name = "Fundamentals"
-  weight = 1
-  identifier = "fundamentals"
-  url = "/tags/fundamentals/"
+identifier = 'fundamentals'
+name = 'Fundamentals'
+pageRef = '/tags/fundamentals/'
+weight = 1
 
 ######## GLOBAL ITEMS TO BE SHARED WITH THE HUGO SITES
 
 [[global]]
-    name = "News"
-    weight = 1
-    identifier = "news"
-    url = "/news/"
+name = 'News'
+weight = 1
+identifier = 'news'
+pageRef = '/news/'
 
 [[global]]
-  name = "Docs"
-  weight = 5
-  identifier = "docs"
-  url = "/documentation/"
+name = 'Docs'
+weight = 5
+identifier = 'docs'
+url = '/documentation/'
 
 [[global]]
-  name = "Themes"
-  weight = 10
-  identifier = "themes"
-  url = "https://themes.gohugo.io/"
+name = 'Themes'
+weight = 10
+identifier = 'themes'
+url = 'https://themes.gohugo.io/'
 
 [[global]]
-  name = "Showcase"
-  weight = 20
-  identifier = "showcase"
-  url = "/showcase/"
+name = 'Showcase'
+weight = 20
+identifier = 'showcase'
+pageRef = '/showcase/'
 
 # Anything with a weight > 100 gets an external icon
 
 [[global]]
-  name = "Community"
-  weight = 150
-  icon = true
-  identifier = "community"
-  post = "external"
-  url = "https://discourse.gohugo.io/"
+name = 'Community'
+weight = 150
+icon = true
+identifier = 'community'
+post = 'external'
+url = 'https://discourse.gohugo.io/'
 
 [[global]]
-  name = "GitHub"
-  weight = 200
-  identifier = "github"
-  post = "external"
-  url = "https://github.com/gohugoio/hugo"
+name = 'GitHub'
+weight = 200
+identifier = 'github'
+post = 'external'
+url = 'https://github.com/gohugoio/hugo'

config/_default/params.toml

@@ -22,3 +22,6 @@ flex_box_interior_classes = "flex-auto w-100 w-40-l mr3 mb3 bg-white ba b--moon-
 
 [social]
 twitter = "GoHugoIO"
+
+[render_hooks.link]
+errorLevel = 'warning' # ignore (default), warning, or error (fails the build)

content/en/about/hugo-and-gdpr.md

@@ -29,7 +29,7 @@ toc: true
 
 Below are all privacy settings and their default value. These settings need to be put in your site configuration (e.g. `hugo.toml`).
 
-{{< code-toggle file="hugo" >}}
+{{< code-toggle file=hugo >}}
 [privacy]
 [privacy.disqus]
 disable = false
@@ -58,7 +58,7 @@ privacyEnhanced = false
 
 An example privacy configuration that disables all the relevant services in Hugo. With this configuration, the other settings will not matter.
 
-{{< code-toggle file="hugo" >}}
+{{< code-toggle file=hugo >}}
 [privacy]
 [privacy.disqus]
 disable = true
@@ -98,7 +98,7 @@ simple
 
 **Note:** If you use the _simple mode_ for Instagram and a site styled with Bootstrap 4, you may want to disable the inline styles provided by Hugo:
 
- {{< code-toggle file="hugo" >}}
+{{< code-toggle file=hugo >}}
 [services]
 [services.instagram]
 disableInlineCSS = true
@@ -114,7 +114,7 @@ simple
 
 **Note:** If you use the _simple mode_ for Twitter, you may want to disable the inline styles provided by Hugo:
 
- {{< code-toggle file="hugo" >}}
+{{< code-toggle file=hugo >}}
 [services]
 [services.twitter]
 disableInlineCSS = true