Installing Octopress 3.0 From Scratch

I’ve been getting excited for the release of Octopress 3.0 and decided to try installing it today. I’ve never used Jekyll without Octopress so I struggled a little, but it was a relatively painless experience.

Listed below are the steps I took to get a brand new Octopress 3.0 install

Assumptions

I’m assuming that you’re not migrating from Octopress 2.0 but are starting completely from scratch in a new/empty directory.

Install Jekyll

gem install jekyll

Create Site scaffolding

jekyll new SITENAME cd SITENAME

Install Octopress

  • Add a Gemfile to your directory with the following content:
source "https://rubygems.org"
gem 'octopress', '~> 3.0.0.rc.15'
gem 'rake'
gem 'octopress-deploy'
gem 'aws-sdk'
  • Add these to your .gitignore
    _deploy.yml
    .bundle
    bin
    vendor
    
  • Run bundle install --binstubs --path=vendor
    • This installs all of the required ruby gems to a subdirectory here, making it easier to manage per project.
  • Run bundle exec octopress init
  • Add this to your _config.yml so the Ruby stuff is ignored when builing your site exclude: [.bundle, bin, vendor]

Set up Github deployment

  1. Create your Github-pages repo via Github
  2. Run octopress deploy init git
  3. Add your git URL to _deploy.yml file

CNAME

Create your CNAME file if you’re using a custom URL with Github-pages

Build your site

octopress build

Preview your site

  1. Run octopress serve
  2. Visit 127.0.0.1:4000

Commit Source

  1. Run git init
  2. Run git remote add origin GIT-REPO-URl
  3. Run git add . git commit -m 'inital Octopress 3.0 install' git checkout -b source
  4. Run git push -u origin source

Deploy the Site

Run octopress deploy