GitHub 블로그 만들기 (Jekyll)

작성일: 2023-06-27

Prerequisite

GitHub에 블로그를 띄우기 위해 다음과 같은 항목들이 필요합니다.

GitHub 계정
Notion 계정
Jekyll theme

구글에 검색해보면 굉장히 많은 Jekyll Theme 가 있는데 저는 just-the-docs를 선택했습니다.

로컬 환경 구축

선택한 Jekyll Theme 테스트를 위해 로컬 환경을 구축하겠습니다.

구축 순서는 다음과 같습니다.

rbenv, ruby-build 설치
ruby 패키지 설치
Jekyll Theme 저장소 Clone

rbenv, ruby-build 설치

rbenv는 ruby 버전관리 패키지로, 저는 Homebrew, zsh를 사용했습니다.

$ brew update
$ brew install rbenv ruby-build

# rbenv 버전 확인
$ rbenv -v

# 설치 가능한 ruby 버전 조회
$ rbenv install -l

# 원하는 버전의 ruby 설치
$ rbenv install 3.2.2

# 설치 학인 및 현재 사용중인 ruby 버전 확인
$ rbenv versions

# 원하는 버전의 ruby 사용
$ rbenv global 3.2.2

# rbenv 환경변수 등록
$ vi ~/.zshrc 

# 마지막 줄에 추가
[[ -d ~/.rbenv  ]] && \
  export PATH=${HOME}/.rbenv/bin:${PATH} && \
  eval "$(rbenv init -)"

# 적용
$ source ~/.zshrc

# ruby 버전 확인
$ ruby -v

ruby 패키지 설치

$ gem install bundler
$ gem install jekyll

Jekyll Theme 저장소 Clone

프로젝트를 받은 후 bundler 설치 후 실행 명령어를 입력합니다.

$ bundler install
$ bundle exec jekyll serve

실행이 완료되면 http://127.0.0.1:4000/ 로 접속해 아래 화면을 볼 수 있습니다.

Reference

https://frhyme.github.io/blog/install_jekyll_again/