GitHub Pages에 Jekyll Chirpy 테마 설치 가이드

깔끔한 다크 모드, 모바일 반응형 디자인, 목차(TOC), 코드 하이라이팅, 검색 기능을 기본 지원하는 Chirpy 테마를 GitHub Pages에 설치하고 배포하는 전체 과정을 정리합니다.

과거에는 테마 소스 전체를 포크(Fork)해서 쓰는 경우가 많았으나, 현재는 공식 템플릿인 chirpy-starter를 사용하는 것이 업그레이드와 유지보수 측면에서 가장 안정적입니다.

사전 준비

• ruby 설치

# ruby version manager 설치
brew install rbenv

# 설치 가능한 ruby version 확인
rbenv install -l

# ruby 설치
rbenv 3.3.13

# global 설정
rbenv global 3.3.13

chirpy starter 저장소 생성

1. 공식 템플릿 저장소인 cotes2020/chirpy-starter에 접속합니다.
2. 우측 상단의 녹색 버튼 [Use this template] → [Create a new repository]를 클릭합니다.
3. 저장소 설정:
   • Repository name: username.github.io (반드시 본인의 GitHub 사용자명과 일치해야 개인 도메인 루트로 연결됩니다.)
   • Visibility: Public 선택
4. [Create repository]를 눌러 생성을 완료합니다.

의존성 설치

# 1. 저장소 클론
git clone https://github.com/<username>/<username>.github.io.git
cd <username>.github.io

# 2. 필요한 Ruby 젬(Gem) 설치
bundle install

로컬 테스트 서버 구동

bundle exec jekyll serve --livereload

정상 실행되면 http://127.0.0.1:4000 으로 접속하여 기본 화면이 뜨는지 확인합니다.