# 史记

**Repository Path**: MoganLab/shiji

## 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)

西汉司马迁所著《史记》（全书共 130 卷）的结构化排版工程。基于 **Mogan STEM** 与 **Goldfish Scheme (`gf`)** 工具链构建，面向学术阅读、AI 辅助研读及高质量排版设计。

## 文本底本
正文基于《史记三家注》（裴骃《集解》、司马贞《索隐》、张守节《正义》）底本整理，去除非正文注释与现代校记，保留纯正的古籍正文，并转换为规范简体中文。

## 目录结构
全书按《史记》体例分为五大体系，各卷以三位数字编号独立建档为 `.stem` 文件：
- **`part1/`**：十二本纪（卷 001 - 012）
- **`part2/`**：十表（卷 013 - 022，表格体例暂留空）
- **`part3/`**：八书（卷 023 - 030）
- **`part4/`**：三十世家（卷 031 - 060）
- **`part5/`**：七十列传（卷 061 - 130）
- **`shiji.stem`**：全书 120 卷完整正文合并生成的主书文档

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

## 工具链与脚本（基于 Goldfish Scheme）
本工程所有自动化脚本统一使用 **`gf`** 编写，位于 `scripts/` 目录：
- **全书合并**：
  ```bash
  gf scripts/generate_shiji.scm
  ```
- **PDF 导出**：
  ```bash
  gf scripts/stem2pdf.scm <input.stem> [output.pdf]
  ```
- **人名标注**：
  ```bash
  gf scripts/tag_person.scm <target.stem> [data/persons.scm]
  ```
- **代码与排版格式化**：
  ```bash
  gf fmt <path>
  ```

## 运行环境
- **Goldfish Scheme (`gf`)**：LiiiLabs 现代化 Scheme 解释器
- **Liii STEM (`liiistem`)**：Mogan STEM 文档编译器（用于渲染 PDF）
- **OpenCC**：中文繁简转换工具