블로그 포스트 작성 가이드

Jekyll 기반 GitHub Pages 블로그에 새 포스트를 작성하는 방법을 안내합니다.

1. 포스트 파일 생성하기

새 포스트는 _posts 디렉토리 내에 카테고리별 폴더에 다음 파일명 형식으로 생성합니다:

YYYY-MM-DD-title.md

예: 2024-03-16-chatgpt-활용법.md

2. Front Matter 작성하기

모든 포스트 파일은 YAML Front Matter로 시작해야 합니다. 기본 형식은 다음과 같습니다:

---
title: "포스트 제목"
categories: 
  - 카테고리명
tags:
  - 태그1
  - 태그2
excerpt: "포스트 요약 내용"
last_modified_at: YYYY-MM-DD
toc: true  # 목차 표시 여부
classes: wide  # 넓은 레이아웃 사용 여부
header:
  teaser: assets/images/경로/이미지파일명.jpg  # 썸네일 이미지
---

3. 포스트 내용 작성하기

Front Matter 이후에 마크다운 형식으로 내용을 작성합니다:

마크다운 기본 문법

# 제목 1
## 제목 2
### 제목 3

**굵은 글씨**
*기울임체*
~~취소선~~

[링크 텍스트](URL)

![이미지 설명](이미지 경로)

- 목록 항목 1
- 목록 항목 2
  - 중첩 항목

1. 순서 항목 1
2. 순서 항목 2

> 인용문

코드 블록:
```python
def hello_world():
    print("Hello, World!")

이미지 추가하기

이미지 파일을 assets/images/포스트-이름/ 디렉토리에 업로드합니다.
마크다운에서 다음과 같이 이미지를 참조합니다:

![이미지 설명](/assets/images/포스트-이름/이미지.jpg)

고급 옵션을 사용한 이미지 삽입:

<figure class="">
  <img src="/assets/images/%ED%8F%AC%EC%8A%A4%ED%8A%B8-%EC%9D%B4%EB%A6%84/%EC%9D%B4%EB%AF%B8%EC%A7%80.jpg"
       alt="대체 텍스트"><figcaption>
      이미지 캡션

    </figcaption></figure>

코드 하이라이팅

```python
def example_function():
    return "Hello World"

### 수식 사용하기 (MathJax)

```markdown
$$ E = mc^2 $$

인라인 수식: $E = mc^2$

4. 카테고리와 태그

현재 블로그에서 사용하는 주요 카테고리:

프로그래밍
논문뿌셔먹기
알고리즘

새 카테고리 추가 시 _posts 디렉토리에 해당 카테고리명으로 폴더 생성을 권장합니다.

5. 포스트 미리보기

로컬에서 포스트 작성 후 미리보기:

bundle exec jekyll serve

브라우저에서 http://localhost:4000으로 접속하여 확인할 수 있습니다.

6. 포스트 게시하기

작성한 포스트는 Git 커밋 후 GitHub에 푸시하면 자동으로 사이트에 게시됩니다:

git add .
git commit -m "Add new post: 포스트 제목"
git push origin main

7. 예시 포스트

아래는 간단한 포스트 예시입니다:

---
title: "깃허브 블로그 시작하기"
categories: 
  - 프로그래밍
tags:
  - GitHub
  - Jekyll
  - 블로그
excerpt: "GitHub Pages와 Jekyll로 개인 블로그 만들기"
last_modified_at: 2024-03-16
toc: true
header:
  teaser: assets/images/github-blog/teaser.jpg
---

## 깃허브 블로그란?

GitHub Pages는 정적 웹사이트를 무료로 호스팅해주는 서비스입니다...

## Jekyll 테마 선택하기

Jekyll 테마를 선택하는 방법은...

## 포스트 작성하기

마크다운으로 포스트를 작성하는 방법은...