Hexo 블로그 제작 가이드

juntae123456 Lv1

Hexo 기반 블로그를 제작하면서 Chirpy 테마에 대한 가이드는 많았지만,
Hexo의 다른 테마에 대한 자료는 부족하다고 느껴 이 가이드를 작성하게 되었습니다.
제가 사용한 테마는 Redefine 테마입니다.
공식 사이트에도 시작 가이드가 있지만 영어로 되어 있고 설명이 간단해 GitHub 배포 과정에서 어려움을 겪었습니다.


🔧 Hexo 설치 및 초기 설정

1
npm install hexo-cli -g

※ npm이 설치되지 않았다면 Node.js 설치 후 진행하세요.

1
2
3
hexo init blog
cd blog
npm install hexo-theme-redefine@latest
  • 위 명령어로 blog 디렉토리에 Hexo 프로젝트를 초기화하고 테마를 설치합니다.

🗂 GitHub Pages 연결

  1. GitHub에서 새로운 레포지토리를 생성합니다.
    레포지토리 이름은 반드시 다음과 같은 형식으로 작성합니다:
    깃허브아이디.github.io (예: juntae123456.github.io)
  2. 터미널에서 레포지토리를 클론합니다:
1
git clone https://github.com/juntae123456/juntae123456.github.io.git
  1. 클론된 폴더 안에 Hexo로 만든 blog 폴더의 모든 파일을 붙여넣습니다.

⚙️ _config.yml 설정

  • 다음과 같이 테마를 redefine으로 지정합니다:
1
theme: redefine
  • 배포 설정은 _config.yml 하단에 추가합니다:
1
2
3
4
deploy:
type: git
repo: https://github.com/juntae123456/juntae123456.github.io.git
branch: main

🚀 배포하기

1
2
hexo clean
hexo deploy
  • 위 명령어를 실행하면 블로그가 GitHub Pages에 배포됩니다.

🎨 테마 설정 변경

  • 테마 관련 설정은 아래 경로의 _config.yml 파일에서 수정합니다:
1
node_modules/hexo-theme-redefine/_config.yml
  • 테마내용은 Redefine 테마를 참조하시기 바랍니다.
  • 변경 후 다시 배포하려면:
1
2
hexo clean
hexo deploy

❓ 도움이 필요하신가요?

  • 블로그 설정 중 막히는 부분이 있다면 댓글로 질문해주세요.
    제가 아는 범위에서 최대한 도와드리겠습니다.
  • 제목: Hexo 블로그 제작 가이드
  • 작성자: juntae123456
  • 작성일 : 2025-06-19 02:50:14
  • 수정일 : 2025-06-19 03:29:11
  • 링크: https://juntae123456.github.io/2025/06/19/first/
  • 저작권 안내: 이 글은 CC BY-NC-SA 4.0 라이선스를 사용합니다.
댓글