Files

T

laoyang e70339fcf6 全库脱敏：清除真实姓名、个人账号与私有域名 #17

开源前排查，发现三处真实个人信息残留，全部清除：

1. 真名「杨永全」→ 中性署名「中国海洋大学 LaTeX 模板库」
   幻灯片/ 下 6 个 sty 文件头的「%% 作者：杨永全」。

2. 个人账号 dryangyq → 占位地址
   幻灯片/slides.tex 第 66 行脚注里的 github/gitee/gitlab 三个
   dryangyq 仓库地址，改为 example.org 占位并注明开源后替换。

3. 个人域名 yangyq.net + 私有 Gitea 账号 laoyang → 占位地址
   幻灯片/README.md 与科技报告/README.md 的 clone 地址
   code.yangyq.net/laoyang/... 改为 example.org 占位。

另重编幻灯片/slides.pdf：旧 PDF 的脚注里还印着 dryangyq 与
yangyq.net 的 URL（源码改了但成品没重编），逐字提取确认后覆盖。

验证：
- 全库源码（.tex/.sty/.cls/.md）grep 杨永全 / dryangyq / yangyq /
  yongquan / 永全 全部零命中
- 全库 PDF 成品用 pymupdf 提取渲染文本，上述关键词零命中
- 幻灯片重编 30 页、0 error

未处理（遗留，需另决策）：git 历史 27 个 commit 的作者签名是
「laoyang <i@yangyq.net>」，含个人域名邮箱。若推到公开平台需
git filter-repo 重写历史（改全部 SHA + force push），属破坏性操作，
本单不做。

2026-10-29 08:17:08 +08:00

4.9 KiB

Raw Blame History

中国海洋大学科技报告 LaTeX 模板

一个基于 ctexart 的科技报告模板，可用于撰写科技报告、实验讲义、教程、说明文档等。

本目录原为独立仓库 ouc-report-latex-template，2026-10 起并入 ouc_latex_template 统一维护，旧仓库不再更新。

特性

中英文字体一体化：英文默认使用鸿蒙字体（HarmonyOS Sans），中文使用仓库公共字体包（宋体 / 宋体粗 / 楷体 / 仿宋 / 黑体），字体文件在仓库根 ../fonts/ 目录，编译时自动调用，无须安装任何字体；
模块化文档类：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 或包含常用宏包的发行版即可。

使用方法

本目录是 ouc_latex_template 仓库的 科技报告/ 子目录，克隆主仓库即可：

git clone https://example.org/ouc_latex_template.git   # ⚠️ 开源后替换为实际公开仓库地址
cd ouc_latex_template/科技报告

在 input/info.tex 中填写标题、副标题、作者、单位、部门等信息；
在 report.tex 中撰写正文（或按 \input 方式组织章节文件）；
使用 XeLaTeX 编译两遍（第一遍生成目录与交叉引用信息，第二遍写入正文）：
```
xelatex report.tex
xelatex report.tex
```
临时切换字体可使用命令：\fzss（宋体）、\fzxbs（宋体粗）、\fzkai（楷体）、\fzfs（仿宋）、\fzzdx（黑体）、\hm（鸿蒙字体）。命令名沿用旧版（fz 取自原方正系列），实际用的是随仓库分发的开源字体，对应关系见 cls/font.cls 的注释。

署名与联系方式（二次分发前请修改）

模板里有两处「作者 / 联系方式」信息，性质不同，别改错地方：

想改什么	改哪个文件的哪里	说明
模板维护者的联系方式	`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/               # 图片资源
├── (字体在仓库根 fonts/)  # 不再自备字体，详见 ../fonts/README.md
├── fontawesome.pdf     # fontawesome 图标使用手册
└── report.tex          # 主文件（XeLaTeX 编译入口）

关于 `report.pdf`

仓库内的 report.pdf 是成品样张，用于预览效果。封面的日期取自 \today，所以每次编译都会变；用不同年份的 TeX Live 编译，PDF 体积也可能略有差异，但页面渲染内容一致。以 report.tex 源码为准。

4.9 KiB Raw Blame History Unescape Escape