맥OS에서 Jekyll 빌드 환경 설정하기

1. 루비(Ruby) 버전 확인

$ruby --version
$ruby 2.xxx

2. 루비 버전은 2.1.x 이상이어야 한다.

macOS (High) Sierra , El Capitan은 Ruby 2.0이 설치되있다.

참조 https://www.ruby-lang.org/en/documentation/installation/#homebrew

OS X는 Homebrew라는 패키지매니저를 사용한다. 다음과 같이 Ruby를 업그레이드 한다.

$brew install ruby

루비 최신 버전을 설치할때 사용하는 brew 가 루비 버전이 낮아서 실패하는 경우가 있다. 이 경우에는 brew 대신 ruby-install로 설치해야 한다.

/usr/local/Homebrew/Library/Homebrew/brew.rb:12:in `<main>': Homebrew must be run under Ruby 2.3! You're running 2.0.0. (RuntimeError)

ruby-install 을 깃허브에서 다운로드한 후 다음과 같이 설치한다.

JaeHyunLees-iMac:bin jaehyunlee$ ./ruby-install
>>> Downloading latest ruby versions ...
>>> Downloading latest jruby versions ...
>>> Downloading latest rbx versions ...
>>> Downloading latest maglev versions ...
>>> Downloading latest mruby versions ...
Stable ruby versions:
  ruby:
    2.2.10
    2.3.7
    2.4.4
    2.5.1
  jruby:
    1.7.27
    9.1.16.0
  rbx:
    3.100
  maglev:
    1.0.0
  mruby:
    1.4.0
JaeHyunLees-iMac:bin jaehyunlee$ 

3. Homebrew 가 없다면

https://brew.sh/index_ko 접속해 다음 주소를 복사해 터미널에 붙여넣기 한다. xcode-command-line tool 이 설치되있지 않으면 중간에 다운로드 받은 후 설치한다.

/usr/bin/ruby -e “$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)”

==> This script will install:
/usr/local/bin/brew
/usr/local/share/doc/homebrew
/usr/local/share/man/man1/brew.1
/usr/local/share/zsh/site-functions/_brew
/usr/local/etc/bash_completion.d/brew
/usr/local/Homebrew

Press RETURN to continue or any other key to abort
==> /usr/bin/sudo /bin/mkdir -p /Library/Caches/Homebrew
Password:
==> /usr/bin/sudo /bin/chmod g+rwx /Library/Caches/Homebrew
==> /usr/bin/sudo /usr/sbin/chown jaehyunlee /Library/Caches/Homebrew
==> Downloading and installing Homebrew...
HEAD is now at 648a7c7b Merge pull request #4104 from reitermarkus/missing-formula
==> Cleaning up /Library/Caches/Homebrew...
==> Migrating /Library/Caches/Homebrew to /Users/jaehyunlee/Library/Caches/Homebrew...
==> Deleting /Library/Caches/Homebrew...
Already up-to-date.
==> Installation successful!

==> Homebrew has enabled anonymous aggregate user behaviour analytics.
Read the analytics documentation (and how to opt-out) here:
  https://docs.brew.sh/Analytics.html

==> Next steps:
- Run `brew help` to get started
- Further documentation: 
    https://docs.brew.sh

 JaeHyunLees-iMac:bin jaehyunlee$ 

여기 까지가 Ruby 최신버전을 받기 위해서다. ㅠㅠ

4. 다시 루비 업그레이드

두 대의 맥북에 설치했을 때 한쪽은 2.3.7을 설치해도 이상이 없었지만 한군데는 ruby 2.2.0을 설치해야 bundler가 정상적으로 설치됐다.

$./ruby-install ruby 2.3.7

5. Bundler 설치

$ gem install bundler

Write Permission 없다고 튕김. sudo gem install bundler

JaeHyunLees-iMac:bin jaehyunlee$ sudo gem install bundler
Password:
Fetching: bundler-1.16.1.gem (100%)
Successfully installed bundler-1.16.1
Parsing documentation for bundler-1.16.1
Installing ri documentation for bundler-1.16.1
1 gem installed
JaeHyunLees-iMac:bin jaehyunlee$ 

6. 깃허브에서 리퍼지토리 가져온다.

$ cd {리퍼지토리 폴더}
$ ls
$ Gemfile

Gemfile 이 없으면 vi 또는 텍스트 에디터를 사용해 새 파일을 생성한 후 다음과 같이 작성한다.

source 'https://rubygems.org'
gem 'github-pages', group: :jekyll_plugins

이파일은 여러분의 리포지토리 루트에 저장한다.

7. bundle install

$ bundle install

8. bundle service 가동

$ bundle exec jekyll serve &

정상적으로 서버가 가동되면 웹브라우저에서 http://localhost:4000 하면 리포지토리에 있는 페이지가 표시된다.

위 내용은 아래 사이트에서 참조했습니다.

https://help.github.com/articles/setting-up-your-github-pages-site-locally-with-jekyll/

Written on April 1, 2018