用户反馈「标题一会儿黑体一会儿什么体的」。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 字体说明文字同步
229 lines
8.4 KiB
TeX
229 lines
8.4 KiB
TeX
%!TEX program = xelatex
|
|
|
|
\documentclass{report}
|
|
\usepackage{graphicx}
|
|
\usepackage[dvipsnames]{xcolor}
|
|
\usepackage{wrapfig}
|
|
\usepackage{enumerate}
|
|
\usepackage{amsmath,mathrsfs,amsfonts}
|
|
\usepackage{booktabs}
|
|
\usepackage{tabularx}
|
|
\usepackage{colortbl}
|
|
\usepackage{multirow,makecell}
|
|
\usepackage{multicol}
|
|
\usepackage{ulem} % \uline
|
|
\usepackage{listings}
|
|
\usepackage{tikz}
|
|
\usepackage{tcolorbox}
|
|
\usepackage{fontawesome}
|
|
\usepackage[justification=centering]{caption}
|
|
\usepackage{draftwatermark}% 所有页加水印
|
|
\usepackage{titletoc}
|
|
\usepackage{ctex}
|
|
\usepackage[subfigure]{tocloft}
|
|
\usepackage{subfigure}
|
|
|
|
\input{input/info.tex}
|
|
\input{input/setting.tex}
|
|
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
%% 正文开始
|
|
%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
|
|
\begin{document}
|
|
|
|
\sloppy % 解决中英文混排文字超出边界问题
|
|
|
|
\input{input/cover.tex}
|
|
\input{input/toc.tex}
|
|
\input{input/abstract.tex}
|
|
|
|
\newpage%开始新的一页,正文开始
|
|
\setcounter{page}{1}%页码编号,从1开始
|
|
|
|
\section{准备工作}
|
|
在正式开始使用模板之前,需要你安装LiveTex,并安装任何可用的编辑器。
|
|
|
|
不需要再做其他配置。字体统一放在仓库根目录的 \texttt{fonts/} 文件夹中(全库共用同一套),编译时会自动调用,无须额外安装,也不依赖你电脑上装了什么字体。
|
|
|
|
\section{字体}
|
|
|
|
在模板中,中文默认使用思源宋体,西文默认使用 Cochineal,标题统一使用鸿蒙字体。除此之外,还定义了一些其他的中文字体。
|
|
|
|
英文字体,正文默认使用的是 Cochineal(一款 Minion 风格的衬线体),代码等宽位使用的是 Latin Modern Mono。所以你现在看到的西文和阿拉伯数字都是衬线字体。这样安排是为了和中文的思源宋体保持相近的灰度——如果西文用无衬线,同一行里字母数字会明显比汉字细、像"陷进去",读起来割裂。这些设置,可以在 cls 中字体设定里面进行修改。
|
|
|
|
中文字体,使用的是鸿蒙字体、思源宋体、霞鹜文楷、朱雀仿宋、思源黑体等。全部为开源可商用字体,不使用任何方正、微软雅黑等商业字体。
|
|
|
|
中文的默认字体衬线字体是思源宋体,加粗字体是思源宋体的真粗体,就像这样:\textbf{这里是加粗字体}。斜体的字体是霞鹜文楷,就像这样:\textit{这里是中文斜体}。斜体粗体的字体是朱雀仿宋,就像这样:\textbf{\textit{这里是粗体斜体}}。中文的无衬线字体sans font使用的是鸿蒙字体,你应该可以在标题中看到它。中文等宽字体,使用的是思源黑体。
|
|
|
|
默认的无衬线字体是鸿蒙字体,你应该可以在各种标题中看到它的样子。注意标题里的中文和西文(包括编号 "1."、"3.1")现在统一都是鸿蒙——旧版因为编号是阿拉伯数字、被归到西文字体,会出现同一个标题里中文鸿蒙、编号衬线的情况,看着像"字体一会一个样",现已修正。
|
|
|
|
同样,上述的字体,在cls中,都可以进行设置。
|
|
|
|
另外,可以使用额外的命令,来临时改变某一段文字的字体设置。这些命令沿用了旧版的名字(fz开头,取自原先的方正系列),但实际用的都是随仓库分发的开源字体:fzss(宋体)、fzxbs(宋体粗,标题用)、fzkai(楷体)、fzfs(仿宋)、fzzdx(黑体)、hm(鸿蒙字体)。使用方法是使用斜线命令的方式,这样:{\fzss 宋体}、 {\fzxbs 宋体粗}、{\fzkai 楷体}、{\fzfs 仿宋}、{\fzzdx 黑体}、{\hm 鸿蒙字体}。注意这里的楷体是霞鹜文楷、仿宋是朱雀仿宋、黑体是思源黑体,都是可免费商用的开源字体。
|
|
|
|
\section{标题}
|
|
|
|
文档模板支持三级标题,并且自动编号。上面就是一级标题的样子。
|
|
\subsection{这里是二级标题}
|
|
|
|
\subsubsection{这里是三级标题}
|
|
|
|
\section{列表}
|
|
列表分为有序列表和无序列表。
|
|
\subsection{无序列表}
|
|
无序列表使用itemize。
|
|
|
|
\begin{itemize}
|
|
\item \textbf{第一个有序列表}。可以在这里写列表的内容。
|
|
|
|
\item \textbf{第二条列表}。这里继续显示列表内容。
|
|
\end{itemize}
|
|
|
|
默认的前缀是实心的 黑色原点, 但是我们可以在 \textbackslash item[] 中进行自定义符号, 一般来说, 想要的符号都能够进行显示。
|
|
|
|
\begin{itemize}
|
|
\item[-] 条目1
|
|
\item[+] 条目2
|
|
\item[x] 条目3
|
|
\item[/] 条目4
|
|
\item[*] 条目5
|
|
\item[a] 条目6
|
|
\item[$\circ$] 条目7
|
|
\item[$\bigotimes$] 条目8
|
|
\item .....
|
|
\end{itemize}
|
|
|
|
|
|
\subsection{有序列表}
|
|
有序列表使用enumerate。
|
|
|
|
\begin{enumerate}
|
|
\item 方括号中写的是列表的样式。可以是()、[]等。如果要改变编号样式,可使用begin\{enumerate\}[(1)]等。
|
|
\item 如果使用了特殊的样式导致没有了缩进,可以使用begin\{enumerate\}[itemindent=2em]设置缩进。
|
|
\end{enumerate}
|
|
|
|
\section{图表信息}
|
|
|
|
可以插入表格,如表\ref{table1}所示\footnote{更复杂的表格,可以使用在线工具生成 https://www.tablesgenerator.com/}。
|
|
|
|
\noindent
|
|
\begin{table}[h!]
|
|
\caption{一个表格的实例}\label{table1}
|
|
\begin{tabularx}{\textwidth}{>{\hsize=.6\hsize\raggedright\arraybackslash}X>{\raggedright\arraybackslash}X}\toprule
|
|
\bfseries{食物} & \bfseries{菜谱}\\ \midrule
|
|
热狗 & 面包、香肠 \\
|
|
包子 & 面粉、馅料 \\ \bottomrule
|
|
\end{tabularx}
|
|
\end{table}
|
|
|
|
可以插入图片,如图\ref{fig1}所示。
|
|
\begin{figure}[!h]
|
|
\centering
|
|
\includegraphics[width=12cm]{figs/1.jpg}
|
|
\caption{这是一个示例图片}
|
|
\label{fig1}
|
|
\end{figure}
|
|
|
|
在其他的地方,通过输入图片的label来引用图片,就像这样:如图\ref{fig1}所示。
|
|
|
|
\section{代码}
|
|
|
|
模板中支持插入代码片段。
|
|
|
|
就像下面这些例子一样:
|
|
|
|
\begin{lstlisting}[language=TypeScript,caption={src/app/app.module.ts}]
|
|
import { NgModule } from '@angular/core';
|
|
import { BrowserModule } from '@angular/platform-browser';
|
|
@NgModule({
|
|
imports: [ BrowserModule ],
|
|
providers: [ Logger ],
|
|
declarations: [ AppComponent ],
|
|
exports: [ AppComponent ],
|
|
bootstrap: [ AppComponent ]
|
|
})
|
|
export class AppModule { }
|
|
\end{lstlisting}
|
|
|
|
\begin{lstlisting}[language=Java,caption={src/app/app.module.ts}]
|
|
import org.sun.com;
|
|
|
|
public class helloworld{
|
|
public static void main()
|
|
{
|
|
System.out.println("hello world!");
|
|
}
|
|
}
|
|
\end{lstlisting}
|
|
|
|
\begin{lstlisting}[style=bashstyle]
|
|
cd my-app
|
|
ng serve --open
|
|
\end{lstlisting}
|
|
|
|
\begin{lstlisting}[style=bashoutputstyle]
|
|
blablabla
|
|
\end{lstlisting}
|
|
|
|
还可以展示linux shell命令:
|
|
|
|
\begin{invertedshellbox}
|
|
npm install -g @angular/cli
|
|
\end{invertedshellbox}
|
|
|
|
也可以使用shell box。
|
|
|
|
\begin{shellbox}
|
|
cd my-app
|
|
ng serve --open
|
|
\end{shellbox}
|
|
|
|
还可以展示shell执行结果:
|
|
|
|
\begin{lstlisting}[style=bashoutputstyle]
|
|
src
|
|
app
|
|
app.component.css
|
|
app.component.html
|
|
app.component.spec.ts
|
|
app.component.ts
|
|
app.module.ts
|
|
assets
|
|
.gitkeep
|
|
environments
|
|
environment.prod.ts
|
|
environment.ts
|
|
browserslist
|
|
favicon.ico
|
|
index.html
|
|
...
|
|
\end{lstlisting}
|
|
|
|
|
|
\section{文本框}
|
|
|
|
模板支持三中文本框,分别是titledbox、notebox和importantbox。
|
|
|
|
\begin{titledbox}{HTTP/Console 内核}
|
|
HTTP 内核继承自 \verb|Illuminate\Foundation\Http\Kernel| 类,该类定义了一个 \verb|bootstrappers| 数组,这个数组中的类在请求被执行前运行,这些 \verb|bootstrappers| 配置了错误处理、日志、检测应用环境以及其它在请求被处理前需要执行的任务。
|
|
\end{titledbox}
|
|
|
|
|
|
|
|
\begin{notebox}
|
|
HTTP 内核继承自 \verb|Illuminate\Foundation\Http\Kernel| 类,该类定义了一个 \verb|bootstrappers| 数组,这个数组中的类在请求被执行前运行,这些 \verb|bootstrappers| 配置了错误处理、日志、检测应用环境以及其它在请求被处理前需要执行的任务。
|
|
\end{notebox}
|
|
|
|
|
|
|
|
\begin{importantbox}
|
|
HTTP 内核继承自 \verb|Illuminate\Foundation\Http\Kernel| 类,该类定义了一个 \verb|bootstrappers| 数组,这个数组中的类在请求被执行前运行,这些 \verb|bootstrappers| 配置了错误处理、日志、检测应用环境以及其它在请求被处理前需要执行的任务。
|
|
\end{importantbox}
|
|
|
|
\section{图标}
|
|
|
|
模板还支持使用图标,图标主要来自于fontawesome。其使用说明,可以参考文件夹中的fontawesome.pdf。
|
|
|
|
\faHeart
|
|
|
|
\end{document} |