Deploying Octopress on github with your domain

I started writing this post because I want a place to remember how to (quickly) install another Octopress, and I'm too lazy to read again all the documentation.

I followed steps explained on Octopress documentation, but mainly it consists of cloning the Octopress repo and installing the required gems:

git clone git://github.com/imathis/octopress.git jorgemaroto.es
cd jorgemaroto.es
bundle install #

After that, you need to create a repository on GitHub, as explained in their github guide, you can choose between two options.
In my case I'm going to create a repo with my name (patoroco.github.io), so after that I can push all the content to the master branch. At this point, you can run the rake task, which works as a wizard to configure everything.

rake setup_github_pages
rake install

By default it uses the classic theme, but I was looking for other options, and finally I decided to use darkstripes theme, so if you want to try it, follow these steps:

git clone git://github.com/amelandri/darkstripes.git .themes/darkstripes
rake install['darkstripes'] # again, this will ask you about overriding your current theme 

At this point, you can run rake preview on your terminal, and your site will be available on http://localhost:4000.
OK, this is a good time to publish your blog and start sharing with your friends how cool you are, so first of all you need to create a new repo on your GitHub account with your username, in my case it was http://patoroco.github.io. This would be enough, but I want to use my own domain, so I created a file named CNAME inside source folder (that's jorgemaroto.es/source/CNAME), with the name of my domain:

jorgemaroto.es

Obviously I needed to change my domain configuration, so I recommend that you check Github Pages with custom domain page, because they explain it better than I do :).

Finally, you need to edit some parameters in the _config.yml file as follows:

url: http://jorgemaroto.es
title: Jorge Maroto
subtitle: Trying to write a blog (again).
author: Jorge Maroto
simple_search: http://google.com/search
description: Here I'll try to write a blog somewhat more technical than in the past, and in English!

After that, you can run rake deploy, and you can now access your website using the selected domain (it could take a few hours).

It's important to highlight that with rake deploy, you are only uploading static files to GitHub, so it's recommended to also push your source files (that is, Markdown files, Sass, etc.) uncompiled.
Octopress makes it very easy because you always work on a branch named source, and when you deploy to the master branch, it does that automatically, so at this point you only need to push your source branch:

git push origin source

In the next post, I'll explain the configuration I did to customize the title, social networks, and more.