Hugo 정적 사이트 생성기 가이드

2020-01-15

Hugo는 Go언어로 만들어진 정적 사이트 생성기(static site generator)입니다. Go언어로 만들어져서 정적 파일 생성이 빠르고 최근 많은 인기를 얻고 있습니다.

사전 정의 변수

 {{ .Title }}

사용자 정의

{{ $address }}

파셜 템플릿 가져오기

{{ partial "header.html"}}

layouts/posts/single.html.html가 layouts/posts/single.html보다 우선 순위가 높습니다.

layouts/_default

위 디렉터리에 접근해보면 베이스 템플릿인 baseof.html가 존재합니다. 디폴트 리스트 템플릿인 list.html 파일이 존재합니다.

템플릿 설치는 https://themes.gohugo.io/ 사이트를 이용할 수 있습니다.

$ hugo new site happy

$ hugo server -D

$ hugo server -t <theme name>

$ hugo server -v --debug

$ hugo new posts/hello.md

위와 같이 추가하면 /posts/hello 경로의 마크다운 문서가 추가됩니다.

-t 옵션을 추가해 public 디렉터리에 정적 파일을 만듭니다.

$ hugo -t <theme name>

주의할 사항은 마크다운 상단에 설정이 draft: false 인 문서만을 정적 파일로 만듭니다. 예를 들어 /posts/hello.md라는 파일을 정적 파일을 생성하려면 draft 상태값이 false여야 합니다.

---
title: "hello"
date: 2019-12-25T21:59:01+03:00
draft: false
---

hugo를 배포를 빠르게 하기 위해 저장소에 연결 후 배포 스크립트를 작성해 두면 편리합니다. 먼저 hugo를 배포하기 위해서는 로컬 저장소를 원격 저장소에 연결해 주어야 합니다.

$ git remote add origin https://github.com/happygrammer/happygrammer.github.io.git

이후, 아래와 같은 쉡 스크립트(push.sh)를 두어 hugo의 정적 파일 생성과 commit 그리고, 원격 저장소의 배포를 한번에 처리하면 효율적입니다.

hugo -t hugo-theme-minos
cd public
git add .
git commit -m "commit"
git push -u origin master

HTML 태그를 사용하려 할때 hugo는 safe하지 않다고 판단해 아래와 같이 “raw HTML omitted” 주서으로 치환을 수행합니다.

<p>...</p>
<!-- raw HTML omitted -->
<p>...</p>

이러한 경우는 hugo 설정에서 unsafe 값을 true로 해주면, safe 모드가 해제 되어 html 태그를 사용할 수 있게 됩니다.

[markup.goldmark.renderer]
unsafe = true