gh-pages 브랜치를 이용한 프로젝트 페이지 만들기

Github Pages 서비스

Github에서는 프로젝트를 위한 웹사이트를 사용자들에게 제공하기 위해서 Github Pages라는 서비스가 있다. Github 계정이 있는 사람이라면 http://username.github.io라는 호스트가 할당 되어 있으며 자신이 원하는 대로 사용할 수 있다.

이 블로그 역시 Github Pages를 사용한다. Jekyll이라는 블로그를 Github Pages에 호스팅을 하는 것이다. 호스팅 방법은 Github Pages 소개에 잘 나와 있으니 일단 넘어가자.

Github 사용자들은 자신의 username이 들어간 호스트를 사용할 수 있고, Github repository를 통해서 호스팅을 할 수 있다는 것이 포인트다.

gh-pages 브랜치

http://username.github.io 호스트의 활용은 여기서 그치지 않고 본인의 프로젝트 페이지를 만들 수 있게도 해놨다. gh-pages 브랜치가 그 역할을 한다. repository에 gh-pages 브랜치를 만들어 놓고 index.html을 올리면 http://<username>.github.io/<projectname> url에 보이게 해놓은 것이다.

프로젝트의 페이지를 만드는 방법은 Creating Project Pages manually 문서에 나와 있지만 간단하게 기록해두면 다음과 같은 절차를 거친다.

1. git checkout –orphan gh-pages (orphan 옵션은 부모없는 브랜치를 만든다.)
2. git rm -rf . (프로젝트 파일은 필요 없으니 지운다.)
3. echo “My Page” > index.html
4. git 애드, 커밋, 푸쉬
5. http://username.github.io/projectname 접속

한단계 더 나아가 이 작업을 일일이 손으로 할 필요도 없다. Github의 각 repository 설정에는 클릭 몇 번으로 프로젝트 페이지를 만들어주는 기능도 있다. 내용을 쓰고 레이아웃을 선택한 후 Publish Page 버튼을 누르면 간편하게 프로젝트 페이지를 만들 수 있다. The Automatic Page Generator 도움말 항목을 참고하면 쉽게 할 수 있다.