[ETC] GitHub Pages로 Jekyll 블로그 호스팅 하기 - Hydejack theme

#github #pages #jekyll #hydejack #blog

Image

1. 개요

오늘날 블로그 플랫폼은 Tistory, Naver Blog 등 다양한 사설 서비스부터, GitHub Pages + Jekyll 같은 정적 사이트 생성기(Static Site Generator) 기반 솔루션까지 폭넓게 제공됩니다. 이 글에서는 GitHub Pages와 Jekyll을 활용해 무료로 빠르고 안정적인 블로그를 호스팅하는 방법을 설명하고, 대표적인 사설 블로그 서비스와의 장단점을 비교해 보겠습니다.

2. Jekyll/GitHub Pages vs. 사설 블로그 서비스

비교 항목GitHub Pages + JekyllTistory / Naver Blog
비용무료 (GitHub 개인 저장소 한정)무료(광고 옵션, 유료 스킨 등 부가 비용 존재)
커스터마이징테마·레이아웃·플러그인 직접 제어 가능제공되는 스킨·플러그인 범위 내에서 제한적 수정
유지관리GitHub Actions 등 CI로 자동 빌드·배포 가능플랫폼 의존, 기능 업데이트는 서비스 제공자에 따름
속도CDN 배포로 빠른 로딩 및 전 세계 분산일반 호스팅 환경, 지역·트래픽에 따라 차이
확장성코드·리소스 직접 관리, 무제한 페이지 작성 가능서비스 정책에 따른 저장용량·기능 제한
SEO 최적화메타 태그·구조화 데이터 직접 설정 가능기본 설정 제공, 세부 최적화에는 한계
백업/이전Git 저장소 백업으로 영구 보관플랫폼 제공 백업 기능 사용, 이전 시 변환 필요
커뮤니티·에코시스템GitHub & Jekyll 테마·플러그인 방대국내 사용자 커뮤니티 강하지만, 외부 자료 제한

2.1 장점 요약

  • 완전 무료: GitHub 저장소 사용료 외에 추가 비용이 없습니다.

  • 높은 커스터마이징: 레이아웃, CSS, 플러그인 등을 직접 편집할 수 있습니다.

  • 버전 관리: 모든 글과 설정을 Git으로 관리해 언제든 롤백·협업이 가능합니다.

  • 빠른 배포: GitHub Actions 및 자동화 스크립트로 글을 커밋만 하면 실시간 배포됩니다.

2.2 단점 요약

  • 초기 설정 난이도: 개발 환경에 익숙하지 않은 사용자는 설치·설정 과정이 복잡하게 느껴질 수 있습니다.

  • 플랫폼 의존 지원 부족: 문제 발생 시 공식 지원이 없고, 대부분 커뮤니티 자료에 의존해야 합니다.

  • 에디터 기능 제한: 마크다운 기반으로 글을 작성해야 하며, WYSIWYG 편집기는 별도 도구를 사용해야 합니다.

3. 설치 및 배포 과정

다음 절차를 따라 GitHub Pages와 Jekyll 블로그를 설정하고 배포해 보겠습니다. 여기선 여러가지의 Jekyll 테마 중, hydejack 테마를 사용합니다

3.1 사전 준비

  • Git 설치: 로컬에 Git이 설치되어 있어야 합니다.

  • Ruby & Bundler 설치: Jekyll은 Ruby 기반이므로, Ruby >= 3.2.2 과 bundler가 필요합니다.

  • GitHub 계정: 공개 저장소를 생성할 수 있는 GitHub 계정이 필요합니다.

3.2 hydejack starter kit 다운로드

  1. hydejack github

    • 게시글 작성일 기준 Latest 버전인 9.2.1 사용
    • Source code (zip) 다운로드
  2. 압축 해제

3.3 Install Jekyll

  1. bundle install 실행
bundle install
  1. execute jekyll
bundle exec jekyll serve --livereload
  • 브라우저에서 http://localhost:4000 접근

  • 변경사항 실시간 반영 확인 가능

3.4 GitHub Pages 배포

  1. gitub에 github계정.github.io 저장소 생성 (public)

    저장소는 private으로 사용하고, github pages 호스팅을 사용하려면 유료 구독 필요

  2. _config.yml 파일 수정
# _config.yml
# theme 는 주석처리, remote_theme 는 주석 해제

# theme: jekyll-theme-hydejack
remote_theme: hydecorp/hydejack@v9
  1. 커밋
    • 저장소의 Settings > Pages 메뉴에서 배포 브랜치(main) 확인
  •  빌드 잡 수행 후 https://github계정.github.io 에서 블로그 확인 가능

4. 추가 팁

  • 커스텀 도메인 연결CNAME 파일에 도메인 입력 후 설정

  • CI/CD: GitHub Actions를 활용해 빌드·테스트 자동화

  • 플러그인 활용: SEO, Sitemap, RSS 피드 등 플러그인 설치

5. 마무리

GitHub Pages와 Jekyll을 이용하면 비용 부담 없이도 프로페셔널한 개발 기술 블로그를 운영할 수 있습니다. 초기 설정이 다소 복잡할 수 있지만, 일단 환경이 갖춰지면 버전 관리자동화 배포무한 확장성 등 다양한 장점을 누릴 수 있습니다.

다음 포스팅에선 hydejack 테마에서 아쉬운 점인 서브메뉴 커스텀에 대해 알아보겠습니다.