안녕하세요! 오늘은 개인 웹사이트, 특히 블로그를 운영하는 방식을 획기적으로 개선해주는 ‘정적 사이트 생성기(Static Site Generator)’, 그중에서도 가장 대표적인 Jekyll에 대해 이야기해보려고 합니다.

최근 저의 개인 웹사이트를 운영하면서, 새로운 글을 올릴 때마다 HTML 파일을 만들고, 목록 페이지를 일일이 수정하는 단순 반복 작업에 지쳐있었습니다. 바로 오늘, 이 문제를 해결하기 위해 기존 사이트를 Jekyll 기반으로 완전히 전환하는 작업을 진행했습니다.

이 글에서는 그 과정에서 얻은 경험을 바탕으로, 왜 Jekyll을 선택해야 하는지, 그리고 많은 분들이 어려움을 겪는 윈도우(Windows) 환경에서 Jekyll을 설치하는 방법을 누구나 따라 할 수 있도록 정리했습니다.

왜 Jekyll인가? 블로그 운영이 편해지는 이유

단순 HTML로 만들어진 웹사이트는 처음엔 간단해 보이지만, 콘텐츠가 많아질수록 관리가 기하급수적으로 어려워집니다. 헤더 메뉴 하나를 바꾸려고 모든 페이지를 수정해야 했던 경험, 다들 한 번쯤 있으실 겁니다.

Jekyll은 이러한 문제를 다음과 같이 해결해줍니다.

  1. 콘텐츠 중심: 더 이상 복잡한 HTML 태그에 신경 쓰지 않아도 됩니다. 간단한 마크다운(.md) 형식으로 글을 작성하는 데만 집중하면, Jekyll이 알아서 예쁜 HTML 페이지로 변환해줍니다.
  2. 템플릿과 자동화: 웹사이트의 반복되는 부분(헤더, 푸터 등)을 ‘레이아웃’과 ‘인클루드’라는 템플릿으로 분리할 수 있습니다. 메뉴를 수정하고 싶으면, 단 하나의 파일만 수정하면 모든 페이지에 자동으로 반영됩니다.
  3. 자동 목록 생성: _posts 폴더에 년-월-일-제목.md 형식으로 파일을 추가하기만 하면, Jekyll이 최신 글 목록 페이지를 알아서 업데이트해줍니다. 더 이상 수동으로 링크를 추가할 필요가 없습니다.

결론적으로, Jekyll은 개발자가 ‘콘텐츠 생산’이라는 본질에만 집중할 수 있도록 도와주는 강력한 도구입니다.

윈도우(Windows) 환경에서 Jekyll 설치하기

많은 가이드가 macOS 기준으로 설명되어 있어 윈도우 사용자들이 초기 설정에 어려움을 겪곤 합니다. 아래 단계를 차근차근 따라오시면 문제없이 설치할 수 있습니다.

1단계: RubyInstaller 다운로드 및 설치

Jekyll은 Ruby라는 프로그래밍 언어로 만들어졌기 때문에, Ruby를 먼저 설치해야 합니다.

  1. RubyInstaller for Windows 공식 사이트에 접속합니다.
  2. WITH DEVKIT이라고 표시된 버전 중, 이름에 bold체로 추천 표시가 된 최신 버전을 다운로드합니다. (예: Ruby+Devkit 3.x.x (x64))
  3. 다운로드한 설치 파일을 실행합니다.
    • 라이선스 동의(I accept the License) 후 Next를 클릭합니다.
    • 설치 경로 설정 화면에서, Add Ruby executables to your PATH 체크박스가 반드시 선택된 상태로 Install을 누릅니다. 이 옵션은 어느 폴더에서든 ruby 명령어를 사용할 수 있게 해줍니다.
    • 설치가 진행된 후, 마지막 화면에서 Run 'ridk install' to setup MSYS2... 옵션이 체크된 상태로 Finish 버튼을 누릅니다.

2단계: MSYS2 및 개발 도구 체인 설치

Ruby 설치 마지막 단계에서 ridk install을 실행하면, 검은색 명령 프롬프트 창이 나타납니다. 이 과정은 Jekyll이 사용하는 여러 의존성(라이브러리)을 빌드하는 데 필요한 도구들을 설치하는 과정입니다.

  1. 명령 프롬프트 창에 옵션을 묻는 메시지가 나타나면, 1, 3 등을 입력하라고 나옵니다. 특별한 경우가 아니라면, 그냥 Enter 키를 눌러 기본 추천 항목(1, 2, 3)을 모두 설치합니다.
  2. 설치가 진행되고, 다시 한번 옵션을 묻는 창이 나오면 마찬가지로 Enter 키를 눌러 계속 진행합니다.
  3. 설치가 모두 완료되면, “Done” 메시지와 함께 창이 저절로 닫히거나, Enter 키를 누르면 닫힙니다.

3단계: Jekyll 및 Bundler 설치

이제 모든 준비가 끝났습니다. 시작 메뉴에서 Command Prompt 또는 PowerShell을 검색하여 실행한 후, 아래 명령어를 입력합니다.

gem install jekyll bundler

이 명령어는 Jekyll과, 프로젝트 의존성을 관리해주는 Bundler를 함께 설치합니다.

4단계: 설치 확인

설치가 잘 되었는지 확인하기 위해 아래 두 명령어를 차례로 입력해 보세요. 버전 번호가 문제없이 출력된다면 성공적으로 설치된 것입니다.

ruby -v
jekyll -v

새로운 Jekyll 블로그 시작하기

이제 모든 준비가 끝났습니다. 원하는 위치에 프로젝트 폴더를 만들고, 터미널에서 해당 폴더로 이동한 후 아래 명령어로 새로운 Jekyll 사이트를 만들 수 있습니다.

# 'my-blog'라는 이름의 새 폴더에 Jekyll 사이트 생성
jekyll new my-blog

# 생성된 폴더로 이동
cd my-blog

# 로컬 서버 실행
bundle exec jekyll serve

이제 웹 브라우저에서 http://127.0.0.1:4000 주소로 접속하면, 여러분의 새로운 Jekyll 블로그를 만나보실 수 있습니다!

마치며

오늘 저의 웹사이트는 수동으로 관리되던 HTML 덩어리에서, 체계적이고 자동화된 Jekyll 프로젝트로 완전히 탈바꿈했습니다. 처음에는 설치 과정이 다소 낯설 수 있지만, 한번 구축하고 나면 앞으로의 블로그 운영이 정말 편해질 거라 확신합니다.

여러분도 이번 기회에 Jekyll과 함께 즐거운 블로깅 라이프를 시작해 보시는 건 어떨까요?