Hexo와 github로 블로그 사용하기

Github 레포지토리 생성

 

 

위와 같이 자신의 계정 아래에 새로운 레포지토리를 생성하는데, 레포지토리의 이름은 "[계정 이름].github.io" 이다.

 

자신의 계정 이름이 user31337이라면 "user31337.github.io"

 

그리고 위의 사진에서 보면 맨 아래에 Create repository 버튼이 있는데 이 버튼을 눌러 레포지토리 생성을 완료한다.

 

 

Github 설정

 

 

방금 생성한 레포지토리를 들어가서 위의 메뉴들 중 맨 오른쪽에 Settings 메뉴에 들어간다.

 

 

Settings 메뉴에서 왼쪽에 보면 Pages 메뉴가 있다.

 

Pages 메뉴에 들어가면 위와 같이 되어 있는데

 

 

위와 같이 Branch 항목을 설정해주면 위에 파란 글씨로 URL이 설정된다.

 

---

Hexo 설치, 설정 및 실행

 

1. Hexo는 Node.js 기반이므로 Node.js를 설치한다.

npm install hexo-cli -g

 

2. hexo로 blog 프로젝트를 만든다.

hexo init [디렉토리 명]
cd [디렉토리 명]
npm install

 

3. 자신이 원하는 hexo 테마를 clone한 뒤 themes 폴더 안에 clone 받은 테마의 폴더명을 자신이 사용하기 편하게 바꾼다. (hexo-theme-xxx → xxx)

 

4. 루트 경로에서 _config.yml 파일을 아래처럼 수정

theme: [위에서 바꾼 폴더 명]
ex) theme: Chic

 

5.  테마에 필요한 npm 패키지들을 설치(없으면 생략)

npm install --save [패키지들]

 

6. 아래의 명령어로 로컬에서 테마가 적용됐는지 확인

hexo s

 

7. Hexo에서 git으로 정적파일을 생성 후 편하게 배포하기 위한 패키지 다운로드

npm install --save hexo-deployer-git

 

8. _config.yml 파일의 내용을 아래와 같이 변경

deploy:
  type: git
  repo: 저장소 주소(ex. <https://github.com/사용자계정/사용자계정.github.io.git>)
  branch: master

ex)
deploy:
  type: git
  repo: https://github.com/user31337/user31337.github.io.git
  branch: master

 

9. publish용 정적파일 생성

hexo generate

 

10. 동시 생성 및 github 배포

hexo d -g

 

tip) 캐시 때문에 업데이트가 반영이 안될 경우

hexo clean
hexo d -g

 

---

 

 

브라우저에서 "[사용자계정].github.io" 로 접속하면 위와 같이 적용된 테마와 함께 블로그 생성이 완료

 

---

https://velog.io/@nonz/GitHub-Pages-%EC%97%90-Hexo-%EB%B8%94%EB%A1%9C%EA%B7%B8-%EB%A7%8C%EB%93%A4%EA%B8%B0