Octopress Quick Setup - Windows

What is Octopress?

Octopress is, according to their website, "a blogging framework for hackers". It is a static site generator based/powered by Jekyll. The benefits of using a static site is that you'll have a site that loads fast, easy to modify, and secure unlike dynamic site framework like Wordpress which requires you to have a web server running, a database to manage contents, and a security solution.


For hackers?

Hackers are those who considers programming as an art and is a part of their daily life, so why octopress aimed for programmers rather than web designers? simply, web designers hate complicated setups, they want to immediately see the result, they want their site pretty and dynamic as much as possible. On the other hand, programmers don't care at all, they're too busy to focus on how their site looks, they just want to keep everybody updated about their progress.

Why not wordpress?

Seriously, try using new web technologies. Also, octopress isn't bad, it's lightweight, not bloated, simple to configure and customize, fast and secure (since we won't need a database at all).

You'll need a Github account to use Github's pages service to host our octopress blog. Also, make sure that you have git installed on your machine before proceeding.

• You need Ruby 1.9.3
• You need RubyDevKit for 1.9.3 (http://rubyinstaller.org/downloads/)

After extracting the devkit, open up a terminal then cd to that directory then fire the following commands:
$ ruby dk . rb init
$ ruby dk . rb install

Lets get started!

First, login to your Github account, create a new repository. Make sure that you name that repo as "your-github-username.github.io"

Now, we have to clone octopress somewhere so, open up bash then type in the following command.
$ git clone https://github.com/imathis/octopress your-github-username.github.io

After that, cd to the newly cloned repo.

$ cd your-github-username.github.io

By the way, you'll need to edit the Gemfile so edit it with whatever text editor you wish to use then in the first line, change https to http then save it.

Go back to bash then type:
$ bundle install

If everything went good, we'll now have to install the default octopress theme. Type in:
$ rake install

Okay, we're now finished with the first part. Lets deploy it to Github.

In bash, type in the command:
$ rake setup_github_pages

This will:
• Ask you for your Github Pages repository url. Rename the remote pointing to imathis/octopress from origin to octopress .
• Add your Github Pages repository as the default origin remote.
• Switch the active branch from master to source .
• Configure your blog url according to your repository.
• Setup a master branch in the _deploy directory for deployment.

We're almost done here, lets generate our blog. Go back to bash then type:

$ rake generate
$ rake deploy

That's it!

Lets commit our source to the repo, in bash, issue these commands

$ git add .
$ git commit -m "your commit message"
$ git push -u origin source

To test if everything works fine, fire up your browser and type in the URL bar: your-github-username.github.

If it says 404 something, you either did something wrong or missed a step.

Alright! Lets make our first post, shall we?

In bash, type in:

$ rake new_post["title for your post"]

In Octopress, you can either use Markdown formatting or Textile formatting to write your post, by the default, you'll need to use Markdown.

Now, in your local repository, you should see a folder called source, open it, then go to posts, you should see a markdown (.md) file inside it, open it up in a text editor. This is where we will tpe the content of our post, go ahead and type something below the dashes then save it.

Go back to bash and type:

$ rake generate
$ rake deploy

Now, go to your octopress blog's url and you should see our very first post!

That's all! What an idiotic guide, for more information about octopress, please refer to https://octopress.org/docs

I'll try to answer some of your questions here.
Top Bottom