This post will guide you to start blogging with Teracy’s dev and octopress like we did with our blog at https://github.com/teracy-official/blog with these outstanding advantages:

• use octopress blogging framework

• could start blogging on any operating systems

• have automatic deployment via travis-ci everytime you update the blog source like ours at https://travis-ci.org/teracy-official/blog

In case if you’re wondering:

• Teracy’s dev is a little virtual machine (VM) box that any Teraciers must use it to setup working environment. All the required runtime environment will be automatically setup there.

• octopress is “A blogging framework for hackers.” I don’t think it’s for hackers anymore when you’re using Teracy’s dev for blogging, it should be for everyone who knows how to type and a little bit of Git learning. Do you? :–)

octopress requires Ruby for its runtime environment, Git for blog management. To make it dead-simple and error-prone-free to start, we’re going to use Teracy’s dev.

So let’s begin now, this could take you a little long time for setting up, but it’s worth it, believe me!

Step 1: Setup dev

Note that before $ vagrant up as guided below, you need to enable forwarded-port on Vagrantfile to preview octopress blog later (by removing the hash character (#) at the beginning of the line):

1

config.vm.network :forwarded_port, guest: 4000, host: 4000 # octopress preview, disabled by default

Please follow the guide here at: http://dev.teracy.org/docs/getting_started.html

Step 2: Install Ruby

Please follow the guide here at: http://dev.teracy.org/docs/ruby_training.html#installation

Step 3: Setup octopress

Note:

• Git and Ruby was already installed on the VM.

• You need to make sure to register a Github account at https://github.com/

• You must store your repository at teracy-dev/workspace/personal directory or you could possibly loose it when $ vagrant destroy. For example, to clone octopress repository:

1
2
3

$ ws
$ cd personal
$ git clone git://github.com/imathis/octopress.git octopress

$ ws is an alias provided by Teracy’s dev to change directory to workspace directory where all your work must be kept there.

1. Setup

Please follow the official guide here at: http://octopress.org/docs/setup/ and make sure to deploy with Github Pages.

2. Preview

Note: To preview with $ rake preview you should enable forwarded-port on the VM mentioned from step 1 above.

$ rake preview and open your browser at: http://localhost:4000 to preview the octopress blog.

After that, you could start blogging and enjoy it now. However, one very cool thing is that you don’t have to $ rake generate and then $ rake deploy anymore, it should be automatically done when you push updates to your github repository like we did for Teracy’s official blog.

Step 4: Automatic deployment with travis-ci

1. Register travis-ci account at: http://travis-ci.org

2. Configure your project build

2.1. Install curl with:

1

$ sudo apt-get install curl

2.2. Provide your github user account and run the following command, for example, my account is hoatle:

1

$ curl -u 'hoatle' -d '{"scopes":["public_repo"], "note":"Travis access"}' https://api.github.com/authorizations

You could get the output something like this, you need to notice the “token” key:

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

Enter host password for user 'hoatle':
{
  "id": 3223760,
  "url": "https://api.github.com/authorizations/3223760",
  "app": {
    "name": "Travis access (API)",
    "url": "http://developer.github.com/v3/oauth/#oauth-authorizations-api",
    "client_id": "66c370cb34ce199ab76a"
  },
  "token": "1cbbaf4dd0b82c54006377b233ee528612345678",
  "note": "Travis access",
  "note_url": null,
  "created_at": "2013-08-03T05:47:39Z",
  "updated_at": "2013-08-03T05:47:39Z",
  "scopes": [
    "public_repo"
  ]
}

2.3. Install travis gem to generate “secure” key:

1
2

$ gem install travis
$ rbenv rehash

2.4. Generate “secure” key from your provided token, mine is something like:

1

$ travis encrypt GH_TOKEN=1cbbaf4dd0b82c54006377b233ee528612345678

And you will get the output something like below, you need to get “secure” key to configure travis-ci later.

1
2
3
4
5

Please add the following to your .travis.yml file:

  secure: "f+g8tyvZYOYm+jUARCD5qLNMFkslYu26PwAFe8s4VzngJ2iv37T0yj5d8R40/cLIQ6LX+nHAltuJeNK786qjtiIuKuvHAypL0/3ZgVSN9XZAKnVvwh7fz7W7bETrJDkyk1WVSTini37CLSIdDS8lBg4iKHAhSuD35FZviuf/CbY="

Pro Tip: You can add it automatically by running with --add.

2.5. Configure .travis.yml like we did at https://github.com/teracy-official/teracy-official-blog/commit/263f79000b4fa3665ce704b502b5ddf5db25e88c#diff-1

You need to replace these with yours accordingly:

- git config --global user.name "Hoat Le"
- git config --global user.email "hoatlevan @ gmail . com"

- GH_REPO="teracy-official/teracy-official.github.io"
- secure: "f+g8tyvZYOYm+jUARCD5qLNMFkslYu26PwAFe8s4VzngJ2iv37T0yj5d8R40/cLIQ6LX+nHAltuJeNK786qjtiIuKuvHAypL0/3ZgVSN9XZAKnVvwh7fz7W7bETrJDkyk1WVSTini37CLSIdDS8lBg4iKHAhSuD35FZviuf/CbY="

If you setup blog as user/ organization page, you need to enable source branch instead of master like ours.

2.6. Configure Rakefile like we did at https://github.com/teracy-official/blog/commit/263f79000b4fa3665ce704b502b5ddf5db25e88c#diff-2

And this [hot-fix]: https://github.com/teracy-official/blog/commit/8aba0181098b3964b8c19cf5dfbdd06178f222f8#diff-1

3. Finally, enable travis-ci build for your project

You should make a post, push the change to see how travis-ci works. Your blog should be running well now.

If you want to use Github custom domains, please head to: http://blog.teracy.com/2013/08/08/multiple-github-custom-domains/

Many thanks to:

• http://rogerz.github.io/blog/2013/02/21/prose-io-github-travis-ci/ for automatic deployment work.

• http://www.harimenon.com/blog/2013/01/27/auto-deploying-to-my-octopress-blog/ for twitter button fixing.

Happy blogging!