Jekyll/Old Crap - Revision history

Admin: moved Jekyll to Jekyll/Old Crap

2014-04-12T05:45:36Z

← Older revision

Revision as of 05:45, 12 April 2014

Admin: /* Check Out Your Site Repo */

2014-04-11T21:10:17Z

Check Out Your Site Repo

← Older revision		Revision as of 21:10, 11 April 2014
Line 130:		Line 130:
	<pre>		<pre>
	jekyll new /path/to/repo		jekyll new /path/to/repo
	</~~per~~>		</pre>

	Now your basic, barebones Jekyll site should be complete and ready-to-serve. Try serving it up with Jekyll locally:		Now your basic, barebones Jekyll site should be complete and ready-to-serve. Try serving it up with Jekyll locally:

Admin: /* Check Out Your Site Repo */

2014-04-11T21:10:01Z

Check Out Your Site Repo

← Older revision		Revision as of 21:10, 11 April 2014
Line 141:		Line 141:

	[[Image:JekyllFirstSite.png\|500px]]		[[Image:JekyllFirstSite.png\|500px]]

			The pages you see are being hosted in the <code>_site</code> directory in your repository.

			==Repository Layout and Checking In Changes==

Admin: /* Check Out Your Site Repo */

2014-04-11T21:08:08Z

Check Out Your Site Repo

← Older revision		Revision as of 21:08, 11 April 2014
Line 138:		Line 138:
	</pre>		</pre>

	Now ~~point~~ your browser to <code>0.0.0.0:4000</code> ~~and you~~ should see something like this:		This command will force Jekyll to generate new static content from all of the raw markdown and other content that composes your site. Now see it live by pointing your browser to <code>0.0.0.0:4000</code>. You should see something like this:

	[[Image:JekyllFirstSite.png\|500px]]		[[Image:JekyllFirstSite.png\|500px]]

Admin: /* Check Out Your Site Repo */

2014-04-11T21:07:01Z

Check Out Your Site Repo

← Older revision		Revision as of 21:07, 11 April 2014
Line 140:		Line 140:
	Now point your browser to <code>0.0.0.0:4000</code> and you should see something like this:		Now point your browser to <code>0.0.0.0:4000</code> and you should see something like this:

	[[Image:JekyllFirstSite.png]]		[[Image:JekyllFirstSite.png\|500px]]

Admin: /* Setting Up Jekyll Githug Pages Site */

2014-04-11T21:05:34Z

Setting Up Jekyll Githug Pages Site

← Older revision		Revision as of 21:05, 11 April 2014
Line 60:		Line 60:
	=Setting Up Jekyll Githug Pages Site=		=Setting Up Jekyll Githug Pages Site=

	~~Create~~ a ~~file called~~ Gemfile that will ~~define~~ a ~~collection~~ of ~~ruby~~ gems ~~that will compose~~ a bundle. This ~~ruby bundle~~ will ~~then~~ be ~~used~~ to ~~turn~~ your ~~raw site content into polished static web content~~.		The way we're going to use Ruby and Jekyll is by creating a bundle of gems. These ruby gems perform some core functionality, so a bundle of gems is a way of providing you with lots of different tools for turning your raw site content into polished static web content.

			==Make Yer Bundle==

			Install the bundler, which will help us create gem bundles:

			<pre>
			gem install bundler
			</pre>

			Now you can create a Gemfile that tells ruby what gems this bundle will need. It should contain the following contents:

			<pre>
			source 'https://rubygems.org'
			gem 'github-pages'
			</pre>

			When I tried to install the bundle using this command,

			<pre>
			$ bundle install
			Fetching gem metadata from https://rubygems.org/.........
			Fetching additional metadata from https://rubygems.org/..
			Resolving dependencies...

			An error occurred while installing RedCloth (4.2.9), and Bundler cannot
			continue.
			Make sure that `gem install RedCloth -v '4.2.9'` succeeds before bundling.
			</pre>

			So I ran that gem install command, which installed a bunch of dependent gems. Then I ran the command again:

			<pre>
			$ bundle install
			Using RedCloth 4.2.9
			Using i18n 0.6.9
			Using json 1.8.1
			[...]
			Using jekyll 1.5.1
			[...]
			Using kramdown 1.3.1
			Using rdiscount 2.1.7
			Using github-pages 17
			Using bundler 1.6.1
			Your bundle is complete!
			Use `bundle show [gemname]` to see where a bundled gem is installed.
			</pre>

			Okay, we've successfully made our gem bundle.

			==Check Out Your Site Repo==

			Next step is to check out a copy of the repo where you want your site to go, using git clone:

			<pre>
			git clone <your repo here>
			</pre>

			Next, switch to the <code>gh-pages</code> branch, which is the branch that contains the live content for your site:

			<pre>
			git checkout --orphan gh-pages
			</pre>

			This will create a new branch called gh-pages that is an orphan, i.e., distinct and separate from any other branch (that way, it doesn't try to pull in changes to other branches).

			Now create your Jekyll site with the new command:

			<pre>
			jekyll new /path/to/repo
			</per>

			Now your basic, barebones Jekyll site should be complete and ready-to-serve. Try serving it up with Jekyll locally:

			<pre>
			jekyll serve
			</pre>

			Now point your browser to <code>0.0.0.0:4000</code> and you should see something like this:

			[[Image:JekyllFirstSite.png]]

Admin: /* Setting Up Content-Only Jekyll Site */

2014-04-11T20:39:44Z

Setting Up Content-Only Jekyll Site

← Older revision		Revision as of 20:39, 11 April 2014
Line 58:		Line 58:
	Once you've installed Ruby, you can move on to installing Jekyll.		Once you've installed Ruby, you can move on to installing Jekyll.

	=Setting Up ~~Content-Only~~ Jekyll Site=		=Setting Up Jekyll Githug Pages Site=

			Create a file called Gemfile that will define a collection of ruby gems that will compose a bundle. This ruby bundle will then be used to turn your raw site content into polished static web content.

Admin: /* Installing Ruby on Mac OS X */

2014-04-11T20:37:04Z

Installing Ruby on Mac OS X

← Older revision		Revision as of 20:37, 11 April 2014
Line 24:		Line 24:
	brew install ruby-build rbenv		brew install ruby-build rbenv
	</pre>		</pre>

			===Installing Ruby Just About Anywhere===

	Alternatively, you can use sstephenson's Github projects, ruby-build and rbenv:		Alternatively, you can use sstephenson's Github projects, ruby-build and rbenv:

Admin: /* Mac OS X */

2014-04-11T20:35:43Z

Mac OS X

← Older revision		Revision as of 20:35, 11 April 2014
Line 15:		Line 15:
	First thing you'll need is a computer with a version of ruby on it.		First thing you'll need is a computer with a version of ruby on it.

	===Mac OS X===		===Installing Ruby on Mac OS X===

	To install Ruby on Mac OS X, I had to first install ruby-build, then install rbenv.		To install Ruby on Mac OS X, I had to first install ruby-build, then install rbenv.
Line 55:		Line 55:

	Once you've installed Ruby, you can move on to installing Jekyll.		Once you've installed Ruby, you can move on to installing Jekyll.



	=Setting Up Content-Only Jekyll Site=		=Setting Up Content-Only Jekyll Site=

Admin: Created page with "This page covers my adventure in getting a Jekyll site set up. My intent in using Jekyll was to set up a site that would host a pile of Markdown files that compose the contents ..."

2014-04-11T20:35:27Z

Created page with "This page covers my adventure in getting a Jekyll site set up. My intent in using Jekyll was to set up a site that would host a pile of Markdown files that compose the contents ..."

New page

This page covers my adventure in getting a Jekyll site set up.

My intent in using Jekyll was to set up a site that would host a pile of Markdown files that compose the contents of a book. Thus, the site is mainly content, and not many blog posts.

I'm writing up my procedure in the spirit of this thread: https://github.com/jekyll/jekyll/issues/1650

=Creating Jekyll Site=

Here's the basics of setting up a Jekyll site in a Github repository.

Also see here: https://help.github.com/articles/using-jekyll-with-pages

==Installing Ruby==

First thing you'll need is a computer with a version of ruby on it.

===Mac OS X===

To install Ruby on Mac OS X, I had to first install ruby-build, then install rbenv.

One way to install these is using Homebrew:

<pre>
brew install ruby-build rbenv
</pre>

Alternatively, you can use sstephenson's Github projects, ruby-build and rbenv:
* rbenv: https://github.com/sstephenson/rbenv - this project helps you manage Ruby installations
* ruby-build: https://github.com/sstephenson/ruby-build - this project helps you build Ruby

<pre>
git clone https://github.com/sstephenson/rbenv.git ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bash_profile
echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
</pre>

then start a new shell and make sure this command prints a function:

<pre>
type rbenv
</pre>

Now install ruby-build as a plugin to rbenv:

<pre>
git clone https://github.com/sstephenson/ruby-build.git ~/.rbenv/plugins/ruby-build
</pre>

Finally, you can install a version of Ruby:

<pre>
$ rbenv install -l # list all available versions
$ rbenv install 2.0.0-p247 # install a particular version
</pre>

Once you've installed Ruby, you can move on to installing Jekyll.

=Setting Up Content-Only Jekyll Site=