# 西游记

**Repository Path**: MoganLab/xiyouji

## Basic Information

- **Project Name**: 西游记
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-20
- **Last Updated**: 2026-09-20

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 西游记 (Mogan STEM)

明代吴承恩所著《西游记》（全书共一百回）的结构化排版工程。基于 **Mogan STEM** 与 **Goldfish Scheme (`gf`)** 工具链构建，面向研读、AI 辅助阅读及高质量排版设计。

## 文本底本
正文基于《西游记》百回本整理，去除非正文标记与杂音，保留完整的经典回目与诗词赋赞，并转换为规范简体中文。

## 目录结构
由于《西游记》无分卷体系，全书一百回直接建档存放于 **`stem/`** 目录（编号 001 至 100）：
- **`stem/001.stem` ~ `stem/100.stem`**：各回独立排版文档
- **`xiyouji.stem`**：全书一百回完整正文合并生成的主书文档
- **`xiyouji.tmu`**：Mogan TMU 格式编译文件
- **`packages/guwen.stem`**：古籍宏包，提供人名下划线标记等宏定义
- **`data/persons.scm`**：西游记人物与神仙魔怪数据库

## 排版特性
- **人名专名标注**：通过 `packages/guwen.stem` 宏包定义的 `(person "规范名" "显示名")` 标签标记人物、神仙、魔怪，正文中自动呈现古籍专名下划线。
- **人名数据库**：`data/persons.scm` 收录数百位主要人物角色与别名/尊号/诨号映射规则。
- **A5 紧凑版心**：宏包全局配置默认 A5 页面尺寸，适合配合编辑器侧边栏 AI 辅助时分栏并排阅读。
- **首行缩进**：宏包配置 `par-first` 规范首行缩进，正文已清理段首硬空格。

## 工具链与脚本（基于 Goldfish Scheme）
本工程所有自动化脚本统一使用 **`gf`** 编写，位于 **`scripts/`** 目录：
- **从原始 txt 转换**：
  ```bash
  gf scripts/convert.scm [/path/to/xiyouji_txt]
  ```
- **人名标注**：
  ```bash
  gf scripts/tag_person.scm --all [data/persons.scm]
  # 或标注单回：
  gf scripts/tag_person.scm stem/001.stem [data/persons.scm]
  ```
- **全书合并与编译**：
  ```bash
  gf scripts/generate_xiyouji.scm
  ```
- **PDF 导出**：
  ```bash
  gf scripts/stem2pdf.scm <input.stem> [output.pdf]
  ```
- **格式化**：
  ```bash
  gf fmt <path>
  ```

## 运行环境
- **Goldfish Scheme (`gf`)**：LiiiLabs 现代化 Scheme 解释器
- **Liii STEM (`liiistem`)**：Mogan STEM 文档编译器（用于渲染 PDF 与生成 TMU）