종우(Jongwoo Han)

hugo_cv

Hugo + Blowfish로 만든 CV 사이트입니다.

실행

• 개발 서버: ./bin/hugo server --port 1313
• 빌드: ./bin/hugo --gc --minify

콘텐츠 작성 가이드 (Project / Details)

이 사이트는 Project(문서형 목록) → Details(포스트) 구조입니다.

• Project 목록 페이지: content/projects/_index.md (KO), content/projects/_index.en.md (EN)
• Details 포스트: content/details/<slug>.md (KO), content/details/<slug>.en.md (EN)

1) Details 포스트 추가 (추천 플로우)

1. KO 포스트 생성: content/details/<slug>.md
2. EN 포스트 생성: content/details/<slug>.en.md

아키타입으로 빠르게 만들기:

• KO: ./bin/hugo new details/<slug>.md
• EN: ./bin/hugo new --kind details-en details/<slug>.en.md

템플릿 예시:

---
title: "Project Name"
date: 2026-01-13
---

## 개요

## 내가 한 일

## 결과

## 기술 스택

## 링크

2) Projects 목록에 링크 추가

Projects는 문서형 목록이므로, 항목을 직접 링크로 추가합니다.

• KO 링크 규칙: /details/<slug>/
• EN 링크 규칙: /en/details/<slug>/

예시:

- [Project Name](/details/project-name/)

- [Project Name](/en/details/project-name/)

슬러그(slug) 규칙 (권장)

• 소문자 + 하이픈(kebab-case): project-name, ml-pipeline, app-v2
• 공백/한글/특수문자는 피하기(링크/공유/이동이 깔끔해짐)
• KO/EN은 같은 슬러그를 쓰기(언어 전환/URL 대응이 쉬움)

빠른 체크리스트

• ./bin/hugo new details/<slug>.md
• ./bin/hugo new --kind details-en details/<slug>.en.md
• content/projects/_index.md에 KO 링크 추가: /details/<slug>/
• content/projects/_index.en.md에 EN 링크 추가: /en/details/<slug>/
• ./bin/hugo --gc --minify로 확인

3) 언어 전환(한/영) 동작 조건

헤더의 언어 전환은 현재 페이지에 대해 번역본이 있을 때 표시됩니다. 즉, Details 포스트는 *.md와 *.en.md를 둘 다 만들어두는 것을 권장합니다.

파비콘/manifest (사이트 static에서 관리)

Blowfish의 아이콘 링크는 사이트 루트의 정적 파일을 참조합니다. 이 레포는 테마 쪽 기본 아이콘을 제거했으니, 아래 파일들을 static/에 네 에셋으로 넣어주세요.

• static/apple-touch-icon.png (180x180)
• static/favicon-32x32.png
• static/favicon-16x16.png
• static/favicon.svg (선택)
• static/favicon.ico (선택)
• static/android-chrome-192x192.png (manifest용)
• static/android-chrome-512x512.png (manifest용)
• static/site.webmanifest

Blowfish 테마 업데이트(수동 덮어쓰기)

이 레포는 Blowfish를 submodule이 아니라 themes/blowfish/에 포함(벤더링)해서 관리합니다.

• 태그 확인: https://github.com/nunocoracao/blowfish/releases (또는 https://github.com/nunocoracao/blowfish/tags)

1) Blowfish의 태그(권장) 또는 커밋을 정합니다.

• 태그 예시: v2.0.0

2) 테마를 덮어씁니다.

• 스크립트 사용: scripts/update-blowfish.sh v2.0.0
  • 기존 테마는 .tmp/blowfish-backup-<timestamp>/에 백업됩니다.

3) 빌드로 검증합니다.

• ./bin/hugo --gc --minify