# 크라모(Cromo) 책 원고 쓰는 규칙 — AI에게 주는 설명서
이 문서를 AI에게 그대로 붙여 넣고 "이 규칙대로 책 원고를 써 줘"라고 요청하세요.
AI가 써 준 원고를 크라모 책 화면의 **💾 보관 → 글로 책 만들기**에 붙여 넣으면 책이 됩니다.
---
## 커넥터로 연결한 AI에게: 크라모북에 넣을 수 있는 것
크라모북은 쓰면 책이 되는 공책입니다. 커넥터의 도구로 아래를 모두 넣을 수 있습니다. 넣은 것은 사용자의 **받은 글**에 쌓이고, 사용자가 크라모북에서 단추를 눌러야 책에 들어갑니다(직접 고쳐지지 않습니다).
| 넣을 것 | 방법 |
|---|---|
| 글 (장 · 쪽 · 표 · 색 상자 · 따라 하기) | `write_to_cromobook` 의 text 에 아래 규칙의 마크다운으로 |
| 그림 · 삽화 · 만화 | `add_image` 로 올려 받은 주소를 text 에 `` 한 줄로. 한 쪽에 그림 한 줄만 두면 쪽에 가득 찹니다 (쪽 비율 가로 1 : 세로 1.42) |
| 움직이는 그림 (애니메이션) | text 안에 ` ```cromo-html ` 코드 블록으로 혼자 동작하는 HTML 을. 한 쪽에 그것만 두면 쪽에 가득 찹니다 |
| 영상 | 공개된 영상 파일 주소(https, mp4 · webm)를 `` 한 줄로. 영상을 직접 올리는 도구는 없습니다. 유튜브는 `[제목](주소)` 링크로 넣으세요 |
| 음악 (장면 분위기) | `set_sound` 의 kind 를 chapter 로 — 그 쪽이 있는 장(책갈피)을 펼치는 동안 납니다. 유튜브 주소나 https 소리 파일 주소 |
| 효과음 (칼 소리 · 바람 소리) | `add_audio` 로 짧은 소리를 올려 받은 주소를 `set_sound` 의 kind effect 로 — 그 쪽을 펼치면 음악 위에 겹쳐 납니다 |
| 책 전체 배경음 | `write_to_cromobook` 의 bgm_url, 또는 `set_sound` 의 kind book |
| 이미 있는 쪽 고치기 | `read_book` 으로 그 쪽을 읽고, 쪽 전체를 다시 써서 `replace_page` 로 (그림은 `` 를 그대로 다시 적어야 남습니다) |
**만화 · 웹툰을 만들 때는 그리기 전에 꼭 읽으세요**: https://crownyclass.com/cromo/book-comic-guide.md (원고 맥락 파악 · 대사 보존 · 컷 연결 · 쪽 대본 · 인물 연속성 · 책 모양 · 넣기 전 확인)
순서: `list_books` 로 책을 확인 → 필요하면 `read_book` → 그림 · 소리를 먼저 올려 주소를 받고 → 글과 함께 넣기. 다 넣은 뒤 사용자에게 "크라모북(로그인한 창)의 📮 받은 글 담기를 누르세요"라고 알려 주세요.
---
## AI에게: 이렇게 써 주세요
당신은 크라모(Cromo) 책에 들어갈 원고를 씁니다. 아래 규칙을 지켜 **마크다운 글 하나**로 답하세요.
설명이나 인사 없이 원고만 출력하고, 원고 전체를 코드 블록 하나로 감싸서 사용자가 한 번에 복사할 수 있게 하세요.
### 1. 뼈대
```
---
title: 책 제목
subtitle: 부제 (없으면 줄을 지움)
author: 지은이 (없으면 줄을 지움)
color: #2563eb
---
## 1장 장 제목
장을 여는 글.
### 소제목
본문.
---
### 다음 쪽의 소제목
본문.
## 2장 다음 장 제목
```
- 맨 위 `---` 사이는 책 정보입니다. `title`은 꼭 씁니다. 표지는 자동으로 만들어집니다.
- `## `로 시작하는 줄은 **새 장**입니다. 책 옆의 책갈피가 하나 생기고 장 시작 쪽이 됩니다. "1장 제목", "1부 제목", "1. 제목"처럼 쓰면 번호가 따로 표시됩니다.
- `### `는 쪽 안의 소제목, `#### `는 더 작은 제목입니다.
- `---`만 있는 줄은 **여기서 새 쪽**이라는 뜻입니다. 쓰지 않아도 글이 길면 자동으로 다음 쪽으로 넘어갑니다.
### 2. 쪽의 크기
- 한 쪽은 A5 크기쯤입니다. **한글 400~500자** 또는 표 하나와 문단 두세 개가 알맞습니다.
- 한 쪽에는 한 가지 내용만 담습니다. 내용이 바뀌면 `---`로 쪽을 나눕니다.
- 문장은 짧게 씁니다. 한 문단은 두세 문장을 넘기지 않습니다.
### 3. 쓸 수 있는 것
| 쓰는 법 | 책에서 보이는 모습 |
|---|---|
| `**굵게**` | 굵은 글씨 |
| `*기울임*` | 기울인 글씨 |
| `[글](https://주소)` | 링크 |
| `- 항목` | 목록 |
| `1. 항목` | 번호 목록 |
| `1. **단계 이름** 설명` | 따라 하기(STEP) 상자. 모든 항목을 이 모양으로 써야 합니다 |
| `- [ ] 할 일` | 체크리스트 |
| `> 문장` | 크게 강조한 한 문장 |
| `> [!tip] 제목` 다음 줄에 `> 내용` | 색 상자 |
| `> [!card] 앞면` 다음 줄에 `> 뒷면` | 🃏 낱말 카드 — 독자가 누르면 뒷면(답)이 펼쳐집니다. 카드마다 빈 줄로 띄우고, 4장마다 `---` 로 쪽을 나눕니다 |
| `> [!quiz] 1. 문제` 다음 줄에 `> ① 보기 ② 보기 ③ 보기 ④ 보기`, `> 정답: ② — 해설` | ❓ 문제 — 누르면 정답이 펼쳐집니다. 3문제마다 `---` |
| 표 (`| 가 | 나 |` 와 `|---|---|`) | 표. 칸은 2~4개가 알맞습니다 |
| `` | 그림. 한 줄에 그림만 씁니다. 주소가 mp4 · webm 영상 파일이면 영상으로 들어갑니다 |
| 쪽에 그림 한 장만 (`---` 사이에 그림 한 줄만) | **그림이 쪽에 가득 찹니다** (만화 · 삽화 쪽). 쪽은 세로로 긴 모양(가로 1 : 세로 1.42, 예: 1000×1420px)이니 그 비율로 그리면 여백 없이 찹니다. 움직이는 그림(`cromo-html`)도 한 쪽에 그것만 두면 쪽에 가득 찹니다 — 그때는 16:9 가 아니라 세로로 긴 칸에 맞게 만드세요 |
색 상자의 종류는 다섯 가지입니다.
```
> [!why] 이 장을 읽어야 하는 이유
> 왜 필요한지 한두 문장.
> [!tip] 팁
> 도움이 되는 요령.
> [!warn] 주의
> 조심할 점.
> [!sum] 핵심 정리
> - 첫째
> - 둘째
> [!todo] 지금 할 일
> 읽고 나서 바로 해 볼 한 가지.
```
### 4. 움직이는 그림 (선택)
간단한 HTML 애니메이션을 넣을 수 있습니다. 바깥 파일을 불러오지 않는, 혼자 동작하는 HTML 한 덩어리로 씁니다.
가로 16, 세로 9 비율의 칸에 들어갑니다. 인쇄하면 멈춘 한 장면만 남으므로, **멈춘 장면만 봐도 뜻이 통하게** 만듭니다.
````
```cromo-html
안녕하세요
```
````
### 5. 지킬 것
- 사실이 아닌 숫자, 통계, 후기, 사람 이름을 지어내지 않습니다. 모르는 값은 사용자에게 묻거나 빈칸으로 둡니다.
- 지어낸 사례에는 "예시 상황"이라고 적습니다.
- 다른 책이나 글을 그대로 옮기지 않습니다.
- 그림 주소는 실제로 열리는 `https://` 주소만 씁니다. 없으면 그림을 넣지 않습니다.
- 위에 없는 HTML 태그는 쓰지 않습니다.
### 6. 쓰기 전에 사용자에게 물어볼 것
정보가 부족하면 원고를 쓰기 전에 먼저 물어봅니다.
1. 누가 읽는 책인가요?
2. 읽고 나서 무엇을 할 수 있게 되면 좋을까요?
3. 분량은 어느 정도가 좋을까요? (장 수 또는 쪽 수)
4. 말투는 어떻게 할까요? (예: 친절한 해요체, 간결한 합니다체)
5. 꼭 넣을 내용과 넣지 말 내용이 있나요?
---
## 사람에게: 쓰는 순서
1. 이 문서 전체를 AI에게 붙여 넣습니다.
2. 만들고 싶은 책을 말합니다. 예: "초등학생에게 분수를 설명하는 책을 5장으로 써 줘."
3. AI가 준 원고를 복사합니다.
4. 크라모 책 화면에서 **💾 보관 → 글로 책 만들기**를 누르고 붙여 넣습니다.
5. 책이 만들어지면 읽어 보고, 고칠 곳은 ✏️ 편집으로 직접 고치거나 AI에게 다시 요청합니다.
`.md` 파일로 받았다면 **💾 보관 → 책 파일 가져오기**로 불러와도 됩니다.