[Github Blog] Jekyll 실행시 Dependency Error / webrick 오류가 난다면

깃헙 블로그를 사용하다보면, 정식으로 commit하기 전에 포스팅을 미리보기 하고 싶을 때가 있다. 그럴 때 Jekyll에 bundler를 이용하여 로컬로 서버를 열곤 하는데, Dependency Error, webrick 오류가 생겼다.

Dependency Error

$ bundle exec jekyll serve
Configuration file: /home/jihye/Home/blog/_config.yml
  Dependency Error: Yikes! It looks like you don't have jekyll-coffeescript 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-coffeescript gem in your Gemfile as well. The full error message from Ruby is: 'cannot load such file -- jekyll-coffeescript' If you run into trouble, you can find helpful resources at https://jekyllrb.com/help/! 
                    ------------------------------------------------
      Jekyll 4.2.0   Please append `--trace` to the `serve` command 
                     for any additional information or backtrace. 
                    ------------------------------------------------
/home/jihye/Home/blog/vendor/bundle/ruby/3.0.0/gems/jekyll-4.2.0/lib/jekyll/external.rb:73:in `rescue in block in require_with_graceful_fail': jekyll-coffeescript (Jekyll::Errors::MissingDependencyException)
        from /home/jihye/Home/blog/vendor/bundle/ruby/3.0.0/gems/jekyll-4.2.0/lib/jekyll/external.rb:58:in `block in require_with_graceful_fail'

다음과 같은 error가 나오면 _config.yml의 plugin에 다음을 추가해준다.

# Plugins (previously gems:)
plugins:
  - jekyll-coffeescript
  - jekyll-default-layout
  - jekyll-github-metadata
  - jekyll-optional-front-matter
  - jekyll-readme-index
  - jekyll-titles-from-headings
  - jekyll-relative-links

이를 추가해도 문제가 해결되지 않는다면, _config.yml이 아닌 Gemfile에 다음의 명령어를 추가해준다.

source "https://rubygems.org"
gemspec

gem "jekyll-coffeescript"
gem "jekyll-default-layout"
gem "jekyll-github-metadata"
gem "jekyll-optional-front-matter"
gem "jekyll-readme-index"
gem "jekyll-titles-from-headings"
gem "jekyll-relative-links"

Webrick Error

bundle exec jekyll serve 로 로컬에서 지킬을 구동하려 할 때 webrick 로드 오류가 발생할 수 있다.

이 경우에는 다음을 통해 webrick를 추가해주면 된다.

$ bundle add webrick

---

Jekyll로 Local Server 켜기

$ bundle install
$ bundle exec jekyll serve