laoyang/ouc_latex_template
1
0
Fork 0
Code Issues 1 Pull Requests Actions Packages Projects Releases Wiki Activity

简历左上角加中国海洋大学校徽（可选，默认不印） #13

New Issue
Closed
opened 2026-10-27 06:25:08 +00:00 by laoyang · 2 comments
laoyang commented 2026-10-27 06:25:08 +00:00
Owner
Copy Link
Copy Source

诉求

给「简历/」模板加一个可选的中国海洋大学校徽，放在左上角。

用户原话：

看一下简历左上角，加一个中国海洋大学的 logo 好看不好看，不要那么大，小一点，位置就跟科技报告差不多，试试效果。

经三轮迭代后确定尺寸 28mm（横式彩色），并已确认推送。

设计约束

  1. 可选。不写 \cvlogo{...} 就完全不出现，版面与调用前逐字节一致。
    不能改坏现有简历的默认外观。
  2. 小一点。最终定 28mm 宽（横式比例 2400:605 ⇒ 高 7.06mm）。
  3. 位置对齐科技报告的思路（距纸边而非距版心），但因版面不同需调整数值。
  4. 复用 科技报告/logos/ 里的官方 VI 素材，不新造图。

实现要点

  • 新增 \cvlogo[<文件名>]{<宽度>}，导言区只登记参数；
    真正画图放在 \makecvheader 开头的 \@makecvlogo，否则导言区产生内容会报
    ! LaTeX Error: Missing \begin{document}。
  • 用 tikzpicture[remember picture, overlay] + current page.north west 定位，
    距纸左 10mm、距纸顶 6mm。
  • 距顶不能照搬科技报告的 20mm：简历页边距只有 15mm、姓名墨迹顶在 17.2mm，
    20mm 会直接压到姓名。

验收标准

  • 简历.tex 加 \cvlogo{28mm} 后，左上角出现校徽，实测 28.0×7.1mm，
    距纸左 10mm / 距纸顶 6mm，下沿 13.1mm（仍在 15mm 版心边距内）。
  • 姓名基线位置不位移：加 logo 前后 y 均为 48.8pt，误差 0.0。
  • 不加 \cvlogo 时，PDF 与改动前逐字节一致（可选性成立）。
  • 编译 3 页，0 error / 0 Overfull / 0 Underfull / 0 个 ×。
  • 换圆形/换配色只需改可选参数，不必改代码。
## 诉求 给「简历/」模板加一个可选的中国海洋大学校徽，放在左上角。 用户原话： > 看一下简历左上角，加一个中国海洋大学的 logo 好看不好看，不要那么大，小一点，位置就跟科技报告差不多，试试效果。 经三轮迭代后确定尺寸 **28mm**（横式彩色），并已确认推送。 ## 设计约束 1. **可选**。不写 `\cvlogo{...}` 就完全不出现，版面与调用前逐字节一致。 不能改坏现有简历的默认外观。 2. **小一点**。最终定 28mm 宽（横式比例 2400:605 ⇒ 高 7.06mm）。 3. **位置对齐科技报告**的思路（距纸边而非距版心），但因版面不同需调整数值。 4. 复用 `科技报告/logos/` 里的官方 VI 素材，不新造图。 ## 实现要点 - 新增 `\cvlogo[<文件名>]{<宽度>}`，导言区只**登记**参数； 真正画图放在 `\makecvheader` 开头的 `\@makecvlogo`，否则导言区产生内容会报 `! LaTeX Error: Missing \begin{document}`。 - 用 `tikzpicture[remember picture, overlay]` + `current page.north west` 定位， 距纸左 10mm、距纸顶 6mm。 - 距顶**不能**照搬科技报告的 20mm：简历页边距只有 15mm、姓名墨迹顶在 17.2mm， 20mm 会直接压到姓名。 ## 验收标准 - [x] `简历.tex` 加 `\cvlogo{28mm}` 后，左上角出现校徽，实测 28.0×7.1mm， 距纸左 10mm / 距纸顶 6mm，下沿 13.1mm（仍在 15mm 版心边距内）。 - [x] 姓名基线位置**不位移**：加 logo 前后 y 均为 48.8pt，误差 0.0。 - [x] 不加 `\cvlogo` 时，PDF 与改动前逐字节一致（可选性成立）。 - [x] 编译 3 页，0 error / 0 Overfull / 0 Underfull / 0 个 `×`。 - [x] 换圆形/换配色只需改可选参数，不必改代码。
laoyang commented 2026-10-27 06:26:10 +00:00
Author
Owner
Copy Link
Copy Source

已完成并推送

commit 8e3017f，已推到 main。

改动文件

文件 变化
简历/awesome-source-cv.cls +70 行，新增 \cvlogo / \@makecvlogo / \cvlogox / \cvlogoy
简历/简历.tex +8 行，写入 \cvlogo{28mm} 与说明注释
简历/logos/ouc_横式_彩色.png 新增，380 KB（从 科技报告/logos/ 复制）
简历/README.md +47 行，新增「### 5. 左上角校徽（可选）」
简历/简历.pdf 重新生成，158 KB → 573 KB

最终实测（本地 + 服务器双份 PDF 独立测量，结果一致）

用 pymupdf 的 get_image_info() 取 bbox，不靠肉眼：

项 数值
校徽尺寸 28.00 × 7.06 mm（横式 2400:605，比例吻合）
左上角坐标 x = 10.07 mm、y = 6.07 mm
下沿位置 13.1 mm（仍在 15 mm 版心边距以内）
姓名墨迹 y 48.83 pt（与加 logo 前完全一致，未被推低）
页数 / error / Overfull / Underfull 3 / 0 / 0 / 0
× 残留 0
西文字体 Cochineal Roman/Bold/Italic 全部嵌入，Termes 已消失

服务器验证

从 Gitea API 直接下载 main 分支的原始 PDF：

  • 提交：main HEAD = 8e3017f
  • 大小：573565 字节
  • sha256 = 0acb298ab7c91d301814bc72e8cd2252ce84167c37d61d5fb126ffc20ea14c34
  • 与本地文件逐字节相同
  • 远程文件内确实含校徽（bbox 与上表一致）

⚠️ 若网页预览仍显示旧版，是 Gitea 网页 PDF 预览器的服务端缓存，
浏览器 Ctrl+F5 作用不到它。判断方法：下载原始文件看，或给 URL 加随机参数
?v=1 绕过。文件本身已确认是新版。

尺寸选型记录（8 组实测）

宽度 logo 纵范围 下沿 距姓名
18mm 8.1~12.6mm 12.6mm 4.6mm
22mm 8.1~13.6mm 13.6mm 10.2pt
24mm 8.1~14.1mm 14.1mm 8.8pt
26mm 7.1~13.6mm 13.6mm 10.2pt
28mm（选定） 6.1~13.1mm 13.1mm 11.6pt
30mm 6.1~13.6mm 13.6mm 10.2pt

（22~30mm 各档都做过双遍编译，确保 remember picture 定位正确。）

遗留提示（未处理，已知可接受）

PDF 体积 158 KB → 573 KB。内嵌的是 2400×605 原图，实际只用 28 mm ≈ 660 px，
约 3.6 倍冗余。保留原图是为了将来放大不糊；真要瘦身把 png 缩到 700 px 宽即可。

另外距顶 6 mm 偏小（已接近 A4 裁切余量 10~12 mm 的边界感），屏幕阅读和普通
办公打印无问题；若要专业印刷装订，把 \cvlogoy 改成 8 mm 以上。

## 已完成并推送 commit `8e3017f`，已推到 `main`。 ### 改动文件 | 文件 | 变化 | |---|---| | `简历/awesome-source-cv.cls` | +70 行，新增 `\cvlogo` / `\@makecvlogo` / `\cvlogox` / `\cvlogoy` | | `简历/简历.tex` | +8 行，写入 `\cvlogo{28mm}` 与说明注释 | | `简历/logos/ouc_横式_彩色.png` | 新增，380 KB（从 `科技报告/logos/` 复制） | | `简历/README.md` | +47 行，新增「### 5. 左上角校徽（可选）」 | | `简历/简历.pdf` | 重新生成，158 KB → 573 KB | ### 最终实测（本地 + 服务器双份 PDF 独立测量，结果一致） 用 `pymupdf` 的 `get_image_info()` 取 bbox，不靠肉眼： | 项 | 数值 | |---|---| | 校徽尺寸 | **28.00 × 7.06 mm**（横式 2400:605，比例吻合） | | 左上角坐标 | x = **10.07 mm**、y = **6.07 mm** | | 下沿位置 | 13.1 mm（仍在 15 mm 版心边距以内） | | 姓名墨迹 y | **48.83 pt**（与加 logo 前完全一致，未被推低） | | 页数 / error / Overfull / Underfull | 3 / 0 / 0 / 0 | | `×` 残留 | **0** | | 西文字体 | Cochineal Roman/Bold/Italic 全部嵌入，Termes 已消失 | ### 服务器验证 从 Gitea API 直接下载 `main` 分支的原始 PDF： - 提交：`main` HEAD = `8e3017f` - 大小：573565 字节 - `sha256 = 0acb298ab7c91d301814bc72e8cd2252ce84167c37d61d5fb126ffc20ea14c34` - 与本地文件**逐字节相同** - 远程文件内确实含校徽（bbox 与上表一致） ⚠️ 若网页预览仍显示旧版，是 **Gitea 网页 PDF 预览器的服务端缓存**， 浏览器 Ctrl+F5 作用不到它。判断方法：下载原始文件看，或给 URL 加随机参数 `?v=1` 绕过。文件本身已确认是新版。 ### 尺寸选型记录（8 组实测） | 宽度 | logo 纵范围 | 下沿 | 距姓名 | |---|---|---|---| | 18mm | 8.1~12.6mm | 12.6mm | 4.6mm | | 22mm | 8.1~13.6mm | 13.6mm | 10.2pt | | 24mm | 8.1~14.1mm | 14.1mm | 8.8pt | | 26mm | 7.1~13.6mm | 13.6mm | 10.2pt | | **28mm（选定）** | **6.1~13.1mm** | **13.1mm** | **11.6pt** | | 30mm | 6.1~13.6mm | 13.6mm | 10.2pt | （22~30mm 各档都做过双遍编译，确保 `remember picture` 定位正确。） ### 遗留提示（未处理，已知可接受） PDF 体积 158 KB → 573 KB。内嵌的是 2400×605 原图，实际只用 28 mm ≈ 660 px， 约 3.6 倍冗余。保留原图是为了将来放大不糊；真要瘦身把 png 缩到 700 px 宽即可。 另外距顶 6 mm 偏小（已接近 A4 裁切余量 10~12 mm 的边界感），屏幕阅读和普通 办公打印无问题；若要专业印刷装订，把 `\cvlogoy` 改成 8 mm 以上。
laoyang commented 2026-10-27 06:26:14 +00:00
Author
Owner
Copy Link
Copy Source

需求已完成并推送（commit 8e3017f），服务器端 PDF 已从 API 下载逐字节验证一致，
关闭本工单。

若有后续调整（例如加大到 30mm、改成圆形校徽、上移到 8mm），请在本单继续评论。

需求已完成并推送（commit `8e3017f`），服务器端 PDF 已从 API 下载逐字节验证一致， 关闭本工单。 若有后续调整（例如加大到 30mm、改成圆形校徽、上移到 8mm），请在本单继续评论。
Sign in to join this conversation.
No Branch/Tag Specified
Branches Tags
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
laoyang (老杨)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: laoyang/ouc_latex_template#13