042 프로젝트
GitHub Pages 기술 블로그
기술 기록을 시작하기 위해 만든 첫 개인 블로그
GitHub Pages와 Jekyll minimal-mistakes 기반으로 기술 기록을 위한 첫 개인 블로그를 구축하고 운영한 프로젝트입니다.
- GitHub Pages 기반 블로그 구축
- minimal-mistakes 테마 커스터마이징
- 댓글, 검색 노출, 방문 분석 설정 경험
프로젝트 개요
GitHub Pages 기술 블로그는 기술 기록을 남기기 위해 만든 첫 개인 블로그 구축 프로젝트입니다. GitHub Pages, Jekyll, minimal-mistakes 기반으로 정적 블로그를 구성했습니다.
블로그 이름은 "정리가 재밌는 개발자 Blog"였고, 2020년 7월 1일부터 2021년 7월 8일까지 1.0 버전으로 운영했습니다.
기술 스택
플랫폼
GitHub Pages
블로그 호스팅
프레임워크
Jekyll
정적 블로그 구성
minimal-mistakes
4.20.2
블로그 테마
도구
Google Analytics
방문 분석
Disqus
댓글 기능
Google Search Console / Naver Webmaster Tools
검색 노출 등록
팀 구성
- 개인 프로젝트 1명 - 블로그 구축과 초기 운영을 직접 진행
기획 배경
애착을 갖고 직접 관리할 수 있는 블로그가 필요했습니다. 당시 많이 쓰이던 블로그 서비스들은 광고가 많거나 본문이 가려지는 경험이 있어, 직접 구성한 공간에서 글을 쓰고 싶었습니다.
학습한 내용을 정리하고, 기술 기록을 쌓아둘 개인 공간을 마련하려는 목적도 있었습니다.
목표와 구현 범위
minimal-mistakes 테마를 기반으로 블로그 구조를 구성하고, 한국어 사이트 설정, 작성자 프로필, 카테고리/태그/연도 아카이브, 댓글, 방문 분석, 검색 노출 설정을 적용했습니다. Disqus 댓글 기능을 붙이고, Google Analytics를 통해 방문 통계를 확인할 수 있도록 구성했습니다.
Google과 Naver 검색 노출을 위한 인증 파일과 sitemap/feed 설정도 함께 관리했습니다.
내 역할과 기여
개인 프로젝트로 블로그 구축과 초기 설정을 직접 진행했습니다.
실제 구현/기여 상세
- GitHub Pages 기반 블로그 구축
- minimal-mistakes 테마 커스터마이징
- Disqus 댓글 기능 추가
- Google Analytics 방문 분석 설정
- Google/Naver 검색 노출 등록
- 카테고리, 태그, 연도별 아카이브 기반 탐색 구조 설정
설계와 구현
`_config.yml`을 중심으로 사이트 언어, 제목, 작성자 프로필, 소셜 링크, 댓글, 분석 도구, 플러그인, 기본 레이아웃을 설정했습니다. `_data/navigation.yml`에서는 Category, Tags, Year 중심의 탐색 구조를 구성했습니다.
`jekyll-paginate`, `jekyll-sitemap`, `jekyll-feed`, `jekyll-include-cache` 플러그인을 사용했고, 정적 블로그로 GitHub Pages에 배포했습니다.
어려웠던 점과 해결
Ruby, Bundler, GitHub.io, Jekyll 기반 블로그 운영을 모두 처음 사용했습니다. minimal-mistakes 공식 문서가 잘 정리되어 있었지만 영어 문서를 따라가며 테마를 이해하고 커스터마이징하는 과정이 낯설었습니다.
직접 만들고 설계하는 재미는 있었지만, 설정과 운영에 신경 쓸 부분이 많아 글을 자주 쓰기에는 부담이 있었습니다.
결과와 배운 점
개인 기술 기록을 시작하는 공간을 만들었고, 블로그 방문 통계를 확인하며 기록이 외부에 닿는 경험도 했습니다. 특히 회고록들이 생각보다 꾸준히 높은 방문 통계를 보여준 점이 인상적이었습니다.
다만 글을 쓰는 것보다 블로그 자체를 관리하는 비용이 커졌고, 이후에는 글 작성에 더 집중하고 싶어 2021년 7월 8일 Velog로 이관하기로 결정했습니다.
이 경험은 이후 블로그와 기록 도구를 고를 때, 직접 구축하는 재미와 지속 가능한 작성 흐름을 분리해서 보게 만든 기준이 되었습니다.