站点地图模板

概述

Hugo 的嵌入式站点地图模板符合站点地图协议的 v0.9 版本。

对于单语言项目，Hugo 使用嵌入式站点地图模板在 publishDir 的根目录下生成一个 sitemap.xml 文件。

对于多语言项目，Hugo 会生成：

这些是站点地图的默认配置值。除非在 front matter 中被覆盖，否则它们适用于所有页面。

hugo.

sitemap:
  changeFreq: ""
  disable: false
  filename: sitemap.xml
  priority: -1

[sitemap]
  changeFreq = ''
  disable = false
  filename = 'sitemap.xml'
  priority = -1

{
   "sitemap": {
      "changeFreq": "",
      "disable": false,
      "filename": "sitemap.xml",
      "priority": -1
   }
}

changefreq: (string) 页面更改的频率。有效值为 always 、 hourly 、 daily 、 weekly 、 monthly 、 yearly 和 never 。使用默认值 "" 时，Hugo 将省略站点地图中的此字段。参见详情。
disable New in v0.125.0: (bool) 是否禁用页面包含。默认为 false 。在 front matter 中设置为 true 以排除页面。
filename: (string) 生成的文件名。默认为 sitemap.xml 。
priority: (float) 页面相对于站点上任何其他页面的优先级。有效值范围为 0.0 到 1.0。使用默认值 -1 时，Hugo 将省略站点地图中的此字段。参见详情。

在 front matter 中覆盖给定页面的默认值。

news.md

---
sitemap:
  changefreq: weekly
  disable: true
  priority: 0.8
title: News
---

+++
title = 'News'
[sitemap]
  changefreq = 'weekly'
  disable = true
  priority = 0.8
+++

{
   "sitemap": {
      "changefreq": "weekly",
      "disable": true,
      "priority": 0.8
   },
   "title": "News"
}

要覆盖内置的 sitemap.xml 模板，请在以下任一位置创建一个新文件：

在遍历页面集合时，分别使用 .Sitemap.ChangeFreq 和 .Sitemap.Priority 访问 更改频率 和 优先级 。

要覆盖内置的 sitemapindex.xml 模板，请在以下任一位置创建一个新文件：

您可以在站点配置中禁用站点地图生成：

hugo.

disableKinds:
- sitemap

disableKinds = ['sitemap']

{
   "disableKinds": [
      "sitemap"
   ]
}