From 0f008c02d821e859698a0fb317d18fcee3694b0c Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Fri, 19 Sep 2014 19:56:36 -0700 Subject: [PATCH 1/3] Add note about using the github-pages gem properly --- site/_docs/github-pages.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/site/_docs/github-pages.md b/site/_docs/github-pages.md index b8bf4d33..b448d510 100644 --- a/site/_docs/github-pages.md +++ b/site/_docs/github-pages.md @@ -12,6 +12,32 @@ organizations, and repositories, that are freely hosted on GitHub's powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free. + +
+
Use the github-pages gem
+

+ Our friends at GitHub have provided the + github-pages + gem which is used to manage Jekyll and its dependencies on + GitHub Pages. To use the currently-deployed version of the + gem in your project, add the following to your `Gemfile`: + + {% highlight ruby %} + source 'https://rubygems.org' + + require 'json' + require 'open-uri' + versions = JSON.parse(open('https://pages.github.com/versions.json').read) + + + gem 'github-pages', versions['github-pages'] + {% endhighlight %} + + This will ensure that when you run bundle install, you + have the correct version of the github-pages gem. +

+
+ ## Deploying Jekyll to GitHub Pages GitHub Pages work by looking at certain branches of repositories on GitHub. From a7eeeda99f1a1b65bc1d5c43d79fcfd36fae1388 Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Fri, 19 Sep 2014 19:58:45 -0700 Subject: [PATCH 2/3] Move it down a little --- site/_docs/github-pages.md | 13 ++++++------- 1 file changed, 6 insertions(+), 7 deletions(-) diff --git a/site/_docs/github-pages.md b/site/_docs/github-pages.md index b448d510..e098067f 100644 --- a/site/_docs/github-pages.md +++ b/site/_docs/github-pages.md @@ -12,6 +12,12 @@ organizations, and repositories, that are freely hosted on GitHub's powered by Jekyll behind the scenes, so in addition to supporting regular HTML content, they’re also a great way to host your Jekyll-powered website for free. +## Deploying Jekyll to GitHub Pages + +GitHub Pages work by looking at certain branches of repositories on GitHub. +There are two basic types available: user/organization pages and project pages. +The way to deploy these two types of sites are nearly identical, except for a +few minor details.
Use the github-pages gem
@@ -38,13 +44,6 @@ content, they’re also a great way to host your Jekyll-powered website for free

-## Deploying Jekyll to GitHub Pages - -GitHub Pages work by looking at certain branches of repositories on GitHub. -There are two basic types available: user/organization pages and project pages. -The way to deploy these two types of sites are nearly identical, except for a -few minor details. - ### User and Organization Pages User and organization pages live in a special GitHub repository dedicated to From a5a8be97de6b0372c6e70b01d8a1a17f4e43974b Mon Sep 17 00:00:00 2001 From: Parker Moore Date: Mon, 22 Sep 2014 22:52:23 -0700 Subject: [PATCH 3/3] Make it a little nicer. --- site/_docs/github-pages.md | 24 +++++++++++++----------- 1 file changed, 13 insertions(+), 11 deletions(-) diff --git a/site/_docs/github-pages.md b/site/_docs/github-pages.md index b448d510..c9305cd0 100644 --- a/site/_docs/github-pages.md +++ b/site/_docs/github-pages.md @@ -19,20 +19,22 @@ content, they’re also a great way to host your Jekyll-powered website for free Our friends at GitHub have provided the github-pages gem which is used to manage Jekyll and its dependencies on - GitHub Pages. To use the currently-deployed version of the - gem in your project, add the following to your `Gemfile`: - - {% highlight ruby %} - source 'https://rubygems.org' + GitHub Pages. Using it in your projects means that when you deploy + your site to GitHub Pages, you will not be caught by unexpected + differences between various versions of the gems. To use the + currently-deployed version of the gem in your project, add the + following to your Gemfile: - require 'json' - require 'open-uri' - versions = JSON.parse(open('https://pages.github.com/versions.json').read) +{% highlight ruby %} +source 'https://rubygems.org' +require 'json' +require 'open-uri' +versions = JSON.parse(open('https://pages.github.com/versions.json').read) + +gem 'github-pages', versions['github-pages'] +{% endhighlight %} - gem 'github-pages', versions['github-pages'] - {% endhighlight %} - This will ensure that when you run bundle install, you have the correct version of the github-pages gem.