功能与模块概述

启动入口

语涵编译器项目目前有以下三个可执行文件(EXE)。

命令行核心

图标和文件名：命令行核心的图标 preppipe_cli.exe

语涵编译器的核心部分，用 Python 编写。由于语涵编译器在设计之初就想支持第三方集成、允许其他人的程序使用语涵编译器的功能，所以所有的功能、内嵌资源都在命令行核心中，用户或第三方的脚本可以使用这个程序使用所有功能。调用这个命令行模式的文件可以避免在特定环境下由于使用窗口导致出错。除非您知道自己在做什么，否则都推荐用以下的图形界面来使用本程序。

初版 UI

图标和文件名：初版UI的图标 preppipe_gui.exe

该程序是套在命令行核心外的壳，所有功能通过调用命令行核心来完成。推荐使用该图形界面。此文档的所有说明也均围绕该 UI 展开。

语涵编译器项目在(2023年)修改定位前只考虑剧本录入、自动演出等功能，不包含素材库、没有需要频繁与用户交互的功能，所以图形窗口没有与核心耦合的需求，完全可以做成独立的程序。使用Qt/C++开发初版 UI 只是因为作者对此比较熟悉，平台稳定可靠。但是这版 UI 也有局限，界面复杂难懂。我们在新版 UI 成熟后会放弃这版 UI。

新版 UI (开发中)

图标和文件名：新版UI的图标 preppipe.exe

目前仍在开发中的新 UI，也由 Python 编写。设计上支持以下功能和特性：

更方便、完善的多语言支持（包括简中、繁中、英语）
UI 重新设计，用户无需花时间阅读文档或介绍视频即可上手使用
开发效率更高

核心模块

语涵编译器的核心部分目前有以下模块：

graph LR
  subgraph frontend["前端"]
    frontend_node["剧本读取、解析、自动演出"]
  end
  subgraph middleend["中端"]
    analysis["分析工具"]
  end
  subgraph backend["后端"]
    direction TB
    renpy["Ren'Py 导出"]
    webgal["WebGal 导出"]
    renpy ~~~ webgal;
  end
  frontend --> middleend;
  middleend --> backend;
  subgraph support["支持部分"]
    assetlib["素材库"]
  end
  backend ~~~ support;

稍微详细一点的版本在这里

graph TB
  subgraph frontend["前端"]
    direction LR
    input["剧本读取"]
    lang["语法解析"]
    perform["自动演出"]
    input --> lang;
    lang --> perform;
  end
  subgraph middleend["中端"]
    direction LR
    normalization["规范化、优化"]
    analysis["分析工具"]
    normalization ~~~ analysis;
  end
  subgraph backend["后端"]
    direction LR
    renpy["Ren'Py 导出"]
    webgal["WebGal 导出"]
    renpy ~~~ webgal;
  end
  frontend --> middleend;
  middleend --> backend;
  subgraph support["支持部分"]
    direction LR
    assetlib["素材库"]
    debug["调试工具"]
    assetlib ~~~ debug;
  end
  backend ~~~ support;

让我们对每个模块逐一进行介绍：

素材库：为了支持在只有剧本、没有素材的情况下生成实机演示，语涵编译器项目内嵌了一些素材。所有素材均可从语涵编译器的代码仓库直接下载，您即使不使用语涵编译器也可以使用我们准备的素材。
前端剧本读取、解析、自动演出：语涵编译器可以读取符合剧本格式要求的剧本，以此生成游戏工程文件。剧本内可以引用素材库中的内容。
中端分析优化工具：语涵编译器可以分析剧本并生成报告，用以引导制作者进行迭代。详情请见中端工具总览。
后端工程导出：语涵编译器目前可以生成 Ren'Py 或 WebGal 的游戏工程。目前 WebGal 的支持暂时还不完整，部分功能用不了，之后会慢慢完善。

前、中、后端在本文档里都有各自的部分进行介绍，详情请阅读对应章节。关于素材的使用方法将在前端部分介绍。