맥OS 에 Jekyll 설치

Command Line Tools 설치

먼저, Native 확장기능을 컴파일할 수 있게 해주는 명령행 도구를 설치해야 하므로, 터미널을 열어 다음 명령을 실행합니다:

xcode-select --install

루비 설치

Jekyll 은 루비 > 2.4.0 버전을 필요로 합니다. 맥OS 카탈리나 10.15 는 루비 2.6.3 이 기본 포함되어 있으므로 아무런 문제가 없습니다. 이전 버전의 맥OS 시스템을 사용중이라면, 새로운 버전의 루비를 설치해야 합니다.

Homebrew 사용

최신 버전의 루비를 Homebrew 로 설치할 수 있습니다.

# Homebrew 설치
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

brew install ruby

Homebrew 루비의 경로를 쉘 환경설정에 추가합니다:

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

이제 터미널을 재시작하여 추가한 루비 설정을 확인합니다:

which ruby
# /usr/local/opt/ruby/bin/ruby

ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580)

야호, 안정적인 버전의 루비가 작동하고 있어요!

rbenv 사용

많은 사람들이 rbenv 로 여러 버전의 루비를 관리합니다. 각각의 프로젝트마다 다른 버전의 루비를 실행해야 할 때 아주 유용합니다.

# Homebrew 설치
/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

# rbenv 와 ruby-build 설치
brew install rbenv

# 쉘 환경에 rbenv 가 연동되도록 설정
rbenv init

# 설치상태 검사
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/master/bin/rbenv-doctor | bash

터미널을 재시작하면 변경사항이 적용됩니다. 이제 원하는 버전의 루비를 설치할 수 있습니다. 최신 버전의 루비를 사용해봅시다:

rbenv install 2.6.3
rbenv global 2.6.3
ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580)

끝났습니다! rbenv 명령어 참고서를 읽어보면 다양한 버전의 루비를 프로젝트별로 관리하는 방법을 배울 수 있습니다.

Jekyll 설치

이제 남은 것은 Bundler 와 Jekyll 을 설치하는 것 뿐입니다.

로컬 설치

gem install --user-install bundler jekyll

그리고 설치된 루비 버전을 확인하려면

ruby -v
ruby 2.6.3p62 (2019-04-16 revision 67580)

이제 아래 내용을 쉘 환경에 추가하는데, X.X 부분에는 설치된 루비 버전의 처음 두 숫자를 넣습니다.

echo 'export PATH="$HOME/.gem/ruby/X.X.0/bin:$PATH"' >> ~/.bash_profile

젬 경로가 홈 디렉토리를 가리키고 있는지 확인하려면 이 명령을 실행합니다:

gem env

그리고 GEM PATHS: 가 홈 디렉토리 내의 경로를 가리키고 있는지 확인합니다.

루비를 업데이트하여 버전의 처음 두 숫자가 바뀌었다면, 환경설정을 수정하여 올바른 경로를 가리키도록 해야합니다.

글로벌 설치

파일 권한 문제와 sudo 사용을 피하기 위해서, 루비 젬을 시스템 경로에 설치하는 것은 권장하지 않습니다.

Mojave 버전 (10.14)

Mojave 의 시스템 무결성 보호 (SIP) 기능 때문에, 다음과 같이 실행해야 합니다:

sudo gem install bundler
sudo gem install -n /usr/local/bin/ jekyll

Mojave 버전 이전 (<10.14)

다음과 같이 실행하면 됩니다:

sudo gem install bundler jekyll

문제가 발생했나요?

문제해결 페이지를 읽어보거나 포럼에 도움을 요청하세요.