Mac에서 Jekyll 실행하기

연초에 저는 한 달에 두 개의 새 Mac을 연속으로 구입했습니다. 회사를 옮기고 이전 노트북을 반납해야 했습니다. 그래서 교체품을 주문했지만 현재 하드웨어 부족으로 인해 배송에 몇 주가 걸렸습니다. 그동안 하나를 임대해야 했습니다.

Jekyll 스택을 연속으로 두 번 설치해야 한다는 뜻입니다. 처음에는 시간이 꽤 걸렸습니다. 두 번째는 훨씬 빨랐습니다.

이 글에서는 같은 일을 하고자 하는 다른 개발자들과 미래의 제 자신에게 도움이 되고자 한번에 적어봅니다.

새로운 Mac OS 시스템은 이미 설치된 Ruby 배포판과 함께 제공됩니다. 안타깝게도 업그레이드할 수 없습니다. 내 Mac에서는 이 글을 쓰는 시점에 2.6.8p205 (2021-07-07 revision 67951) 입니다.

첫 번째 단계는 최신 버전을 설치하는 것입니다. 이를 위해 먼저 rbenv를 설치해야 합니다.

Use rbenv to pick a Ruby version for your application and guarantee that your development environment matches production. Put rbenv to work with Bundler for painless Ruby upgrades and bulletproof deployments.

-- https://github.com/rbenv/rbenv

다음은 Mac OS용 명령줄 패키지 관리자인 Homebrew 에 의존합니다. 새로 구입하면 가장 먼저 설치하는 것입니다.

brew install rbenv

다음으로 쉘을 초기화해야 합니다. 이를 위해 쉘 프로필을 업데이트해 보겠습니다.

eval "$(rbenv init - zsh)"

기본 Z-shell을 사용하고 있습니다. 다른 셸을 사용하는 경우 해당 프로필을 찾습니다.

그런 다음 현재 터미널 창에서 프로필을 실행해야 합니다.

. ~/.zshrc

이 시점에서 사용 가능한 모든 Ruby 배포판을 나열해야 합니다.

rbenv install --list

출력은 다음과 유사해야 합니다.

2.6.9
2.7.5
3.0.3
3.1.1
jruby-9.3.4.0
mruby-3.0.0
rbx-5.0
truffleruby-22.0.0.2
truffleruby+graalvm-22.0.0.2

최신 "표준"버전을 설치해 보겠습니다.

rbenv install 3.1.1

이제 이 버전을 사용할 수 있습니다. Jekyll 폴더로 이동하여 다음을 입력합니다.

rbenv local 3.1.1

Bundler 으로 내 Jekyll 블로그의 종속성을 관리합니다. Bundler는 다른 모든 것과 마찬가지로 Gem입니다.

gem install bundler

종속성은 myGemfile 에 기록됩니다. bundler를 실행하여 설치할 수 있습니다.

bundle install

이 단계에서 표준 Jekyll 블로그가 작동해야 합니다. 그러나 내 블로그는 Asciidoctor , 더 중요한 것은 asciidoctor-diagram 도 사용합니다. PlantUML 구문을 사용하여 다이어그램을 그립니다. PlantUML에는 JVM이 필요하며 graphviz .

JVM의 경우 전용을 설치하거나 간단한 Ruby 배포 대신 JRuby를 설치할 수 있습니다. graphviz에는 전용 실행 파일이 필요합니다.

brew install graphviz

짜잔!

이 단계를 이보다 더 자주 수행해야 한다면 더 자동화할 것입니다.

더 나아가려면:

Jekyll

rbenv

rbenv cheatsheet

Bundler

2022년 6월 5일 A Java Geek에서 원래 게시됨