- README 去掉创建者署名(个人姓名 + 校园邮箱) - report.cls 顶部维护者信息改为通用占位符 someone@example.com - README 新增「署名与联系方式(二次分发前请修改)」一节,分别说明 模板维护者信息(report.cls 顶部注释,不参与排版)与报告作者信息 (input/info.tex,会印在封面、单位部门还会成为全页水印)该在哪改 验证:仓库全文扫描无个人身份信息命中;XeLaTeX(TeX Live 2026) 编译两遍通过,输出 10 页、无错误。
4.1 KiB
4.1 KiB
中国海洋大学科技报告 LaTeX 模板
一个基于 ctexart 的科技报告模板,可用于撰写科技报告、实验讲义、教程、说明文档等。
特性
- 中英文字体一体化:英文默认使用鸿蒙字体(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或包含常用宏包的发行版即可。
使用方法
-
克隆仓库,在
input/info.tex中填写标题、副标题、作者、单位、部门等信息; -
在
report.tex中撰写正文(或按\input方式组织章节文件); -
使用 XeLaTeX 编译两遍(第一遍生成目录与交叉引用信息,第二遍写入正文):
xelatex report.tex xelatex report.tex -
临时切换字体可使用命令:
\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 年份维护分支,main 始终为最新版本:
| 分支 | 兼容的 TeX Live | 说明 |
|---|---|---|
2022 |
TeX Live 2022 | 基线版本 |
2023 |
TeX Live 2023 | 已验证通过 |
2024 |
TeX Live 2024 | 已验证通过 |
2025 |
TeX Live 2025 | 已验证通过 |
2026 |
TeX Live 2026 | 已验证通过(与 main 同步) |
如需在特定年份的 TeX Live 下使用,请切换到对应分支。在新版 TeX Live 下发现编译问题时,欢迎反馈。
目录结构
.
├── report.cls # 文档类(模块化加载 cls/ 下各子模块)
├── cls/ # 功能模块:全局设定、字体、页面、标题、信息框、代码块等
├── input/ # 文档内容:封面、目录、摘要、信息与整体设置
├── figs/ # 图片资源
├── font/ # 鸿蒙及方正字体文件(自动加载)
├── fontawesome.pdf # fontawesome 图标使用手册
└── report.tex # 主文件(XeLaTeX 编译入口)