GitHub Pages

A short walkthrough of how to setup GitHub pages for local editing and some references of similar GitHub based websites and portals.

Running Jekyll For Local Editing:


Before we install Jekyll, we need to make sure we have all the required dependencies.
sudo apt-get install ruby-full build-essential zlib1g-dev
It is best to avoid installing Ruby Gems as the root user. Therefore, we need to set up a gem installation directory for your user account. The following commands will add environment variables to your ~/.bashrc file to configure the gem installation path. Run them now:
echo '# Install Ruby Gems to ~/gems' >> ~/.bashrc
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc
echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
Finally, install Jekyll:
gem install jekyll bundler
That’s it! You’re ready to start using Jekyll.


cd <cloned-github-directory>
$ bundle exec jekyll serve
> Configuration file: /Users/octocat/my-site/_config.yml
> Source: /Users/octocat/my-site
> Destination: /Users/octocat/my-site/_site
> Incremental build: disabled. Enable with --incremental
> Generating...
> done in 0.309 seconds.
> Auto-regeneration: enabled for '/Users/octocat/my-site'
> Configuration file: /Users/octocat/my-site/_config.yml
> Server address: <>
> Server running... press ctrl-c to stop.
To preview your site, in your web browser, navigate to http://localhost:4000.