mirror of
https://github.com/gohugoio/hugo.git
synced 2024-11-29 19:52:09 -05:00
5fd1e74903
``` git subtree add --prefix=docs/ https://github.com/gohugoio/hugoDocs.git master --squash ``` Closes #11925
1.9 KiB
1.9 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
. Default is "" (change frequency omitted from rendered sitemap).
{{ .Sitemap.ChangeFreq }}
- Priority
- (
float
) The priority of a page relative to any other page on the site. Valid values range from 0.0 to 1.0. Default is -1 (priority omitted from rendered sitemap).
{{ .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.