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
I’m assuming that you’re not migrating from Octopress 2.0 but are starting completely from scratch in a new/empty directory.
gem install jekyll
Create Site scaffolding
jekyll new SITENAME
- 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
_deploy.yml .bundle bin vendor
bundle install --binstubs --path=vendor
- This installs all of the required ruby gems to a subdirectory here, making it easier to manage per project.
bundle exec octopress init
- Add this to your
_config.ymlso the Ruby stuff is ignored when builing your site
exclude: [.bundle, bin, vendor]
Set up Github deployment
- Create your Github-pages repo via Github
octopress deploy init git
- Add your git URL to
Create your CNAME file if you’re using a custom URL with Github-pages
Build your site
Preview your site
git remote add origin GIT-REPO-URl
git add .
git commit -m 'inital Octopress 3.0 install'
git checkout -b source
git push -u origin source
Deploy the Site