Jekyll on Windows

2019-01-10

들어가며

GitHub Pages(Jekyll)를 사용하는 블로그에 Pull Request 형식으로 글을 투고해야 할 일이 생겼다.

이 블로그는 처음부터 Markdown을 쓰고 있었으므로 내용을 작성하는 데에는 별 문제가 없지만, 그냥 웹 페이지를 미리 보는 것이 잘 되지 않았다. 그래서 Jekyll을 설치해 보기로 했다.

기본적으로 공식 문서^#를 따라가지만, 일부 부족한 내용을 추가로 작성한다.

먼저 Jekyll은 Ruby에서 실행된다. 따라서 Ruby를 설치해야 한다.

RubyInstaller를 사용하면 Devkit까지 잘 설치된다고 하나 Installer에 왠지 모를 거부감이 생기므로 수동 설치를 해 보도록 하자.

7-ZIP ARCHIVES > Ruby 2.5.3-1 (x64) (rubyinstaller-2.5.3-1-x64.7z) 다운로드

msys2-x86_64-20180531.exe 다운로드

pacman -Syu
pacman -Su
pacman -S make mingw-w64-x86_64-gcc

이 과정 중에 Git for Windows가 설치되어 있다면 cygwin 버전이 안 맞는다는 오류가 발생할 수 있다. PATH에서 C:\Program Files\Git\usr\bin을 빼면 된다.

맨 마지막 줄은 이후 과정에서 필요하다.

gem install jekyll bundler

bundler install
bundler exec jekyll serve

물론 경로에 한글이 있으면 안 된다. serve시 Gemfile에 wdm이 없다면 추가하라는 문구가 뜬다.