github page와 hexo를 통해 블로그 만들기

[github page와 hexo를 통해 블로그 만들기]

해당 내용은 hexo 프레임워크를 사용하여 손쉽게 블로그를 제작하는 내용을 기술했다.

선행 작업은 gitpage를 hosting한 상태에서 진행이 필요하다.

 

hexo(https://hexo.io)

- hexo는 jekyll와 함께 대표적으로 정적 페이지를 쉽게 만들 수 있도록 도와주는 서비스이다.

 

1. 설치필요

   - node.js(https://nodejs.org/en/)

   - git

 

2. hexo 설치 및 블로그 생성

   - npm install hexo-cli -g

     hexo init blog  // hexo설치된 폴더로 이동하여 명령실행(C:\Users\..\AppData\Roaming\npm)

     cd blog

     npm install

   - 설치가 다 되면 설치된 경로에 _config.yml 이라는 설정파일이 생성되어있다. 이 곳에 페이지에 대한 설정을 할 수 있다.

     자세한 정보는 -> https://hexo.io/docs/ 를 참고(kr:https://hexo.io/ko/api)

   - 우선 _config.yml에서 간단한 정보를 수정하자

     [_config.yml]

     ....

     title: 전봉근

     subtitle: 전봉근 사이트

     description: 전봉근 개인 사이트

     author: BongKeun Jeon

 

     url: https://bkjeon1614.github.io/

     root: /

     permalink: :year/:month/:day/:title/

     permalink_defaults:

 

     deploy:

       type: git

       repo: https://github.com/bkjeon1614/bkjeon1614.github.com.git

       branch: master

     ....

 

     * 만약 custom domain을 적용하려면 url값은 custom domain 설정시 cname 파일을 생성하는 부분을 찾아보자

 

   - hexo server // 실행하면 http://localhost:4000/ 로컬에서 확인이 가능하다.

     

3. github에 배포하기

   - hexo generate  // 정적 리소스 생성

   - npm install hexo-deployer-git --save

   - hexo deploy  // 배포하기

   

   * 간혹 정상적으로 배포되었지만 페이지가 업데이트가 되지 않는 현상이 있는데 이 경우에는

     아래 명령과같이 clean후에 배포를 하자

     - hexo clean

     - hexo deploy --generate

 

4. 테마 적용

   - https://hexo.io/themes/ 접속한다.

   - 위의 테마 페이지에서는 github링크가 포함되어 있는데 테마를 적용하는 방법에 대해 설명되어있다.

   - 테마 설정 후 아래 명령을 최종적으로 실행하자.

   - hexo clean

   - hexo deploy --generate

 

5. 포스트 작성

   커맨드 라인으로 markdown파일을 생성하여 포스트를 작성하자.

   - hexo new post git // /source/_posts/git.md 라고 파일이 생성된다.

 

6. 에러

   (1) hexo deploy error - fatal: HttpRequestException encountered.

       - https://github.com/Microsoft/Git-Credential-Manager-for-Windows/releases/tag/v1.14.0 접속해서 GCMW-1.14.0.exe를 설치하고 다시 deploy를 시작하면된다.​