
选择范围并导出
- 打开工程,在左侧剧本树中右键章节,选择「导出剧本…」。
- 选择格式,在「导出范围」勾选一个或多个章节。目录可整组勾选,章节下面会展示所包含的片段;选择一章会包含它的全部片段。
- 在「文件组织」选择「合并为一个文件」或「每章单独一个文件」。顺序沿用剧本树的章节排列。
- 在「指令类型」选择「仅文本」或所需类型,按需纳入禁用指令。筛选影响实际导出内容。
- 查看右侧预览。按章输出时先切换预览章节;Markdown 与 Word 可以查看排版,Ren’Py 可检查脚本与转换提醒。
- 点击导出,选择工程目录之外的文件或文件夹。看到完成提示后打开输出文件,检查文字、章节层级和范围。
选择格式
| 格式 | 文件 | 用途与边界 |
|---|---|---|
| 纯文本 | .txt | 通读、配音或自定义排版;不携带原项目素材 |
| 表格 | .csv | 用电子表格处理结构化台词;不是 .xlsx 工作簿 |
| JSON | .json | 保留所选指令的结构与属性;导出 Schema 是 letsgal-script-export,不能直接当章节文件导入 |
| Ren’Py | .rpy | 将可转换指令导出为标准 Ren’Py 脚本;不能完整还原 Studio 的所有演出 |
| Markdown | .md | 带章节与片段层级的阅读稿 |
| Word 文档 | .docx | 带章节层级、角色与对白排版的文档 |
.rpy 导出分别处理,不应把 Studio 的 studio ... 语法直接交给 Ren’Py 运行。
分支、条件和演出在导出中的表现
打开导出窗口时默认只勾选文本类指令(对白、旁白、段落和注释)。此时选项内容里的台词按原来的顺序导出,分支和条件本身不出现。需要它们时,在「指令类型」的「分支与逻辑」分组里勾选(演出段的标记在「演出与效果」分组里),或点击「全部指令」。Ren’Py 格式的默认选择已经包含分支和条件。| 格式 | 分支选项与条件判断 | 演出段 |
|---|---|---|
| 纯文本、Markdown、Word | 组头、每个选项或每条路、结束行各占一行,内容不缩进 | 开始、结束标记各占一行 |
| CSV | 每行一条记录,保留类型和完整参数 | 同左 |
| JSON | 保留每个 Block 的类型和全部属性 | 同左 |
| Ren’Py | 转换成原生缩进写法,见下方 | 标记自动跳过,中间的指令按顺序导出,时间编排不保留 |
Ren’Py 中的分支和条件
分支选项导出为menu:,条件判断导出为 if / elif / else,内容写在缩进里,可以任意嵌套:
- 被禁用的分支、条件、选项和路不导出。
- 选项的显示条件无法转换时,去掉这个条件并写入转换提醒,需要在 Ren’Py 中手动补上。
- 「如果」「否则如果」的条件无法转换时,整个条件判断不导出,并写入转换提醒。
menu: 和 if 加 call;目标片段不在导出范围内时跳过这一项。
自定义纯文本导出
纯文本格式提供自定义脚本入口,可以载入或编辑 JavaScript,然后运行脚本生成输出,检查预览后再保存。范围或脚本发生变化后需要重新运行。 脚本应返回字符串,或包含text 与 extension 的对象。单次运行上限为 2 秒,输出上限为 5 MiB,载入脚本文件上限为 256 KiB。扩展名使用 1~12 位字母或数字。按章输出时脚本会分别处理每个有导出内容的章节。
保存与失败处理
- 导出不会替代工程保存、Git 同步或素材备份;先确认编辑器保存状态。
- 输出位置必须在工程目录之外,避免覆盖工程文件。
- 按章输出如果部分文件保存失败,提示会列出已保留的文件;先检查输出目录,再重试。
- 选择为空或筛选后没有内容时,先调整章节与指令类型。