2.3 KiB
title | description | categories | keywords | params | |||||||
---|---|---|---|---|---|---|---|---|---|---|---|
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. |
|
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 are always
, hourly
, daily
, weekly
, monthly
, yearly
, and never
. 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 is false
. Set to true
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:
{{ printf "<?xml version=\"1.0\" encoding=\"utf-8\" standalone=\"yes\"?>" | safeHTML }}
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9"
xmlns:xhtml="http://www.w3.org/1999/xhtml">
{{ range .Pages }}
<url>
<loc>{{ .Permalink }}</loc>
{{ if not .Lastmod.IsZero }}
<lastmod>{{ .Lastmod.Format "2006-01-02T15:04:05-07:00" | safeHTML }}</lastmod>
{{ end }}
{{ with .Sitemap.ChangeFreq }}
<changefreq>{{ . }}</changefreq>
{{ end }}
</url>
{{ end }}
</urlset>
The change frequency will be hourly
for the news page, and monthly
for other pages.