hexo 기본 사용법 및 Tip

작성일 Edited on Disqus:

hexo는 octopress에 비해 사용법이 어렵지 않아서 구글링만 하면 쉽게 정보를 얻을 수 있다.

설치하면서 봤던 유용한 글 링크와 기본적인 팁들 몇개만 저장의 의미로 옮겨둔다.

새 글 작성

1
2
$ hexo new [layout] <title> # 새로운 파일을 만든다
$ hexo publish <포스트명>    # _draft -> _posts로 이동된다.

배포하기

public 폴더 하위에 정적 파일을 만드는 것과, 파일을 올리는 절차가 나뉘어있다.

로컬에서 hexo server를 실행할 때 보이는 페이지들은 public 폴더와 무관하다. 

1
2
3
4
5
6
$ hexo generate                     # public 폴더 생성하기
$ hexo clean                        # public 폴더 정리하기
$ hexo deploy                       # 생성된 파일들을 배포한다.

$ hexo generate --deploy            # 생성 + 배포를 한꺼번에
$ hexo deploy --generate            # 생성 + 배포를 한꺼번에

설치 관련 : disqus 활성화

config에 disqus_shortname 항목을 신규추가하고, disqus의 사이트 이름을 넣는다.

테마 파일들은 config의 값 설정 여부를 통해 disqus를 활성화할지 결정한다.

설치 관련 : google analystic 활성화

역시 config에 google_analytics 항목을 신규로 넣으면서 고유키를 지정한다.

테마 파일들은 이 설정을 확인해 나머지 처리를 활성화한다.

설치 관련 : 사용하면 좋은 utility

1
2
3
npm install hexo-browsersync --save # 브라우저 실시간 갱신
npm install hexo-deployer-git --save # git 배포. 사실상 필수.
npm install hexo-generator-feed --save # rss 생성. 사실상 필수.

Tip: 로컬 서버에서 draft문서도 함께 보기

기본 draft 문서까지 포함해서 보려면 아래처럼 실행

1
$ hexo server --draft

Tip: 테마 설치할 때 git submodule 활용하기

설치는 git submodule을 이용해서 설치한다

1
$ git submodule add https://<원본경로> themes/<이름>

다른 환경에서 depot을 클론할 때는 submodule도 함께 받아야 한다.

1
$ git submodule update --init --recursive

참고 :