Skip to content

总览

该部分将介绍与剧本读取有关的一切，主要包括剧本可以按什么格式写、有哪些命令等。

由于目前开发速度不够，文档仍有许多内容没有覆盖，我们会在之后的开发中慢慢完善。

文件读取类型

语涵编译器目前接受以下输入剧本格式：

  • docx 文档 (*.docx)，兼容性以 Office Word 为标准。（读取功能由 python-docx 实现。）
  • odt 文档 (*.odt)，兼容性以 LibreOffice Writer 为标准。（读取功能由 odfpy 实现。）
  • Markdown (*.md)，兼容性以 GFM 为标准。（读取功能由 marko 实现。）
  • 纯文本 (*.txt)，建议使用 UTF-8 编码。

以上格式的剧本可能包含语涵编译器不支持的功能（比如内嵌文本框、内嵌音视频），程序会忽略所有不支持的功能。程序会使用部分文字样式（加粗、前景色等）、段落样式（背景色，居中）和内嵌图片等，不支持的输入格式（比如纯文本）无法直接使用此类功能，不过涉及到的功能都可以用别的方式实现。

章节

章节的概念对应于:

  • 编程中的“函数”
  • RenPy 中的标签(label)
  • WebGal 中的单个场景文件(scene/*.txt)

基础语法

程序不区分半角（英文）标点和全角（中文）标点。比如英文的方括号 [] 与中文的 【】 等效。

程序解析内容时遵循按行解析的策略，在文档里等效为按段落解析。每个段落可以分为命令段（只有命令）与内容段（只有发言对话、内嵌素材等）。