サイトマップテンプレート

Hugo には組み込みのサイトマップテンプレートが用意されています。

On this page

概要

Hugo の組み込みサイトマップテンプレートは、サイトマッププロトコルの v0.9 に準拠しています。

単一言語プロジェクトでは、Hugo は組み込みの sitemap.xml テンプレートを使用して、publishDir のルートに sitemap.xml ファイルを生成します。

多言語プロジェクトで、Hugo は以下を生成します。

変更頻度と優先度のデフォルト値、および生成されるファイル名は、サイト設定で設定してください。

sitemap:
  changefreq: monthly
  filename: sitemap.xml
  priority: 0.5

[sitemap]
  changefreq = 'monthly'
  filename = 'sitemap.xml'
  priority = 0.5

{
   "sitemap": {
      "changefreq": "monthly",
      "filename": "sitemap.xml",
      "priority": 0.5
   }
}

changefreq: ページが変更される頻度を指定します。有効な値は always、hourly、daily、weekly、monthly、yearly そして never です。デフォルトは "" です (レンダリングされたサイトマップでは変更頻度が省略されます)。
filename: 生成されるファイルの名前です。デフォルトは、 sitemap.xml です。
priority: サイト上の他のページと比較したページの相対的な優先度です。有効な値は 0.0 から 1.0 までです。デフォルトは -1 です (サイトマップのレンダリングでは優先順位が省略されます)。

指定されたページのデフォルト値をフロントマターでオーバーライドします。

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

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

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

組み込みの sitemap.xml テンプレートをオーバーライドするには、以下のいずれかの場所に新しいファイルを作成します。

ページコレクションにアクセスする場合、変更頻度 と 優先度 には、それぞれ .Sitemap.ChangeFreq と .Sitemap.Priority を指定します。

組み込みの sitemapindex.xml テンプレートをオーバーライドするには、以下のいずれかの場所に新しいファイルを作成します。

以下のサイト設定で、サイトマップの生成を無効にすることができます。

disableKinds:
- sitemap

disableKinds = ['sitemap']

{
   "disableKinds": [
      "sitemap"
   ]
}