Jekyll에서 Hugo로 블로그 이전하기: 직접 만든 테마로 마이그레이션 완료

Mon, 26 Oct 2026 00:00:00 +0900

오랫동안 방치했던 Jekyll 블로그를 Hugo로 옮겼다. 단순히 테마를 바꾸는 대신, 앞으로 편하게 고칠 수 있도록 외부 테마나 Git submodule 없이 layouts/부터 직접 구성했다. 디자인은 Tailwind CSS로 만들었고, 기존 글과 댓글·통계·광고 설정도 최대한 이어받았다.

이 글은 마이그레이션하면서 실제로 손봤던 부분만 짧게 정리한 기록이다.

1. 외부 테마 없이 Hugo 구조부터 만들기

Hugo 테마를 submodule로 연결하면 시작은 빠르지만, 원하는 부분을 수정할 때 테마 구조를 계속 따라가야 한다. 이번에는 템플릿을 직접 관리하기로 했다.

layouts/
├── baseof.html
├── home.html
├── single.html
├── section.html
├── taxonomy.html
├── term.html
├── _partials/
│ ├── head.html
│ ├── header.html
│ └── footer.html
└── _markup/
 └── render-image.html
assets/css/main.css
static/
content/
hugo.yaml

layouts/는 화면 구조, assets/css/는 Tailwind 스타일, content/는 게시글, static/은 그대로 공개할 파일을 담당한다. 특히 public/은 빌드 결과물이므로 직접 관리하지 않는다.

Jekyll on 코딩잘하자

Jekyll에서 Hugo로 블로그 이전하기: 직접 만든 테마로 마이그레이션 완료

1. 외부 테마 없이 Hugo 구조부터 만들기