Hugo Stack 계층형 카테고리 리팩토링

Mon, 27 Apr 2026 09:00:00 +0900

계층형 카테고리 커스텀 이후 발견한 버그 및 불필요한 코드 정리

이전 포스트에서 구현한 계층형 카테고리 시스템에서 3가지 문제를 발견

포스트 categories frontmatter의 오타로 인해 카테고리가 잘못 생성되고 있었음
generate-categories.go에서 Go의 slugify()와 Hugo의 urlize 동작 불일치로 인한 잠재적 404 위험
테마 사이드바 위젯 오버라이드 파일이 테마 기본값과 완전히 동일한데도 계속 유지되어, 테마 자동 업데이트 내용이 반영 안 되는 문제

1. 포스트 카테고리 오타 수정

frontmatter의 categories 배열에 오타가 있으면 카테고리 페이지가 잘못된 이름으로 생성됨
발견된 오타 5건 수정

파일	변경
`2025-11-04-AnsiblePlaybookDockerInstall`	`"Ansilbe"` → `"Ansible"`
`2025-11-05-AnsiblePlaybookcmdlogrotateopenfilesar`	`"Ansilbe"` → `"Ansible"`
`2026-02-04-MiniPCPromoxInstall`	`"Promox"` → `"Proxmox"`
`2026-02-23-PromoxNetworkVMSettings`	`"Promox"` → `"Proxmox"`
`2025-09-16-troubleshootinghaproxyrestartfault`	`"LoadBalancer"` → `"Load Balancer"`

2. `generate-categories.go` 개선

2.1 ioutil 제거

io/ioutil 패키지는 Go 1.16부터 deprecated
os.ReadFile / os.WriteFile으로 직접 대체

1
2
3
4
5
6
7
8


// 변경 전
import "io/ioutil"
content, err := ioutil.ReadFile(path)
ioutil.WriteFile(path, data, 0644)

// 변경 후
content, err := os.ReadFile(path)
os.WriteFile(path, data, 0644)

2.2 url 필드 추가

문제: Go의 slugify() 결과와 Hugo의 urlize 함수 결과가 불일치하는 경우 발생 가능
- 예: "Load Balancer" → slugify() → "load-balancer" vs Hugo urlize → "load-balancer" (일치하는 경우도 있지만, 특수문자·한글 혼용 시 불일치 가능)
- 레이아웃 템플릿에서 urlize로 생성한 링크와 실제 생성된 페이지 URL이 달라지면 404
해결: 생성되는 _index.md와 .md 파일에 url: 필드를 명시적으로 추가
- Hugo가 url: 필드를 최우선으로 사용하므로 slugify 결과와 완전히 동일해짐

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22


// Primary _index.md
primarySlug := slugify(primary)
primaryContent := fmt.Sprintf(`---
title: "%s"
description: "%s 카테고리의 모든 포스트"
primary_category: "%s"
layout: "category-primary"
url: "/categories/%s/"
---
`, primary, primary, primary, primarySlug)

// Secondary .md
secondarySlug := slugify(secondary)
secondaryContent := fmt.Sprintf(`---
title: "%s"
description: "%s > %s 카테고리의 포스트"
primary_category: "%s"
secondary_category: "%s"
layout: "category-secondary"
url: "/categories/%s/%s/"
---
`, secondary, primary, secondary, primary, secondary, primarySlug, secondarySlug)

생성 결과 예시

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


content/categories/linux/_index.md
---
title: "Linux"
url: "/categories/linux/"
...
---

content/categories/linux/load-balancer.md
---
title: "Load Balancer"
url: "/categories/linux/load-balancer/"
...
---

3. 사이드바 위젯 오버라이드 삭제

layouts/partials/widget/categories.html
테마 Stack v3의 기본 위젯 파일을 오버라이드하고 있었음
내용 비교 결과 테마 기본값과 완전히 동일
- 유지할 이유가 없는 상태
매일 실행되는 테마 자동 업데이트 워크플로우가 있는데, 이 파일이 존재하면 테마에서 해당 위젯이 변경되어도 반영이 안 됨
- 불필요한 오버라이드 파일은 삭제하는 것이 테마 독립성 유지에 적합
해당 파일 삭제

Refactoring on Joonlog

Hugo Stack 계층형 카테고리 리팩토링

1. 포스트 카테고리 오타 수정

2. generate-categories.go 개선

2.1 ioutil 제거

2.2 url 필드 추가

생성 결과 예시

3. 사이드바 위젯 오버라이드 삭제

2. `generate-categories.go` 개선