In this tutorial I will teach you how to test your Jekyll Bootstrap3 site locally.
Jekyll is a parsing engine bundled as a ruby gem used to build static websites from dynamic components such as templates, partials, liquid code, markdown, etc. Jekyll is known as “a simple, blog aware, static site generator”.
To test your site locally, you’ll need
There are lots of different ways to install ruby.
In Windows, use RubyInstaller. (In most of this tutorial, I’ve assumed you’re using a Mac or some flavor of Unix. It’s possible that none of this was usable for Windows folks. Sorry!)
Installing the github-pages gem
Run the following command:
gem install github-pages
This will install the
github-pages gem and all dependencies
Later, to update the gem, type:
gem update github-pages
Testing your site locally
To construct and test your site locally, go into the directory and type
This will create (or modify) a
_site/ directory, containing
assets/, and then the
index.md and all
pages/*.md files, converted to html. (So there’ll be
_site/index.html and the various
Type the following in order to “serve” the site.
This will first run
build, and so it does not need to be
To make jekyll automatically re-build your changes you can also add the
jekyll serve --watch
Now open your browser and go to http://localhost:4000.
Read the complete tutorial on http://jekyllrb.com/docs/usage/.