블로그를 시작하려고 하면 가장 먼저 접하게 되는 이름이 아마 WordPress일 겁니다. 그 이유는 분명합니다. WordPress는 놀라울 정도로 유연해서 대형 웹사이트부터 소규모 사이트까지 모두 구동할 수 있죠. 하지만 모든 웹사이트가 이렇게 강력한 인프라를 필요로 하는 것은 아니며, 특히 간단한 블로그라면 더욱 그렇습니다.
더 작고, 더 간단하고, 더 저렴한 선택지가 존재합니다. 예를 들어 GitHub Pages는 개인 사용 기준으로 무료입니다. 여기에 정적 사이트 생성기인 Jekyll을 결합하면 블로그에 필요한 모든 것을 갖추게 됩니다. 게다가 전부 무료라는 점이 최고의 장점입니다.
시작하기 전에
Jekyll은 자신의 컴퓨터에서 실행되며, 공식적으로 지원되는 운영체제는 macOS와 Linux뿐입니다. 이 글에서는 두 운영체제를 모두 다루며, Linux용 설치 방법은 Windows Subsystem for Linux(WSL)의 Ubuntu 환경에서도 동작할 수 있습니다. 다만 이 환경은 테스트되지 않았으니 참고하세요.
또한 쓸만한 텍스트 편집기도 준비해야 합니다. TextEdit이나 GEdit으로도 충분하지만, 더 강력한 도구를 원한다면 크로스 플랫폼을 지원하는 텍스트 편집기를 살펴보는 것이 좋습니다.
알아두어야 할 사항
명령줄(command line)에 대한 기본적인 이해가 필요합니다. git과 GitHub에 익숙해지는 것도 필수적입니다. 처음이라면 git 입문 가이드나 GitHub 공식 문서를 참고하는 것을 추천합니다.
마지막으로, Jekyll은 Markdown을 사용합니다. Markdown을 사용하면 일반 텍스트로 글을 작성하면서도 사용자에게는 HTML 형태로 콘텐츠를 보여줄 수 있습니다. Markdown이 생소하더라도 걱정하지 마세요. 배우기 매우 쉬운 문법이라 몇 번만 사용해 보면 금방 익숙해질 겁니다.
Jekyll과 의존성 패키지 설치하기
이 가이드는 macOS Mojave와 Ubuntu 18.04에서 테스트되었습니다. 다른 버전을 사용 중이라면 Jekyll 공식 웹사이트에서 추가 정보를 확인하는 것이 좋습니다.
macOS에서 설치하기
Jekyll을 설치하기 전에 먼저 다음 명령어로 XCode 명령줄 도구를 설치해야 합니다.
xcode-select --install
Install을 선택하고 설치가 완료될 때까지 기다립니다. 이제 Jekyll과 Bundler를 설치할 수 있습니다.
gem install --user-install bundler jekyll
명령어를 실행하면 아래와 같은 경고 메시지가 나타날 수 있습니다.
WARNING: You don't have /Users/YOURNAME/.gem/ruby/2.3.0/bin in your PATH, gem executables will not run.
여기서 버전 숫자를 잘 확인해 두세요. 위 메시지를 기준으로 한다면, 실제 버전 번호에 맞게 수정하여 다음 명령어를 실행합니다.
echo 'export PATH=$HOME/.gem/ruby/2.3.0/bin:$PATH' >> ~/.bash_profile source ~/.bash_profile
Ubuntu에서 설치하기
Jekyll을 설치하기 전에 먼저 다음 명령어로 빌드 도구를 설치해야 합니다.
sudo apt-get install ruby-full build-essential zlib1g-dev
macOS와 마찬가지로 root 권한 대신 홈 디렉터리에 설치하고 실행하는 것이 좋습니다. 다음 명령어를 실행하세요.
echo 'export GEM_HOME="$HOME/gems"' >> ~/.bashrc echo 'export PATH="$HOME/gems/bin:$PATH"' >> ~/.bashrc source ~/.bashrc
이제 Jekyll과 Bundler를 설치합니다.
gem install jekyll bundler
Jekyll 설치 확인하기
모든 것이 제대로 작동하는지 확인하려면 다음 명령어를 실행합니다.
jekyll -v
설치가 올바르게 완료되었다면 버전 번호가 포함된 메시지가 표시됩니다. 만약 command not found 같은 오류 메시지가 나타난다면 Jekyll 공식 문서를 참고해 문제를 해결하세요.
Jekyll로 새 블로그 만들기
Jekyll 설치가 끝났다면 새 블로그 생성은 아주 간단합니다.
jekyll new blog
위 명령어에서 'blog'는 원하는 이름으로 바꿀 수 있으며, 이는 Jekyll이 생성하는 디렉터리의 이름입니다. 이제 방금 만든 디렉터리로 이동(cd)한 후 다음 명령어를 실행합니다.
bundle exec jekyll serve
이렇게 하면 새 블로그가 로컬 컴퓨터에서 실행됩니다. 화면에 표시된 URL을 브라우저에서 열어 사이트를 확인해 보세요. 아직 손볼 곳이 많다는 걸 알 수 있을 겁니다. 확인 후에는 Ctrl + C를 눌러 서버를 종료합니다.
블로그 커스터마이징하기
사이트 제목과 기타 정보를 수정하려면 블로그 디렉터리에서 "_config.yml" 파일을 열어 편집합니다. 각 옵션들은 직관적이라 쉽게 이해할 수 있을 겁니다. 필요하다면 홈 페이지인 "index.md" 파일도 수정할 수 있지만, 이는 선택 사항입니다.
첫 블로그 포스트를 작성하려면 "_posts" 폴더를 열면 샘플 포스트가 있는 것을 볼 수 있습니다. 이 파일을 열어 직접 수정하거나, 복제하여 새 포스트를 만들면 됩니다.
GitHub에 블로그 배포하기
로컬에서 사이트 준비가 끝났다면 이제 온라인에 올릴 차례입니다. 아직 GitHub 계정이 없다면 회원가입을 하고, 컴퓨터에 git을 설치 및 설정하세요. 그다음 username.github.io 형식의 이름으로 새 저장소(repository)를 생성합니다. 'username' 부분에는 본인의 GitHub 사용자 이름을 입력하면 됩니다.
이제 터미널을 열고 블로그 폴더로 이동한 뒤 다음 명령어들을 순서대로 실행합니다.
git init git add --all git commit -m "initial commit" git remote add origin https://github.com/username/username.github.io.git git push -u origin master
이제 username.github.io에 접속하면 새 블로그를 볼 수 있습니다. 바로 나타나지 않는다면 몇 분 후에 다시 시도해 보세요.
다음 단계
지금까지 살펴본 내용은 블로그를 시작하기 위한 기본적인 과정일 뿐입니다. Jekyll에는 훨씬 다양한 기능이 있으니 반드시 공식 문서를 확인해 보세요. 블로그 디자인을 한층 멋있게 만들어 줄 수많은 테마도 준비되어 있습니다.
GitHub Pages에서도 추가 설정이 가능합니다. HTTPS 지원은 예전에는 복잡한 과정이었지만, 요즘은 저장소 설정에서 간단히 활성화할 수 있습니다. 자신만의 도메인 연결 역시 어렵지 않으며, GitHub에서 상세한 가이드를 제공하고 있습니다.
마지막으로 한 가지 팁을 드리자면, 변경 사항을 저장소에 커밋하기 전에 로컬에서 미리 확인하는 습관을 들이는 것이 좋습니다. 앞서 사용했던 bundler exec jekyll serve 명령어로 내 컴퓨터에서 사이트를 미리 볼 수 있습니다. 이렇게 하면 오타부터 Markdown 문법 오류까지 다양한 실수를 사전에 잡아낼 수 있습니다.