GitHub Pages용 Jekyll 치트 시트

GitHub Pages로 Jekyll 정적 웹사이트를 구성하고 게시하기 위한 빠른 참고 가이드입니다.

디렉터리 구조

.
├── _config.yml       # 사이트 설정
├── _includes/        # 재사용 가능한 템플릿 조각
├── _layouts/         # 기본 페이지 레이아웃
├── _posts/           # 블로그 포스트 (YYYY-MM-DD-title.md)
├── _sass/            # SASS / SCSS 스타일 파셜
├── assets/           # 이미지, 컴파일된 스타일, JS
└── index.md          # 홈페이지 콘텐츠

구성 (_config.yml)

title: My Documentation
description: Quick reference cheatsheets
baseurl: "/my-repo"
url: "https://username.github.io"

# GitHub Pages 플러그인 의존성
plugins:
  - jekyll-feed
  - jekyll-seo-tag
  - jekyll-sitemap

markdown: kramdown
theme: minima

Frontmatter 헤더

---
layout: post
title: "Getting Started with Jekyll"
date: 2026-10-25 12:00:00 +0000
categories: [development, tools]
tags: [jekyll, static-site]
---

Liquid 템플릿 헬퍼

출력 및 변수

{{ site.title }}
{{ page.title }}
{{ content }}

조건문과 반복문

{% if page.comments %}
  {% include comments.html %}
{% endif %}

<ul>
  {% for post in site.posts limit:5 %}
    <li><a href="{{ post.url | relative_url }}">{{ post.title }}</a></li>
  {% endfor %}
</ul>

로컬 테스트

# 의존성 패키지 설치
bundle install

# 라이브 리로드가 포함된 로컬 개발 서버 실행
bundle exec jekyll serve --livereload