2014-05-07 06:58:25 +00:00
|
|
|
|
---
|
2014-05-29 22:42:05 +00:00
|
|
|
|
aliases:
|
|
|
|
|
- /layout/sitemap/
|
|
|
|
|
date: 2014-05-07
|
|
|
|
|
linktitle: Sitemap
|
2014-05-07 06:58:25 +00:00
|
|
|
|
menu:
|
|
|
|
|
main:
|
2014-05-29 22:42:05 +00:00
|
|
|
|
parent: layout
|
|
|
|
|
next: /templates/404
|
|
|
|
|
notoc: true
|
|
|
|
|
prev: /templates/rss
|
|
|
|
|
title: Sitemap Template
|
|
|
|
|
weight: 95
|
2014-05-07 06:58:25 +00:00
|
|
|
|
---
|
|
|
|
|
|
|
|
|
|
A single Sitemap template is used to generate the `sitemap.xml` file.
|
2014-08-31 11:08:36 +00:00
|
|
|
|
Hugo automatically comes with this template file. **No work is needed on
|
2014-12-04 16:26:12 +00:00
|
|
|
|
the users' part unless they want to customize `sitemap.xml`.**
|
2014-05-07 06:58:25 +00:00
|
|
|
|
|
|
|
|
|
This page is of the type "node" and have all the [node
|
|
|
|
|
variables](/layout/variables/) available to use in this template
|
|
|
|
|
along with Sitemap-specific ones:
|
|
|
|
|
|
|
|
|
|
**.Sitemap.ChangeFreq** The page change frequency<br>
|
|
|
|
|
**.Sitemap.Priority** The priority of the page<br>
|
|
|
|
|
|
|
|
|
|
In addition to the standard node variables, the homepage has access to all
|
|
|
|
|
site pages through `.Data.Pages`.
|
|
|
|
|
|
2014-12-04 16:26:12 +00:00
|
|
|
|
If provided, Hugo will use `/layouts/sitemap.xml` instead of the internal
|
2014-05-27 22:32:57 +00:00
|
|
|
|
one.
|
2014-05-07 06:58:25 +00:00
|
|
|
|
|
2014-05-27 22:32:57 +00:00
|
|
|
|
## Hugo’s sitemap.xml
|
2014-05-07 06:58:25 +00:00
|
|
|
|
|
|
|
|
|
This template respects the version 0.9 of the [Sitemap
|
|
|
|
|
Protocol](http://www.sitemaps.org/protocol.html).
|
|
|
|
|
|
2014-05-15 13:58:55 +00:00
|
|
|
|
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
|
|
|
|
|
{{ range .Data.Pages }}
|
|
|
|
|
<url>
|
|
|
|
|
<loc>{{ .Permalink }}</loc>
|
2015-03-18 06:44:12 +00:00
|
|
|
|
<lastmod>{{ safeHTML ( .Date.Format "2006-01-02T15:04:05-07:00" ) }}</lastmod>{{ with .Sitemap.ChangeFreq }}
|
2014-05-15 13:58:55 +00:00
|
|
|
|
<changefreq>{{ . }}</changefreq>{{ end }}{{ if ge .Sitemap.Priority 0.0 }}
|
|
|
|
|
<priority>{{ .Sitemap.Priority }}</priority>{{ end }}
|
|
|
|
|
</url>
|
|
|
|
|
{{ end }}
|
|
|
|
|
</urlset>
|
2014-05-07 06:58:25 +00:00
|
|
|
|
|
2014-12-04 16:26:12 +00:00
|
|
|
|
***Important:** Hugo will automatically add the following header line to this file
|
|
|
|
|
on render. Please don't include this in the template as it's not valid HTML.*
|
2014-05-07 06:58:25 +00:00
|
|
|
|
|
|
|
|
|
<?xml version="1.0" encoding="utf-8" standalone="yes" ?>
|
2015-08-06 05:39:49 +00:00
|
|
|
|
|
|
|
|
|
## Configuring sitemap.xml
|
|
|
|
|
|
|
|
|
|
Defaults for `<changefreq>` and `<priority>` values can be set in the site's config file, e.g.:
|
|
|
|
|
|
|
|
|
|
[sitemap]
|
|
|
|
|
changefreq = "monthly"
|
|
|
|
|
priority = 0.5
|
|
|
|
|
|
|
|
|
|
The same fields can be specified in an individual page's front matter in order to override the value for that page.
|