summaryrefslogtreecommitdiff
path: root/macros/latex/contrib/qyxf-book/qyxf-book-doc.tex
blob: d063f7558c929e8d8337dc724b294e6b109e9f58 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
% !TEX program = xelatex
\documentclass[
  10pt,
  twoside,
  openany,
  b5paper, % 以上均为 ctexbook 提供的文类选项
  colorscheme = basic, % 请根据需要选择或定制配色方案
]{qyxf-book}

\title{钱院学辅 \LaTeX 书籍模板}
\subtitle{\LaTeX{} book class of Qian Yuan Xue Fu}  % 可选
\author{钱小辅}
\date{2019 年 2 月 29 日}
%\typo{AlphaGo}  % 排版人员信息,选填

% 定制元信息
\org{\Large\textit{西安交通大学}\\\textsc{Xi'an Jiaotong University}}
\footorg{\textsc{Qian Yuan Xue Fu}}
\cover{\includegraphics[width=.6\textwidth]{qyxf-logo.pdf}}
\license{}  % 清空许可证信息

% 调整封面标题大小
\renewcommand{\titlefont}{\Huge\bfseries}
\renewcommand{\subtitlefont}{\LARGE\itshape}

\begin{document}

\maketitle

\tableofcontents

\chapter{模板功能介绍}

\section{模板概况}

本模板名为 \verb|qyxf-book|,意即「\emph{钱院学辅之书}」,是西安交通大学钱学森书院学业辅导中心(简称「\emph{钱院学辅}」)自编资料时所采用的 \LaTeX 书籍模板。

利用 \verb|qyxf-book| 模板,我们已经生成了如下一些作品,它们都发布于钱院学辅信息站
\footnote{网址:\url{https://qyxf.site},其中最新资料发布于 \url{https://qyxf.site/latest/} 页面上。}
上,点击以下各条链接即可在浏览器中预览、下载。因各份作品采用了不同版本的 \verb|qyxf-book| 复本,且有一些个性化的定制,故观感将略有差异。

\begin{tcolorbox}
  \begin{description}
    \item [GRE备考指南] \url{https://qyxf.site/latest/GRE备考指南-v2.0.pdf}
    \item [军事理论教程] \url{https://qyxf.site/latest/军事理论教程.pdf}
    \item [分析力学笔记] \url{https://qyxf.site/latest/分析力学笔记-v1.0.pdf}
    \item [大学物理题解] \url{https://qyxf.site/latest/大物题解(上).pdf}
    \item [实变函数习题解答] \url{https://qyxf.site/latest/实变函数习题解答.pdf}
    \item [计算方法撷英] \url{https://qyxf.site/latest/计算方法撷英-v1.1.pdf}
    \item [计算机程序设计指南] \url{https://qyxf.site/latest/计算机设计程序指南.pdf}
  \end{description}
\end{tcolorbox}

根据钱院学辅所编资料的题材与传播形式,本套模板的设计宗旨确定为:
\begin{enumerate}
  \item 实现钱院学辅自编资料所需功能,同时留出供其他用户定制的接口;
  \item 保持页面样式的干净、整洁,不引入与作品内容的呈现无关的元素;
  \item 保证文档的打印效果,以及在手机、平板等小屏设备上的阅读效果。
\end{enumerate}

\section{版本演进}

至目前为止,\verb|qyxf-book| 已经发展了三代版本。当前模板的版本为 \textbf{v\styversion}。

\subsection{V1 版本}
最早的版本。在该版本中确定了模板当前的格局(封面、信息页等)。结构、样式上效仿于 \href{https://elegantlatex.org/}{Elegant\LaTeX} 系列模板,借用了其章节标题样式、配色选项,并定义了一套字体(中文采用 Adobe 系列字体,西文采用 Cambria + Calibri,数学字体采用 Cambria Math)。

因技术水平,存在诸多兼容性问题,使用多有不便。仅有 \textbf{v1.0} 一个正式版本。

\subsection{V2 版本}

完全摆脱 Elegant\LaTeX{} 的框架,从头独立编写。与笔记模板 \verb|qyxf-note|、告示模板 \verb|qyxf-notice|(均已不再开发)共三个模板合并为 \verb|qyxf-sets| 宏集
\footnote{代码仓库地址:\url{https://github.com/qyxf/qyxf-sets/}(已经存档,无法编辑)。}
,采用 doc/docstrip 套件一同开发;后因这种方式的维护难度较大,\verb|qyxf-sets| 宏集停止开发,\verb|qyxf-book| 又分离出来独立开发。

在 V1 的基础上趋于成熟,优化了字体、封面与章节标题样式,并初步定义了一些用户常用的环境(如数学定理)。利用 \verb|pgfornament| 重新设计了章节标题、页脚的样式,取消了配色(仅用灰度色系)。

目前钱院学辅出品的大多数资料采用这一代模板编写。

\begin{itemize}
  \item \textbf{v2.0}:独立开发的首个版本,确定了整个模板的框架。
  \item \textbf{v2.0a}:修正了说明文档的问题。
  \item \textbf{v2.1}:定义了可选项 \verb|sourcefont| 以启用思源字体为中文字体,将默认字体交还 C\TeX 宏集处理。
  \item \textbf{v2.2}(\verb|qyxf-sets|):实现了取消装饰的选项 \verb|nodecoration|;修正了字体设置卡顿的问题。
  \item \textbf{v2.2}(\verb|qyxf-book|):分离出来之后采用同一版本号再发布一次,增加了 demo 文件。
  \item \textbf{v2.3}:由 \href{https://github.com/SciZeal}{SciZeal} 补充了 demo 中的段落示例、\hologo{BibTeX} 示例等内容。
\end{itemize}

\subsection{V3 版本}

当前版本。在 V2 版本之上进一步改进了之前的问题,并向通用、可定制的方向前进一大步。

在字体方面,移除了中文字体备选项,完全采用 C\TeX 宏集的默认设置;西文及数学内容采用 \TeX 发行版附带的 XITS 字体,使模板进一步减少了对外部字体的依赖\footnote{字体的定制交由用户完成,本模板不参与其中。}。

在样式方面,综合若干书籍及网页模板重设了各类元素的尺寸、间距,并完全移除了原由 \verb|pgfornament| 与 \verb|pgfornament-han| 宏包所实现的装饰\footnote{一方面,是因为 \TeX Live 2020 中这两个宏包未被容纳进来;另一方面,目前也发现装饰的存在不利于样式的修改、定制,且对阅读效果并无明显改善。}。

此外,还新增了用户定制配色方案、元信息的功能,这将为钱院学辅之外的其他用户使用本模板提供方便。

\subsection{我该用哪一个版本?}

若需要编译由钱院学辅 2020 年 8 月前发布的资料之 \LaTeX 源码,请直接用源码中附带的 \verb|qyxf-book.cls| 文件编译,或下载 V2 系列最新版本 v2.3\footnote{链接:\url{https://gitee.com/qyxf/qyxf-book/releases/2.3}}。否则,请采用最新版本的模板文件。

\begin{alert}
  请采用 \hologo{XeLaTeX} 编译使用本模板,其他场合下不保证本模板的功能正常;模板未来的开发之中也不会考虑对其他 \LaTeX 引擎的支持
  \footnote{未来新开发出来的 \LaTeX 引擎可能会被考虑。}。
\end{alert}

\section{常用功能指南}

\subsection{命令与环境}

本模板提供了以下几个引导命令,主要用于题解、教辅的编写。这些命令都自带 \verb|\noindent| 控制序列,请放在段首使用。

\begin{itemize}
  \item \verb|\exercise{<id>}|:生成一个「练习」标记,接受一个参数 \verb|<id>| 作为编号
        \footnote{模板中没有为这个命令设置自动编号,主要是因为编写题解的过程中常出现选题、
        跳题的情况,且自动编号下不易从源代码中找到对应题目。}
        (可留空),如 \verb|\exercise{1}| 将生成:\exercise{1}。
  \item \verb|\solve|:生成一个「解」的标记:\solve。(其可以接受一个可选参数来替换「解」字
  \footnote{你可以通过这个特性定义自己需要的标记命令,下面的分析标记同理。})
  ,如 \verb|\solve[答]| 将生成:\solve[答]。
  \item \verb|\analysis|:生成一个「分析」的标记:\analysis。(其可以接受一个参数来替换「分析」二字,如 \verb|\analysis[注记]| 将生成:\analysis[注记]。)
\end{itemize}

除此之外,还提供了常见的用户环境,包括:
\begin{itemize}
  \item 定理类环境:定理 \verb|theorem|、引理 \verb|lemma|
  \item 定义类环境:定义 \verb|definition|
  \item 其他环境:注记 \verb|note|、警告 \verb|alert|
\end{itemize}
其中,定理、定义类环境属于数学类环境,采用 \LaTeX 原生机制定义,仅在外围包裹一层装饰用的盒子;因此,可按照通常的写法编写数学类环境,如:
\begin{tcolorbox}
  \begin{verbatim}
\begin{theorem}[L'H\^opital 法则]
\begin{equation}
\lim_{x\to x_0} \frac{f(x)}{F(x)} =
\lim_{x\to x_0} \frac{f'(x)}{F'(x)}.
\end{equation}
\end{theorem}
\end{verbatim}
\end{tcolorbox}
将生成:
\begin{theorem}[L'H\^opital 法则]
\begin{equation}
\lim_{x\to x_0} \frac{f(x)}{F(x)} =
\lim_{x\to x_0} \frac{f'(x)}{F'(x)}.
\end{equation}
\end{theorem}

\subsection{配色方案定制}

\subsubsection{预定义配色方案}

目前,模板中已预定义的配色方案包括:
\begin{itemize}
  \item \verb|basic|:默认的灰度配色方案,与 \verb|qyxf-book| V2 版本中的配色接近。
  \item \verb|black|:只有黑白两色的配色方案。可以很容易的调整为\emph{自定义双色方案}。
  \item \verb|rbb|:红色 + 蓝色 + 黑色(Red Blue Black)的配色方案。可以很容易的调整为\emph{自定义三色方案}。
  \item \verb|bootstrap-v4|:借鉴 BootStrap V4 中的配色方案。
\end{itemize}
欲使用以上的方案,请在文档类中通过键值对的形式引用,如
\begin{tcolorbox}
\verb|colorsheme = rbb| 
\end{tcolorbox}
将启用 \verb|rbb| 配色方案。

\subsubsection{双色\&三色方案快速生成}
为方便用户快速修改预定义配色方案,模板为双色方案 \verb|black| 和三色方案 \verb|rbb| 设计了两个文类选项:
\begin{itemize}
  \item \verb|primary|:主色,相当于 \verb|black| 中的黑色及 \verb|rbb| 中的蓝色;
  \item \verb|seconadry|:辅助色,只对 \verb|rbb| 方案生效,相当于 \verb|rbb| 中的红色。
\end{itemize}
若您想快速定义一个自己的双色或三色配色方案,可直接通过以上两个文类选项设置。例如,若您希望使用橙 + 黑的双色主题,可通过以下的文类选项实现:
\begin{tcolorbox}
\begin{verbatim}
\documentclass[
  colorscheme = black,  % 载入双色主题,此时主色为黑色
  primary = orange  % 将主色改为橙色
]{qyxf-book}
\end{verbatim}
\end{tcolorbox}
而如果您希望使用橙 + 紫 + 黑的三色主题,则可通过以下的文类选项实现:
\begin{tcolorbox}
\begin{verbatim}
  \documentclass[
    colorscheme = rbb,  % 载入三色主题
    primary = orange,  % 将主色改为橙色
    secondary = violet  % 将辅助色改为紫色
  ]{qyxf-book}
\end{verbatim}
\end{tcolorbox}

\begin{alert}
请采用 \verb|xcolor| 宏包所提供的混色语法(如 \verb|red!50!blue|)设置对应的值,其他写法目前尚不支持。下同。
\end{alert}

\subsubsection{自定义配色方案}

若您需要编写自己的配色方案,请通过 \verb|\renewcommand| 命令修改表 \ref{tab:color-scheme} 所示的各项接口,在预定义主题的基础上修改相应颜色值。
\begin{table}[htbp]
\centering\small
\caption{配色方案接口表}\label{tab:color-scheme}
\begin{tabular}{llcc}
\toprule
条目 & 接口宏 & \parbox{5em}{\centering \texttt{basic}\\方案默认值} & 备注 \\
\midrule
标题文字 & \verb|\TitleColor| & \verb|black| & \\
列表标记 & \verb|\ListColor| & \verb|black| & \\
图表标题文字 & \verb|\CaptionColor| & \verb|black| & \\
链接文字 & \verb|\LinkColor| & \verb|black| & \\
杂项文字 & \verb|\MiscColor| & \verb|black| & \parbox{7em}{页码、引用标记、引导标记等} \\
\midrule
盒子背景 & \verb|\BoxBackground| & \verb|white| & \parbox{7em}{\texttt{tcolorbox} 环境默认定义,下同} \\
盒子边框 & \verb|\BoxFrame| & \verb|black!75| & \\
盒子标题文字 & \verb|\BoxTitleColor| & \verb|white| & \\
盒子标题背景 & \verb|\BoxTitleBackground| & \verb|black!50| & \\
盒子文字 & \verb|\BoxColor| & \verb|black| & \\
警告盒子背景 & \verb|\AlertBackground| & \verb|white| & \parbox{7em}{对 \texttt{alert} 环境定义,下同} \\
警告盒子文字 & \verb|\AlertColor| & \verb|black| & \\
警告盒子边框 & \verb|\AlertFrame| & \verb|black| & \\
警告盒子标题背景 & \verb|\AlertTitleBackground| & \verb|black| & \\
警告盒子标题文字 & \verb|\AlertTitleColor| & \verb|white| & \\
\midrule
定义环境背景 & \verb|\DefineBackground| & \verb|white| & \parbox{7em}{对 \texttt{define} 环境定义,下同} \\
定义环境边框 & \verb|\DefineFrame| & \verb|black!40| & \\
定义环境文字 & \verb|\DefineColor| & \verb|black| & \\
定理环境背景 & \verb|\TheoremBackground| & \verb|black!10| & \parbox{7em}{对各定理类环境定义,下同} \\
定理环境边框 & \verb|\TheoremFrame| & \verb|black!80| & \\
定理环境文字 & \verb|\TheoremColor| & \verb|black| & \\
\bottomrule
\end{tabular}
\end{table}

需要注意的是,在重定义链接及盒子环境的配色时,可能因设置命令提前展开接口而无法生效;在此情况下,请使用 \verb|\selectcolor| 命令强制更新这些颜色的值。例如,要变更链接颜色 \verb|\LinkColor| 及盒子文字颜色 \verb|\BoxColor| 为 \verb|red!50|,请通过以下命令实现:

\begin{tcolorbox}
\begin{verbatim}
\renewcommand{\LinkColor}{red!50}
\renewcommand{\BoxColor}{red!50}
\selectcolor  % 更新颜色
\end{verbatim}
\end{tcolorbox}

\subsection{元信息定制}

本模板中要求填写几项元信息,如表 \ref{tab:metadata} 所示。请在使用时填写完整,以避免出现预料之外的情况。

\begin{table}[htbp]
  \centering\small
  \caption{\texttt{qyxf-book} 中需求的元信息}
  \label{tab:metadata}
  \begin{tabular}{llcl}
    \toprule
    元信息       & 设置命令                & 可否置空  & 默认值                     \\
    \midrule
    标题         & \verb|\title| & \ding{55} & 无                         \\
    副标题       & \verb|\subtitle| & \ding{51} & 无                         \\
    作者         & \verb|\author| & \ding{55} & 无                         \\
    创作日期     & \verb|\date| & \ding{55} & \verb|\today|    \\
    排版者       & \verb|\typo| & \ding{51} & 无                         \\
    \midrule
    首页组织信息 & \verb|\org| & \ding{51} & \footnotesize\begin{tabular}[c]{@{}l@{}}
      \verb|\textit{钱学森书院学业辅导中心}\\[1ex]| \\\verb|\textsc{Xi'an Jiaotong University}|\end{tabular} \\
    \midrule
    页脚组织信息 & \verb|\footorg| & \ding{51} & \verb|\textsc{Qian Yuan Xue Fu}|    \\
    \midrule
    许可证说明   & \verb|\license| & \ding{51} & \footnotesize\begin{tabular}[c]{@{}l@{}}
      \verb|本作品采用\href{https://| \\
      \verb|creativecommons.org/licenses/| \\
      \verb|by-nc-nd/4.0/}{\bfseriesCC BY-| \\
      \verb|NC-ND 4.0 协议}进行许可。使用| \\
      \verb|者可以在给出作者署名及资料来源| \\
      \verb|的前提下对本作品进行转载,但不| \\
      \verb|得对本作品进行修改,亦不得基于| \\
      \verb|本作品进行二次创作,不得将本作| \\
      \verb|品运用于商业用途。|
    \end{tabular} \\
    \bottomrule
  \end{tabular}
\end{table}

\subsection{封面定制}

本模板提供了简易的封面定制接口,通过 \verb|\cover| 命令来填写封面上需要的内容。例如,需要将本模板中自带的 \verb|qyxf-logo.pdf| 文件插入到封面中心,通过以下命令即可:

\begin{tcolorbox}
\begin{verbatim}
\cover{\includegraphics[width=0.5\textwidth]%
{figure/qyxf-logo.pdf}}
\end{verbatim}
\end{tcolorbox}
若您希望使插入元素靠向上侧,则可这样实现:
\begin{tcolorbox}
\begin{verbatim}
\cover{\includegraphics[width=0.5\textwidth]%
{figure/qyxf-logo.pdf}\vfill}
\end{verbatim}
\end{tcolorbox}
后侧的 \verb|\vfill| 会将插入元素向上挤压。在另一方向上同理。除了插入图片之外,您也可以使用 \verb|\cover| 命令在首页上插入全局性命令,或使用 Ti$k$Z 环境按页面定位插入图片。

此外,封面标题的字体大小、样式也可重新定义,字体接口及默认值如表 \ref{tab:preface-font} 所示。如有需要(如标题名称较长导致换行),请使用 \verb|\renewcommand| 命令修改。

\begin{table}[htbp]
  \centering
  \caption{\texttt{qyxf-book} 提供的封面字体修改接口}
  \label{tab:preface-font}
  \begin{tabular}{ccc}
    \toprule
    接口                    & 对应元信息              & 默认值                  \\
    \midrule
    \verb|\titlefont| & \verb|\title| & \verb|\Huge\bfseries| \\
    \verb|\subtitlefont| & \verb|\subtitle| & \verb|\huge\itshape| \\
    \verb|\authorfont| & \verb|\author| & \verb|\LARGE\itshape| \\
    \verb|\datefont| & \verb|\date| & \verb|\Large| \\
    \bottomrule
  \end{tabular}
\end{table}

\section{正文字体设置}

\subsection{字体设置方案的考虑}

不像其他功能完备的模板,\verb|qyxf-book| 没有提供除默认配置之外的其他「字体包」,仅给出了关闭默认字体配置的选项,其余工作完全交由用户决定
\footnote{对于大多数用户而言,需要做的决定就是「什么也不用做,采用默认配置即可」。}
、执行。对这一点,有两方面考虑:
\begin{enumerate}
  \item 钱院学辅的成员大多使用 Windows 系统,在其上为 \TeX 环境配置字体比较困难。大多数同学无法载入外部字体,使得之前版本中提供的字体配置选项相当「鸡肋」,几乎无人使用。
  \item 对于少部分有能力自行配置字体的用户而言,预先定义的字体方案则往往不合其意,不如完全置空、由用户自行完成。
\end{enumerate}
因此,在当前版本的 \verb|qyxf-book| 模板中,完全移除了预定义的字体选项。如您认为有必要、也有能力自行配置字体,请阅读以下内容;否则,请遵循默认的字体配置。

\subsection{西文字体设置}

西文字体方面,目前采用与 Times 系列字体相近的 XITS 系列字体
\footnote{无衬线体采用接近于 Helvetica 的 \TeX{} Gyre Heros。}
。如您想变更西文字体,请完成以下两个步骤:

\begin{enumerate}
  \item 为 \verb|qyxf-book| 文类传入 \verb|xits = false| 的选项,此时西文字体将还原至 Computer Modern 字体;
  \item 采用 \verb|fontspec| 宏包提供的 \verb|\setmainfont| 等命令设置字体。
\end{enumerate}

例如,下面的代码会将西文字体调整为 \TeX 发行版自带的 Libertinus 系列
\footnote{其中并未设置数学字体,这种情况下模板将采用默认的数学字体。若需要调整数学字体,可采用 \texttt{unicode-math} 宏包配置。}
:

\begin{tcolorbox}
\begin{verbatim}
\documentclass[xits = false]{qyxf-book}
% fontspec 宏包已载入,无需再声明
\setmainfont{Libertinus Serif}
\setsansfont{Libertinus Sans}
\setmonofont{Libertinus Mono}
\end{verbatim}
\end{tcolorbox}

\subsection{中文字体设置}

中文字体方面,目前交由 C\TeX 宏集按系统自动选择默认字体。若您希望变更中文字体,同样需要两个步骤:
\begin{enumerate}
  \item 为 \verb|qyxf-book| 文类传入 \verb|noCJKfont| 选项,此时 C\TeX 宏集将把模板的中文字体设置清空;
  \item 仅完成以上一步,文档是不能编译的,还需采用 C\TeX 宏集的接口来选择其他中文字体,或采用 \verb|xeCJK| 宏包提供的命令自行设置。
\end{enumerate}

C\TeX 宏集提供了几种预定义的字体设置,除系统字体之外还包括:
\begin{itemize}
  \item Fandol 字体 \verb|fandol|:包括宋、楷、黑、仿宋四套字体,在 \TeX 发行版中自带,无需安装;
  \item 方正字体 \verb|founder|:包括方正书宋、方正黑体、方正楷体、方正仿宋等若干套字体,需自行安装,配置稍复杂;
  \item Adobe 字体:包括宋、楷、黑、仿宋四套字体,需自行安装。
\end{itemize}
在正确配置相关字体的情况下,可直接采用 C\TeX 宏集提供的 \verb|\ctexset| 命令配置,如下面的命令将使得模板采用 Fandol 字体:
\begin{tcolorbox}
\begin{verbatim}
\documentclass[noCJKfont]{qyxf-book}
\ctexset{fontset = fandol}
\end{verbatim}
\end{tcolorbox}
从方便使用的角度来说,Fandol 字体无需额外配置,显示效果也好于 Windows 系统的默认字体配置,但有缺字现象;对于需要印刷的作品,方正系列字体效果较好,字体完备
\footnote{前提是:应安装对应于较完备的 GBK 字符集的字体文件。}
,更适宜。

除了直接调用 C\TeX 的配置外,也可采用由 \verb|xeCJK| 宏包
\footnote{该宏包已经包含在模板中,其命令可以直接使用,无需在您的文档中载入。}
提供的若干命令自行配置字体。例如,下列命令将使得模板采用思源系列中文字体
\footnote{同样的,请确保相关字体已正确配置。}:
\begin{tcolorbox}
\begin{verbatim}
\documentclass[noCJKfont]{qyxf-book}
\setCJKmainfont[AutoFakeSlant]{Source Han Serif SC} % 伪斜体
\setCJKsansfont[AutoFakeSlant]{Source Han Sans SC}
\setCJKmonofont[AutoFakeSlant]{Source Han Sans SC}
\end{verbatim}
\end{tcolorbox}
以上命令未配置与中文字体对应的字族(如 \verb|zhsong| 之类),在一般场合没有问题。若有需要,请参考 C\TeX 文档及 \verb|xeCJK| 宏包文档进行设置。

\section{问题及改进}

\subsection{已知问题}

本模板目前还存在许多可改进之处,主要包括:
\begin{enumerate}
  \item 模板对 \verb|part| 级别的标题、目录样式未作任何定制;
  \item 在参考文献方面,模板仅对 \LaTeX 自带的简易文献环境 \verb|thebibliorgraphy| 做了定制,未考虑 \hologo{BibTeX}
        \footnote{在 v2.3 版本中曾在 demo 中引入了 \hologo{BibTeX} 的示例;后考虑到此方面并无需求,为了简化 demo 结构,在 V3 版本中又移除了。}
        及 \verb|biblatex| 的样式支持;
  \item 模板尚未引入对代码抄录宏包(如 \verb|listings|)的支持;
  \item 配色方案还不完善,对部分元素的支持不佳。
\end{enumerate}
未做改动的原因很多,最大的原因是在钱院学辅排版的过程中对这些功能暂时没有需求
\footnote{例如,在参考文献方面,许多资料甚至连 \texttt{thebibliorgraphy} 环境也不需要,用脚注就能解决问题。}。

\subsection{帮帮我们!}

如果您:
\begin{itemize}
  \item 对上述功能有需求,并有能力帮助我们完善;
  \item 有其他好的建议、功能推荐;
  \item 设计了新颖、实用的配色、字体方案;
\end{itemize}
请通过我们的代码仓库向我们提交建议与改动请求:\url{https://gitee.com/qyxf/qyxf-book},我们将酌情采纳、接收。

同时,我们也欢迎您透过 fork 的形式修改出适合您自己的模板,分发给更多人使用。本模板按 MIT 许可证发行,据此您享有充分的自由。这也是对于我们模板的一种推广
\footnote{模板滞销,帮帮我们!}
与帮助!

本模板目前由\textbf{黑山雁}维护,您也可以通过邮箱联系维护者:\url{yjr134@163.com}。

\subsection{可解决的问题}

在 \TeX\ Live 2019 中测试本模板时,发现 \textsc{Small Caps} 字族(\verb|\scfamily|)不能正常加载,回退到了普通字族;经过检查,发现默认采用的 XITS 字体在 \TeX\ Live 2019 中提供的版本(1.200)还未引入该字族,到 \TeX\ Live 2020 时对应的版本(1.300)方才完善了此部分。若您对于该字族有需求,请更新您的 \TeX 发行版。

\chapter{内容示例}
\section{用户环境示例}

\begin{define}
  极限就是超越自我。
\end{define}

\begin{theorem}
  任何极限都可以直接观察得出。
\end{theorem}

\begin{lemma}
  以上内容,纯属扯淡。
\end{lemma}

\begin{note}
  好好学习,天天向上。
\end{note}

\begin{alert}
  今天你学习了吗?
\end{alert}

\section{列表样式}
\begin{itemize}
  \item 这是第一层
  \item 这也是第一层
  \begin{itemize}
    \item 这是第二层
    \begin{itemize}
      \item 这是第三层
    \end{itemize}
  \end{itemize}
\end{itemize}

\begin{enumerate}
  \item 这是第一层
  \item 这也是第一层
  \begin{enumerate}
    \item 这是第二层
    \begin{enumerate}
      \item 这是第三层
    \end{enumerate}
  \end{enumerate}
\end{enumerate}

\section{正文示例}

\textbf{微分学}(\emph{differential calculus})是微积分的一部分,是通过\emph{导数}和\emph{微分}来研究曲线斜率、加速度、最大值和最小值的一门学科,也是探讨特定数量变化速率的学科。微分学是微积分的两个主要分支之一,另一个分支则是\textbf{积分学},探讨曲线下的面积。


\begin{table}[htbp]
  \centering
  \caption{常用导数}
  \begin{tabular}{cccc}
    \toprule
    \textbf{原函数} & \textbf{导函数}   & \textbf{原函数} & \textbf{导函数} \\
    \midrule
    $C$             & $0$               & $\ln x$         & $\frac{1}{x}$   \\
    $x^\mu$         & $\mu x^{\mu - 1}$ & $\sin x$        & $\cos x$        \\
    $e^x$           & $e^x$             & $\cos x$        & $-\sin x$       \\
    \bottomrule
  \end{tabular}
\end{table}

……几乎所有量化的学科中都有\textbf{微分}的应用。例如在物理学中,运动物体其\emph{位移}对时间的导数即为其\emph{速度},\emph{速度}对时间的导数就是\emph{加速度}、物体\emph{动量}对时间的导数即为物体所受的\emph{力},重新整理后可以得到牛顿第二运动定律 $F=ma$ 。化学反应的\emph{化学反应速率}也是导数。在运筹学中,会透过导数决定在运输或是设计上最有效率的做法。

\begin{figure}[htbp]
  \centering
  \includegraphics[width=.3\textwidth]{qyxf-cover.pdf}
  \caption{V2 版本的封面图片}
  \label{fig:qyxf-logo}
\end{figure}

导数常用来找函数的\emph{极值}。含有微分项的方程式称为\textbf{微分方程},是自然现象描述的基础。微分以及其广义概念出现在许多数学领域中,例如\emph{复分析}、\emph{泛函分析}、\emph{微分几何}、\emph{测度}及\emph{抽象代数}\footnote{以上内容摘自维基百科中文词条 --- 微分学:\url{https://zh.wikipedia.org/wiki/微分学}。}。

\section{引导命令示例}

\exercise{1} 试用配方法求解方程:
\begin{equation}\label{eq:quadratic}
  ax^2 + bx + c = 0
\end{equation}

\solve 首先,方程左右两侧同除以 $a$,得到
\[ x^2 + \frac bax + \frac ca = 0 \]
根据一次项来配方,按公式 $(x+A)^2=x^2+2Ax+A^2$ 配出常数项:
\[ x^2 + \frac bax + \left(\frac b{2a}\right)^2 + \frac ca - \left(\frac b{2a}\right)^2 = 0 \]
配方并移项得到
\[ \left(x + \frac b{2a}\right)^2 = \frac {b^2}{4a^2} - \frac ca \]
方程左右开方,得
\[ x + \frac b{2a} = \pm \sqrt{\frac {b^2}{4a^2} - \frac ca} \]
从而得到方程 \eqref{eq:quadratic} 之解为
\begin{equation}
  x = - \frac b{2a} \pm \sqrt{\frac {b^2}{4a^2} - \frac ca}
\end{equation}
该式即为一元二次方程的\textbf{通用求根公式}。


\analysis 在这一问题中,需要注意以下几点 \cite{texbook,latex}:
\begin{itemize}
  \item ……
  \item ……
  \item ……
\end{itemize}

\begin{thebibliography}{99}
  \bibitem{texbook} KNUTH~D~E. The \TeX book [M]. Addison-Wesley: Reading, 1986.
  \bibitem{latex} 刘海洋. \LaTeX 入门 [M]. 人民邮电出版社: 北京, 2013.
\end{thebibliography}

\end{document}