mippin

Serve your Jekyll site as a rack application.

This is a soft fork of lanyon, as that gem is, seemingly, no longer maintained (see: https://github.com/stomar/lanyon/issues/5).

A huge thank you to Marcus Stollsteimer for creating all the code underpinning this fork!

Installation

Install the gem and add to the application's Gemfile by executing:

bundle add mippin

If bundler is not being used to manage dependencies, install the gem by executing:

gem install mippin

Usage

Once the the gem is installed in your Jekyll project, create a rackup file (config.ru) in the root of your project directory with the following:

require "mippin"
run Mippin.application

Now, build the site with:

jekyll build

Finally run the folling to start serving your site via rack:

bundle exec rackup config.ru

For more info, take a look at the demo site, inside the demo/ directory of this repository. You can also use rake demo to serve the demo site (and rake rm in order to remove the files that rake demo generates).

Development

After checking out the repo, run bin/setup to install dependencies. Then, run rake to run the tests and linter. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and the created tag, and push the .gem file to rubygems.org.

Contributing

Please email your diffs inline to rory AT mailbox DOT cat.