hexo 시작하기

hexo 란

Hexo는 node.js 기반 정적 사이트 생성기(Static site generator)의 일종이다….
사실 잘 모르겠고 간단하고 강력한 블로그 프레임 워크다 라고 하는게 더 이해가 쉬울듯하다.
hexo 주소 : https://hexo.io/

hexo 설치 전 필수 사항

크게 3가지가 필요하다.

node.js 설치 https://nodejs.org/ko/
git 설치 https://git-scm.com/
github 계정생성 https://github.com

node.js 설치

node.js는 다운받아서 설치해주면 되는데 안전버전이랑, 최신버전으로 나뉜다.
보통 안전버전을 많이 권하긴 한다.

노트를 설치한뒤에 cmd(터미널,명령 프롬프트)에 node -v를 입력하고 버전정보가 나오면 설치가 된 것이다.

1
2

node -v
//v10.15.3

git 설치

사이트 url로 들어가면 오른쪽에 download 2.23.0 for windows 식으로 뜨는데 다운 받아 설치해주면 된다.
git 설치 프로그램의 default 셋팅 그래로 설치한다.
git을 설치하면 Git Bash 와 git GUI가 자동으로 같이 설치된다.

git bash의 경우 vscode 에디터의 기본 터미널로 설정하면 편하다.

• 설정방법
  설정(하단 톱니바퀴) -> 사용자 설정 -> json 추가

1

"terminal.integrated.shell.windows": "C:\\Program Files\\Git\\bin\\bash.exe", //git bash를 기본 터미널로 사용

github 계정생성 및 repository 등록

1. 일단 github에 가입을 한다.
2. 가입 후 https://github.com/username 주소에서 본인 github가 나온다.
3. Repository 탭의 new 버튼을 누르면 새로운 Repository가 생성된다.

4. Repository name , Description(생략가능) , Public 체크, Initialize this repository with a README (생략가능) 을 선택하고 Create repository를 누르면 나만의 저장소가 생긴다.

5. Repository를 생성하고 clone download 버튼을 누르면 주소가 나오는데 이를 복사해둔다.

6. repository를 생성하면 사이트 url을 얻을 수 있는데 , setting 탭의
   하단의 스크롤을 해 GitHub Pages의 souce 의 select를 none에서 master branch로 바꾸면 url을 알 수 있다.

hexo 설치

모든 요구사항이 설치되면 npm(node 설치하면 자동으로 사용가능함) 과 함께 hexo 설치가 가능하다.

1
2

npm install hexo-cli -g
hexo -v

hexo를 설치하고 hexo -v를 통해 hexo 버전이 나오면 설치가 된것이다.
나의 경우에는 blog라는 루트폴더를 만들고 cd로 blog 경로로 들어가서 hexo를 설치했다.

hexo 설치가 성공

1
2
3
4
5
6
7
8

hexo init <폴더명>
cd <폴더명>
npm install

ex)
hexo init blog
cd blog
npm install

설치가 성공하면 local 서버를 띄워서 확인해볼 수 있다.

1
2
3
4
5
6
7

hexo s //로컬서버 구동 명령어


INFO  Checking dependencies
INFO  Validating the configuration file
INFO  Start processing
INFO  Hexo is running at http://localhost:4000 . Press Ctrl+C to stop.

이런식으로 로컬서버가 나오면 성공

클릭시 hexo 기본테마인 landscape의 theme가 내 로컬서버에 나타난다.

github repository와 연결

이제 로컬말고 방금 만든 내 github와 연결하면 되는데, 루트 폴더 아래의
_config.yml이라는 파일이 있다. 클릭 후

1
2
3
4
5
6

# Deployment
## Docs: https://hexo.io/docs/deployment.html
deploy:
  type: git
  repo: //아까 복사해놓은 내 repository 주소를 넣는다.(.git으로 끝남)
  branch: master

을 넣으면 내 github와 연결된다.

배포

이제 github repository로 내 hexo 블로그를 배포해야한다.

1
2

hexo clean
hexo d -g

가끔 배포가 안돼는 경우에 한번씩 clean 해주고 배포하면 잘 된다.
배포 후 몇분 기다리면 github에 내 블로그가 올라간다.

확인

아까 봤던 사이트 url로 들어가면 내 블로그가 들어가 있는것을 확인할 수 있다.