# million-math-book

**Repository Path**: zhcosin/million-math-book

## Basic Information

- **Project Name**: million-math-book
- **Description**: 小学数学课外阅读书籍 latex 源码工程.
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-16
- **Last Updated**: 2026-07-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 小学数学课外阅读

一本基于 LaTeX (ctexbook) 的小学数学课外拓展阅读书籍源码工程。

## 编译方式

```bash
xelatex million-math-book.tex
```

需要 XeLaTeX 引擎（ctexbook 宏包依赖）。含 Asymptote 图形时需额外执行 `asy` 编译。

## 项目结构

```
million-math-book/
├── million-math-book.tex     # 主文档：封面、目录、\include 引入各章
├── use-packages.tex          # 导言区：宏包加载、颜色定义、定理环境、排版样式
├── DESIGN.md                 # 项目设计文档（目录规范、命名规则、编译说明）
├── contents/                 # 章节内容源文件
│   └── g{年级}s{学期}/       # 按学期划分，如 g4s2、g5s1
│       ├── chapter.tex       # 章文件：\input 引入各节
│       ├── <topic>.tex       # 节文件：具体内容，文件名描述主题
│       └── asy/              # Asymptote 矢量图源文件（可选）
├── auto/                     # AUCTeX 自动生成的本地配置（不纳入版本控制）
└── .gitignore
```

## 文档层级

```
主文档 (million-math-book.tex)
    │ \include（自动分页）
章文件 (contents/gNsM/chapter.tex)
    │ \input（不分页）
节文件 (contents/gNsM/topic-name.tex)
```

- `\include` 用于主文档引入章文件，章从新页开始
- `\input` 用于章文件引入节文件，连续排版
- `\input` 路径相对于**根目录**（主文档所在位置）

## 章节目录命名规则

`contents/g{年级}s{学期}/`，如 `g4s2` = 四年级下学期，`g5s1` = 五年级上学期。禁止中文目录名。

节文件不使用编号前缀，文件名描述内容，显示顺序由 `chapter.tex` 中 `\input` 的顺序决定。

  ## 写作风格要求

  - **语言风格**：轻松诙谐，贴近小学生认知水平，避免生硬说教
  - **叙事方式**：可适当加入趣味比喻、生活实例、幽默对话
  - **表达建议**：多使用"你知道吗？""有趣的是……""试试看"等亲和力强的表达
  - **目标**：让数学知识变得有趣易懂，激发学习兴趣

  ## 排版特性

  - **纸张**：A5
  - **图形**：TikZ（行内插图）、Asymptote（独立矢量图，存放于 `asy/` 子目录）
  - **定理环境**：基于 amsthm + tcolorbox，区分定理（蓝）、定义（金）、例题（绿）、练习（紫）、注/解（灰）
  - **章节样式**：titlesec 定制，chapter 带 TikZ 圆角标签和装饰线
  - **目录**：tocloft 定制样式
  - **页眉页脚**：fancyhdr 定制
  - **中文支持**：ctexbook 文档类 + indentfirst 首段缩进

## Emacs/AUCTeX 集成

所有 `.tex` 文件末尾包含 Local Variables 注释，支持从任意子文件直接编译主文档：

- 主文档：`TeX-master: t`
- 子文档：`TeX-master` 使用相对路径指向根目录主文档（如 `"../../million-math-book"`）