From 5d59aa1853dcfd277d4f315cabc7eb7188c80e40 Mon Sep 17 00:00:00 2001 From: laoyang Date: Thu, 29 Oct 2026 15:47:33 +0800 Subject: [PATCH] =?UTF-8?q?=E7=A7=91=E6=8A=80=E6=8A=A5=E5=91=8A=E5=AD=97?= =?UTF-8?q?=E4=BD=93=E8=B0=83=E6=95=B4=EF=BC=9A=E8=A5=BF=E6=96=87=E6=94=B9?= =?UTF-8?q?=20Cochineal=E3=80=81=E6=A0=87=E9=A2=98=E7=BB=9F=E4=B8=80?= =?UTF-8?q?=E9=B8=BF=E8=92=99=E3=80=81=E4=BB=A3=E7=A0=81=E6=8D=A2=E7=AD=89?= =?UTF-8?q?=E5=AE=BD=20#19?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 用户反馈「标题一会儿黑体一会儿什么体的」。pymupdf 提取旧 PDF 定位到 三处字体分裂，逐条修掉。 一、西文从鸿蒙换成 Cochineal（cls/font.cls） 旧版 \setmainfont / \setsansfont / \setmonofont 三处全是鸿蒙。中文换成 思源宋体之后，正文就成了「中文衬线 + 西文无衬线」：同一行里英文数字比 汉字细、像陷进去，读起来割裂。 Cochineal 是 Minion 风格的衬线体（OFL 1.1，fonts/cochineal/ 已在库内）， 与思源宋体灰度接近；度量与 Termes 只差 1.9%，不推着断行变。 \setsansfont 保持鸿蒙 —— 标题靠 \hm 切到 OUCHM 族，西文 sans 位仍是鸿蒙， 标题的中西文因此都是鸿蒙，与正文区分得开。 二、\hm 重定义为中西文一起切（cls/font.cls，本次核心） 这是「字体一会儿一个样」的真正来源。fonts.tex 里的 \hm 是 \def\hm{\CJKfamily{OUCHM}} 纯 xeCJK 中文字族切换，管不到阿拉伯数字和拉丁字母。而标题、封面主标题、 摘要标题都用 \hm 表示「这是鸿蒙」，于是凡是标题里夹了西文就还是西文字体： · 章节编号 "1." "3.1" → 走 \setmainfont → 旧版是鸿蒙粗，改 Cochineal 后 变成衬线粗，与中文鸿蒙粗并排 · "这是一个很好用的 LaTex 模板" 里的 LaTex → 走 \setmainfont · 目录条目编号是数字、标题是中文 → 同一条目录两种字体 修法：本模板内把 \hm 重定义为 \hmlatin\CJKfamily{OUCHM}，中西文一起切。 一次在源头解决，不在每个调用点补 \hmlatin —— 后者必然漏（封面、摘要、 目录标题、页眉、文本框标题各漏一次，本次实测漏了 4 处）。 不改 ../fonts.tex 的 \hm：幻灯片和简历也在用，它们没有这个问题，全局改 会外溢。 三、目录条目与页码归零（cls/title.cls） \cftsecfont 等三条只管条目文字，页码走 \cft*pagefont，不显式清掉的话 目录里页码比标题还粗、最抢眼。两组共 6 条一起设 \normalfont。 不塞 \bfseries：加粗与否是各条目录自己的事，硬加会让二三级也变粗。 四、代码等宽位换 Latin Modern Mono（cls/font.cls） 旧版 \setmonofont 也是鸿蒙 —— 它不是等宽字体，代码里 i/l/1、m/w 宽度 不一，竖向对不齐、缩进看着是歪的。lmmono 是 TeX Live 自带，无需额外 字体文件。 ⚠️ 这里不能用 Extension + UprightFont=*-regular：lm 系列文件名本身是 "lmmono10-regular.otf" 已带 -regular，再拼会变成 lmmono10-regular-regular 然后报 cannot be found。给完整文件名、不给 Extension。粗体用 lmmonolt10-bold（同族等宽，换粗体不错位），没有 lmmonobq 这个变体。 五、内容块保留 3 个 Underfull（cls/boxes.cls，只加注释不改代码） 第 208/214/220 行的 \verb|Illuminate\Foundation\Http\Kernel| 是 35 字符 不可断串，在内容块 371pt 内宽里塞不下。试过无效的：\emergencystretch 2em/10em（不是额度不够，是这行没有足够可拉伸 glue）、\sloppy（badness 从 1231 升到 3590，更差）。有效但不采用：\seqsplit（归零但任意字符处 断行，代码路径被切两段）、窄体 lmmonoltcond（归零但压缩可读性）。 结论：保留这 3 个，badness 1231 属轻微（10000 才是严重），渲染只是行末 留白略多。日志里看到它们属预期，不是回归。 六、report.tex 字体说明同步 第 52/58 行原文说「英文字体默认使用鸿蒙」，改后已不准确，重写为 Cochineal + Latin Modern Mono 的实际状况，并说明标题编号统一的原因。 验证（两套环境各跑两遍，逐字同数） WSL / TeX Live 2025：rc=0，error 0，Overfull 0，Underfull 4，10 页 Windows / TeX Live 2022：rc=0，error 0，Overfull 0，Underfull 4，10 页 pymupdf 提取字体分布，两侧完全一致： Cochineal-Roman 782 OUCSerif-Regular 143 LMMono10-Regular 98 OUCKai-Regular 33 HarmonyOS_Sans_SC_Bold 22 HarmonyOS_Sans_Bold 14 OUCSerif-Bold 8 FontAwesome 5 HarmonyOS_Sans_SC 3 ZhuqueFangsong 2 OUCSans-Regular 2 CMSY10 1 CMEX10 1 HarmonyOS_Sans 1 标题逐页核对（中西文双档均属鸿蒙）： p1 封面 HarmonyOS_Sans_SC_Bold「这是一个很好用的」+ HarmonyOS_Sans_Bold「LaTex」 p2 目录 HarmonyOS_Sans_SC_Bold「目录」 p5 摘要 HarmonyOS_Sans_SC_Bold + HarmonyOS_Sans_Bold「LaTex」 p6 正文 HarmonyOS_Sans_Bold「1.」+ HarmonyOS_Sans_SC_Bold「准备工作」 p10 正文 HarmonyOS_Sans_Bold「8.」+ HarmonyOS_Sans_SC_Bold「图标」 OUCSans-Regular 2 / ZhuqueFangsong-Regular 2 / HarmonyOS_Sans 1 三处少量 命中已逐个查清，都不是回归： · p6「黑体」「仿宋」—— 正文故意演示 \fzzdx / \fzfs 的示例文字 · p8 每页同 bbox、45° 旋转、29.8pt —— 全页水印，设计如此 · p10「HTTP/Console」—— 文本框标题走 fonttitle=\hm，改后已是 HarmonyOS_Sans + HarmonyOS_Sans_SC，中西文都属鸿蒙 涉及文件： 科技报告/cls/font.cls 默认族、\hm 重定义、等宽位 科技报告/cls/title.cls 目录条目与页码归零 科技报告/cls/boxes.cls 仅补 Underfull 记录注释，代码未改 科技报告/report.tex 字体说明文字同步 --- 科技报告/cls/boxes.cls | 21 ++++++++++++ 科技报告/cls/font.cls | 73 +++++++++++++++++++++++++++++++++++++----- 科技报告/cls/title.cls | 48 +++++++++++++++++++++++++-- 科技报告/report.tex | 6 ++-- 4 files changed, 135 insertions(+), 13 deletions(-) diff --git a/科技报告/cls/boxes.cls b/科技报告/cls/boxes.cls index 15b09a5..7c6b352 100644 --- a/科技报告/cls/boxes.cls +++ b/科技报告/cls/boxes.cls @@ -6,6 +6,27 @@ % 颜色一律引用 cls/color.cls 里的语义名（oucinfo / oucalert ...）， % 不在这里写具体色名，更不写 RGB 值。 % +% 【关于内容块里的 3 个 Underfull \hbox（#19 记录）】 +% +% 第 208/214/220 行那三段示例文字里有 \verb|Illuminate\Foundation\Http\Kernel|， +% 这个 35 字符的串在 \verb 里**不能断行**，整行只能把它塞进去，于是那行 +% 被撑松 —— 报 Underfull (badness 1231)。 +% +% 试过且**无效**的方案（别重复踩）： +% · \emergencystretch 2em / 10em —— 无效。它不是"额度不够"的问题： +% 这一行没有足够的可拉伸 glue 可用，给多少额度都无从施展。 +% · \sloppy —— 反而更差，badness 从 1231 升到 3590（放宽了断行标准， +% TeX 选了别的更松的解）。 +% +% 有效但**不采用**的方案： +% · \seqsplit —— Underfull 归零，代价是在任意字符处断行， +% 一条代码路径被切成两段，可读性明显变差。 +% · 换窄体等宽 lmmonoltcond（Light Condensed）—— 也归零， +% 但压缩字体让代码变窄变小，为一个示例文本牺牲整体代码可读性不合理。 +% +% 结论：保留这 3 个 Underfull。badness 1231 属轻微（10000 才是严重）， +% 渲染出来只是行末留白略多，不影响阅读。日志里看到它们属预期，不是回归。 +% %% 带标题的文本框 % 这个框走的是"极简"路线：框线和标题栏都是白色，靠黑字 + 细边分界。 diff --git a/科技报告/cls/font.cls b/科技报告/cls/font.cls index 8bc1bd1..18abb5b 100644 --- a/科技报告/cls/font.cls +++ b/科技报告/cls/font.cls @@ -42,18 +42,38 @@ %====================================================================== % 二、默认字体族 % -% 西文：鸿蒙 HarmonyOS Sans（与原模板一致，观感不变） % 中文：OUC Serif 书宋（对应原方正书宋），粗体用 OUC Serif Bold % （对应原方正小标宋 —— 小标宋本身就是宋体的标题变体） +% 西文：Cochineal（Minion 风格，OFL 1.1） +% 无衬线：鸿蒙 HarmonyOS Sans（标题、目录标题、封面标题都靠 \hm 切） % % ⚠️ Path= 是相对**编译时工作目录**（= 科技报告/）的，不是相对 cls/。 % 故写作 ../fonts/...，不要写 ../../。 +% +% ⚠️⚠️ 西文为什么从 HarmonyOS 换成 Cochineal（2026-10 改，#19） +% +% 旧版这里 \setmainfont / \setsansfont / \setmonofont 三处全是鸿蒙。 +% 中文换成思源宋体之后，正文就成了「中文衬线 + 西文无衬线」， +% 同一行里英文数字明显比汉字细、比汉字"陷进去"，读起来割裂。 +% +% 更明显的副作用在目录：\setmainfont 是西文字体总开关，目录条目的 +% 编号（"1." 是数字）走它 → 鸿蒙粗体；而条目标题是中文 → 走 +% \setCJKmainfont → 思源宋体粗。**同一条目录里两种字体**， +% 这就是"标题一会儿黑体一会儿什么体"的实际来源。 +% +% 换成 Cochineal 后：中文宋体、西文衬线，灰度接近；目录编号与标题 +% 也归到同一字族。度量与 Termes 只差 1.9%，不推着断行变。 +% +% ⚠️ \setsansfont 保持鸿蒙 —— 标题用 \hm（CJK 族名 OUCHM）切换， +% 西文 sans 位仍是鸿蒙，标题的中西文因此都是鸿蒙，与正文区分得开。 %====================================================================== -\setmainfont{HarmonyOS_Sans_Regular.ttf}[ - Path = ../fonts/harmonyos-sans/, - BoldFont = HarmonyOS_Sans_Bold.ttf, - ItalicFont = HarmonyOS_Sans_Regular_Italic.ttf, - BoldItalicFont = HarmonyOS_Sans_Bold_Italic.ttf, +\setmainfont{cochineal}[ + Extension = .otf, + Path = ../fonts/cochineal/, + UprightFont = *-Roman, + BoldFont = *-Bold, + ItalicFont = *-Italic, + BoldItalicFont = *-BoldItalic, ] \setsansfont{HarmonyOS_Sans_Regular.ttf}[ Path = ../fonts/harmonyos-sans/, @@ -61,8 +81,23 @@ ItalicFont = HarmonyOS_Sans_Regular_Italic.ttf, BoldItalicFont = HarmonyOS_Sans_Bold_Italic.ttf, ] -\setmonofont{HarmonyOS_Sans_Regular.ttf}[ - Path = ../fonts/harmonyos-sans/, + +% 等宽位：真等宽，供代码块（listings 的 \ttfamily）使用。 +% 旧版这里也是鸿蒙 —— 它不是等宽字体，代码里 i/l/1、m/w 宽度不一， +% 竖向对不齐，缩进看起来是歪的。 +% lmmono（Latin Modern Mono）是 TeX Live 自带，无需额外字体文件。 +% +% ⚠️ 这里**不能**用 Extension + UprightFont=*-regular 的组合。 +% lm 系列的文件名本身就是 "lmmono10-regular.otf"，已经带 -regular 后缀； +% 再配 Extension=.otf 加 *-regular，fontspec 会拼成 +% lmmono10-regular-regular.otf +% 然后报 The font "lmmono10-regular-regular" cannot be found。 +% 正确做法是给完整文件名、不给 Extension。 +% ⚠️ 没有 lmmonobq 这个变体；粗体用 lmmonolt10-bold（同属 lmmono 家族， +% 字宽与 regular 一致，换粗体不会让代码错位）。 +\setmonofont{lmmono10-regular.otf}[ + ItalicFont = lmmono10-italic.otf, + BoldFont = lmmonolt10-bold.otf, ] % \hm 已在 fonts.tex 里登记（CJK 族名 OUCHM），这里不重复定义。 @@ -81,6 +116,28 @@ \XeTeXlinebreaklocale "zh" \XeTeXlinebreakskip = 0pt plus 1pt +%====================================================================== +% 二之二、重定义 \hm：中文与西文一起切到鸿蒙（#19） +% +% 问题：fonts.tex 里的 \hm 是 \def\hm{\CJKfamily{OUCHM}} —— 这只是 +% xeCJK 的**中文字族**切换，管不到阿拉伯数字和拉丁字母。而本模板的 +% 标题、封面主标题、摘要标题都用 \hm 来做"这是鸿蒙"，于是凡是标题里 +% 夹了西文（"LaTex"、编号 "1." "3.1"）就还是渲染成西文字体， +% 表现为同一个标题里中文鸿蒙、西文衬线 —— 就是"字体一会一个样"。 +% +% 解法：在本模板内把 \hm 重定义为「中文字族 + 拉丁字族」一起切。 +% \hmlatin 由 fonts.tex 用 \newfontfamily 定义，是 Latin 字族命令， +% 与 \CJKfamily 作用域不同，可以并存。 +% +% ⚠️ 必须是 \renewcommand，不能 \newcommand —— 名字已被 fonts.tex 定义。 +% ⚠️ 只改本模板，不动 ../fonts.tex：幻灯片和简历也在用那个 \hm， +% 全局改会让它们跟着变，而它们没有这个"标题里混西文"的问题。 +% 这是本模板的局部修正，不该外溢。 +% ⚠️ 重定义要在所有 \hm 调用**之前**。本文件由 report.cls 在 +% \begin{document} 前 \input，位置没问题；不要把这段挪到后面。 +%====================================================================== +\renewcommand{\hm}{\hmlatin\CJKfamily{OUCHM}} + %====================================================================== % 三、5 个方正语义别名 % diff --git a/科技报告/cls/title.cls b/科技报告/cls/title.cls index 17d887f..e4de3a0 100644 --- a/科技报告/cls/title.cls +++ b/科技报告/cls/title.cls @@ -2,12 +2,26 @@ %% 标题、目录等设定 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%% +%---------------------------------------------------------------------- +% 各级标题字体（#19） +% +% 目标：编号和标题文字**都是鸿蒙**。 +% +% 踩的坑：原来只写 format=\hm\bfseries，以为 \hm 就够了。实际 \hm 在旧版 +% 是纯 xeCJK 中文字族切换，管不到阿拉伯数字 —— 编号 "1." "3.1" 被判成 +% 西文，仍走 \setmainfont，于是同一个标题里中文鸿蒙、编号衬线。 +% +% 修法：本次在 cls/font.cls 里把 \hm 重定义为「中西文一起切鸿蒙」， +% 所以这里维持 format=\hm\bfseries 即可，不需要再写 \hmlatin。 +% 换个说法：问题统一在 \hm 的定义处解决，而不是在每一处调用点逐个补 —— +% 后者必然漏（封面、摘要、目录标题、页眉都会各自漏一次）。 +%---------------------------------------------------------------------- \ctexset{ % 修改 section文字样式， section={ name={,.},%编号和文字中间用.。 number={\arabic{section}},%编号形式：\arabic设置为阿拉伯数字，\chinese设置为中文，\roman设置为小写罗马字母，\Roman设置为大写罗马字母，\alph设置为小写英文，\Alph设置为大写英文。 - format=\hm\bfseries\raggedright\zihao{4},%鸿蒙字体，小四号字，右对齐。 + format=\hm\bfseries\raggedright\zihao{4},%鸿蒙字体（中西文都用鸿蒙），小四号字，右对齐。 aftername=\hspace{5pt},%编号和标题的距离 % beforeskip=1ex,%标题与前文的距离 % afterskip=1ex,%标题与后文的距离 @@ -31,4 +45,34 @@ %给目录加上点 \renewcommand{\cftpartleader}{\cftdotfill{\cftdotsep}} % 给 parts 加点 %\renewcommand{\cftchapleader}{\cftdotfill{\cftdotsep}} % 给 chapters 加点 -\renewcommand{\cftsecleader}{\cftdotfill{\cftdotsep}} % 给 sections加点 \ No newline at end of file +\renewcommand{\cftsecleader}{\cftdotfill{\cftdotsep}} % 给 sections加点 + +%---------------------------------------------------------------------- +% 目录条目的字族统一（#19） +% +% 问题：一条目录里能出现两种字体。编号 "1." 是阿拉伯数字 → 被 xeCJK +% 判成西文 → 走 \setmainfont；条目标题是中文 → 走 \setCJKmainfont。 +% 旧版 \setmainfont 是鸿蒙、\setCJKmainfont 是思源宋体，于是同一条里 +% 「编号鸿蒙粗 + 标题宋体粗」，看着就是标题字体一会儿一个样。 +% +% 把西文改回衬线（Cochineal）之后这个分裂本身已经消失，但这里仍然显式 +% 声明一次，理由有二： +% ① 不依赖 \setmainfont 的间接效果 —— 将来若有人改了 font.cls 的 +% 西文设置，目录不会跟着又裂开； +% ② tocloft 的 \cftsecfont 是"只管目录条目"的开关，改它比调全局安全。 +% +% ⚠️ 只设 \cftsecfont / \cftsubsecfont / \cftsubsubsecfont，不动 +% \cftsecpagefont —— 页码那列保持默认，不用跟着正文加粗。 +% ⚠️ \cftsecfont 里不要塞 \bfseries：加粗与否是各条目录自己的事 +% （正文章节标题本就 \bfseries），在这里硬加会让二级三级也变粗。 +%---------------------------------------------------------------------- +\renewcommand{\cftsecfont}{\normalfont} +\renewcommand{\cftsubsecfont}{\normalfont} +\renewcommand{\cftsubsubsecfont}{\normalfont} + +% 页码列单独归零。上面三条只管条目文字，页码走的是 \cft*pagefont， +% 默认继承条目的粗体设置 —— 不显式清掉的话，目录里页码会比标题还粗， +% 一眼看过去页码最抢眼。 +\renewcommand{\cftsecpagefont}{\normalfont} +\renewcommand{\cftsubsecpagefont}{\normalfont} +\renewcommand{\cftsubsubsecpagefont}{\normalfont} \ No newline at end of file diff --git a/科技报告/report.tex b/科技报告/report.tex index 32d94d0..cfba88b 100644 --- a/科技报告/report.tex +++ b/科技报告/report.tex @@ -47,15 +47,15 @@ \section{字体} -在模板中，默认使用的字体是鸿蒙字体，除此之外，还定义了一些其他的中文字体。 +在模板中，中文默认使用思源宋体，西文默认使用 Cochineal，标题统一使用鸿蒙字体。除此之外，还定义了一些其他的中文字体。 -英文字体，默认使用的是鸿蒙字体(HarmonyOS Sans)，现在你看到的应该就是这个字体的效果。这些设置，可以在cls中，字体设定里面进行修改。 +英文字体，正文默认使用的是 Cochineal（一款 Minion 风格的衬线体），代码等宽位使用的是 Latin Modern Mono。所以你现在看到的西文和阿拉伯数字都是衬线字体。这样安排是为了和中文的思源宋体保持相近的灰度——如果西文用无衬线，同一行里字母数字会明显比汉字细、像"陷进去"，读起来割裂。这些设置，可以在 cls 中字体设定里面进行修改。 中文字体，使用的是鸿蒙字体、思源宋体、霞鹜文楷、朱雀仿宋、思源黑体等。全部为开源可商用字体，不使用任何方正、微软雅黑等商业字体。 中文的默认字体衬线字体是思源宋体，加粗字体是思源宋体的真粗体，就像这样：\textbf{这里是加粗字体}。斜体的字体是霞鹜文楷，就像这样:\textit{这里是中文斜体}。斜体粗体的字体是朱雀仿宋，就像这样：\textbf{\textit{这里是粗体斜体}}。中文的无衬线字体sans font使用的是鸿蒙字体，你应该可以在标题中看到它。中文等宽字体，使用的是思源黑体。 -默认的无衬线字体是鸿蒙字体，你应该可以在各种标题中看到它的样子。 +默认的无衬线字体是鸿蒙字体，你应该可以在各种标题中看到它的样子。注意标题里的中文和西文（包括编号 "1."、"3.1"）现在统一都是鸿蒙——旧版因为编号是阿拉伯数字、被归到西文字体，会出现同一个标题里中文鸿蒙、编号衬线的情况，看着像"字体一会一个样"，现已修正。 同样，上述的字体，在cls中，都可以进行设置。