laoyang
1f807e9cce
目录改名（git mv 保留历史，包名不变）： exam/ -> 试卷/ form/ -> 年度考核登记表/ form2/ -> 劳务发放说明表/ course/ -> 课程执行大纲/ 改名即可编译：实测 6 个模板在含中文的目录下 XeLaTeX 均零报错， PDF 逐页文本与改名前的版本完全一致（0 页差异，仅元数据时间戳变化）。 并入两个此前独立维护的仓库： ouc-slide-latex-template -> 幻灯片/ ouc-report-latex-template -> 科技报告/ 带入了 theme/ fonts/ logos/ figs/ cls/ input/ 与 fontawesome.pdf， 字体随模板附带（无须在系统安装）。中间文件一律不入库。 同步修正的文档：根 README 目录表改为中文名并说明统一维护； 四个子 README 的标题；ouclw.sty 注释里对 form/ 的交叉引用； 幻灯片与科技报告 README 里「从旧仓库 clone」「按年份切分支」等已失效的说明 （并入后只有 main 一个分支，各年份 TeX Live 通用）。 两个迁入模板的 PDF 保留源仓库原版（逐字节一致），未重新编译： 源 PDF 出自 TeX Live 2026，本机为 2022，重新编译会让结尾页装饰层定位 产生细微偏移，保留原版以保证样张与原来完全一致。
85 lines
4.7 KiB
Markdown
85 lines
4.7 KiB
Markdown
# 中国海洋大学科技报告 LaTeX 模板
|
||
|
||
一个基于 `ctexart` 的科技报告模板，可用于撰写科技报告、实验讲义、教程、说明文档等。
|
||
|
||
> 本目录原为独立仓库 `ouc-report-latex-template`，2026-10 起并入 `ouc_latex_template` 统一维护，旧仓库不再更新。
|
||
|
||
## 特性
|
||
|
||
- **中英文字体一体化**：英文默认使用鸿蒙字体（HarmonyOS Sans），中文使用方正书宋 / 小标宋 / 楷体 / 仿宋 / 中等线，字体文件随模板附于 `font/` 目录，编译时自动调用，**无须安装任何字体**；
|
||
- **模块化文档类**：`report.cls` 按功能拆分为 `cls/` 下的多个模块（全局设定、字体、页面布局、标题、页眉页脚、信息框、代码块等），便于按需修改；
|
||
- **三种信息框**：`titledbox`（带标题）、`notebox`（提示）、`importantbox`（重要），基于 tcolorbox 实现；
|
||
- **代码排版**：基于 listings 预设了多种样式，支持行内命令 `shellbox` / `invertedshellbox` 展示 shell 命令及输出；
|
||
- **自动水印**：默认以「单位 + 部门」作为全页水印，可在 `input/setting.tex` 中调整文字、透明度与大小；
|
||
- **图表与引用**：tabularx 表格、图片插入、自动编号与交叉引用、目录 / 图目录 / 表目录；
|
||
- **图标支持**：通过 fontawesome 可直接使用 `\faHeart` 等图标命令（详见根目录 `fontawesome.pdf`）。
|
||
|
||
## 环境要求
|
||
|
||
- **TeX 发行版**：TeX Live 2022 及以上（必须使用 **XeLaTeX** 编译）；
|
||
- 无需额外安装字体或其他依赖，使用 `scheme-full` 或包含常用宏包的发行版即可。
|
||
|
||
## 使用方法
|
||
|
||
1. 本目录是 `ouc_latex_template` 仓库的 `科技报告/` 子目录，克隆主仓库即可：
|
||
```bash
|
||
git clone https://code.yangyq.net/laoyang/ouc_latex_template.git
|
||
cd ouc_latex_template/科技报告
|
||
```
|
||
2. 在 `input/info.tex` 中填写标题、副标题、作者、单位、部门等信息；
|
||
3. 在 `report.tex` 中撰写正文（或按 `\input` 方式组织章节文件）；
|
||
4. 使用 XeLaTeX 编译**两遍**（第一遍生成目录与交叉引用信息，第二遍写入正文）：
|
||
|
||
```bash
|
||
xelatex report.tex
|
||
xelatex report.tex
|
||
```
|
||
|
||
5. 临时切换字体可使用命令：`\fzss`（方正书宋）、`\fzxbs`（方正小标宋）、`\fzkai`（方正楷体）、`\fzfs`（方正仿宋）、`\fzzdx`（方正中等线）、`\hm`（鸿蒙字体）。
|
||
|
||
## 署名与联系方式（二次分发前请修改）
|
||
|
||
模板里有两处「作者 / 联系方式」信息，**性质不同，别改错地方**：
|
||
|
||
| 想改什么 | 改哪个文件的哪里 | 说明 |
|
||
|---|---|---|
|
||
| **模板维护者**的联系方式 | `report.cls` 顶部的 `Maintainer:` 一行 | 目前是占位符 `someone@example.com`。它只出现在注释里，**不参与排版**，改成什么都不会影响编译结果 —— 你要把这份模板再分发出去，就换成你自己的。 |
|
||
| **报告本身**的作者 / 单位 / 部门 | `input/info.tex` 里的 `\theauthor`、`\theaffiliation`、`\thedept` | 会印在**封面**上；单位与部门还会成为全页**水印**（水印的文字、透明度、大小在 `input/setting.tex` 里调）。 |
|
||
|
||
> 也就是说：`report.cls` 顶部那行与你的报告内容无关；报告里显示的作者信息一律在 `input/info.tex`。
|
||
|
||
## TeX Live 版本兼容性
|
||
|
||
同一份源码在下列 TeX Live 版本下均可直接编译（XeLaTeX），**不需要切分支、不需要改代码**：
|
||
|
||
| TeX Live | 状态 |
|
||
|------|------|
|
||
| 2022 | 已验证通过（基线） |
|
||
| 2023 | 已验证通过 |
|
||
| 2024 | 已验证通过 |
|
||
| 2025 | 已验证通过 |
|
||
| 2026 | 已验证通过 |
|
||
|
||
> 本目录原为独立仓库 `ouc-report-latex-template`，曾按 TeX Live 年份维护多套分支。
|
||
> 2026-10 并入 `ouc_latex_template` 后**只保留 `main` 一份源码**（已实测各年份通用），
|
||
> 旧仓库的分支不再更新。
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
.
|
||
├── report.cls # 文档类（模块化加载 cls/ 下各子模块）
|
||
├── cls/ # 功能模块：全局设定、字体、页面、标题、信息框、代码块等
|
||
├── input/ # 文档内容：封面、目录、摘要、信息与整体设置
|
||
├── figs/ # 图片资源
|
||
├── font/ # 鸿蒙及方正字体文件（自动加载）
|
||
├── fontawesome.pdf # fontawesome 图标使用手册
|
||
└── report.tex # 主文件（XeLaTeX 编译入口）
|
||
```
|
||
|
||
## 关于 `report.pdf`
|
||
|
||
仓库内的 `report.pdf` 是成品样张，用于预览效果。封面的日期取自 `\today`，
|
||
所以**每次编译都会变**；用不同年份的 TeX Live 编译，PDF 体积也可能略有差异，
|
||
但**页面渲染内容一致**。以 `report.tex` 源码为准。
|