오늘은 세련된 디자인과 강력한 커스터마이징 기능으로 많은 주목을 받고 있는 Blowfish 테마를 기존에 운영하던 Hugo 블로그에 적용하는 방법을 상세하게 안내해 드리겠습니다.
이 글에서는 Blowfish 공식 문서가 권장하는 방식인 Git Submodule**을 사용하여, 가장 안정적이고 확실하게 테마를 설치하고 기본 설정을 완료하는 전 과정을 다룹니다. 차근차근 따라오시면 누구나 멋진 블로그를 완성할 수 있습니다.
기존 테마 깔끔하게 제거하기#
새로운 옷을 입기 전, 기존 옷을 먼저 정리해야겠죠. 현재 사용 중인 테마를 깔끔하게 제거하는 것부터 시작하겠습니다. 테마 설치 방식에 따라 아래 방법 중 하나를 선택하세요.
Git 서브모듈로 설치된 경우:#
# 이전 테마 폴더가 'themes/old-theme' 라고 가정합니다.
git submodule deinit -f themes/old-theme
git rm -f themes/old-theme
rm -rf .git/modules/themes/old-theme
단순히 폴더만 삭제하는 것을 넘어, Git의 추적 기록까지 완전히 정리해 주는 가장 깔끔한 방법입니다.
직접 다운로드하여 설치한 경우:#
# 이전 테마 폴더가 'themes/old-theme' 라고 가정합니다.
rm -rf themes/old-theme
또는 파일 탐색기에서 직접 themes/old-theme 폴더를 삭제해도 됩니다.
Git Submodule로 Blowfish 테마 설치#
이제 Blowfish 테마를 내 프로젝트에 추가할 차례입니다. 프로젝트의 최상위 폴더(루트)에서 아래 명령어를 순서대로 실행합니다.
cd my-blog
git init
git submodule add -b main https://github.com/nunocoracao/blowfish.git themes/blowfish
테마 설정 파일 구성하기#
Blowfish는 매우 상세한 설정 옵션을 제공합니다. 가장 쉽고 확실한 방법은 테마가 제공하는 기본 설정 파일들을 내 프로젝트로 복사한 뒤, 필요한 부분만 수정하는 것입니다.
최상위 폴더(루트)에서의 hugo.toml는 더이상 사용하지 않으므로 삭제합니다.
rm hugo.toml
아래 명령어를 실행하면, 프로젝트 루트에 config 폴더가 생성되고 그 안에 _default 폴더와 함께 hugo.toml, params.toml 등의 기본 설정 파일들이 복사됩니다.
cp -r themes/blowfish/config .
이제 복사된 설정 파일을 Hugo가 인식하도록 config/_default/hugo.toml 파일을 열어, 파일 최상단에 아래 내용을 수정합니다.
# config/_default/hugo.toml
theme = "blowfish"
# baseURL을 자신의 환경에 맞게 수정합니다.
baseURL = "https://your_domain.com/"
로컬 확인 및 최종 배포#
모든 준비가 끝났습니다. 로컬 서버를 실행하여 Blowfish 테마가 적용되었는지 최종 확인합니다.
# -D 옵션은 draft(초안) 상태의 글도 함께 보여줍니다.
hugo server -D
브라우저에서 http://localhost:1313 으로 접속하여 새로운 블로그의 모습을 확인하세요. 메인 페이지, 글 목록, 검색 기능이 모두 잘 작동한다면 성공입니다.
마지막으로, 변경된 내용을 서버에 배포합니다.
# 모든 변경사항 추가
git add .
# 테마 변경을 알리는 커밋 메시지 작성
git commit -m "Feat: Apply Blowfish theme"
# 원격 저장소에 푸시하여 배포 완료
git push
마무리하며#
지금까지 기존 Hugo 블로그에 Blowfish 테마를 적용하고 기본적인 설정을 마치는 전 과정을 함께했습니다. Blowfish는 params.toml 파일에 수많은 커스터마이징 옵션을 제공하므로, 시간을 갖고 천천히 살펴보시면 라이트/다크 모드, 폰트, 아이콘 등 블로그의 거의 모든 요소를 원하는 대로 바꿀 수 있습니다.
이 가이드를 시작으로 여러분만의 개성이 가득한 멋진 블로그를 완성하시길 바랍니다.