Jekyll 설치 오류

Jekyll을 Mac에 설치 하면서 발생 했던 오류들을 정리 해보았습니다.

누군가는 나와 같은 오류가 발생 할수 있을거란 생각에 적습니다.

Mac 버전은 macOS Sierra 10.12입니다. 제 생각에는 El Capitan 에서도 발생될거라 생각됩니다.

jekyll 한글 페이지에 빠른시작 설명서에는 아래와 같이 나와있는데요. 한글 페이지는 아직 업데이트를 안한것 같습니다.

gem install jekyll
jekyll new myblog
cd myblog
jekyll serve

이대로 따라하다가 에러만 봤습니다. 그 에러에 대해 제가 해결한 내용을 공유 드립니다.

Error #1 : gem으로 jekyll 설치 하면서 권한 에러

gem install jekyll
Fetching: liquid-3.0.6.gem (100%)
ERROR:  While executing gem ... (Gem::FilePermissionError)
You don't have write permissions for the /Library/Ruby/Gems/2.0.0 directory.

아마도 최신 macOS에서 권한을 변경된게 많은듯 합니다.

아래 루비 환경 설정을 다시 하는 방법입니다.

xcode-select --install
curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm
rvm install 2.2.0

만약 brew 가 최신 버전이 아니라면 마지막 rvm install에서 아래와 같은 에러가 발생 됩니다.

Error #2 : rvm install 에러

rvm install 2.2.0
..
Error running 'requirements_osx_brew_update_system ruby-2.2.0',
showing last 15 lines of /Users/visu4l/.rvm/log/1478062640_ruby-2.2.0/update_system.log
+rvm_error:2> rvm_pretty_print stderr
..
+rvm_error:4> printf %b 'Failed to update Homebrew, follow instructions here:
    https://github.com/Homebrew/homebrew/wiki/Common-Issues
and make sure `brew update` works before continuing.\n'
Failed to update Homebrew, follow instructions here:
    https://github.com/Homebrew/homebrew/wiki/Common-Issues
and make sure `brew update` works before continuing.
+requirements_osx_brew_update_system:25> return 1

중간에 brew update 하라고 나옵니다. 따라서 해줍니다.

brew update

만약 brew update에서도 아래와 같은 에러가 발생한다면

Error #3 : `brew update` Permission Error

brew update
Error: /usr/local must be writable!

이 에러도 macOS가 업그레이드 되면서 발생된 에러 입니다.

/usr/local 디렉토리에 대한 권한 설정을 다시 해줘야 합니다.

sudo chown -R $(whoami):admin /usr/local

위 명령으로 해당 디렉토리 권한을 변경해줍니다.

하... 드디어 jekyll 설치 완료......
그리고 이어지는 에러....는...

Error #4 : jekyll 실행 에러

모든 파일을 다 설치하고 기분 좋게 project를 생성하는데 아래와 같은 에러가 발생했습니다.

jekyll new myblog
jekyll 3.3.0 | Error:  bundler

jekyll 한글 페이지가 아직 업데이트가 안되었습니다.

영문에서는 gem으로 jekyll 설치시에 과 bundler를 같이 설치하라고 되어 있습니다.(영문으로 볼껄..)

영문 가이드 페이지

gem install bundler

bundler를 추가 설치해 줍니다.

드디어 완료.

저와 같은 에러를 모두 만나신 분들에게는 심심한 위로를 드립니다