[Note] Github 블로그 시작

목차

블로그를 시작한 이유

‘흐릿한 잉크가 진한 기억보다 강하다’
총명불여둔필(聰明不如鈍筆) - 중국의 한 속담

기록은 단순히 지나간 흔적을 남기는 일이 아니다.
다시 돌아보며 배우고, 앞으로 나아가기 위한 이정표가 되기도 한다.

그동안 공부와 실습, 프로젝트를 주로 노션(Notion)에 정리해왔다.
빠르고 편리했지만, 시간이 지나면서 기록은 점점 간단한 메모로 축소되었고, 다시 꺼내 보기에는 아쉬움이 남았다.

블로그는 단순히 기록을 외부에 공개하는 수단이 아니다.
글을 쓰고 정리하는 과정 자체가 나의 사고를 더 명확하게 만들며,
“누군가 본다”는 전제가 붙는 순간 내용은 더욱 체계적이고 단단해진다.

그래서 이제는 조금 더 정제된 기록을 이곳 블로그에 남기려 한다.
학습 과정에서의 고민, 시행착오, 그리고 작은 성취들을 글로 정리하며,
이 기록이 훗날 나 자신에게는 성장의 증거가,
그리고 다른 누군가에게는 작은 길잡이가 되길 바란다.

Github 블로그를 선택하기까지

Velog, Tistory 등 다양한 블로그 플랫폼이 있다.
처음에는 나 역시 그곳에 글을 올려볼까 고민했었다.

하지만 나는 내가 주인이 되는 나만의 공간에서 기록을 쌓고 싶었다.
내가 원하는 방식대로 정리하고, 다시 꺼내 보고, 또 언젠가 한 페이지의 기록으로 남길 수 있는 블로그를 직접 만들고 싶었다.

그런 내 성향에 깃허브 블로그는 매력적으로 다가왔다.
자유도가 높아 모든 것을 내 마음대로 커스터마이징할 수 있고, 무엇보다 하나의 계정 안에서 코드, 프로젝트, 그리고 블로그까지 함께 관리할 수 있다는 점이 큰 장점이었다.

나는 무엇이든 심플하게 정리되는 걸 좋아한다. 여러 플랫폼과 계정을 여기저기 흩어두기보다, 하나로 묶어 관리하는 것이 편하다. 깃허브 블로그는 바로 그런 내 성격과 잘 맞는 선택이었다.

블로그 제작 방식

Github 블로그는 자유도가 높은 만큼 초기 설정이 쉽지 않았다. 어떤 기술을 써야 할지 막막했지만, 조사 끝에 많은 개발자들이 Hugo, Jekyll 같은 SSG(Static Site Generator)를 사용한다는 걸 알게 되었다.

SSG는 마크다운으로 글을 작성하고, 레이아웃을 지정해 빌드하면 정적 웹사이트를 자동으로 생성해준다. 다양한 테마와 커스터마이징이 가능해, 나도 이 방식을 선택하기로 했다.

SSG 선정

Jekyll과 Hugo, 두 도구 모두 널리 쓰이지만, 장단점은 뚜렷하다.

Jekyll

  • GitHub Pages에서 기본 지원 (Ruby 기반)
  • 자료와 사용자 커뮤니티가 풍부
  • 단점: 빌드 속도가 느리고, 글이 많아질수록 관리가 불편

Hugo

  • Go 기반으로 빌드 속도가 매우 빠름
  • 설치가 간단하고 별도 의존성이 적음
  • 테마와 커스터마이징 옵션이 다양
  • 최근 사용자 증가 추세, 많은 개발자들이 Hugo로 이동 중

나는 여러 고민 끝에 Hugo를 선택했다.
빠른 속도와 단순함이 개인적으로 마음에 들었고, 동시에 많은 개발자들이 Hugo로 넘어가는 추세라는 점에서 안정감을 얻었다.

테마 선정

Hugo 테마 중에서 Anatole을 선택했다.
내 취향에 맞는 심플한 디자인, 700개가 넘는 Star 수, 꾸준한 업데이트, 그리고 오버라이드 없이도 가능한 다양한 커스터마이징 기능이 마음에 들었다.

구현 방식

테마를 사용한다면 블로그 제작은 어렵지 않다.
Hugo 프로젝트를 생성하고, 테마를 불러온 뒤, hugo.toml 설정 파일만 Anatole 위키와 Hugo 공식 문서를 참고하여 작성하면 된다.

배포 방식에 대해서는 조금 고민이 있었다. 기존 글들을 보면 대부분 GitHub submodule 방식으로 배포 브랜치와 개발 브랜치를 나누어 관리했지만, GitHub Pages를 사용할 계획이라면 굳이 그렇게 할 필요가 없다.

GitHub Actions를 이용하면 main 브랜치에 push할 때마다 자동으로 Hugo 빌드가 실행되고, 결과물이 GitHub Pages에 호스팅된다.
즉, contents 디렉토리에 글을 작성 → push만 하면 자동으로 배포되는 단순한 구조로 블로그를 운영할 수 있다.

마무리하며

처음에는 막막하게만 보였던 GitHub 블로그도, SSG와 테마를 활용하니 내가 직접 해야 할 일은 기본 설정뿐이었다.

앞으로 블로그를 운영하면서 기능을 추가하고 커스터마이징하는 과정에서 계속해서 Hugo와 Anatole의 구조를 배워야겠지만, 큰 틀만 이해하면 적용 자체는 어렵지 않다.

이제 막 첫 글을 남겼다.
그러나 이러한 기록들이 차곡차곡 쌓여 언젠가 다시 돌아봤을 때, 나의 고민과 노력의 흔적이 고스란히 담긴 블로그가 되어 있기를 바란다.
그리고 그 과정 속에서 계속 앞으로 나아갈 힘을 얻을 수 있기를 기대한다.

HugoSSGGit