mirror of https://github.com/gohugoio/hugo
2.2 KiB
2.2 KiB
title | description | categories | keywords | action | toc | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
Sitemap | Returns the sitemap settings for the given page as defined in front matter, falling back to the sitemap settings as defined in the site configuration. |
|
true |
Access to the Sitemap
method on a Page
object is restricted to sitemap templates.
Methods
- changefreq
- (
string
) How frequently a page is likely to change. Valid values arealways
,hourly
,daily
,weekly
,monthly
,yearly
, andnever
. With the default value of""
Hugo will omit this field from the sitemap. See details.
{{ .Sitemap.ChangeFreq }}
- disable {{< new-in 0.125.0 >}}
- (
bool
) Whether to disable page inclusion. Default isfalse
. Set totrue
in front matter to exclude the page.
{{ .Sitemap.Disable }}
- priority
- (
float
) The priority of a page relative to any other page on the site. Valid values range from 0.0 to 1.0. With the default value of-1
Hugo will omit this field from the sitemap. See details.
{{ .Sitemap.Priority }}
Example
With this site configuration:
{{< code-toggle file=hugo >}} [sitemap] changeFreq = 'monthly' {{< /code-toggle >}}
And this content:
{{< code-toggle file=content/news.md fm=true >}} title = 'News' [sitemap] changeFreq = 'hourly' {{< /code-toggle >}}
And this simplistic sitemap template:
{{< code file=layouts/_default/sitemap.xml >}} {{ printf "" | safeHTML }} {{ range .Pages }} {{ .Permalink }} {{ if not .Lastmod.IsZero }} {{ .Lastmod.Format "2006-01-02T15:04:05-07:00" | safeHTML }} {{ end }} {{ with .Sitemap.ChangeFreq }} {{ . }} {{ end }} {{ end }} {{< /code >}}
The change frequency will be hourly
for the news page, and monthly
for other pages.