Install
require('pptxgenjs')누구에게 맞나
입력, 출력, 또는 둘 다로 .pptx나 .potx 파일이 관여하면 이 pptx 가이드를 사용한다. 슬라이드, 피치 자료, 프레젠테이션 만들기와 텍스트 읽기·파싱·추출이 포함된다. 요약은 편집, 병합, 분할, 템플릿, 노트, 댓글도 같은 범위에 둔다. 트리거는 이런 파일을 열거나 만들거나 바꿔야 할 때다.
작업별로 경로를 고르며 단일 GUI가 아니다. 자료는 에이전트 제품 목록을 주지 않으며 특정 소프트웨어 전용으로 이해해서는 안 된다. 공식 설명 페이지는
https://raw.githubusercontent.com/anthropics/skills/main/skills/pptx/SKILL.md
3분 안에 첫 시도 끝내기
권장하는 첫 경로는 자료가 명시한 것이다: pptxgenjs는 이미 미리 설치되어 있으므로 먼저 npm install을 실행하지 말 것. 스크립트를 작성하고 실행한다:
require('pptxgenjs')
전제: 현재 환경에서 이 require를 실행할 수 있다. 성공 신호: 가져오기가 성공하고 모듈 누락을 보고하지 않는다. 읽기 전용 확인이며 바로 디스크에 프레젠테이션을 쓰지 말 것. require가 실패할 때만 같은 페이지의 예비 명령 npm install pptxgenjs을 쓸 수 있다. 예비 설치를 기본 첫 단계로 삼지 말 것.
가져오기가 성공하고 새 파일을 만들겠다고 확인한 뒤에 .pptx를 생성하는 스크립트를 작성한다. 디스크에 쓰기 전에 출력 파일 이름과 기존 원고 덮어쓰기 여부를 확인한다. 요약은 읽기에 markitdown 또는 thumbnail.py를 쓸 수 있다고 하지만 발췌는 markitdown의 완전한 호출을 쓰지 않는다. thumbnail.py는 덮어쓰기 위험이 있으니(아래 사례) 처음에 썸네일을 먼저 돌리지 말 것.
사용 사례
사례 1: 새 프레젠테이션을 만든다. 경로는 pptxgenjs다. 스크립트를 쓰고 바로 require('pptxgenjs')하며 먼저 npm install하지 않는다. 자료는 .pptx를 XML 파일로 된 ZIP으로 설명하고 작업별로 방법을 고르라고 한다. 새로 만들기는 pptxgenjs, 편집은 압축 해제/슬라이드 XML 수정/다시 묶기, 읽기는 요약의 markitdown 또는 thumbnail.py. 이 사례는 새로 만들기만 다룬다. 완료 기준은 스크립트가 require에 성공하고 출력 경로를 확인한 뒤 .pptx 하나를 생성하는 것이다. 발췌는 구체적인 슬라이드 API를 주지 않으므로 나타나지 않은 페이지 레이아웃 함수 이름을 지어내지 말 것.
사례 2: 기존 원고의 썸네일 그리드를 만들기 전에 덮어쓰기를 피한다. 자료는 prefix를 반드시 넘기라고 한다. 기본값은 thumbnails이며 같은 디렉터리의 다른 프레젠테이션 그리드를 덮어쓴다. 요약은 두 번째 인수를 원고 이름으로 맞추라고 요구한다. 부작용이 있는 명령이다. 이름이 겹치지 않는 prefix를 고르고 디렉터리에 같은 이름 그리드가 없는지 확인한 뒤 실행한다. 완료 기준은 이번 출력용으로 독립 prefix를 준비했다는 것이며 기본 thumbnails를 재사용하지 않는 것이다.
사용 경계
.pptx는 XML의 ZIP이며 방법은 작업별로 고른다. 새로 만들기는 미리 설치된 pptxgenjs, 편집은 XML을 바꾸고, 읽기에서는 기본으로 먼저 패키지를 설치하지 말 것. require가 실패할 때만 npm install pptxgenjs. 썸네일 기본 prefix는 같은 디렉터리의 다른 그리드를 덮어쓴다.
나타나지 않은 저장소 경로를 설치 명령으로 쓰지 말 것. 요약의 markitdown, 병합, 분할 같은 능력에 완전한 명령이 없으면 「자료가 이름을 댔고 단계는 펼치지 않았다」고만 쓴다. 여기에 적힌 트리거, require 순서, prefix 부작용을 넘는 범위는 이 설명이 다루지 않는다.