站点地图模板
概述
Hugo 的嵌入式站点地图模板符合站点地图协议的 v0.9 版。 站点地图协议。
对于单语言项目,Hugo 会在 publishDir
的根目录中生成一个 sitemap.xml 文件,使用 嵌入式站点地图模板。
对于多语言项目,Hugo 会生成
- 每个站点(语言)的根目录中的 sitemap.xml 文件,使用 嵌入式站点地图模板
- 使用
publishDir
根目录中的 sitemap.xml 文件,使用 嵌入式站点地图索引模板
配置
这些是站点地图的默认配置值。除非在 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
- (
字符串
)页面可能更改的频率。有效值为always
、hourly
、daily
、weekly
、monthly
、yearly
和never
。使用默认值""
,Hugo 将省略站点地图中的此字段。参见 详情。 - 禁用 v0.125.0 版新增
- (
布尔值
)是否禁用页面包含。默认为false
。在 front matter 中设置为true
以排除页面。 - 文件名
- (
字符串
)生成的名称。默认为sitemap.xml
。 - 优先级
- (
浮点数
)页面相对于站点上任何其他页面的优先级。有效值范围为 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 模板,请在以下任一位置创建一个新文件
- layouts/sitemap.xml
- layouts/_default/sitemap.xml
在遍历页面集合时,分别使用 .Sitemap.ChangeFreq
和 .Sitemap.Priority
访问更改频率和优先级。
要覆盖内置的 sitemapindex.xml 模板,请在以下任一位置创建一个新文件
- layouts/sitemapindex.xml
- layouts/_default/sitemapindex.xml
禁用站点地图生成
您可以在站点配置中禁用站点地图生成
hugo。
disableKinds:
- sitemap
disableKinds = ['sitemap']
{
"disableKinds": [
"sitemap"
]
}