Hugo로 테크노트 블로그 구축하기

Hugo는 Go 언어로 작성된 빠른 정적 사이트 생성기입니다. 이 글에서는 Hugo를 사용하여 테크노트 블로그를 구축하는 방법을 알아보겠습니다.

Hugo의 장점

  • 빠른 빌드 속도: Go 언어의 특성상 매우 빠른 빌드 속도
  • 다양한 테마: 수많은 무료 테마 제공
  • 마크다운 지원: 간편한 콘텐츠 작성
  • SEO 친화적: 정적 사이트로 검색 엔진 최적화에 유리

설치 및 초기 설정

1. Hugo 설치

1
2
3
4
5
# macOS (Homebrew)
brew install hugo

# 설치 확인
hugo version

2. 새 사이트 생성

1
2
hugo new site my-blog
cd my-blog

3. 테마 설치

1
2
git init
git submodule add --depth=1 https://github.com/adityatelange/hugo-PaperMod.git themes/PaperMod

설정 파일 구성

hugo.toml 파일을 다음과 같이 설정합니다:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
baseURL = 'https://your-domain.com/'
languageCode = 'ko-kr'
title = 'Tech Note'
theme = 'PaperMod'

[params]
  description = "기술 노트와 개발 경험을 공유하는 블로그"
  ShowReadingTime = true
  ShowShareButtons = true
  ShowCodeCopyButtons = true

콘텐츠 작성

새 포스트를 작성하려면:

1
hugo new posts/my-first-post.md

마크다운으로 콘텐츠를 작성하고, 프론트매터에 메타데이터를 추가합니다:

1
2
3
4
5
6
7
8
---
title: "포스트 제목"
date: 2024-01-01T10:00:00+09:00
draft: false
description: "포스트 설명"
tags: ["태그1", "태그2"]
categories: ["카테고리"]
---

로컬 서버 실행

개발 중에는 로컬 서버를 실행하여 실시간으로 변경사항을 확인할 수 있습니다:

1
hugo server --buildDrafts

배포

빌드된 사이트를 배포하려면:

1
2
3
4
# 사이트 빌드
hugo

# public 폴더의 내용을 웹 서버에 업로드

추천 배포 플랫폼

  • Netlify: 무료 호스팅, 자동 배포
  • Vercel: 빠른 배포, 자동 HTTPS
  • GitHub Pages: 무료 호스팅
  • AWS S3 + CloudFront: 확장성 좋은 솔루션

마무리

Hugo는 빠르고 효율적인 정적 사이트 생성기로, 테크노트 블로그 구축에 매우 적합합니다. 마크다운으로 콘텐츠를 작성하고, 다양한 테마를 활용하여 개성 있는 블로그를 만들어보세요!


참고 자료: