After a couple of years being lazy and just reading what others wrote, I belive it’s time to start blogging again. One could explain inspring stories about blogging and black holes but I’m just going to explain why I chose Octopress over other blogging platforms and how I made it work for me.
There are several blogging platforms out there, they all have their features and some of them are easier to use. The likes of Wordpress, Ghost, Medium, etc… are more than good options in order to start. In my case, I used Wordpress in the past, still use it for some other projects but I wanted to use something new for me.
Markdown files are a great way of writing text, it won’t be the best option if you are trying to write a novel but if you are familiar with Github you’d probably have used them in the past. Octopress text editing is based on Markdown files, that was a plus. Octopress also supports Github Pages and the whole publishing process is based on Git, what else could you ask?
Next, install dependencies.
1 2 3
Install the default Octopress theme.
At this point you have Octopress installed and the default theme installed, now we need to deploy it. Octopress supports deployment on GitHub pages and that’s the method I chose.
Deploying to Github Pages
Github allows you to host a blog from
username is your Github username.
Github Pages for users and organisations uses the master branch like the public directory on a web server, serving up the files at your Pages url http://username.github.io. As a result, you’ll want to work on the source for your blog in the source branch and commit the generated content to the master branch. Octopress has a configuration task that helps you set all this up.
The rake task will ask you for a URL of the Github repo. Copy the SSH or HTTPS URL from your newly created repository (e.g. firstname.lastname@example.org:username/username.github.io.git) and paste it in as a response.
Done, at this point your Github page is ready to be deployed, but first we need to generate the blog.
This will generate your blog, copy the generated files into _deploy/, add them to git, commit and push them up to the master branch. In a few seconds you should get an email from Github telling you that your commit has been received and will be published on your site.
As you would do with any other git based project, after adding some code you’d add it and commit it.
1 2 3
Using a custom domain
First thing that needs to be added is a
CNAME in the blog’s source.
I’m using a main domain, so all I had to do is modifying the DNS host and add a new
CNAME record for
www pointing to