Skip to content

Latest commit

 

History

History
122 lines (77 loc) · 1.63 KB

development.md

File metadata and controls

122 lines (77 loc) · 1.63 KB

Development

Guide to local development of this plugin

Installation

Requirements

  • Ruby
  • Bundler

Install system dependencies

  • Install Ruby - see the Downloads page.
  • Install Bundler - see the Bundler homepage.

Clone

Clone the repo, or your fork.

$ git clone git@github.com:jekyll/github-metadata.git
$ cd github-metadata

Install project dependencies

Configure Bundler.

$ bundle config set --local path vendor/bundle

Install gems.

$ bundle install

Or, for a faster install.

$ script/bootstrap

Usage

See the script directory.

Format

Check for code formatting issues - recommended before you commit.

$ script/fmt

Fix formatting issues.

$ script/fmt -a

Open interactive console

$ script/console

Test

Run all unit tests.

$ script/test

Run a target unit test file by specifying a path.

$ script/test spec/owner_spec.rb

See some recommended flags below.

Run tests in the order they are written (not a random order).

$ script/test --order defined

Run tests in the same random order as a previous run.

$ script/test --seed 12345

Run tests with verbose trace logs.

$ script/test --format documentation

Start dev server

Preview the plugin in Jekyll by running the repo's sample Jekyll site.

$ script/test-site

Then open in the browser at:

Release

Run tests, formatting and create a release.

$ script/release