2011-07-19 22:28:48 -04:00
|
|
|
---
|
|
|
|
layout: page
|
|
|
|
title: Octopress Setup
|
|
|
|
date: July 18 2011
|
|
|
|
sidebar: false
|
|
|
|
footer: false
|
|
|
|
---
|
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
First, I want to stress that **Octopress is a blogging framework for hackers**.
|
|
|
|
You should be comfortable running shell commands and familiar with the basics of Git.
|
|
|
|
If that sounds daunting, Octopress probably isn't for you.
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
## Before You Begin
|
2011-08-02 00:40:15 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
You'll need to have Git and RVM installed before you move forward.
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
1. [Download Git](http://git-scm.com/)
|
2011-08-03 11:48:33 -04:00
|
|
|
|
2011-09-22 14:58:44 -04:00
|
|
|
Octopress requires Ruby 1.9.2 so you have two alternatives to install it: RVM or rbenv.
|
|
|
|
|
|
|
|
**Important:** you can't have both rbenv and RVM installed on the same system. Choose one.
|
|
|
|
|
|
|
|
### RVM steps
|
|
|
|
|
|
|
|
1. [Setup RVM](/docs/setup/rvm)
|
|
|
|
2. Install Ruby 1.9.2
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
```sh
|
|
|
|
rvm install 1.9.2
|
2011-08-02 00:40:15 -04:00
|
|
|
```
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-09-22 14:58:44 -04:00
|
|
|
### rbenv steps
|
|
|
|
|
|
|
|
1. [Install rbenv](https://github.com/sstephenson/rbenv#section_2)
|
|
|
|
2. [Install ruby-build](https://github.com/sstephenson/ruby-build)
|
|
|
|
3. Install Ruby 1.9.2
|
|
|
|
|
|
|
|
```sh
|
|
|
|
rbenv install 1.9.2-p290
|
|
|
|
```
|
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
## Setup Octopress
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
```sh
|
|
|
|
git clone git://github.com/imathis/octopress.git octopress
|
2011-09-22 14:58:44 -04:00
|
|
|
cd octopress # If you use RVM, You'll be asked if you trust the .rvmrc file (say yes).
|
|
|
|
ruby --version # Should report Ruby 1.9.2
|
2011-08-02 00:40:15 -04:00
|
|
|
```
|
|
|
|
|
2011-09-22 14:58:44 -04:00
|
|
|
If `ruby --version` doesn't say you're using Ruby 1.9.2, you may want to [revisit your RVM installation](/docs/setup/rvm).
|
2011-09-19 13:19:20 -04:00
|
|
|
|
|
|
|
Next, install dependencies.
|
|
|
|
|
|
|
|
```sh
|
|
|
|
gem install bundler
|
|
|
|
bundle install
|
|
|
|
```
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
Install the default Octopress theme.
|
2011-07-19 22:28:48 -04:00
|
|
|
|
2011-08-02 00:40:15 -04:00
|
|
|
``` sh
|
2011-09-19 13:19:20 -04:00
|
|
|
rake install
|
2011-08-02 00:40:15 -04:00
|
|
|
```
|
2011-07-23 01:36:20 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
## Next Steps
|
2011-07-23 01:36:20 -04:00
|
|
|
|
2011-09-19 13:19:20 -04:00
|
|
|
- [Set up deployment](/docs/deploying)
|
|
|
|
- [Configure your blog](/docs/configuring)
|
|
|
|
- [Start blogging with Octopress](/docs/blogging)
|