macOS) github blog with jekyll -(1) 로컬에 jekyll 설치 중에 마주하는 오류

로컬에 jekyll 설치하기

github 를 이용한 블로그를 운영하기 위한 설정

github는 시차가 있어서 즉각적으로 확인할 수 없어 불편하다. 그래서 블로그에 새로운 테마 혹은 플러그인이 적용했을 때 어떻게 변화하는지 바로 확인하기 위해 jekyll를 사용

Install Command Line Tool

사전에 Native 확장 기능을 컴파일할 수 있게 Command Line Tools 설치를 해야 한다.

$xcode-select --install

Install Ruby

Jekyll 는 Ruby 2.4.0 버전 이상을 필요.

Homebrew 사용

$brew install ruby 최신 버전 설치

Ruby의 경로를 쉘 환경 설정에 추가

• bash 사용시

$echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.bash_profile

• zsh 사용 시

$echo 'export PATH="/usr/local/opt/ruby/bin:$PATH"' >> ~/.zshrc

버전 확인

$ruby -v

ruby 3.0.2p107 (2021-07-07 revision 0db68f0233) [x86_64-darwin20]

Install rbenv, ruby-build

$brew install rbenv

$brew install rbenv ruby-build

rbenv를 사용해서, ruby 가상 환경을 설치

$rbenv install '최신 버전'
$rbenv global '최신 버전'

rbenv 활성화

• zsh 사용자는 ~/.zshrc
• bash 사용자는 ~/.bash_profile

[[ -d ~/.rbenv  ]] && \
  export PATH=${HOME}/.rbenv/bin:${PATH} && \
  eval "$(rbenv init -)"

• zsh 사용자는 $source ~/.zshrc
• bash 사용자는 $source ~/.bash_profile

Install Jekyll

Jekyll은 Ruby로 개발되었으며 따라서 설치하기 위해서는 Gem을 사용

$gem install jekyll bundler

설치 후

$bundle exec jekyll serve 명령어로 jekyll 로컬 서버를 구동

위와 같이 나온다면 성공.

위와 같은 오류가 난다면 아래 오류 해결 부분 참고

 

🔒 오류 1

Jekyll serve fails on Ruby 3.0

bundle exec jekyll serve 입력 시 `require': cannot load such file -- webrick (LoadError) 에러 표시

/Users/youngkyoonim/.rbenv/versions/3.0.2/lib/ruby/gems/3.0.0/gems/jekyll-4.2.0/lib/jekyll/commands/serve/servlet.rb:3:in `require': cannot load such file -- webrick (LoadError)
    from /Users/youngkyoonim/.rbenv/versions/3.0.2/lib/ruby/gems/3.0.0/gems/jekyll-4.2.0/lib/jekyll/commands/serve/servlet.rb:3:in `<top (required)>'
    from /Users/youngkyoonim/.rbenv/versions/3.0.2/lib/ruby/gems/3.0.0/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:179:in `require_relative'
    from /Users/youngkyoonim/.rbenv/versions/3.0.2/lib/ruby/gems/3.0.0/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:179:in `setup'
    from /Users/youngkyoonim/.rbenv/versions/3.0.2/lib/ruby/gems/3.0.0/gems/jekyll-4.2.0/lib/jekyll/commands/serve.rb:100:in `process'
...
...
...

🔓 해결

$bundle add webrick 입력

Reference - https://github.com/jekyll/jekyll/issues/8523

 

🔒 오류 2

Dependency Error: Yikes! It looks like you don't have jekyll-paginate or one of its dependencies installed. In order to use Jekyll as currently configured, you'll need to install this gem. If you've run Jekyll with bundle exec, ensure that you have included the jekyll-paginate gem in your Gemfile as well. The full error message from Ruby is: 'cannot load such file -- jekyll-paginate' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/!

🔓 해결

$bundle add jekyll-paginate 입력