윈도우즈 기준, Choco를 통한 설치를 추천
Choco 설치
이하의 커맨드들은 PowerShell에서 진행합니다.
choco install hugo -confirm
<username>.github.io-project
<proj_repo> contents(md, image, css등)
<username>.github.io
<deploy_repo> 실제 웹서비스를 위해 렌더링 된 site
<username>이 thesora라면 git 주소는 https://github.com/thesorauni/thesorauni.github.io-project (주소에 <username>이 2번 들어 있음에 유의)`
# C:\Users\username\Hugo\Sites를 Working Dictory로 사용
cd $env:USERPROFILE
md Hugo\Sites ; cd Hugo\Sites
hugo new site <deploy_repo>
# ex : hugo new site thesora.github.io
cd $env:USERPROFILE
# <proj_repo> clone
git clone http://github.com/<username>.<proj_repo>
# 방금 Hugo를 통해 만들 Site안의 내용물들 <proj_repo> 안으로 복사
Copy Hugo\Sites\<deploy_repo>\* <proj_repo>
# clone 한 곳에서 작업
cd <proj_repo>
# themes 받기, 여기서는 ananke 테마 사용
git submodule add https://github.com/budparr/gohugo-theme-ananke.git themes/ananke
# theme 설정
echo 'theme = "ananke"' >> config.toml
# blog post 하나 작성
hugo new posts/my-first-post.md
# 서버 띄워 보기
hugo server -D -t ananke
# http://localhost:1313/ 잘 되면 Ctrl+C로 Server 중지 후에
# 아래의 submodule 추가를 위해 public 폴더 정리
rd Public -Recurse
# <deploy_repo>를 <proj_repo>안에 submodule 추가하여 관리하는 것을 추천
git submodule add -b master https://github.com/<username>/<username>.github.io.git public
###################################################
# config.toml baseURL을 <username>.github.io로 변경
###################################################
# 빌드를 위해 다시 <proj_repo>로
cd ..
# 빌드
hugo -t ananke
# <deploy_repo> 변경 사항 업데이트
cd public
git add .
git commit -m "first"
git push origin master
# 마지막으로 <proj_repo>의 변경 사항도 업데이트
cd ..
git add .
git commit -m "first"
git push origin master
https://github.com/<USERNAME>/<USERNAME>.github.io/settings로 이동하여
[GitHub Pages]에서
웹브라우저상에서 <USERNAME>.github.io로 접속
Hugo Official
Github-Pages Official Guide
😊