Hammer.rb

Hammer.rb is the hammer compilation gem. Check out the "Latest" branch for the latest development version of the the compiler.

Release versions are captured in branches named after the release e.g. "5.2"

How it works

  @build = Hammer::Build.new(
    :input_directory => @input_directory,
    :output_directory => Dir.mktmpdir(),
    :cache_directory => Dir.mktmpdir()
  )
  @build.compile()

To use it:

  $ git clone git@github.com:RiotHQ/hammer-gem.git
  $ cd hammer-gem
  # install all the Gems that the compiler uses
  $ bundle install
  # vendor these gems and symlink for Ruby 2.0.0 and Ruby 1.8.7 compatibility
  $ rake bundle
  # Copy the ready-to-go gem into Hammer's Application Support directory so the Mac app uses it
  $ bundle exec rake use

Auto-update script for this branch

  ruby -e "$(curl -fsSL https://raw.githubusercontent.com/RiotHQ/hammer-gem/latest/scripts/update.rb)"

If bundle install failed (could not find ruby/config.h)

      cd /Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.9.sdk/System/Library/Frameworks/Ruby.framework/Versions/2.0/usr/include/ruby-2.0.0/ruby
      sudo ln -s ../universal-darwin13/ruby/config.h ./config.h

http://stackoverflow.com/questions/26434642/yosemite-upgrade-broke-ruby-h

Advanced configuration

Since version 5.2.2 you can use autoprefixer option. Read more about Autoprefixer. In order to enable auto-prefixer for your styles you have to create a configuration file hammer.json in root of your project. This file must have next format:

{
  "sourcemaps": true,
  "autoprefixer":
  {
    "browsers": ["last 2 versions", "ie 9"]
  }
  "contentful":
  {
    "apiKey": "123456789",
    "spaces": 
    {
      "default":
      {
        "id": "987654321"
      }
    }
  }
}

There are only 2 options for now.

Sourcemaps - You can enable/disable sourcemaps generation with simple true or false
Autoprefixer - If you want to disable autoprefixer, you should write: "autoprefixer": false You can pass 4 different options to autoprefixer, see the autoprefixer docs for information

Troubleshooting

hammer.json is a JSON file. If you see that your configuration is having no effect, please check the format of your JSON file here.