Files
ouc-report-latex-template/README.md
T
laoyang 3f1234d0b8 脱敏:README 与 report.cls 去掉个人邮箱与真实身份
- README 去掉创建者署名(个人姓名 + 校园邮箱)
- report.cls 顶部维护者信息改为通用占位符 someone@example.com
- README 新增「署名与联系方式(二次分发前请修改)」一节,分别说明
  模板维护者信息(report.cls 顶部注释,不参与排版)与报告作者信息
  (input/info.tex,会印在封面、单位部门还会成为全页水印)该在哪改

验证:仓库全文扫描无个人身份信息命中;XeLaTeX(TeX Live 2026)
编译两遍通过,输出 10 页、无错误。
2026-09-28 19:16:19 +08:00

4.1 KiB
Raw Blame History

中国海洋大学科技报告 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 或包含常用宏包的发行版即可。

使用方法

  1. 克隆仓库,在 input/info.tex 中填写标题、副标题、作者、单位、部门等信息;

  2. 在 report.tex 中撰写正文(或按 \input 方式组织章节文件);

  3. 使用 XeLaTeX 编译两遍(第一遍生成目录与交叉引用信息,第二遍写入正文):

    xelatex report.tex
    xelatex report.tex
    
  4. 临时切换字体可使用命令:\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 编译入口)