목차

  1. Hexo 글쓰기
  2. more, excerpt
  3. Escape
  4. 이미지 삽입
  5. 로컬에서 확인하기
  6. 마치며

Hexo 글쓰기

hexo-cli가 워낙 잘 되어있기 때문에 간단한 명령어를 통해 글을 만들 수 있습니다.

1
2
3
4
5
6
7
8
# 일반 post는 아래와 같이 만듭니다.
$ hexo new post "Github 블로그 만들기 with Hexo - 1"

# draft 아래와 같이 만듭니다.
$ hexo new draft "Github 블로그 만들기 with Hexo - 2"

# draft를 post로 만들때
$ hexo publish "Github 블로그 만들기 with Hexo - 2"

draft란 초안이라는 의미입니다.

참고로 draft를 post로 만들면 상단 front-matter가 초기화되니 꼭 확인을 해야겠습니다.
꼭 draft를 사용하지 않아도 브랜치 관리를 잘 해주면 해결될것 같기도 합니다.

위 둘의 경우는 각각 scaffolds/post.md, scaffolds/draft.md를 템플릿으로 사용합니다.
템플릿을 수정하고 싶은경우는 이 두 파일을 수정해두면 되겠습니다.
아래는 제가 사용하는 post.md 입니다.

1
2
3
4
5
6
7
8
9
10
11
---
title: Github 블로그 만들기 with Hexo - 글쓰기
date: 1555241000000
tags: []
categories: []
thumbnail: ""
permalink: ""
---

<!-- excerpt -->
<!-- toc -->

다른 항목들은 보시면 바로 이해가 가실테니 permalink만 간단히 설명하겠습니다.
각 글의 주소는 http://호스트명/2019/04/14/Github-블로그-만들기-with-Hexo---1/ 과 같이 title이 패스로 들어가게 됩니다.
만약 이 부분을 변경하고 싶을 때 permalink를 지정해주면 그 글의 주소는 설정한대로 적용됩니다.
자세한 내용은 Front-matter를 참고해주세요.

more, excerpt

인덱스 페이지에 어느부분까지 표시할 건지에 대한 세팅을 할 수 있습니다.
본문에 아래 주석을 이용하면 되는데요.

1
2
3
본문이 이렇게 있을 때 여기까지만 인덱스 페이지에 나타납니다.
<!-- more -->
여기서부턴 인덱스에 안나옵니다.

1
2
3
여기까지의 내용은 인덱스 페이지에만 나타납니다.
<!-- excerpt -->
여기서부턴 본문 시작입니다.

Escape

1
2
3
4
5

{% raw %}
{% codeblock %}
{% endraw %}

이렇게 템플릿 문법을 이스케이핑 하기 위해서는 raw 구문을 이용합니다.

이미지 삽입

_config.yml
1
post_asset_folder: true # or false

만약 _config.yml 파일의 저 항목이 true로 되어있다면 글 마다 글 제목과 같은 asset용 디렉토리가 생깁니다.

1
2
3

{% asset_img demo.png %}

그 디렉토리의 demo.png를 첨부하려면 위와같이 하면 됩니다.
Asset-Folders를 참고해주세요.

로컬에서 확인하기

퍼블리싱 전에 로컬에서 확인을 하기 위해서는 아래 명령을 이용합니다.

1
2
$ hexo server
$ hexo server --draft # draft도 확인하고 싶을 때

자세한 내용은 Commands를 참고해주세요.

마치며

사실 공식 문서에 다 있는 내용이고 문서가 번역도 다 되어있어서 거기를 한번 쓱 보시는게 좋을듯 합니다.
이제 대충 글 쓰는 방법은 알았으니 다음엔 배포를 어떻게 할지 알아보겠습니다.