Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 20 additions & 20 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,32 +1,32 @@
# GStreamer101 Handbook

> GStreamer를 처음 접하는 사람도 막힘 없이 따라올 수 있도록 만드는, **가장 쉽고 가장 친절한** GStreamer 입문 핸드북입니다.
> GStreamer를 처음 배우는 사람을 위한 한국어 입문서입니다.

GStreamer는 강력하지만 처음 배우는 사람에게는 용어도 개념도 낯섭니다.
`pad`, `caps`, `bin`, `element`, `pipeline`, `bus`… 공식 문서를 펴자마자 마주치는 이 단어들 때문에 많은 입문자가 첫 페이지에서 좌절합니다.
GStreamer는 멀티미디어 처리에 강력하지만, 처음 배우기는 만만치 않습니다.
공식 문서를 펴자마자 `pad`, `caps`, `bin`, `element`, `pipeline`, `bus` 같은 용어가 쏟아지고, 많은 입문자가 여기서 한 번 멈춰 섭니다.

**GStreamer101 Handbook**은진입 장벽을 낮추기 위해 시작됐습니다.
"동작하는 코드"를 던지고 끝내는 대신, **"왜 이렇게 동작하는가"** 를 끝까지 설명합니다.
GStreamer101 Handbook은첫 벽을 낮추려고 시작했습니다.
동작하는 코드만 던지고 끝내는 대신, 그 코드가 왜 그렇게 생겼는지를 한 줄씩 풀어 설명합니다.

---

## 이 핸드북의 약속
## 이 핸드북의 방향

- 🐣 **입문자 기준** — "당연히 알겠지"를 가정하지 않습니다. 처음 나오는 용어는 반드시 풀어서 설명합니다.
- 🧩 **왜를 설명** — 코드를 한 줄씩 뜯어보며 "왜 이렇게 쓰는지"를 함께 다룹니다.
- ▶️ **바로 실행** — 모든 예제는 실제로 빌드·실행되며, 기대 출력까지 적어 둡니다.
- 🩹 **에러를 미리 안내** — 초심자가 흔히 만나는 에러와 해결책을 함께 정리합니다.
- 처음 보는 용어는 그때그때 풀어서 설명합니다. "당연히 알겠지"라고 넘기지 않습니다.
- 예제는 한 줄씩 짚어 가며, 왜 이렇게 쓰는지 함께 다룹니다.
- 모든 코드는 실제로 빌드·실행되며, 기대 출력까지 적어 둡니다.
- 입문자가 자주 만나는 에러와 해결책도 함께 정리합니다.

> 모든 결정의 기준은 하나입니다 — **"입문자가 혼자 읽어도 이해되는가?"**
판단 기준은 하나입니다 — "입문자가 혼자 읽어도 이해되는가?"

---

## 무엇을 다루나

- **기반(Base):** [GStreamer 공식 Basic Tutorial](https://gstreamer.freedesktop.org/documentation/tutorials/basic/index.html)을 한국어 학습자 관점에서 풀어 씁니다.
- **확장(Extended):** 공식 튜토리얼에 없는 예제는 **GStreamer101 커뮤니티가 독자적으로 작성**해 기록합니다.
공식 [GStreamer Basic Tutorial](https://gstreamer.freedesktop.org/documentation/tutorials/basic/index.html)을 한국어 학습자의 시각으로 다시 풀어 씁니다.
공식 튜토리얼에 없는 주제는 GStreamer101 커뮤니티가 직접 예제를 만들어 보탭니다.

예제는 C(공식 튜토리얼 스타일)와 Python(PyGObject)을 기준으로 하며, GStreamer **1.x(1.0 API)** 를 따릅니다.
예제는 C(공식 튜토리얼 스타일)와 Python(PyGObject)을 함께 다루며, GStreamer 1.x(1.0 API)를 기준으로 합니다.

---

Expand All @@ -46,13 +46,13 @@ brew install gstreamer gst-plugins-base gst-plugins-good
gst-launch-1.0 --version
```

> 각 예제 README의 **실행 방법** 섹션에 빌드·실행 명령과 기대 출력이 정리되어 있으니, 예제별 안내를 그대로 따라오면 됩니다.
빌드와 실행 명령, 기대 출력은 각 예제 README의 "실행 방법" 항목에 정리되어 있으니, 그대로 따라오면 됩니다.

---

## 목차

> 예제가 추가되면 이 목차에 함께 등록합니다.
예제가 추가되면 아래 표에 함께 등록합니다.

### Basic Tutorial (공식 기반)

Expand All @@ -70,12 +70,12 @@ gst-launch-1.0 --version

## 함께 만들기

이 저장소는 **커뮤니티 기반 학습 자료**입니다. 누구나 예제를 추가하고 다듬을 수 있습니다.
이 저장소는 커뮤니티가 함께 만드는 학습 자료입니다. 누구나 예제를 더하고 다듬을 수 있습니다.

- 작업 규칙·예제 작성 가이드: [`AGENTS.md`](./AGENTS.md)
- 예제 추가/수정 시 점검 리스트: [`CHECKLIST.md`](./CHECKLIST.md)
- 작업 규칙과 예제 작성 가이드: [`AGENTS.md`](./AGENTS.md)
- 예제를 더하거나 고칠 때 점검할 항목: [`CHECKLIST.md`](./CHECKLIST.md)

새 예제를 추가할 때는 **입문자가 혼자 읽어도 이해되도록** 최대한 상세하고 쉽게 써 주세요.
새 예제를 때는 입문자가 혼자 읽어도 따라올 수 있도록, 가능한 한 자세하고 친절하게 풀어 주세요.

---

Expand Down