Decks로 코드 기반 슬라이드 만들기: 설치 흐름과 도입 전 확인할 점
Decks의 공개 저장소에서 확인할 수 있는 코드 기반 슬라이드 작업 흐름, 로컬 실행 방법, 기존 프레젠테이션과 비교할 점을 정리합니다.
[원본 출처 및 레퍼런스]
본문 내용은 X(구 트위터)의 개발자 paulmil11님의 오픈소스 공개 스레드(X 원본 글 보기) 및 관련 개발자 토론 내용을 바탕으로 실무적 관점에서 재구성한 글입니다. (GitHub 저장소: paulmil11/decks)
프레젠테이션을 코드와 Git으로 관리하면 변경 이력을 비교하고 협업하기 쉬워질 수 있다. 반면, 익숙한 슬라이드 편집기와는 작성 방식이 다르고 복잡한 서식의 호환성도 확인해야 한다. 여기서는 X 게시물과 Decks 저장소를 바탕으로 프로젝트의 방향과 실행 전 점검할 부분을 정리한다.
코드로 슬라이드를 관리하면 달라지는 점
코드 기반 도구는 텍스트 파일을 버전 관리에 올리고, 변경 내용을 비교하기 쉽다는 장점이 있다. 다만 이를 기존 도구 전체의 대체재로 단정할 수는 없다. 아래 비교는 각 작업 방식에서 기대할 수 있는 차이를 요약한 것이며, 실제 지원 범위는 저장소의 현재 문서와 구현을 확인해야 한다.
| 비교 항목 | 전통적 슬라이드 (PPT / 구글 슬라이드) | 오픈소스 Decks (코드 기반 슬라이드) |
|---|---|---|
| 파일 포맷 | 이진 파일 (.pptx) 또는 클라우드 종속 |
텍스트 파일 기반 (Git 친화적) |
| 버전 관리 | 파일 복제로 관리 (v1, v2, final) |
Git을 통한 정밀한 Diff 및 히스토리 추적 |
| AI 연동성 | 수동 복사 / 붙여넣기 및 부자연스러운 애드온 | Claude 등 LLM과 직접 인터페이스 및 자동 수정 |
| 협업 및 수정 | 서식 깨짐 현상 발생 및 다중 작업 제한 | 텍스트 중심의 깔끔한 구조와 빠른 수정 |
Decks가 지향하는 방식은 슬라이드 내용을 코드 형태로 다루는 것이다. Git을 함께 쓰면 텍스트로 표현되는 변경 사항을 추적할 수 있지만, 편집 기능이나 내보내기 / 호환성은 프로젝트 버전별로 살펴봐야 한다.
Decks 로컬 실행 순서
아래는 저장소의 일반적인 개발 실행 흐름을 정리한 것이다. 실제 스크립트와 요구 버전은 실행 전에 저장소 안내를 다시 확인한다.
-
저장소 클론 (Clone)
bash git clone https://github.com/paulmil11/decks.git cd decks -
패키지 의존성 설치
bash npm install # 또는 yarn install / pnpm install -
개발 서버 구동
bash npm run dev -
브라우저 접속
로컬 서버가 실행되면 브라우저에서http://localhost:5173(기본 포트)에 접속해 슬라이드 편집 화면이 열리는지 확인한다.
실제 작업에 쓰기 전에 확인할 것
오픈소스 Decks를 실제 업무나 프로젝트 발표에 도입하기 전 점검해야 할 핵심 사항이다.
- [ ] 로컬 개발 환경에 Node.js 및 Git이 정상적으로 설치되어 있는가?
- [ ] 기존
.pptx에서 사용하는 글꼴, 표, 애니메이션이 필요한 수준으로 지원되는가? - [ ] 사용 중인 Node.js 버전과 프로젝트 실행 명령이 저장소 안내와 맞는가?
- [ ] 팀원이 Git 기반 수정 흐름을 사용할 수 있고, 결과물을 원하는 형식으로 내보낼 수 있는가?
내가 궁금한 점
슬라이드가 코드로 관리되면 수정 이력이 남는다는 점은 매력적이다. 그렇다고 지금 쓰는 프레젠테이션 도구를 바로 바꿀 이유가 되지는 않는다. 우선 샘플 자료 하나로 편집과 내보내기를 확인하고, 서식 호환성과 협업 방식이 실제 필요에 맞는지 살펴보는 것이 현실적인 출발점이다.