Github pages Hexo를 사용해서 만들기

Github Repository 생성하기

  • Github에 가입한다.

    https://github.com/

  • 아래와 같은 순서로 Repository 생성

    • New Repository, Repository 이름은 USERNAME.github.io
    • USERNAME 은 Github의 가입시에 사용자의 username을 입력한다
    • Public / Private 중 Public 선택
    • Create Repository 버튼을 통해 Repository 생성

Hexo란?

Hexo

  • Hexo는 Jekyll와 함께 대표적으로 정적 페이지를 쉽게 만들 수 있도록 도와주는 서비스
  • 두 서비스 역시 블로그 지향적인 서비스이며 Hexo의 경우에는 npm을 통해 쉽게 설치가 가능
  • 한 줄의 Command Line을 통해 Github에 바로 배포 가능
  • Jekyll과 마찬가지로 다양한 플러그인과 테마를 지원

Hexo 설치

Hexo를 이용하기 위해서는 먼저 아래의 구성 요소들이 사전에 설치가 되어 있어야 한다

Window10에서 Ubuntu 설치

  • 검색 기능을 활용해서 Window 기능 켜기/끄기 메뉴에 들어간다.

    Window 기능 켜기/끄기

  • “Linux용 Windows 하위시스템” 버튼을 체크

  • Microsoft Store에 가서 ubuntu를 찾아 설치한다.
    Microsoft Store

  • cmd 창에서 bash 명령어로 linux 시스템에 접근 가능하다.

    cmd 창에서 bash 명령어

Hexo CLI 설치

1
2
3
4
5
6
$ sudo -s
$ apt-get install npm
$ npm install hexo-cli -g
$ hexo init blog
$ cd blog
$ npm install

Hexo 설정

_config.yml 파일 설정

*hexo의 기본정보를 셋팅합니다.

https://hexo.io/docs/configuration

Site

블로그의 이름과 간략한 소개등을 수정 할 수 있다.

1
2
3
4
5
6
7
8
# Site
title: Max's Blog
subtitle: 개발시 정리사항 끄적끄적
description: 개발시 정리했던 사항을 끄적이기 위한 블로그
keywords: Android, java, 안드로이드, 자바
author: Jung Max
language: ko
timezone: Asia/Seoul

URL

블로그 URL정보를 설정 할 수 있습니다.

1
2
3
4
5
6
# URL
## If your site is put in a subdirectory, set url as 'http://yoursite.com/child' and root as '/child/'
url: http://username.github.io/
root: /
permalink: :year/:month/:day/:title/
permalink_defaults:

Github 정보

자신의 Git Page의 Repository 정보를 입력하면 이후에 손쉽게 배포가 가능

1
2
3
4
5
6
7
8
## Plugins: https://hexo.io/plugins/
Plugins:
- hexo-deployer-git

# Deployment
deploy:
type: git
repo: https://username@github.com/username/username.github.io

로컬에서 테스트

기본적인 설정이 완료가 되면 아래의 Command Line을 통해 로컬에서 서버를 구동 할 수 있다.

1
2
3
# server 설치
$ npm install hexo-server --save
$ hexo server

서버가 구동이 되면 아래의 주소를 통해 브라우저에서 블로그에 접속 할 수 있다.

http://localhost:4000

Git에 배포하기(Deploy)

hexo-deployer-git은 _config.yml에 정의되어 있기 때문에, server를 구동하기 전에 먼저 설치되어야 한다.

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

아래 명령을 통해 간단하게 Github에 배포(Deploy)할 수 있다.

1
$ hexo deploy --generate

http://username.github.io 에 적용 완료.

새 개시물 추가하기

hexo new post 기능을 쓰면 쉽게 추가가 가능하다.

1
hexo new post post_name

위 명령어를 사용하면 source\_posts폴더에 post_name.md 파일이 생성된다.
해당 파일을 markdown 형식으로 post를 작성하면 된다.

공유하기