Hexo 블로그 Github를 이용해 만들어보기

블로그를 만들고 꾸미다 보니 나같은 사탐들이 많을 거라는 생각에서
Hexo를 이용해 Github 블로그 세팅 하는 방법들을 처음부터 하나씩 보고자 한다.

Hexo

Hexo는 Node.js 기반의 정적 사이트 생성기(Static site generator)이다.
Hexo 공식 사이트에서는 빠르고 간단하고 파워풀한 블로그 프레임워크라고 소개하고 있다.
npm을 통해 쉽게 설치가 가능하고 배포역시 쉽게 가능한 것이 장점이다.
한글문서로도 잘 정리가 되어있으니 참고 하길 바랍니다. Hexo 한글 튜토리얼

설치 전 준비

Github를 이용하여 Hexo 블로그를 세팅 하려고 하기때문에

위의 구성요소들의 사전 설치가 필요하다. 위에 설치 방법들은 이번 포스팅에서는 따로 언급하지 않고 공식사이트로의 링크들만 걸어 놓겠습니다.

설치하기

node.js가 설치되어 있다면 npm을 이용해서 간편히 설치 할 수 있습니다.

bash
1
npm install hexo-cli -g

블로그 Setup

아래 명령을 실행 하여 간단하게 hexo를 초기화 할수 있습니다.

bash
1
2
3
hexo init <폴더이름>
cd <폴더이름>
npm install

초기화가 완료되면 아래와 같은 구조로 세팅됩니다.

1
2
3
4
5
6
7
8
.
├── _config.yml
├── package.json
├── scaffolds
├── source
| ├── _drafts
| └── _posts
└── themes

블로그 설정

_config.yml이 root경로에 생성되는데 해당 파일을 통해서 블로그에 대한 설정을 세팅할 수 있습니다.
자세한 설명은 Hexo의 Cofiguration을 통해 확인해 볼수 있다.

로컬테스트

간단한 설정을 하고 나서 바로 로컬 서버에서 띄워 확인해 볼 수 있습니다.

bash
1
2
hexo server
hexo s #단축명령어

서버가 구동되면 아래와 같은 문구가 출력되며 http://localhost:4000에서 확인 할 수 있습니다.

1
Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

Github 블로그 호스팅

Github에서 새로운 repository를 생성합니다.
Repository name을 username.github.io의 형식으로 기재하고 public으로 만들어 줍니다.

github에서 repository 생성

설정하기

_config.yml 에서 Deployment 항목을 설정해 준다.

1
2
3
4
5
# Deployment
deploy:
type: git
repo: repository 주소
branch: master

Github에 배포하기

hexo server를 통해 로컬에서 정상적으로 작동되었다면 Github에 hexo cli를 통해 쉽게 배포가 가능하다.

정적리소스 생성

bash
1
2
hexo generate 
hexo g #단축 명령어

public 폴더가 생성되어 배포가 가능하다.

배포하기

bash
1
2
hexo deploy
hexo d #단축 명령어

배포 중 오류가 발생 하면 아래 이슈체크를 확인

Generate와 Deploy 동시실행

아래와 같이 Generate와 Deploy를 동시실행 할 수도 있다.

bash
1
2
3
4
5
hexo deploy --generate  #Deploy 전에 Generate를 해준다.
hexo d -g #단축 명령어

hexo generate --deploy #Generate 후에 Deploy를 해준다.
hexo g -d #단축 명령어

https://username.github.io 로 접속하면 deploy된 사이트가 확인 가능하다.

이슈체크

배포시 아래와 같은 에러가 발생하면

1
ERROR Deployer not found: git

hexo-deployer-git 플러그인을 설치해준다.

bash
1
npm install hexo-deployer-git --save

업데이트 시

간혹 업데이트가 바로 이루어 지지 않을 경우에는 아래와 같이 public을 clean시켜준 후 배포를 하면 된다.

bash
1
2
hexo clean
hexo d -g

글쓰기

bash
1
hexo new post <포스트이름>

\source_post 폴더에 포스트이름.md 으로 새로운 마크다운 파일이 생성됩니다.
포스트내용을 작성한후에 다시한번 clean과 generate 그리고 deploy를 해주면 정상 반영된다.

이상으로 Hexo 블로그 만들기에 대한 포스팅을 마친다.
잘못된 사항이나 궁금한 점은 댓글로 남겨주시면 감사하겠습니다.

댓글

Your browser is out-of-date!

Update your browser to view this website correctly. Update my browser now

×