重写全部 README，只保留使用说明

17 个 README 统一改成使用说明书，去掉来源、踩坑、需求过程等内容。只保留： - 怎么编译、跑几遍 - 文件结构 - 要改哪些参数（逐项列出宏名与含义） - 用到的命令（表格） - 版式参数删除： - 原文件来源、抽取过程 - 踩坑记录、最小复现、实测数据 - 用户需求、工单号、历史沿革 - 改造前后对比行数 4185 → 2261。全库 16/16 编译通过。
2026-11-01 08:52:54 +08:00
parent a4bfcac82a
commit f87d763602
17 changed files with 1629 additions and 3334 deletions
@@ -1,99 +1,161 @@
-# 试卷 —— 试卷与参考答案 LaTeX 模板
+# 试卷

-中国海洋大学期末考试**试卷**与**参考答案及评分标准**的 XeLaTeX 模板。
-两份模板均不含真题，题目与分值都是示意，按教学大纲替换即可。
+期末考试试卷 + 参考答案与评分标准，两套模板，A4 两栏。

-> 样张是《数字逻辑》2025 秋的一份**完整虚构 A 卷**：16 类题型（填空 / 选择 /
-> 判断 / 化简 / 分析 / 设计 / 时序 / 计数器 / 状态机 / 存储器 / ADC-DAC /
-> Verilog / 综合设计 …）+ 对应参考答案与评分标准（8 大题 / 满分 100）。
-> **题目是按数字逻辑课程内容真编的、答案算过是对的**，不是「略」或「×××」——
-> 这样既能看清版式，也能看出各题型的排版难度（比如卡诺图、时序波形图
-> 都是 TikZ 内联画的）。
->
-> 与 [`课程教学日历/`](../课程教学日历/)、[`成绩构成说明/`](../成绩构成说明/)、
-> [`试卷归档封面/`](../试卷归档封面/) 是同一门课，四份一起看是自洽的。
-> 唯一**故意留空**的是命题人 / 审核人 / 各题得分栏 —— 那是要签字担责的，
-> 编名字上去容易被误当真实署名。
+## 编译
+
+```bash
+cd 试卷
+xelatex 试卷题型示例.tex
+xelatex 试卷题型示例.tex                  # 题号交叉引用需要两遍
+
+xelatex 参考答案与评分标准示例.tex
+xelatex 参考答案与评分标准示例.tex
+```
+
+或仓库根：`bash build.sh 试卷 试卷题型示例`（自动跑两遍）

 ## 文件

 | 文件 | 说明 |
 |---|---|
-| `oucexam.sty` | 试卷版式包。纸张 195×270mm（学校专用试卷纸），含装订栏、成绩表、页脚 |
-| `ouckey.sty` | 答案与评分标准版式包。默认 A4；加 `exampaper` 选项则与试卷同纸同边距 |
-| `试卷题型示例.tex` | 试卷范例，16 类题型，6 页 |
-| `参考答案与评分标准示例.tex` | 答案范例，8 大题 / 满分 100，3 页 |
+| `试卷题型示例.tex` | 试卷，16 种题型展示 |
+| `参考答案与评分标准示例.tex` | 答案与评分标准 |
+| `oucexam.sty` | 试卷版式包 |
+| `ouckey.sty` | 答案版式包 |

-## 编译
-
-```bash
-xelatex 试卷题型示例.tex
-xelatex 试卷题型示例.tex       # 跑两遍，第二遍才能取到正确总页数（lastpage）
-```
-
-必须用 **XeLaTeX**（fontspec + xeCJK），pdflatex 编译不过。
-两份 .tex 都在本目录内自包含，不依赖任何图片文件（示例配图是 TikZ 内联画的）。
-
-## 试卷模板要点
-
-纸张、页边距、行距、装订栏位置、页脚样式都已在 `oucexam.sty` 里按原卷实测值定好，
-一般**只改 `\examsetup` 那一块**（下例是样张实际用的虚构值）：
+## 试卷：卷头参数

 ```latex
+\documentclass[UTF8,fontset=none]{ctexart}
+\usepackage{oucexam}
+
 \examsetup{
-  year      = {2025},        % 学年（会自动印成 2025—2026）
-  term      = {秋},           % 秋 / 春
-  course    = {数字逻辑},
+  year      = {2025},        % 学年
+  term      = {秋},          % 季学期
+  course    = {数字逻辑},     % 课程名称
  college   = {信息科学与工程学院},
-  type      = {A},            % 卷头「试卷类型：A 卷」
-  foottype  = {},             % 页脚课程名后是否再印类型字母，空=不印
-  proposer  = {},             % 命题人
-  reviewer  = {},             % 审核人
-  mode      = {闭卷},
-  allowed   = {无},           % 允许携带的物品
-  nsec      = {16},           % 大题数，成绩表自动按 nsec+1 栏等分
+  type      = {A},           % 试卷类型 A / B
+  foottype  = {},            % 页脚是否再印类型字母，留空则不印
+  proposer  = {},            % 命题人
+  reviewer  = {},            % 审题人
+  mode      = {闭卷},         % 考试方式
+  allowed   = {无},          % 允许携带的物品
+  nsec      = {16},          % 大题数量（成绩表按此栏数等分）
 }
 ```

- `proposer` / `reviewer` 样张里**故意留空**：命题人、审核人是要签字担责的，
-  编一个名字上去容易被误当真实署名。留空时模板自动不印该项、不留空横线。
- `type` 与 `foottype` 互不影响：前者只管卷头，后者只管页脚。
-  原卷 A 卷页脚没印字母、B 卷印了 B，这是出卷人手工差异，不是规则。
- 大题数变了必须同步改 `nsec`，否则成绩表格子会错位。
+| 参数 | 说明 |
+|---|---|
+| `year` | 学年 |
+| `term` | 季学期 |
+| `course` | 课程名称 |
+| `college` | 学院 |
+| `type` | 试卷类型，A / B |
+| `foottype` | 页脚类型字母，留空不印 |
+| `proposer` | 命题人，留空不印 |
+| `reviewer` | 审题人，留空不印 |
+| `mode` | 闭卷 / 开卷 |
+| `allowed` | 允许携带物品 |
+| `nsec` | 大题数量，决定卷头成绩表的栏数 |

-## 答案模板要点
+留空的项自动不印，不会留空白横线。
+
+## 试卷：题型命令
+
+16 种题型，按需用：
+
+| 题型 | 命令 |
+|---|---|
+| 一、填空题 | `\blank[n]` 按字宽画横线，`\lblank` 通栏横线 |
+| 二、判断题 | `\judge` 括号在题首 |
+| 三、单项选择题 | `\choices` 一行四栏 |
+| 四、多项选择题 | `\choicesII` 两行两栏 |
+| 五、名词解释 | `\answerlines[n]` 答题横线 |
+| 六、简答题 | 题号用 `\qiT`（Times 数字） |
+| 七、判断改错题 | `\judge` + 改错横线 |
+| 八、计算题 | 表格 + `\answerbox` 作答框 |
+| 九、作图题 | 大方框作答 |
+| 十、配伍题 | `\mtpair` 左右两栏，中间连线 |
+| 十一、表格填写题 | `\datatable` + 空格 |
+| 十二、术语翻译题 | 英译中 / 中译英 |
+| 十三、证明题 | 逻辑推演，大作答区 |
+| 十四、分析题 | 配图，用 `\examfig{宽度}{文件}` |
+| 十五、实验设计题 | 方案要素 + 大作答区 |
+| 十六、论述题 | 大段作答区 |
+
+大题标题写法：

 ```latex
+\examsection{一、填空题（每空 1 分，共 10 分）}
+```
+
+## 答案：卷头参数
+
+```latex
+\usepackage{ouckey}
+
 \keysetup{
-  year = {2025}, term = {秋}, course = {数字逻辑}, type = {A},
-  dept = {计算机科学与技术学院}, college = {信息科学与工程学院},
-  major = {计算机科学与技术专业 \TNR{2023} 级},
-  teacher = {张远航}, examiner = {张远航},
-  mode = {闭卷、笔试}, total = {100},
+  year      = {2025},        % 学年
+  term      = {秋},          % 季学期
+  course    = {数字逻辑},     % 课程名称
+  type      = {A},           % 试卷类型
+  dept      = {计算机科学与技术学院},
+  college   = {信息科学与工程学院},
+  major     = {计算机科学与技术专业 \TNR{2023} 级},
+  teacher   = {张远航},       % 任课教师
+  examiner  = {张远航},       % 命题教师
+  mode      = {闭卷、笔试},
+  total     = {100},         % 满分
 }
 ```

-如实现在试卷同一张纸上印，把 `\usepackage{ouckey}` 改成 `\usepackage[exampaper]{ouckey}`。
+| 参数 | 说明 |
+|---|---|
+| `year` `term` `course` `type` | 与试卷一致 |
+| `dept` | 系 |
+| `college` | 学院 |
+| `major` | 面向专业与年级 |
+| `teacher` | 任课教师 |
+| `examiner` | 命题教师 |
+| `mode` | 考试方式 |
+| `total` | 满分 |

-体例四条（学校没有统一模板，按国内高校通行做法拟定）：
+## 答案：命令

-1. 抬头信息齐全，留空的项自动不印、不留空横线
-2. 客观题答案集中列（`\objkeys{C,B,A,...}`，每行 6 个自动换行），附统一给分规则
-3. 主观题**内嵌**分步分值（`\pt{2}`），阅卷时批到哪里看到哪里
-4. 每个大题末尾给【评分标准】`\scoring{...}`
+| 命令 | 用途 |
+|---|---|
+| `\makekeyhead` | 印抬头 |
+| `\keysection{标题}` | 大题的标题与答案区 |
+| `\keysectionfree{标题}` | 不带答案框的标题 |
+| `\keyitem{...}` | 一条答案与评分点 |
+| `\keyitemstar{...}` | 带星号的答案条目 |
+| `\keynote{...}` | 说明性注释 |
+| `\scoring{分值}` | 标出评分点分值 |
+| `\keytotal` | 末尾的分数汇总表 |
+| `\keysign` | 签字栏 |
+| `\objkeys{...}` | 客观题答案（判断、选择） |
+| `\pt{n}` / `\ptline` | 分值标注 |

-主观题内嵌分值是有意为之：阅卷是流水作业，分值必须和答案文字贴在一起，
-集中写在末尾会让批卷人来回翻页。
+答案与试卷的题号、分值要一一对应，改试卷时答案模板也要同步改。

-文末 `\keytotal{20,10,12,12,12,16,8,10}` 是分值汇总表，用于阅卷前核对
-「各大题相加 = 满分」。签名栏 `\keysign` 只留命题人一处。
+## 版式

-## 书写注意
+```
+A4 两栏，栏宽 82mm
+试卷：题号与作答区按题型自动排
+答案：每题带评分点标注，末尾总分汇总表
+正文宋体，题号用 Times
+```

- 题干内部换行用 `\\*`，**不要用裸 `\\`**。裸 `\\` 语义是"允许在此断页"，
-  题干会被切到上下两页，学生看到半句话。
- 数字、英文用 `\TNR{...}` 包起来（内部显式 `\normalfont` 收尾）。
-  裸用字体切换命令会让字体状态泄漏到后续段落。
- `\keyitem{题号}{分值}{答案正文}` 的参数里**不要嵌 `tabular` / `tikzpicture`**——
-  这些环境的 `&` 与 `\\` 会被当成参数分隔符，报 `File ended while scanning`。
-  表格和图写在 `\keyitem` 之后。
+## 配图
+
+分析题等需要配图时，用 TikZ 直接画，或：
+
+```latex
+\examfig{0.6\textwidth}{图片文件.png}
+```
+
+## 注意
+
+示例内容为虚构题目，使用时全部替换。