Hugo 블로그 만들기

About

GitHub Pages로 블로그를 만들기 위해 보통 Jekyll 또는 Hugo를 사용하는데, Hugo가 더 빠르고 사용 경험도 좋다고 해서 Hugo로 만들었던 전적이 있다.

물론 직접 만들어도 되지만, 다른 것 개발하기도 바쁘고 블로그 글 작성하기도 바빠서 그냥 잘 만들어진 엔진을 사용했다.

블로그 자체는 2021년에 만들었는데, 2023년부터 블로그를 재정비하면서 또 한번 어려움을 겪고 난 뒤 한 번 정리해보려고 한다.

설치는 여기를 참고하자.

그 외 자주 쓰는 사용법은 다음과 같다.

$ hugo new posts/게시글-URL.md

로컬에서 테스트하려면 다음과 같이 하면 된다.

$ hugo server

보통 Hugo를 사용할 땐 처음부터 만들기보단 테마를 깔아서 사용하는 경우가 많다. 테마는 여기에서 찾을 수 있다.

테마를 사용할 땐 themes/ 경로에 작성하게 되며, 커스텀 설정을 주로 config.toml 또는 config.yaml에 작성하게 된다.

레이아웃 등 커스텀 페이지 설정은 layouts을 사용하는데, 사용하는 테마의 layouts을 참고하면 된다.

나 같은 경우에는 risotto 테마를 사용했는데, risotto theme에는 comment 기능이 없고 글씨 크기가 너무 균일해서 밋밋하기에 fork를 떠서 직접 수정했다.

이처럼 직접 수정해야 하는 경우에도 fork를 떠서 수정이 가능하다.

Hugo는 템플릿 기능이 있어서 댓글 기능을 추가하기가 쉽다.

근데 사용하는 theme에 따라 댓글을 넣기 위한 기능이 없는 경우도 있다. 내가 쓰는 테마인 risotto는 댓글 기능이 없어서 직접 만들어야 했다.

댓글 기능은 Disqus, utterances 등 여러가지가 있는데, 나는 utterances를 사용했다.

이유는 GitHub issues와 연동이 되고 광고가 없기 때문이다.

둘다 theme에서 지원만 된다면 추가는 쉬우니 구글을 참고하자. 보통 .html 파일을 추가하고 layouts에서 include하면 된다. 일부 theme에는 단순히 config 파일에서 키-밸류만 추가해도 되는 경우도 있다.

도메인 등록은 가장 싼 곳에서 등록하면 된다.

국내 서비스로는 가비아, 호스팅KR 등이 있다.

블로그 찾아보면 충분히 설명이 많으니 이 부분은 생략한다.

이 부분은 그렇게 어렵지 않다. Hugo 자체에서 지원하는데, config.toml에 다음과 같이 작성하면 된다.

googleAnalytics = "UA-XXXXXXXXX-X"

Google SEO를 위해서는 Google Search Console에 등록하는 것이 좋다.

Google Search Console 등록은 꽤나 까다로운데:

yaml 파일로 작성하는 경우에는 다음과 같다.

googleAnalytics: UA-XXXXXXXXX-X

Naver 등 다른 검색 엔진에 등록하는 법은 아티클 최하단 References를 참고하자.

개발 블로그를 만들 생각이 있다면 Hugo를 100%는 아니더라도 고려해볼만 하다.

혼자 처음부터 만드려면 page navigation부터 시작해서 최적화, analytics, SEO 등 고려할 것들이 많은데, Hugo를 사용하면 이런 것들을 많이 신경쓰지 않아도 어느 정도 해결이 된다.