Hugo - Git 웹페이지 생성

Prerequisites

- Git installation

- Python

 

1. https://gohugo.io/installation/

Installation

 

위의 사이트에서 자신의 컴퓨터 OS에 맞는 Hugo 버전을 다운로드한다. 나는 윈도우라서 윈도우 기준으로 다운로드 받았다.

 

 

2. C:\\hugo 에다가 1번에서 다운로드한 Hugo를 압축해제한다.

\bin 폴더를 만들고 거기에 압축해제해도 상관없지만, 애초부터 hugo.exe 파일이 있는 경로면 bin이 있건 없건 상관없다. 

 

 

3. 환경 변수 Path에 hugo.exe가 있는 디렉토리 경로를 추가해준다.

 

 

4. cmd든 아나콘다 prompt든 열고 hugo version <<을 쳐서 제대로 버전 결과가 나오는지 체크한다.

hugo version

 

 

5. cmd에 hugo new site <사이트명> <<을 쳐서 디렉토리를 생성한다. 

hugo new site mysite

 

 

6. cmd에 위에서 만든 디렉토리로 이동하기 위해 cd <사이트명>을 쳐서 해당 디렉토리로 이동한다.

cd mysite

 

 

7. cmd상 위치가 해당 <사이트명> 디렉토리로 들어갔다면, git init 을 쳐준다. 

git init

 

 

8. 해당 디렉토리에서, 나같은 경우 hugo-split-gallery 테마를 선택했기에 아래와 같이 git submodule 명령어를 쳐준다.

git submodule add https://gitlab.com/tmuguet/hugo-split-gallery.git themes/hugo-split-gallery

 

 

9. config.toml 파일에다가 theme = "my-theme"를 추가해준다. 나같은 경우 hugo-split-gallery 테마였기 때문에 아래와 같이 추가를 해줬다. toml 파일은 vscode로 열면 된다.

theme = 'hugo-split-gallery'

 

 

9. cmd 창에다가 hugo new content content/post/start.md 명령어를 쳐서 start.md 파일을 생성한다.

hugo new content content/post/start.md

 

 

10. start.md 파일을 열어보면 상단에 아래와 같은 메시지가 보인다. 해당 메시지 아래에 쓸 내용들을 추가하면 된다. 

+++
date = '2025-07-06T15:34:12+09:00'
draft = true
title = 'First'
+++

 

 

11. 포스팅할 것 까지 다 만들었으면 이제 해당 mystie 디렉토리에서 hugo server 또는 Hugo server -D 명령어를 쳐서 서버를 실행시킨다. 해당 명령어를 실행시킨 다음에 브라우저상에서 http://localhost:1313 을 쳐서 들어가서 정상적으로 웹페이지가 보이는 걸 체크하면 된다.

hugo server -D