GitHub Pages 블로그 처음 만들기 (2025년 Ver. Chirpy 테마)

게시 2025/07/05 업데이트 2025/07/18

By Boolean

15 분읽는 시간

🎯 30분으로 완성하는 나만의 전문 블로그

개발자가 아니어도 괜찮습니다! 이 글을 따라하면 누구나 30분 안에 GitHub Pages와 Chirpy 테마를 사용해서 전문적인 블로그를 만들 수 있습니다.

✨ 완성 후 결과물

🌐 완전 무료 GitHub Pages 호스팅
📱 모바일/데스크톱 반응형 디자인
🔍 검색 기능 내장
🏷️ 카테고리/태그 시스템
💬 댓글 시스템 지원
📊 SEO 최적화 완료

📋 준비물

컴퓨터 (MacOS 또는 Windows)
GitHub 계정
인터넷 연결
약 30분의 시간

1. 개발 환경 준비하기 (약 15분)

1-1. 터미널 열기

MacOS 사용자:

Cmd + Space로 Spotlight 열기 → “터미널” 검색
또는 Applications > Utilities > Terminal

Windows 사용자:

시작 메뉴에서 “PowerShell” 검색 → “관리자 권한으로 실행”
또는 Win + X → “Windows PowerShell(관리자)”

1-2. 패키지 관리자 설치

MacOS - Homebrew 설치:

  
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

설치 확인:

brew --version

Windows - Chocolatey 설치: PowerShell(관리자)에서 실행:

  
Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))

설치 확인:

  
choco --version

1-3. Git 설치

MacOS:

brew install git

Windows:

  
choco install git

공통 - Git 설정:

  
git config --global user.name "당신의 이름"
git config --global user.email "당신의 이메일"

1-4. Ruby 설치

MacOS - rbenv 사용:

  
brew install rbenv
rbenv install 3.2.2
rbenv global 3.2.2
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.zshrc
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

Windows - RubyInstaller 사용:

RubyInstaller 다운로드 페이지 방문
“Ruby+Devkit 3.2.x (x64)” 다운로드 및 설치
설치 마지막에 “Run ‘ridk install’” 체크박스 선택
나타나는 창에서 3 입력 후 Enter

1-5. Node.js 설치

MacOS - nvm 사용:

  
brew install nvm
mkdir ~/.nvm
echo 'export NVM_DIR="$HOME/.nvm"' >> ~/.zshrc
echo '[ -s "/opt/homebrew/bin/nvm" ] && \. "/opt/homebrew/bin/nvm"' >> ~/.zshrc
source ~/.zshrc
nvm install --lts
nvm use --lts

Windows:

Node.js 공식 사이트 방문
LTS 버전 다운로드 및 설치

1-6. 설치 확인

양쪽 OS 공통:

  
git --version
ruby --version
node --version
npm --version

✅ 성공 확인: 모든 명령어가 버전 정보를 출력하면 성공!

2. GitHub 저장소 만들기 (약 3분)

2-1. Chirpy 템플릿 사용하기

웹브라우저에서 Chirpy 템플릿 방문
“Fork” 버튼 클릭
“Create a new repository” 선택

2-2. 저장소 설정

Repository name: [본인의GitHub아이디].github.io
- ⚠️ 중요: 정확히 이 형식으로 입력해야 합니다!
- 예시: GitHub 아이디가 “johndoe”라면 → “johndoe.github.io”
Description: “My personal blog” (선택사항)
Public 선택 (중요!)
“Create repository from template” 클릭

✅ 성공 확인: 새로운 저장소가 생성되고 https://github.com/[사용자명]/[사용자명].github.io 주소로 이동됨

3. 블로그 가져오기 및 로컬 설정 (약 5분)

3-1. 저장소 복제

MacOS/Windows 공통:

git clone https://github.com/[본인의GitHub아이디]/[본인의GitHub아이디].github.io.git
cd [본인의GitHub아이디].github.io

3-2. 의존성 설치

양쪽 OS 공통:

gem install bundler
bundle install

💡 참고: 설치 시간이 3-5분 정도 소요될 수 있습니다.

3-3. 로컬 서버 실행

bundle exec jekyll serve

브라우저에서 http://127.0.0.1:4000 접속

✅ 성공 확인: Chirpy 테마의 기본 블로그가 표시됨 (예시 글들이 보임)

4. 블로그 초기화하기 (약 3분)

먼저 터미널에서 Ctrl + C로 로컬 서버를 종료합니다.

4-1. 초기화 스크립트 실행

MacOS 사용자:

bash tools/init.sh

Windows 사용자:

프로젝트 폴더에서 우클릭 → “Git Bash Here” 선택
Git Bash에서 실행:
1 bash tools/init.sh

✅ 성공 확인:

“Initialization successful!” 메시지 출력
일부 예시 파일들이 자동으로 삭제됨
Git 히스토리가 새롭게 정리됨

5. ⚠️ 문제 해결 가이드

이 섹션은 순서를 지키지 않고 급하게 진행한 경우 발생할 수 있는 문제들입니다.

문제 1: “This operation must be run in a Git repository” 오류

원인: git clone을 하지 않고 직접 다운로드한 경우 해결: 2-3번 섹션으로 돌아가서 git clone으로 다시 시작

문제 2: init.sh 실행 후 “Please commit and push your changes” 메시지

원인: init.sh 실행 전에 _config.yml 등을 미리 수정한 경우 해결:

  
git add .
git commit -m "chore: initialize blog with chirpy theme"
git push --force

문제 3: commitlint 오류 “subject may not be empty” 등

원인: 커밋 메시지가 conventional commits 규칙에 맞지 않음 해결: chore: 설명 형태로 소문자로 시작하여 커밋

문제 4: `_config.yml` 인코딩 오류

원인: 파일이 UTF-8 BOM으로 저장됨 해결:

VS Code에서: 우하단 “UTF-8” 클릭 → “Save with Encoding” → “UTF-8” 선택

문제 5: Ruby/Node.js 버전 충돌

MacOS: rbenv와 nvm으로 버전 변경 Windows: 최신 LTS 버전으로 재설치

🎯 Pro Tip: 이 문제들을 피하려면 정확히 1→2→3→4 순서로 진행하세요!

6. 블로그 개인화 설정 (약 5분)

6-1. _config.yml 파일 수정

텍스트 에디터로 _config.yml 파일을 열어서 다음 항목들을 수정합니다:

  
# 언어 및 시간대
lang: ko-KR
timezone: Asia/Seoul

# 기본 정보
title: 나의 개발 블로그
tagline: 배움을 기록하는 공간
description: >-
  개발하면서 배운 것들과 일상을 기록하는 블로그입니다.

# 사이트 주소
url: "https://[본인의GitHub아이디].github.io"

# GitHub 정보
github:
  username: [본인의GitHub아이디]

# 소셜 정보
social:
  name: [본인 이름]
  email: [본인 이메일]
  links:
    - https://github.com/[본인의GitHub아이디]

# 테마 옵션
theme_mode: # [light | dark] - 비워두면 토글 버튼 제공

# 기타 설정
toc: true
paginate: 10

6-2. 설정 확인

bundle exec jekyll serve

브라우저에서 http://127.0.0.1:4000 접속하여 변경사항 확인

✅ 성공 확인: 블로그 제목과 설명이 변경되어 표시됨

7. 첫 글 작성하기 (약 4분)

7-1. 글 파일 생성

_posts 폴더에서 새 파일 생성: 2025-07-05-my-first-post.md

7-2. 글 내용 작성

  
---
title: 안녕하세요! 첫 번째 글입니다
date: 2025-07-05 14:30:00 +0900
categories: [일상, 블로그]
tags: [첫글, 시작]
---

## 블로그를 시작하며

드디어 나만의 블로그를 만들었습니다! 🎉

앞으로 이곳에서:
- 개발하면서 배운 것들
- 일상 이야기
- 좋았던 책이나 영화 후기

등을 차근차근 기록해보려고 합니다.

### 목표

1. 주 1회 이상 꾸준히 글쓰기
2. 배운 것을 정리하는 습관 만들기
3. 나중에 돌아봤을 때 성장이 보이는 블로그 만들기

잘 부탁드립니다! 😊

### 블로그 만들기 과정

GitHub Pages와 Chirpy 테마를 사용해서 블로그를 만들어봤는데, 
생각보다 쉽고 재미있었습니다. 

무료로 이렇게 전문적인 블로그를 만들 수 있다니 정말 좋네요!

7-3. 미리보기

로컬 서버가 실행 중이라면 자동으로 새 글이 반영됩니다. 브라우저를 새로고침하여 확인하세요.

✅ 성공 확인: 새로 작성한 글이 블로그 메인 페이지에 표시됨

8. 블로그 발행하기 (약 3분)

8-1. 변경사항 커밋 및 푸시