ouc_latex_template/成绩构成说明/README.md

# 成绩构成说明

中国海洋大学课程成绩构成说明表，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），边距标准
表格带框线
```

## 注意

示例内容为虚构数据，使用时全部替换。签字栏留空手填。