diff --git a/docs/README.md b/docs/README.md
index 072714a02..730ad5fc8 100644
--- a/docs/README.md
+++ b/docs/README.md
@@ -19,6 +19,15 @@ 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:
+
+```
+HUGO_MODULE_WORKSPACE=hugo.work hugo server --ignoreVendorPaths "**"
+```
+
## Branches
* The `master` branch is where the site is automatically built from, and is the place to put changes relevant to the current Hugo version.
diff --git a/docs/_vendor/github.com/gohugoio/gohugoioTheme/data/sponsors.toml b/docs/_vendor/github.com/gohugoio/gohugoioTheme/data/sponsors.toml
index 1e46fc07c..adf26ecdb 100644
--- a/docs/_vendor/github.com/gohugoio/gohugoioTheme/data/sponsors.toml
+++ b/docs/_vendor/github.com/gohugoio/gohugoioTheme/data/sponsors.toml
@@ -4,12 +4,6 @@
logo = "/images/sponsors/linode-logo_standard_light_medium.png"
utm_campaign = "hugosponsor"
-[[banners]]
- name = "eSolia"
- link = "https://esolia.com/post/why-did-esolia-choose-hugo/"
- logo = "/images/sponsors/esolia-logo.svg"
- utm_campaign = "hugosponsor"
-
[[banners]]
name = "ButterCMS"
link = "https://buttercms.com/hugo-cms/"
@@ -17,6 +11,13 @@
utm_campaign = "sponsorship"
bgcolor = "#131A3E"
+[[banners]]
+ name = "Your Company?"
+ link = "https://bep.is/en/hugo-sponsor-2023-01/"
+ logo = "/images/sponsors/your-company.svg"
+ utm_campaign = "hugosponsor"
+ bgcolor = "#004887"
+
#hugohome
#hugofooter
#hugogithub
diff --git a/docs/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/baseof.html b/docs/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/baseof.html
index 04261a886..5767f078b 100644
--- a/docs/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/baseof.html
+++ b/docs/_vendor/github.com/gohugoio/gohugoioTheme/layouts/_default/baseof.html
@@ -1,75 +1,119 @@
-
-
-
-
{{ .Title }}
@@ -46,20 +47,20 @@ This single page template makes use of Hugo [base templates], the [`.Format` fun
{{ .Date.Format "Mon Jan 2, 2006" }}
{{ .WordCount }} Words
- {{ with .Params.topics }}
-
- {{ range . }}
- - {{ . }}
+ {{ with .GetTerms "topics" }}
+
{{ end }}
-
- {{ end }}
- {{ with .Params.tags }}
-
- {{ end }}
{{ with .PrevInSection }}
@@ -81,7 +82,7 @@ To easily generate new instances of a content type (e.g., new `.md` files in a s
[content type]: /content-management/types/
[directory structure]: /getting-started/directory-structure/
[dry]: https://en.wikipedia.org/wiki/Don%27t_repeat_yourself
-[`.Format` function]: /functions/format/
+[`.format` function]: /functions/format/
[front matter]: /content-management/front-matter/
[pagetaxonomy]: /templates/taxonomy-templates/#display-a-single-piece-of-contents-taxonomies
[pagevars]: /variables/page/
diff --git a/docs/content/en/tools/frontends.md b/docs/content/en/tools/frontends.md
index 9f52c4c67..7ad44df53 100644
--- a/docs/content/en/tools/frontends.md
+++ b/docs/content/en/tools/frontends.md
@@ -26,5 +26,4 @@ toc: false
## Commercial Services
- [DATOCMS](https://www.datocms.com) DatoCMS is a fully customizable administrative area for your static websites. Use your favorite website generator, let your clients publish new content independently, and the host the site anywhere you like.
-- [Forestry.io](https://forestry.io/). Forestry is a git-backed CMS for Hugo, Gatsby, Jekyll and VuePress websites with support for GitHub, GitLab, Bitbucket and Azure Devops. Forestry provides a nice user interface to edit and model content for non technical editors. It supports S3, Cloudinary and Netlify Large Media integrations for storing media. Every time an update is made via the CMS, Forestry will commit changes back to your repo and vice-versa.
- [CloudCannon](https://cloudcannon.com/hugo-cms/). The intuitive Git-based CMS for your Hugo website. CloudCannon syncs changes from your Git repository and pushes content changes back, so your development and content teams are always in sync. Edit all of your content on the page with visual editing, build entire pages with reusable custom components and then publish confidently.
diff --git a/docs/content/zh/_index.md b/docs/content/zh/_index.md
deleted file mode 100644
index d54cb3436..000000000
--- a/docs/content/zh/_index.md
+++ /dev/null
@@ -1,49 +0,0 @@
----
-title: "世界上最快的网站构建框架"
-date: 2017-03-02T12:00:00-05:00
-features:
- - heading: 飞快的速度
- image_path: /images/icon-fast.svg
- tagline: 摩登发布
- copy: Hugo 是同类中最快的工具。生成一页小于 1ms,生成一个站点平均不超过 1s。
-
- - heading: 强大的内容管理
- image_path: /images/icon-content-management.svg
- tagline: 灵活的规则。Hugo 是一个设计师的梦想。
- copy: Hugo 支持无限的内容类型、分类、菜单、动态 API 驱动的内容,以及更多,都不需要插件。
-
- - heading: 短代码
- image_path: /images/icon-shortcodes.svg
- tagline: Hugo 短代码是 Markdown 隐藏的强大功能。
- copy: 我们喜欢美丽简洁的 markdown 语法,但是有时候我们也想要更灵活一些。Hugo 短代码允许既美丽又灵活。
-
- - heading: 内置模板
- image_path: /images/icon-built-in-templates.svg
- tagline: Hugo 有通用的模式让你快速的完成工作。
- copy: Hugo 平台预置的模板会快速实现搜索引擎优化、评论、分析和其他的功能。一行代码,你就完成了。
-
- - heading: 多语言和国际化
- image_path: /images/icon-multilingual2.svg
- tagline: 多语言制作
- copy: Hugo 为多语言站点提供了完整的国际化支持,并且具有与 Hugo 用户在单语言站点中喜爱的相同的简单开发体验。
-
- - heading: 自定义输出
- image_path: /images/icon-custom-outputs.svg
- tagline: HTML 不够用吗?
- copy: Hugo 允许您以多种格式输出内容,包括 JSON 或 AMP,并且可以很容易地创建自己的内容。
-sections:
- - heading: "100 多个主题"
- cta: 看看 Hugo 的主题
- link: https://themes.gohugo.io/
- color_classes: bg-accent-color white
- image: /images/homepage-screenshot-hugo-themes.jpg
- copy: "Hugo 提供了一个强大的主题系统,易于实现,但能够生成即使是最复杂的网站。"
- - heading: "功能模板"
- cta: 开始吧。
- link: templates/
- color_classes: bg-primary-color-light black
- image: /images/home-page-templating-example.png
- copy: "Hugo 基于 Go 的模板提供了恰当的方法来生成从简单到复杂的任何东西。如果你喜欢 Jade/Pug 类似的语法,你也可以使用 Amber、Ace 或三种任意组合。"
----
-
-Hugo 是最受欢迎的开源静态站点生成器之一。凭借惊人的速度和灵活性,Hugo 使建设网站的乐趣再现。
diff --git a/docs/content/zh/about/_index.md b/docs/content/zh/about/_index.md
deleted file mode 100644
index bf19807d9..000000000
--- a/docs/content/zh/about/_index.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-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
deleted file mode 100644
index 2f4b198c1..000000000
--- a/docs/content/zh/content-management/_index.md
+++ /dev/null
@@ -1,20 +0,0 @@
----
-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
-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
deleted file mode 100644
index 1575fd375..000000000
--- a/docs/content/zh/documentation.md
+++ /dev/null
@@ -1,21 +0,0 @@
----
-title: Hugo 说明文档
-linktitle: Hugo
-description: Hugo 是世界上最快的静态网站引擎。它是用 Go (即 Golang) 编程语言所写成,由 bep、spf13 和朋友们共同开发。
-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
deleted file mode 100644
index 286d32e19..000000000
--- a/docs/content/zh/news/_index.md
+++ /dev/null
@@ -1,4 +0,0 @@
----
-title: "Hugo 新闻"
-aliases: [/release-notes/]
----
diff --git a/docs/content/zh/templates/_index.md b/docs/content/zh/templates/_index.md
deleted file mode 100644
index 3cd8df436..000000000
--- a/docs/content/zh/templates/_index.md
+++ /dev/null
@@ -1,19 +0,0 @@
----
-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
deleted file mode 100644
index bf0e9165a..000000000
--- a/docs/content/zh/templates/base.md
+++ /dev/null
@@ -1,131 +0,0 @@
----
-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).
-date: 2017-02-01
-publishdate: 2018-08-11
-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/
-baseof.html`
-2. `/themes//layouts/section/-baseof.html`
-3. `/layouts//baseof.html`
-4. `/themes//layouts//baseof.html`
-5. `/layouts/section/baseof.html`
-6. `/themes//layouts/section/baseof.html`
-7. `/layouts/_default/-baseof.html`
-8. `/themes//layouts/_default/-baseof.html`
-9. `/layouts/_default/baseof.html`
-10. `/themes//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 `posts` section. Hugo picks `layout/section/posts.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 `posts` base template:
-
-1. `/layouts/section/posts-baseof.html`
-2. `/themes/mytheme/layouts/section/posts-baseof.html`
-3. `/layouts/posts/baseof.html`
-4. `/themes/mytheme/layouts/posts/baseof.html`
-5. `/layouts/section/baseof.html`
-6. `/themes/mytheme/layouts/section/baseof.html`
-7. `/layouts/_default/posts-baseof.html`
-8. `/themes/mytheme/layouts/_default/posts-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" >}}
-
-
-
-
- {{ block "title" . }}
-
- {{ .Site.Title }}
- {{ end }}
-
-
-
- {{ block "main" . }}
-
- {{ end }}
- {{ block "footer" . }}
-
- {{ end }}
-
-
-{{< /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" }}
- Posts
- {{ range .Pages }}
-
- {{ .Title }}
- {{ .Content }}
-
- {{ 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:
-
-```
-
-{{ 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" }}
-
- {{ .Title }} – {{ .Site.Title }}
-{{ end }}
-{{ define "main" }}
- {{ .Title }}
- {{ .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/content/zh/tools/_index.md b/docs/content/zh/tools/_index.md
deleted file mode 100644
index a3de7dc76..000000000
--- a/docs/content/zh/tools/_index.md
+++ /dev/null
@@ -1,25 +0,0 @@
----
-title: 开发者工具
-linktitle: 开发者工具概览
-description: 除了 Hugo 强大的命令外,对于 Hugo 开发者还有大量社区开发的工具链。
-date: 2018-05-29
-publishdate: 2018-05-29
-lastmod: 2018-05-29
-categories: [developer tools]
-keywords: []
-menu:
- docs:
- parent: "tools"
- weight: 01
-weight: 01
-sections_weight: 01
-draft: false
-aliases: [/tools/]
----
-
-Hugo 最强大的在于它是活跃的——并总在发展的——开发者社区。除了在[语法高亮][syntax] 中提到的 `highlight` 简码外,该章节中的这些工具和其它项目特色都是由商业服务和开源项目提供,很多就是由像你一样的 Hugo 开发者开发的。
-
-[查看 Hugo 的流行程度与其它静态网站生成器的比较。][staticgen]
-
-[staticgen]: https://staticgen.com
-[syntax]: /tools/syntax-highlighting/
diff --git a/docs/content/zh/tools/search.md b/docs/content/zh/tools/search.md
deleted file mode 100644
index 26b25ea2a..000000000
--- a/docs/content/zh/tools/search.md
+++ /dev/null
@@ -1,31 +0,0 @@
----
-title: 搜索你的 Hugo 网站
-linktitle: 搜索
-description: 为你最新添加的 Hugo 网站看一些开源和商业搜索选择。
-date: 2018-05-29
-publishdate: 2018-05-29
-lastmod: 2018-05-29
-categories: [developer tools]
-keywords: [search,tools]
-menu:
- docs:
- parent: "tools"
- weight: 60
-weight: 60
-sections_weight: 60
-draft: false
-aliases: []
-toc: true
----
-
-静态网站还有动态搜索功能?是的。作为可选方案,来自 Google 或者其它搜索引擎的嵌入式脚本,可以给你的访客提供一个自定义的直接基于你的内容文件索引的搜素。
-
-* [GitHub Gist for Hugo Workflow](https://gist.github.com/sebz/efddfc8fdcb6b480f567). Gist 包含一个为你的网站创建索引的简单流程。它使用简单的 Grunt 脚本索引你所有的内容文件,并且 [lunr.js](http://lunrjs.com/) 会提供搜索结果。
-* [hugo-lunr](https://www.npmjs.com/package/hugo-lunr). 一个使用 [lunr.js](http://lunrjs.com/) 为你的 Hugo 静态网站添加搜索的简单方法。Hugo-lunr 将会给你的 Hugo 项目中任意 html 和 markdown 文件创建一个索引文件。
-* [hugo-lunr-zh](https://www.npmjs.com/package/hugo-lunr-zh). 有点像 Hugo-lunr,但是 Hugo-lunr-zh 能帮助你分割中文关键字。
-* [Github Gist for Fuse.js integration](https://gist.github.com/eddiewebb/735feb48f50f0ddd65ae5606a1cb41ae). 该 gist 显示如何借助 Hugo 已有的构建时间在客户端通过 [Fuse.js](http://fusejs.io/) 生成可搜索的 JSON 索引。尽管 gist 使用 Fuse.js 进行模糊匹配,任何有能力读取 JSON 索引的客户端工具都可以运行。不需要 Hugo 以外, npm、grunt 或者其它构建时工具。
-* [hugo-search-index](https://www.npmjs.com/package/hugo-search-index). 一个包含实现了搜索的 Gulp 任务和内置浏览器脚本的库。Gulp 从项目中的 markdown 文件生成索引。
-
-## 商业搜索服务
-
-* [Algolia](https://www.algolia.com/) 的搜索 API 使得在你的应用和网站中提供一个很好的搜索体验变得简单。Algolia 搜索提供托管的全文本、数字化、分面以及地理定位搜索。
diff --git a/docs/go.mod b/docs/go.mod
index 6f4856f66..25975d5c4 100644
--- a/docs/go.mod
+++ b/docs/go.mod
@@ -2,4 +2,4 @@ module github.com/gohugoio/hugoDocs
go 1.16
-require github.com/gohugoio/gohugoioTheme v0.0.0-20221217122332-1c1752ad8f14 // indirect
+require github.com/gohugoio/gohugoioTheme v0.0.0-20230109120406-12694c4a9456 // indirect
diff --git a/docs/go.sum b/docs/go.sum
index 465e50591..52c3793ca 100644
--- a/docs/go.sum
+++ b/docs/go.sum
@@ -49,3 +49,7 @@ github.com/gohugoio/gohugoioTheme v0.0.0-20221206093948-1408550ab675 h1:wjpYa1cT
github.com/gohugoio/gohugoioTheme v0.0.0-20221206093948-1408550ab675/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
github.com/gohugoio/gohugoioTheme v0.0.0-20221217122332-1c1752ad8f14 h1:K6tPFpi7W0zb89QIf+lNdgdTXfDFemU6NKk46MlX9lQ=
github.com/gohugoio/gohugoioTheme v0.0.0-20221217122332-1c1752ad8f14/go.mod h1:kpw3SS48xZvLQGEXKu8u5XHgXkPvL8DX3oGa07+z8Bs=
+github.com/gohugoio/gohugoioTheme v0.0.0-20221220160735-8ffa1ef883b6 h1:yEoQecRBoLGfc7yTybMD3Mhm03bTScZFYPvwe0p75vA=
+github.com/gohugoio/gohugoioTheme v0.0.0-20221220160735-8ffa1ef883b6/go.mod h1:GOYeAPQJ/ok8z7oz1cjfcSlsFpXrmx6VkzQ5RpnyhZM=
+github.com/gohugoio/gohugoioTheme v0.0.0-20230109120406-12694c4a9456 h1:RSLItaapVjWkqSdQhumAmJkodFDbWMGNZmkVW/AFx0c=
+github.com/gohugoio/gohugoioTheme v0.0.0-20230109120406-12694c4a9456/go.mod h1:GOYeAPQJ/ok8z7oz1cjfcSlsFpXrmx6VkzQ5RpnyhZM=
diff --git a/docs/hugo.work b/docs/hugo.work
new file mode 100644
index 000000000..a3c91ef28
--- /dev/null
+++ b/docs/hugo.work
@@ -0,0 +1,4 @@
+go 1.19
+
+use .
+use ../gohugoioTheme
diff --git a/docs/netlify.toml b/docs/netlify.toml
index 51c25ef3c..4a1e79e8c 100644
--- a/docs/netlify.toml
+++ b/docs/netlify.toml
@@ -3,7 +3,7 @@ publish = "public"
command = "hugo --gc --minify"
[context.production.environment]
-HUGO_VERSION = "0.108.0"
+HUGO_VERSION = "0.109.0"
HUGO_ENV = "production"
HUGO_ENABLEGITINFO = "true"
@@ -11,20 +11,20 @@ HUGO_ENABLEGITINFO = "true"
command = "hugo --gc --minify --enableGitInfo"
[context.split1.environment]
-HUGO_VERSION = "0.108.0"
+HUGO_VERSION = "0.109.0"
HUGO_ENV = "production"
[context.deploy-preview]
command = "hugo --gc --minify --buildFuture -b $DEPLOY_PRIME_URL"
[context.deploy-preview.environment]
-HUGO_VERSION = "0.108.0"
+HUGO_VERSION = "0.109.0"
[context.branch-deploy]
command = "hugo --gc --minify -b $DEPLOY_PRIME_URL"
[context.branch-deploy.environment]
-HUGO_VERSION = "0.108.0"
+HUGO_VERSION = "0.109.0"
[context.next.environment]
HUGO_ENABLEGITINFO = "true"