网站地图模板
概述
Hugo 的内置网站地图模板符合 v0.9 的 网站地图协议。
对于单语言项目,Hugo 在 publishDir
的根目录中使用内置的 sitemap.xml 模板生成一个 sitemap.xml 文件。
对于多语言项目,Hugo 生成:
- 在每个站点(语言)的根目录中使用内置的 sitemap.xml 模板生成一个 sitemap.xml 文件
- 在
publishDir
的根目录中使用内置的 sitemapindex.xml 模板生成一个 sitemap.xml 文件
配置
在您的站点配置中设置 更新频率、优先级 的默认值,以及生成的文件名。
hugo.
sitemap:
changeFreq: ""
filename: sitemap.xml
priority: -1
[sitemap]
changeFreq = ''
filename = 'sitemap.xml'
priority = -1
{
"sitemap": {
"changeFreq": "",
"filename": "sitemap.xml",
"priority": -1
}
}
- changefreq
- 页面可能更改的频率。有效值为
always
,hourly
,daily
,weekly
,monthly
,yearly
, 和never
。默认值为""
(在生成的 sitemap 中省略更新频率)。 - filename
- 生成文件的名称,默认为
sitemap.xml
。 - priority
- 页面相对于站点上的其他页面的优先级。有效值为 0.0 到 1.0。默认值为
-1
(在生成的 sitemap 中省略优先级)。
覆盖默认值
在前置元数据中覆盖给定页面的默认值。
news.md
---
sitemap:
changefreq: weekly
priority: 0.8
title: 新闻
---
+++
title = '新闻'
[sitemap]
changefreq = 'weekly'
priority = 0.8
+++
{
"sitemap": {
"changefreq": "weekly",
"priority": 0.8
},
"title": "新闻"
}
覆盖内置模板
要覆盖内置的 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"
]
}