블로그를 설치하면서 했던 작업들을 간단하게 기록 겸 정리해서 올려본다.

Github Pages

먼저 Github에서 제공하는 Pages를 사용해 블로그로 사용할 repository를 만들어야한다. Github Pages란 github에서 제공하는 일종의 호스팅같은 개념인데 무엇보다 가장 좋은 점은 역시 ‘공짜’라는 것. 전혀 비용도 들지 않고 웹프로그래밍에 익숙한 사람이라면 금방 사용할 수 있을 정도로 아주 손쉽고 간편하다.

Github는 당연히 알고 있다고 가정하고, Github Pages를 만드는 과정에 대해서 간략하게 설명하도록 하겠다. 먼저 자신의 이름으로 된 repository를 만들어야한다.

username.github.io

위와 같이 만들면 되고, 나의 경우는 SanghyukChun이 username이니 SanghyukChun.github.io 처럼 만들면 된다. 아주 간단!

맨 처음 만들 때 Readme등으로 initialize를 해도 괜찮지만 지금은 일단 하지 말고 그냥 만들어두기만 한다. 원래 이 상태에서 Setting에서 Github Page를 만들고하는 과정이 더 있어야하지만 지금은 Octopress를 Pages Root에 설치한다고 가정했을 때를 기반으로 설명하기 때문에 생략하겠다. Github Pages에 대한 자세한 설명은 공식 도큐먼트에서 확인할 수 있다.

Octopress 설치하기

Octopress는 Ruby 기반으로 만들어진 Framework이므로 당연히 Ruby가 필요하다. 나는 이전에 Rails개발을 했었기 때문에 루비도 1.9.3으로 버전업이 되어있고 rvm이나 rake도 전부 최신버전이므로 아무 문제 없이 넘어갔으므로 이 부분에서 문제가 있다면 추가 구글링을 필요로 할 것이다. 이 포스트는 ‘당연히’ git도 미리 깔려있고 ‘당연히’ Ruby나 기타 rvm이니 rake니 하는 것들도 전부 최신이라 이 부분에서 아무런 문제가 없는 사람들이 이 글을 읽을 것이라고 가정하고 썼으므로 해당 부분에서 문제가 생긴다면 마찬가지로 추가 구글링을 필요로 할 것이다.

일단 octopress repository를 clone해야한다. 지금 clone하는 repository는 앞으로 모든 블로그작업을 하게 되는 workspace가 된다. 편한 위치에 받자

git clone git://github.com/imathis/octopress.git octopress

이제 octopress directory로 이동한 후 bundle을 설치한다. rails나 ruby 관련 어플리케이션을 작업했던 분들에게는 친숙한 과정일 듯

gem install bundler
bundle install
rake install

여기까지 했으면 이제 거의 끝났다. rake할 때 버전 어쩌고 거린다면 bundle exec를 붙여서 bundle exec rake install로 해주면 된다. 모든 rake에 그렇게 해야하는데 이게 rake 버전이 내가 가진 버전이 더 높아서 그런거니 그냥 그러려니 하고 넘어가면 된다. Rails 개발할 때는 너무 귀찮아서 rake를 bundle exec rake로 key binding해버리고 싶은 욕구까지 들었으니.. ㅎㅎ 마지막으로 지금 가지고 있는 Repository를 아까 생성한 github.io Repository에 remote로 추가해줄 차례이다.

rake setup github_pages

Github계정을 물어볼텐데 간단하게 입력하면 Repository가 관리하는 프로젝트가 Octopress가 관리하고 있는 https://github.com/imathis/octopress 에서 본인의 Repository로 변경되게 된다. 이제 Deploy를 해보자

rake generate
rake deploy

공식 홈페이지에서는 generate을 하고 deploy를 하라고 되어있는데 굳이 generate를 하지 않아도 괜찮을 것 같다. 아무튼 이러면 이제 github.io에 배포가 된거다. 이제 username.github.io로 접속해보면 본인의 Octopress Blog를 확인할 수 있다.

Octopress로 포스트하기

이제 Post를 작성해보자.

rake new_post

공식 홈에는 rake new_post[“post name”]으로도 된다는데 난 에러만 뱉어서 그냥 이렇게 입력하고 그 다음 post이름을 입력한다. 이렇게 하면 source/_post 아래에 markdown문서가 생성된다. 그 파일을 수정하면 된다. sublime ~~~~.markdown으로 들어가면 (별다른 설정이 없다면 sublime ~~~으로 sublime을 못 쓴다. 뒷 문단에 설명해놓았으니 참고하길)

---
layout: post
title: "Octopress 설치하고 포스팅하기"
date: 2013-07-25 20:00
comments: true
categories:
---

이제 이 파일에서 간단한 설정을 해주고 (http://octopress.org/docs/blogging/ 참고) — 바로 아래줄 부터 작성하면 된다. 포스트는 전부 HTML기반으로 작성해야한다. 다시 말해서 그냥 웹에서 작성하듯 작성할 수가 없다는 의미이고 그 귀찮은 html코딩을 매번 해야한다. 다른 방법이 없어보이지는 않는데 지금은 다른 어플리케이션을 찾기도 귀찮고 해서 그냥 편집기로 코딩하고 있다. 따라서 편집기를 하나 마련하는 편이 정신 건강에 좋은데 당연히 강력하게 Sublime Text를 주장하는 바이며, Emmet Package를 설치하여 귀찮은 html코딩을 좀 재밌고 간편하게 하기를 강력 권장한다. 이 녀석을 사용하면 정말 편하다. 특히 <p></p> 같은 귀찮기 그지없는 녀석들도 간단하게 p를 입력하고 tab만 입력하면 된다. 오오 아름다운 세상. 터미널에서 작업이 모두 일어나기 때문에 아래 symbolic link를 한번 생성하여 터미널에서도 열 수 있도록 작업하는 편이 덜 귀찮을 것이다.

ln -s /Applications/Sublime\ Text\ 2.app/Contents/SharedSupport/bin/subl /usr/local/bin/sublime

한번만 symbolic link를 생성하고나면 terminal에서도 sublime test.txt 와 같은 형태로 sublime실행이 가능하다. 이제 작성만 하면 된다.

어느정도 작성이 끝나고 preview가 필요하다고 생각되면 아래의 명령어를 입력한다.

rake preview

localhost:4000에 간단한 웹서버를 띄워준다. 메시지 나오는걸 봐서는 rails기반인듯. rails가 없는 컴퓨터에서 돌아가는지 여부는 확인 안했지만 아마 충분히 가능할 것 같다. 편집을 하다가 변경사항을 저장하면 그 즉시 asset이 reload되서 바로 새로고침으로 확인할 수 있다. 매번 deploy해야하는 자바 뻐큐머겅 ㅗ 두번머겅 ㅗㅗ 어느 정도 편집이 끝났으면 이제 배포를 하자

rake deploy

맨 처음 블로그를 배포했던 그 명령어 그대로 하면 된다. 이제 코드가 github로 push되고 github.io 페이지로 들어가서 배포한 post를 확인하면 끝난다. 이 포스트는 공식 도큐먼트의 initial setup, blogging basic, deploying to github pages를 참고하였다.

앞으로 블로그 커스터마이징도 하고 세팅도 많이 변경할텐데 변경 사항들은 그때그때 블로그에 포스팅하려한다. 나도 도움이 되고 구글링을 하다가 지친 누군지 모를 그 사람에게도 도움이 되겠지.