No release in over a year
Automatically generate a sitemap.xml for your Bridgetown site.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

Runtime

>= 1.2.0, < 2.0
 Project Readme

Bridgetown Sitemap Generator Plugin

Tests Gem Version

Bridgetown plugin to silently generate a sitemaps.org compliant sitemap for your Bridgetown site

Usage

  1. Install the plugin with the following command:
bundle add bridgetown-sitemap
  1. Add the following to your site's config/initializers.rb:
Bridgetown.configure do |config|
  config.url = "https://example.com" # the base hostname & protocol for your site

  init :"bridgetown-sitemap"
end

<lastmod> tag

The <lastmod> tag in the sitemap.xml will reflect by priority:

  1. A personalised date if you add the variable last_modified_at: with a date in the Front Matter. (Dates need to be formatted as %Y-%m-%d %H:%M:%S %z)
  2. The modified date of the file as reported by git log.

<priority> and <changefreq> tag

You can optionally specify a priority and change frequency for each page in your site by adding the following to the Front Matter of each page:

sitemap_priority: 0.7
sitemap_change_frequency: weekly

This will add the following to the <url> tag in the sitemap.xml:

<priority>0.7</priority>
<changefreq>weekly</changefreq>

Exclusions

If you would like to exclude specific pages from the sitemap set the sitemap flag to false in the front matter for the page.

sitemap: false

To exclude multiple files, add a glob config to your config/initializers.rb file.

Bridgetown.configure do |config|
  # ...

  config.defaults << {
    "scope" => { "path" => "assets/**/*.pdf" },
    "values" => { "sitemap" => false }
  }
end

Testing

  • Run bundle exec rake test to run the test suite
  • Or run script/cibuild to validate with Rubocop and run tests together.

Contributing

  1. Fork it (https://github.com/ayushn21/bridgetown-sitemap/fork)
  2. Clone the fork using git clone to your local development machine.
  3. Create your feature branch (git checkout -b my-new-feature)
  4. Commit your changes (git commit -am 'Add some feature')
  5. Push to the branch (git push origin my-new-feature)
  6. Create a new Pull Request

License

Bridgetown Sitemap is released under the MIT License.

Copyright © 2023 Ayush Newatia