빌드와 CLI
마켓플레이스 체크아웃에서 변환기를 실행하거나 설치된 스킬의 해당 스크립트 경로를 사용합니다.
명령
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py validate ./my-presentation/
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py build ./my-presentation/
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py build my-talk.md -o /var/tmp/my-talk --lang en
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py build ./my-presentation/ --block 01-fundamentals
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py sync ./my-presentation/
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py migrate old-talk.md -o /var/tmp/migrated-talk
python3 plugins/aws-content-plugin/skills/reactive-presentation/scripts/remarp_to_slides.py issues ./my-presentation/ --json
| 하위 명령 | 지원하는 인수 |
|---|---|
build | 입력 경로, -o/--output, --block, --lang (ko 또는 en) |
sync | 프로젝트 디렉터리, -o/--output |
migrate | Marp 입력 파일, 필수 -o/--output |
issues | 입력 경로, 선택적 --json |
validate | 입력 경로, 선택적 --json |
파서는 --watch나 --format을 제공하지 않습니다. 설치된 스크립트의 --help로 정확한 인터페이스를 확인합니다. build --lang은 소스의 언어 설정을 재정의합니다. sync를 포함한 프로젝트 출력에 영어를 일관되게 사용하려면 _presentation.md에 lang: en을 지정하고 블록별 재정의도 일치시킵니다. 언어 메타데이터가 없으면 출력은 기본적으로 한국어입니다. 언어 메타데이터는 출력의 언어별 표기 방식을 선택할 뿐 소스의 설명을 번역하지는 않습니다.
validate는 유효하지 않거나 없는 입력, 슬라이드 누락 또는 CRITICAL 지적이 있으면 0이 아닌 종료 코드를 반환합니다. --json은 프로그램에서 읽을 수 있는 진단을 반환합니다. build와 sync도 같은 검증을 실행하며, CRITICAL 지적이 있으면 출력을 생성하기 전에 중단합니다. 스타일 경고는 참고 사항으로 유지됩니다.
이름을 지정한 블록이 없는 단일 소스는 소스 옆에 slides/default.html을 만들고 프레임워크 에셋을 slides/common/에 복사합니다. -o로 출력 디렉터리를 바꿀 수 있으며 에셋은 자동으로 복사됩니다. 전체 빠른 시작 절차를 참고합니다.
여러 파일로 구성된 프로젝트
_presentation.md 또는 _presentation.remarp.md에는 공유 메타데이터와 블록 목록을 저장합니다. 번호순 블록 파일에는 개별 프런트매터와 슬라이드가 있습니다. 프로젝트 빌드는 -o로 다른 출력 디렉터리를 지정하지 않으면 소스 파일 옆에 병합된 index.html, toc.html, 개별 블록 HTML과 common/을 생성합니다.
sync는 병합된 인덱스와 TOC를 포함한 이 출력과 에셋을 모두 다시 생성합니다. Markdown 수정 시각에 의존하지 않으므로 전역 메타데이터, 테마와 참조 의존성의 변경도 다시 빌드합니다. build --block은 선택한 블록 페이지와 에셋만 생성합니다. 전체 덱을 갱신하려면 build 또는 sync를 사용합니다. 이미지와 로컬 에셋은 생성 결과에서 접근할 수 있는 경로에 둡니다.
내보내기
생성된 덱에 포함된 경우 웹 프레임워크의 PDF/ZIP 내보내기 제어 기능과 브라우저 내보내기 도구를 사용할 수 있습니다. 스크린샷 기반 PowerPoint는 제공된 export_pptx.py 작업 흐름을 사용합니다. 정적 내보내기에는 실시간 상호작용이 유지되지 않습니다. 편집 가능한 네이티브 PowerPoint에는 aws-light-fcd를 사용합니다.
게시
CSS, JavaScript, 이미지, 아이콘과 테마를 불러올 수 있도록 생성된 전체 디렉터리 트리를 서비스하거나 게시합니다. 소스를 검증하고 렌더링된 덱과 내보내기 결과를 테스트한 뒤 콘텐츠 리뷰를 통과하고 승인된 배포를 진행합니다.