laoyang
f87d763602
17 个 README 统一改成使用说明书，去掉来源、踩坑、需求过程等内容。 只保留： - 怎么编译、跑几遍 - 文件结构 - 要改哪些参数（逐项列出宏名与含义） - 用到的命令（表格） - 版式参数 删除： - 原文件来源、抽取过程 - 踩坑记录、最小复现、实测数据 - 用户需求、工单号、历史沿革 - 改造前后对比 行数 4185 → 2261。 全库 16/16 编译通过。
115 lines
3.1 KiB
Markdown
115 lines
3.1 KiB
Markdown
# 成绩构成说明
|
|
|
|
中国海洋大学课程成绩构成说明表，A4 单页，正文小四（12pt）。
|
|
|
|
## 编译
|
|
|
|
```bash
|
|
cd 成绩构成说明
|
|
xelatex 成绩构成说明.tex
|
|
```
|
|
|
|
或仓库根：`bash build.sh 成绩构成说明`
|
|
|
|
## 文件
|
|
|
|
| 文件 | 说明 |
|
|
|---|---|
|
|
| `成绩构成说明.tex` | 主文件，填内容改这里 |
|
|
| `oucgrade.sty` | 版式包，一般不改 |
|
|
|
|
## 填写参数
|
|
|
|
改 `\begin{document}` 之后的第 1 节，共 10 个宏，正文不用动：
|
|
|
|
```latex
|
|
\newcommand{\grdcourse}{数字逻辑} % 课程名称
|
|
\newcommand{\grdyear}{2025} % 学年
|
|
\newcommand{\grdseason}{秋} % 季学期（春 / 秋）
|
|
\newcommand{\grdteacher}{张远航} % 任课教师
|
|
|
|
\newcommand{\grdtheory}{80} % 理论课占总成绩
|
|
\newcommand{\grdlab}{20} % 实验课占总成绩
|
|
|
|
\newcommand{\grddaily}{30} % 平时成绩占理论课
|
|
\newcommand{\grdfinal}{70} % 期末考试成绩占理论课
|
|
|
|
\newcommand{\grdhw}{20} % 作业占理论课
|
|
\newcommand{\grdattend}{10} % 点名占理论课
|
|
|
|
\newcommand{\grdlabnote}{由实验课教师根据实验报告与实验操作评定。}
|
|
```
|
|
|
|
| 参数 | 说明 |
|
|
|---|---|
|
|
| `\grdcourse` | 课程名称 |
|
|
| `\grdyear` | 学年 |
|
|
| `\grdseason` | 季学期，春 / 秋 |
|
|
| `\grdteacher` | 任课教师 |
|
|
| `\grdtheory` | 理论课占总成绩百分比 |
|
|
| `\grdlab` | 实验课占总成绩百分比 |
|
|
| `\grddaily` | 平时成绩占理论课百分比 |
|
|
| `\grdfinal` | 期末考试占理论课百分比 |
|
|
| `\grdhw` | 作业占理论课百分比 |
|
|
| `\grdattend` | 点名占理论课百分比 |
|
|
| `\grdlabnote` | 实验课评定方式，一句话说明 |
|
|
|
|
百分数只填数字，不要带 `%`。
|
|
|
|
## 比例必须自洽
|
|
|
|
模板会自动检查三组加法：
|
|
|
|
```
|
|
理论课 + 实验课 = 100
|
|
平时成绩 + 期末考试 = 理论课
|
|
作业 + 点名 = 平时成绩
|
|
```
|
|
|
|
不通过时：
|
|
- 编译 log 里打 `*** oucgrade: 比例不自洽 ***`
|
|
- PDF 上印一个醒目的提示
|
|
|
|
## 表格结构
|
|
|
|
| 区段 | 内容 |
|
|
|---|---|
|
|
| 表头 | 课程名称、学年学期、任课教师 |
|
|
| 总成绩构成 | 理论课 / 实验课两行，各占百分比 |
|
|
| 理论课内部 | 平时成绩 / 期末考试 |
|
|
| 平时成绩内部 | 作业 / 点名 |
|
|
| 实验课说明 | 一行文字 |
|
|
| 签字栏 | 任课教师、教研室主任、教学院长 |
|
|
|
|
## 改表格内文字
|
|
|
|
正文里表格用标准 `tabular`，各格改写直接改文字。
|
|
|
|
### 常用命令
|
|
|
|
| 命令 | 用途 |
|
|
|---|---|
|
|
| `\grdmaintitle` | 主标题 |
|
|
| `\grdsubtitle` | 副标题 |
|
|
| `\grdsubtitleline` | 副标题下横线 |
|
|
| `\grdsec{标题}` | 分区标题 |
|
|
| `\grditem{文字}` | 条目 |
|
|
| `\grdpara{文字}` | 段落 |
|
|
| `\grdth{内容}` | 表头格 |
|
|
| `\grdtd{内容}` | 表体格 |
|
|
| `\grdcalc{算式}` | 算式格（自动排版） |
|
|
| `\grdsignblock` | 签字栏整块 |
|
|
| `\grdsmall{文字}` | 小字 |
|
|
| `\grdcheck` | 运行比例校验 |
|
|
| `\grdwarnifbad` | 不自洽时印警告 |
|
|
|
|
## 版式
|
|
|
|
```
|
|
A4，正文小四（12pt），边距标准
|
|
表格带框线
|
|
```
|
|
|
|
## 注意
|
|
|
|
示例内容为虚构数据，使用时全部替换。签字栏留空手填。 |