Middleman-Sitemap-Xml-Generator

This extension is a forked and slightly extended version of Middleman Search Engine Sitemap by Pete Nicholls.

Note that this extension has been forked from the release tagged as v1.3.0 to support Middleman-v3.

Please refer to the original if you want to get the latest release or a version for Middleman-v4.

Because I'm not be planning to use Middleman-v4 yet. 8-)

Add the following line to the Gemfile of your Middleman project:

gem 'middleman-sitemap-xml-generator'

Then as usual, run:

bundle install

To activate and configure this extension, add the following configuration block to Middleman's config.rb:

set :url_root, 'http://example.com'
activate :sitemap_xml_generator

A value of changefreq and priority in the sitemap.xml is determined in the following priority.

1. (Higher) Frontmatter attributes in each file

   ---
   changefreq: daily
   priority: 1.0
   ---

2. Processing in a process_changefreq and a process_priority option

   activate :sitemap_xml_generator do |f|
     f.process_changefreq = ->(path, default) {
       path.end_with?('.foo') ? 'yearly' : default
     }
     f.process_priority = ->(path, default) {
       path.end_with?('.foo') ? 0.9 : default
     }
   end

   Argument	Description
   path	A path prefixed "/" from Web root. e.g. /foo.html
   default	The same value as default_changefreq or default_priority

3. (Lower) A value in a default_changefreq and a default_priority option

You can add a hide_from_sitemap attribute to Frontmatter in the page which is omitted from the sitemap.xml:

---
hide_from_sitemap: true
---

If you would like to use a different Frontmatter attribute, you can specify it in a exclude_attr option:

activate :sitemap_xml_generator do |f|
  f.exclude_attr = 'invisible'
end

Then you can omit a page the following way:

---
invisible: true
---

You can also use a exclude_if option to exclude pages based on conditions you want:

# Exclude all pages which have a date that's after today
activate :sitemap_xml_generator do |f|
  f.exclude_if = ->(resource) {
    resource.data.date && resource.data.date > Date.today
  }
end

You can use a process_url option to process a URL in "loc" tag in each page in the sitemap.xml:

# This Proc removes a trailing slash from a URL in all "loc" tag.
activate :sitemap_xml_generator do |f|
  f.process_url = ->(url) { url.chomp('/') }
end

Only HTML file is added to the sitemap.xml with the default setting.

You can use a extra_ext option to add any file to the sitemap.xml:

# This setting adds every file suffixed ".foo" to the sitemap.xml.
activate :sitemap_xml_generator do |f|
  f.extra_ext = ['.foo'] # prefixed dot is required.
end

You can use a discard_ext option to exclude a content extension from a address in "loc" tag in the sitemap.xml:

# This setting removes suffixed ".foo" from "loc" tag in the sitemap.xml.
activate :sitemap_xml_generator do |f|
  f.discard_ext = ['.foo'] # prefixed dot is required.
end

Note that this process is executed before the process designated in a process_url option.

This extension deals with that issue by this workaround.

All ideas, logics, hints and prizes belong to the original author, Pete Nicholls.

And all mistakes belong to me.

(c) 2016 AT-AT. MIT Licensed, see LICENSE for details.