설명 스크립트
스크립트는 짧은 장면들의 목록입니다. 각 장면에는 하나 이상의 내레이션 라인과 하나의 시각적 요소가 있습니다. 음소거 상태에서 스크롤하는 시청자를 위해 작성되므로, 모든 라인은 자막으로도 작동해야 합니다.
길이
- 30~60초, 45초를 목표로 함 (
src/settings.ts의targetSeconds). - 이는 영어로 약 75~140단어에 해당합니다. 직접 세어보세요. 스페인어는 동일한 내용에 대해 약 15~20% 더 길어집니다.
구조
- 훅, 처음 3초 이내. 놀라운 발견 또는 구체적인 질문. 절대 "이 영상에서는...", "오늘 이야기할 것은..." 또는 인사말로 시작하지 마세요. 인트로 카드.
- 설정. 무엇을 테스트했는지와 그것이 왜 중요한지, 한두 줄로.
- 실험을 하나의 그림으로. 메커니즘 또는 설계를 하나의 시각적 요소(흐름도, 비교)로. 전체 방법 섹션이 아닌 하나의 아이디어만.
- 결과, 정확한 숫자 포함. 기사에 쓰인 대로 숫자 사용 ("14/20 vs 4/20", "83%", "p = 0.0018"): 동일한 반올림, 동일한 단위.
- 그래서 무엇인가. 이 결과가 이를 활용하여 구축하는 사람에게 의미하는 바. 기사가 주장하는 것보다 강하지 않게.
- 종료 카드 라인: "More at javieraguilar.ai" (스페인어: "Más en javieraguilar.ai").
화자 스타일
- 1인칭, 기사가 작성된 방식 그대로: "I gave the planner...", "What I found...".
- 주장은 기사만큼 미묘하게. 기사의 완곡 표현 유지 ("on these runs", "in this setup").
- 짧은 구어체 문장. 한 줄에 하나의 아이디어. 기사가 설명하지 않는 전문 용어 없음.
자막
- 자막은 내레이션 텍스트에서 직접 삽입되며, 최대 두 줄, 각 줄 약 32자.
- 화면에 표시되는 속도는 초당 최대 17자 (
npm run lint로 확인). 너무 빨리 읽히는 라인은 더 빠른 음성이 아닌 더 적은 단어가 필요합니다. - 자막에는 기사에 나온 대로 숫자를 작성하세요. TTS가 다르게 발음해야 하는 경우 라인에 구어체 형태를 제공하세요 (
narration스킬 참조). 자막은 절대 변경하지 마세요. - 내레이션에 긴 URL이나 코드 식별자는 피하세요. 자막에서 잘리고 읽기 어렵습니다.
영어와 스페인어
- 영어/스페인어 쌍을 라인별로 함께 작성하여 두 버전이 동기화되도록 하세요. 스페인어는 선택 사항입니다: 영상이 영어 전용인 경우 스페인어 텍스트는 비워 둡니다.
- 스페인어 라인은 동일한 내용을 말하지만 단어 대 단어 번역이 아닙니다. 영어만큼 짧게 유지하세요.
장면별 시각적 요소
모든 장면에는 라이브러리의 컴포넌트에 매핑된 시각적 아이디어가 있습니다 (explainer-animation 참조):
| 시각적 아이디어 | 컴포넌트 |
|---|---|
| 하나의 헤드라인 수치가 증가 | Counter |
| 두 개에서 다섯 개의 값을 나란히 | BarCompare |
| 파이프라인, 핸드오프, 끊어진 링크 | FlowDiagram |
| 기사가 핵심으로 삼는 문장 | KeyQuote |
| 한 번에 두 개에서 네 개의 수치 | StatGrid |
| 훅과 종료 | intro / outro cards |
어떤 컴포넌트도 맞지 않는 경우 해당 장면에 "bespoke" 플래그를 지정하고 애니메이션에 대한 한 줄 설명을 추가하세요. 그라데이션 배경에 텍스트만 있는 영상은 피하세요: 각 기사마다 메커니즘을 보여주는 시각적 요소가 하나 이상 있어야 합니다.
스크립트 형식
script.md를 테이블로 작성하세요. 내레이션 라인당 한 행:
| 장면 | 컴포넌트 | 영어 라인 | 스페인어 라인 | 시각적 요소 | 출처 문장 |
|---|
- "출처 문장"은 해당 라인의 모든 숫자와 주장에 대해 기사를 인용합니다.
- 영어 단어 수와 예상 길이로 마무리하세요.
- 어떤 것이든 제작되기 전에 승인을 위해 제시하세요.