Middleman Build Info

middleman-build-info is an extension for the Middleman static site generator that mantains an incremental build number and date on a JSON file inside your project.

Once the extension is activated It will run and update the build file every time you build your project.

• middleman-core (3.3+)

Add to your Gemfile and then run bundle install:

gem 'middleman-build-info'

Then activate the extension in your config.rb file:

activate :build_info

There are a couple of settings you can override from your config.rb file:

activate :build_info do |option|
  # Name of the build info file (default: 'build.json')
  option.filename = 'build.json'

  # Relative path to build file from MM root (default: '')
  option.relative_path = ''

  # Print build info after a successful build (default: true)
  option.display_info_after_build = true
end

The build_info helper is available to use in your views. You can pass a key to retrieve a single value or without parameters to retrieve the full hash.

<p class="build-number"><%= build_info(:number) %></p>

It's worth mentioning that:

• During development this helper will return the information about the current build.
• During the build process it will return the information about the new build instead.

I'm thinking about adding some Git information to the file as well like last commit hash, branch and committer at the time of the build. But I'm open to suggestions and pull requests.

CHANGELOG

Copyright (c) 2014 Mariano Cavallo. MIT Licensed, see LICENSE for details.