m2slide-deck

m2slide 로 제작한 프레젠테이션 덱을 공개·공유·협업하기 위한 저장소입니다. 여러 사람이 만든 슬라이드 결과물을 Pull Request 로 모읍니다.

목적

• 공개(public) 덱 공유 — 완성한 m2slide 프레젠테이션을 누구나 열람·재사용
• 협업(collaboration) — Fork → 작업 → PR 흐름으로 여러 저자의 덱을 한곳에 수집
• 소스 우선 — 빌드 산출물(slide/, *.epub, *.pdf)이 아니라 마크다운 소스를 공유. 각자 m2slide.sh 로 재빌드

폴더 구조

m2slide-deck/
├── decks/              # 실제 덱 프로젝트 (카테고리별 2단계)
│   ├── tech/           # 기술
│   ├── ai/             # AI·ML
│   ├── agentic-ai/     # Agentic AI — AI 에이전트·에이전틱 코딩·AI 활용 강의
│   ├── app/            # 앱·도구 소개 — 제품 소개 덱 (m2slide /p/ «📱 앱» 구역과 대응)
│   ├── business/       # 비즈니스
│   ├── education/      # 교육·강의
│   └── misc/           # 기타
├── docs/               # GitHub Pages 배포 산출물 (git doc)
├── _template/          # 새 덱 스캐폴드 (복사해서 시작)
│   ├── README.md       # 덱 문서 템플릿 (모든 덱은 README 기본 지원)
│   ├── _config.yml     # m2slide 설정 예시
│   ├── markdown/       # 슬라이드 소스
│   └── img/            # 이미지 자산
└── .github/
    ├── PULL_REQUEST_TEMPLATE.md
    └── workflows/      # CI (선택)

새 덱 추가 방법

1. 이 저장소를 Fork
2. _template/ 를 원하는 카테고리 폴더로 복사 후 이름 변경

   cp -R _template decks/tech/MyDeck

3. decks/<카테고리>/MyDeck/markdown/ 에 슬라이드 작성 + README.md 채우기
4. 로컬 빌드로 확인

   # m2slide 저장소에서
   ./m2slide.sh /경로/m2slide-deck/decks/tech/MyDeck

5. commit → push → Pull Request 생성

덱 문서(git doc) 기본 지원

모든 덱은 폴더 안에 README.md 를 기본 포함합니다(_template/README.md 기준). 제목·저자·요약·빌드 방법을 적어 두면 GitHub 에서 바로 읽을 수 있습니다. 저장소 전역 문서는 docs/(GitHub Pages) 에 배포합니다.

라이선스·기여

• 기여 규칙: CONTRIBUTING.md
• 저장소 기본 라이선스: LICENSE.md
  • 덱 콘텐츠(슬라이드 원고·이미지) — CC BY-NC-SA 4.0 · 비상업 자유 이용, 상업 이용은 별도 허락(finfra@gmail.com)
  • 빌드 스크립트·템플릿 코드 — MIT
• 각 덱의 저작권은 해당 덱 저자에게 있다. 덱 README.md 에 라이선스를 명시하면 그 명시가 기본값보다 우선한다 (ex: RamyeonCooking — CC BY 4.0)