Park, Geon/[플젝] 윈도에서 hugo로 정적 블로그 만들기

Created Sat, 15 Jun 2024 17:15:29 +0900 Modified Fri, 12 Sep 2025 17:40:17 +0900
610 Words

참고 링크

Integerous.github.io

Hugo 설치

설치 도구 고민

  • Chocolatey는 사용하고 싶지 않았다.
  • winget으로 설치하고자 했으나 여러 문제 발생. [[윈도에서-hugo로-정적-블로그-만들기#winget-설치-시도와-문제|#]]
  • 결국 pre-built binary를 받아 직접 설치했다.

설치에 필요한 도구

  1. Git: 이미 설치되어 있었으므로 생략.
  2. Go: .msi 파일을 사용하여 설치.
  3. Dart Sass: 공식 사이트에서 prebuilt binary 다운로드. 적당한 경로(예: C:\Program Files\sass)에 압축 해제 후, 해당 폴더를 PATH에 추가.

winget 설치 시도와 문제

winget install Hugo.Hugo.Extended

문제 1: 원본 업데이트 실패

문제 2: 명령 실행 중 예기치 않은 오류

명령을 실행하는 동안 예기치 않은 오류가 발생했습니다.
이식 가능한 설치에 실패했습니다. 정리 중...
  • 해결되지 않음 → 결국 수동 설치로 전환

수동 설치 (Pre-built Binary)

  1. 공식 릴리즈 페이지 방문
  2. hugo_extended_*_Windows-64bit.zip 다운로드
  3. 적절한 디렉토리에 압축 해제 (예: C:\tools\hugo)
  4. 해당 디렉토리를 PATH에 추가

블로그 설치 - obsidian-to-hugo로 콘텐츠 옮기기

obsidian-to-hugo로 옵시디언 내용 블로그에 올리기

이미지 링크 문제 해결

cd $BLOG_PROFILE_WRAPPER
git submodule add https://github.com/devidw/obsidian-to-hugo.git
git fetch origin pull/24/head:pr24
git checkout pr24
pip install .

Obsidian에서 자동 메타데이터 미삽입되는 문제 해결

github-style 테마에서 요구하는 title, date, summary 등이 자동으로 삽입되지 않았다.

👉 직접 obsidian-to-hugo.py 스크립트 작성하여 해결함.

수학 수식

yeongcheon.github.io를 참고하고, obsidian-to-hugo.py 스크립트 에서 $\(로 바꾸도록 함.