서버비 0원으로 평생 무료 웹 서비스 운영하기: 나만의 고성능 블로그 뚝딱 만들기

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

brew install hugo

hugo version

hugo v0.154.3+extended+withdeploy darwin/arm64 ...

# 새 Hugo 사이트 생성 (blog 폴더에)
hugo new site blog

# 생성된 폴더로 이동
cd blog

# Git 저장소 초기화
git init

# Stack 테마를 submodule로 추가
git submodule add https://github.com/CaiJimmy/hugo-theme-stack.git themes/hugo-theme-stack

# ============================================
# 기본 설정
# ============================================
baseURL = 'https://내도메인.pages.dev/'  # 배포 후 실제 주소로 변경
title = 'My Tech Blog'                    # 사이트 제목
theme = 'hugo-theme-stack'                # 사용할 테마

# ============================================
# 다국어 설정
# ============================================
defaultContentLanguage = 'ko'             # 기본 언어: 한국어
defaultContentLanguageInSubdir = true     # URL에 /ko/, /en/ 접두사 사용
enableRobotsTXT = true                    # robots.txt 자동 생성

# ============================================
# 검색 기능 (hugo-theme-stack 내장)
# ============================================
[outputs]
  home = ["HTML", "RSS", "JSON"]          # JSON 필수 (검색용)

# ============================================
# 언어별 설정
# ============================================
[languages]
  # --- 한국어 ---
  [languages.ko]
    languageCode = 'ko-KR'
    languageName = '한국어'
    weight = 1
    
    [languages.ko.params]
      description = '개발자의 기술 블로그'
      mainSections = ["posts"]

    [[languages.ko.menu.main]]
      name = "Archive"
      url = "/archives/"
      weight = 10
    [[languages.ko.menu.main]]
      name = "Tags"
      url = "/tags/"
      weight = 20
    [[languages.ko.menu.main]]
      name = "Search"
      url = "/search/"
      weight = 30

  # --- 영어 ---
  [languages.en]
    languageCode = 'en-US'
    languageName = 'English'
    weight = 2
    
    [languages.en.params]
      description = 'Developer Tech Blog'
      mainSections = ["posts"]

    [[languages.en.menu.main]]
      name = "Archive"
      url = "/archives/"
      weight = 10
    [[languages.en.menu.main]]
      name = "Tags"
      url = "/tags/"
      weight = 20
    [[languages.en.menu.main]]
      name = "Search"
      url = "/search/"
      weight = 30

# ============================================
# Stack 테마 설정
# ============================================
[params]
  # 사이트 기본 정보
  description = '개발자의 기술 블로그'
  mainSections = ['posts']
  
  # 사이드바 설정
  [params.sidebar]
    emoji = ''
    subtitle = '개발 블로그'
    
    [params.sidebar.avatar]
      enabled = true
      local = true
      src = 'images/avatar.webp'

  # 댓글 설정 (나중에 활성화)
  [params.comments]
    enabled = false

  # 푸터 설정
  [params.footer]
    since = 2026

  # 색상 설정
  [params.colorScheme]
    toggle = true
    default = 'auto'

# Archive 페이지 (글 목록)
cat > content/archives.md << 'EOF'
---
title: "Archive"
layout: "archives"
summary: "archives"
---
EOF

# Search 페이지 (검색)
cat > content/search.md << 'EOF'
---
title: "Search"
layout: "search"
summary: "search"
---
EOF

# 새 글 폴더 생성
hugo new content/posts/hello-world/index.md

+++
date = '2026-01-08T10:00:00+09:00'
draft = false
title = '안녕하세요, 첫 번째 포스트입니다!'
tags = ["첫글", "Hugo"]
+++

## 소개

이 사이트는 Hugo와 Cloudflare Pages로 만들어졌습니다.

## 앞으로의 계획

- 개발 경험 공유
- 기술 튜토리얼 작성

hugo server -D

# .gitignore 생성 (빌드 결과물 제외)
echo "public/" >> .gitignore
echo "resources/" >> .gitignore
echo ".hugo_build.lock" >> .gitignore

# GitHub 저장소 연결
git remote add origin https://github.com/사용자명/my-blog.git

# 첫 커밋 & 푸시
git add .
git commit -m "Initial commit: Hugo blog setup"
git branch -M main
git push -u origin main