A simple Ruby Gem to bootstrap dependencies for setting up and maintaining a local Jekyll environment in sync with GitHub Pages
Перейти к файлу
Ben Balter 0aa6ca6127 Merge branch 'master' into version 2014-01-13 10:47:19 -05:00
lib require version-check in main class 2014-01-13 10:46:53 -05:00
script dat automated testing 2013-10-08 11:58:33 -04:00
.gitignore expose GitHubPages::VERSION 2014-01-12 09:45:14 -08:00
.ruby-version Bump .ruby-version to GitHub's Ruby 2.0.0. 2013-12-17 11:11:44 -05:00
.travis.yml Travis should use Ruby 2.0.0 to run CI check. 2013-12-17 11:23:27 -05:00
CONTRIBUTING.md fix typos in contributing.md, props @tombell 2013-08-15 10:01:07 -04:00
Gemfile add gemfile for easier testing 2013-09-11 15:32:18 -04:00
LICENSE move ©️ to GitHub 2013-08-08 12:30:10 -04:00
README.md fix spelling/typo 2013-10-18 10:35:05 -06:00
github-pages.gemspec refactor 2014-01-12 10:55:05 -08:00

README.md

GitHub Pages Ruby Gem

A simple Ruby Gem to bootstrap dependencies for setting up and maintaining a local Jekyll environment in sync with GitHub Pages.

Gem Version Build Status

Usage

Run the following command:

gem install github-pages

Alternatively, you can add the following to your project's Gemfile:

gem 'github-pages'

Note: You are not required to install Jekyll separately. Once the github-pages gem is installed, you can build your site using jekyll build, or preview your site using jekyll serve.

Updating

To update to the latest version of Jekyll and associated dependencies, simply run gem update github-pages, or if you've installed via Bundler, bundle update github-pages.

Project Goals

The goal of the GitHub Pages gem is to help GitHub Pages users bootstrap and maintain a Jekyll build environment that most closely matches the GitHub pages build environment. The GitHub Pages gem relies on explicit requirements shared between both users' computers and the build servers to ensure that the result of a user's local build is consistently also the result of the server's build.

Additional tools, such as tools that integrate with the GitHub API to make managing GitHub Pages sites easier are not the primary goal, but may be within the project's scope.

What's versioned

The GitHub Pages gem seeks to version two aspects of the build environment:

1. Ruby

The version of Ruby with which Jekyll is executed. Although Jekyll itself may be compatible with prior or future versions of Ruby, different execution environments yield different results. Ruby 1.8.7 parses YML differently than 1.9.3, for example, and Kramdown has trouble processing mailto links prior to 1.9.3. In order to ensure that building locally consistently results in the same build as what appears when published, it's essential that Ruby itself is versioned along side the Gem, despite no known incompatibilities.

2. Dependencies

This includes Markdown processors, and any other Jekyll dependency for which version incongruency may produce unexpected results. Traditionally, MaruKu, Kramdown, RedCloth, liquid, rdiscount, and redcarpet have been strictly maintained due to known breaking changes.

Changlog

See all releases.

Releasing

To release a new version of this gem, run script/release from the master branch.

License

Distributed under the MIT License.