No commit activity in last 3 years
No release in over 3 years
Helps you to write & exercise behavior-driven (BDD) specifications for your gem-based Jekyll theme
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
 Dependencies

Development

~> 1.14
~> 5.0
~> 10.0

Runtime

~> 2.1
>= 3.0, ~> 3.1
>= 0
 Project Readme

Jekyll Theme Specs

This gem is a simple wrap up of behavior-driven (BDD) validations borrowed from the original source code of Jekyll. The only reason it has been extracted into a gem is to be able to validate gem-based themes for Jekyll using Jekyll's original validation tools & techniques.

All the credits belong to Jekyll's contributors & maintainers. Again, this gem is a carbon-copy of what is already available in Jekyll's code base in a bit more reusable package.

Installation

Add this line to your Jekyll's Gemfile:

gem 'jekyll-theme-specs'

And then execute:

$ bundle

Or install it yourself as:

$ gem install jekyll-theme-specs

Usage

At this point the tool makes quite a few assumptions and very rigid in terms of the configuration options available.

  • All your features MUST be placed in features folder (Cucumber default);
  • Before running your theme's specs, it is a MUST to run bundle or bundle install;
  • Always run the tool via Bundler, eq. bundle exec theme-specs;
  • You can opt-in for more concise reporting style (Jekyll's favorite) by using -f Jekyll::Cucumber::Formatter option, eq. bundle exec theme-specs -f Jekyll::Cucumber::Formatter;
  • You can blend & validate multiple config files to get desired flavor of Jekyll's configuration on-the-fly (:heart:);
    • Given I have "_config.yml" configuration file with "theme" set to "<theme name>"
    • Given I have "features/comments-off.yml" configuration file with "comments_enabled" set to "false"
    • When I run jekyll build --config _config.yml,features/comments-off.yml
    • Then I should get a zero exit status

There is also minima-theme-specs repository that is a work in progress of building minima theme validations. We will start with a few simple things and expand coverage further.

Development

...

Contributing

Bug reports and pull requests are welcome on GitHub at https://github.com/ptsurbeleu/jekyll-theme-specs. 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.

License

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