Steps I’ve taken
Note: ‘username’ is your Github username and ‘myblog’ is the name of your blog / site which you’ll have to replace in the instructions. Don’t sweat too much about the latter, it’s just a project name you won’t necessary have to use on your site.
Set up Github repository for hosting
Go to: https://github.com/new
Fill in form and create repo called “username.github.com”
Set up Octopress →
If you don’t have it yet, install rbenv and ruby-build (to handle Ruby runtimes and build gems). If you’re on Windows this is going to be a bit more complicated, but setting up RubyInstaller and Ruby Development Kit is not that bad.
1 2 3 4 5 6 7
Get a nice theme →
Configure Octopress →
Edit at least “Main Configs” in _config.yml. You can come back later to fill in the rest.
Set site up for Github Pages
Paste your Github repo URL: email@example.com:username/username.github.com.git when prompted.
This will set up some folders and the structure of the Git repos.
Master branch will track the actual generated website (the contents of
_deploy folder) and
source will be the sources you are going to edit.
Create your first post →
Edit contents of myblog/source/_posts/yyyy-mm-dd-hello-world.markdown
Generate page and see it in your browser →
1 2 3
See if it’s all good locally
Check the real thing: http://username.github.com