creek-jekyll-theme

The Jekyll theme used by the Creek site.

Installation

Add this line to your Jekyll site's Gemfile:

gem "creek-jekyll-theme"

And add this line to your Jekyll site's _config.yml:

theme: creek-jekyll-theme

And then execute:

$ bundle

Or install it yourself as:

$ gem install creek-jekyll-theme

Usage

The theme is a fork of minimal-mistakes, with a load of shared defaults, images, data, and customisations.

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/creek-service/creek-jekyll-theme. This project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to the Contributor Covenant code of conduct.

Development

To set up your environment to develop this theme, run bundle install.

This theme is set up just like a normal Jekyll site! To test your theme, run bundle exec jekyll serve and open your browser at http://localhost:4000. This starts a Jekyll server using this theme. Add pages, documents, data, etc. like normal to test the theme's contents. As you make modifications to the theme and to your content, the site will regenerate, and you should see the changes in the browser after a refresh, just like normal.

When the theme is released, only the files in _dat, _layouts, _includes, _sass and assets tracked with Git will be bundled. To add a custom directory to the theme-gem, please edit the regexp in creek-jekyll-theme.gemspec accordingly.

License

The theme is available as open source under the terms of the MIT License.

Building locally

To build and install locally from source, follow these steps:

1. Update version number in the gemspec.
2. Run:

   rm creek-jekyll-theme-*.gem
   gem build creek-jekyll-theme.gemspec
   gem install creek-jekyll-theme-*.gem

Releasing

Releases will automatically be built and pushed to Ruby Gems when a release tag is pushed to git. Currently, the process of updating the gemspec version and pushing a matching git tag is a manual process:

1. Update version number in the gemspec.
2. Run the following to pick up the new version:

   bundle update

3. Commit & push

   git add -A
   git commit -m "Bump release version"
   git push 

4. Push a new git tag, matching the new version in the gemspec:

   GEM_VERSION=$(sed -nr 's/.*spec\.version[^"]*"([1-9.]+)"/\1/p' creek-jekyll-theme.gemspec)
   git tag v$GEM_VERSION
   git push --tag

Dropping a release

gem yank creek-jekyll-theme -v VERSION_TO_DROP