Hugo + Cloudflare Pages 자동 배포 파이프라인 구축 완전 가이드 — 2편

1
2
3
4
5
6

# Scoop 설치 (이미 설치된 경우 생략)
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
irm get.scoop.sh | iex

# Hugo Extended 설치
scoop install hugo-extended

1

winget install Hugo.Hugo.Extended

1

brew install hugo

1
2
3
4
5
6
7

# snap 사용
sudo snap install hugo

# 또는 직접 다운로드
wget https://github.com/gohugoio/hugo/releases/download/v0.145.0/hugo_extended_0.145.0_linux-amd64.tar.gz
tar xzf hugo_extended_0.145.0_linux-amd64.tar.gz
sudo mv hugo /usr/local/bin/

1
2

hugo version
# hugo v0.145.0+extended ...

1
2
3

hugo new site my-blog
cd my-blog
git init

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11

my-blog/
├── archetypes/
├── assets/
├── content/
├── data/
├── layouts/
├── public/         # 빌드 결과물 (git에 포함하지 않음)
├── resources/
├── static/
├── themes/
└── hugo.toml       # 메인 설정 파일

1

git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish

1
2
3
4
5
6
7

# go.mod 초기화
hugo mod init github.com/your-username/your-blog

# hugo.toml에 추가
# [module]
#   [[module.imports]]
#     path = "github.com/nunocoracao/blowfish"

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46

baseURL = "https://blog-8ye.pages.dev"
languageCode = "ko"
defaultContentLanguage = "ko"
title = "My Blog"
theme = "blowfish"

[taxonomies]
  tag = "tags"
  category = "categories"

[params]
  colorScheme = "ocean"      # 색상 테마: ocean, fire, forest, slate 등
  defaultAppearance = "dark" # 기본 다크모드
  autoSwitchAppearance = true # 시스템 설정 따라가기

  enableSearch = true        # 검색 기능
  enableCodeCopy = true      # 코드 복사 버튼

  [params.homepage]
    layout = "profile"       # 홈 레이아웃: profile, page, hero, background
    showRecent = true
    showRecentItems = 5

[params.article]
  showDate = true
  showDateUpdated = true
  showReadingTime = true
  showTableOfContents = true # 목차 자동 생성
  showTaxonomies = true
  showWordCount = true

[params.list]
  showCards = true
  groupByYear = true

[markup]
  [markup.highlight]
    style = "dracula"        # 코드 하이라이팅 스타일
    lineNos = false
    guessSyntax = true
  [markup.goldmark]
    [markup.goldmark.renderer]
      unsafe = true          # HTML 태그 허용

[outputs]
  home = ["HTML", "RSS", "JSON"]  # JSON은 검색 기능에 필요

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15

languageName = "한국어"
weight = 1

[params]
  displayName = "KO"
  isoCode = "ko"
  rtl = false
  dateFormat = "2006년 1월 2일"

  [params.author]
    name = "작성자 이름"
    bio = "블로그 소개 문구"
    links = [
      { github = "https://github.com/username" }
    ]

1

hugo new content posts/2026-03-23-first-post.md

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

---
title: "{{ replace .File.ContentBaseName "-" " " | title }}"
date: 2021-06-04T08:00:00+09:00
lastmod: 2021-06-09T08:00:00+09:00
description: ""
slug: "{{ .File.ContentBaseName }}"
categories: ["ai-automation"]
tags: []
draft: false
---

1

hugo server -D

 1
 2
 3
 4
 5
 6
 7
 8
 9
10

# .gitignore 생성
echo "public/" >> .gitignore
echo "resources/" >> .gitignore
echo ".hugo_build.lock" >> .gitignore

# GitHub에 저장소 생성 후 연결
git remote add origin https://github.com/your-username/your-blog.git
git add .
git commit -m "initial: Hugo blog setup"
git push -u origin main

1

baseURL = "https://blog-8ye.pages.dev"