Skip to content

Commit

Permalink
docs: 增补字体部分手册内容
Browse files Browse the repository at this point in the history
  • Loading branch information
atxy-blip committed Dec 20, 2023
1 parent 1cff259 commit 6ced18a
Show file tree
Hide file tree
Showing 2 changed files with 45 additions and 23 deletions.
4 changes: 4 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,9 @@

## [未发布]

- 增加 `macoffice` 字体配置 - [#164],[#169]
- 感谢 [@liudongmiao]

## [1.3.2] - 2023-12-05

### 变动
Expand Down Expand Up @@ -591,6 +594,7 @@
[#148]: https://github.com/nju-lug/NJUThesis/issues/148
[#150]: https://github.com/nju-lug/NJUThesis/discussions/150
[#155]: https://github.com/nju-lug/NJUThesis/discussions/155
[#164]: https://github.com/nju-lug/NJUThesis/issues/164
[#165]: https://github.com/nju-lug/NJUThesis/discussions/165
[#166]: https://github.com/nju-lug/NJUThesis/discussions/166
[#169]: https://github.com/nju-lug/NJUThesis/issues/169
Expand Down
64 changes: 41 additions & 23 deletions source/njuthesis.dtx
Original file line number Diff line number Diff line change
Expand Up @@ -894,14 +894,23 @@ To produce the documentation run the original source files ending with
%
% 学校论文格式要求使用的字体一般已经预装在各个操作系统,
% 本模板针对不同平台进行了自动检测适配,可以开箱即用。
% 如果希望更改本模板使用的字体,请填写以下两个选项以覆盖默认设置。
% 如果希望更改本模板使用的字体,请填写以下选项以覆盖默认设置。
%
% \begin{function}[added=2023-12-15]{fontset}
% \begin{syntax}
% \OPT{fontset} = <win|macoffice|mac|fandol|none>
% \end{syntax}
% 手动指定字体库。
% \end{function}
%
% \opt{fontset} 这个选项名继承自 \pkg{ctex},相当于在本模板中分别填写以下两项。
%
% \begin{function}[added=2021-09-07,updated=2021-12-18]{cjk-font,latin-font}
% \begin{syntax}
% \OPT{cjk-font} = <win|mac|fandol|founder|noto|source|none>
% \OPT{latin-font} = <win|mac|gyre|none>
% \end{syntax}
% 手动指定字体
% 更精细的字体库设定
% \end{function}
%
% 根据学校论文格式的要求,本模板使用的中文字体主要有{\songti 宋体}、
Expand All @@ -923,16 +932,17 @@ To produce the documentation run the original source files ending with
% 字体文件目录。
% \end{function}
%
% 模板用到的部分字体(例如华文中宋)可能尚未安装在操作系统,
% 可以使用此选项手动指定搜索路径。
%
% ^^A 本模板默认使用操作系统安装的字体。可以使用本选项从任意目录载入字体
% 模板用到的部分字体可能尚未安装在操作系统,可以使用此选项手动指定搜索路径。
% 例如,研究生模板封面上使用到了华文中宋,该字体默认只存在于
% \opt{win} 和 \opt{macoffice} 对应的系统配置,
% 在其他平台编译需使用此选项手动指向 \file{STZHONGS.TTF}
%
% \paragraph{中文}
%
% 本模板提供的中文字体配置如表 \ref{tab:cjk-fontset} 所示。
% 在不指定字体配置的情况下,本模板默认使用与操作系统相对应的字体配置
% (见表中前三行,Windows 和 macOS 以外的系统采用
% (见表中前四行,在装有 MS Office 的 macOS 上优先使用 Office 字体库。
% Windows 和 macOS 以外的系统采用
% \href{https://www.ctan.org/pkg/fandol}{Fandol} 配置)。
% 此外,我们也单独提供了\href{https://www.foundertype.com}
% {方正}和\href{https://github.com/adobe-fonts}{思源}两套中文字体配置。
Expand All @@ -955,13 +965,15 @@ To produce the documentation run the original source files ending with
% 表示思源字体,请下载 Simplified Chinese(即后缀名为 SC)的版本},
% note{e} = {思源字体并不包含楷书和仿宋,而 Adobe
% 楷体和仿宋难以直接下载,因此使用方正字体代替} ]
% { cell{2}{2,4} = {white!70!njuyellow},
% cell{4}{4} = {white!70!njuyellow},
% { cell{2}{2-5} = {white!70!njuyellow},
% cell{3}{2-5} = {white!70!njuyellow},
% cell{5-8}{4} = {white!70!njuyellow},
% colspec = {ccccc} }
% \toprule
% 配置名称 & 宋体 & 黑体 & 楷书 & 仿宋 \\
% \midrule
% \opt{win} & 中易宋体 & 中易黑体 & 中易楷体 & 中易仿宋 \\
% \opt{macoffice} & 中易宋体 & 中易黑体 & 中易楷体 & 中易仿宋 \\
% \opt{mac} & 华文宋体 & 华文黑体 & 华文楷体 & 华文仿宋 \\
% \opt{fandol} & Fandol 宋体 & Fandol 黑体 & Fandol 楷体 & Fandol 仿宋 \\
% \opt{founder}\TA & \FZ{51}{书宋}\TB & \FZ{61}{细黑一}\TC & \FZ{37}{楷体} & \FZ{28}{仿宋} \\
Expand Down Expand Up @@ -993,16 +1005,17 @@ To produce the documentation run the original source files ending with
% note{a} = {TG 表示 \href{http://www.gust.org.pl/projects/e-foundry/tex-gyre}{\TeX~Gyre}。} ]
% { colspec = {cccc} }
% \toprule
% 配置名称 & 衬线体 & 无衬线体 & 等宽字体 \\
% 配置名称 & 衬线体 & 无衬线体 & 等宽字体 \\
% \midrule
% \opt{win} & Times~New~Roman & Arial & Courier~New \\
% \opt{mac} & Times~New~Roman & Arial & Menlo \\
% \opt{gyre} & \TG{Termes} & \TG{Heros} & \TG{Cursor} \\
% \opt{win} & Times~New~Roman & Arial & Courier~New \\
% \opt{macoffice} & Times~New~Roman & Arial & Menlo \\
% \opt{mac} & Times~New~Roman & Arial & Menlo \\
% \opt{gyre} & \TG{Termes} & \TG{Heros} & \TG{Cursor} \\
% \bottomrule
% \end{talltblr}
% \end{table}
%
% macOS 用户需要额外注意的是,此系统内置的 Times New Roman 并没有 smcp
% macOS 用户需要额外注意的是,系统内置的 Times New Roman 并没有 smcp
% 这一特性,所以 \tn{textsc} 命令无法产生正确的小型大写字母字型,导致
% 研究生模板英文封面的部分内容不能正确显示。另外,macOS 中的 Times 字体
% 也不包含 smcp 特性。
Expand Down Expand Up @@ -4862,6 +4875,7 @@ To produce the documentation run the original source files ending with
\setCJKfamilyfont { zhhei } { SimHei } [#1]
\setCJKfamilyfont { zhfs } { FangSong } [#1]
\setCJKfamilyfont { zhkai } { KaiTi } [#1]
\@@_stzhongs:n {#1}
}
\cs_new:Npn \@@_loadfont_cjk_win:
{ \@@_loadfont_cjk_win:N \c_@@_name_fakebold_tl }
Expand Down Expand Up @@ -4897,13 +4911,14 @@ To produce the documentation run the original source files ending with
% \begin{macrocode}
\cs_new:Npn \@@_loadfont_cjk_macoffice:n #1
{
\setCJKmainfont { Simsun.ttc } [ ItalicFont = Kaiti.ttf, #1 ]
\setCJKmainfont { Simsun.ttc } [ ItalicFont = Kaiti.ttf, #1 ]
\setCJKsansfont { SimHei.ttf } [#1]
\setCJKmonofont { Fangsong.ttf } [#1]
\setCJKfamilyfont { zhsong } { Simsun.ttc } [#1]
\setCJKfamilyfont { zhhei } { SimHei.ttf } [#1]
\setCJKfamilyfont { zhfs } { Fangsong.ttf } [#1]
\setCJKfamilyfont { zhkai } { Kaiti.ttf } [#1]
\@@_stzhongs:nn { STZHONGS.ttf } {#1}
}
\cs_new:Npn \@@_loadfont_cjk_macoffice:
{
Expand Down Expand Up @@ -5041,27 +5056,30 @@ To produce the documentation run the original source files ending with
% \end{macrocode}
% \end{variable}
%
% \begin{macro}{\@@_loadfont_stzhongs:,\@@_stzhongs:}
% \begin{macro}{\@@_loadfont_stzhongs:,\@@_stzhongs:nn,\@@_stzhongs:n,\@@_stzhongs:}
% \changes{v1.2}{2023/04/30}{在研究生模板载入华文中宋。}
% \changes{v1.3}{2023/10/09}{可以手动指定华文中宋文件位置。}
% 研究生封面额外需要的华文中宋。
% \begin{macrocode}
\cs_new:Npn \@@_loadfont_stzhongs:
\cs_new:Npn \@@_stzhongs:nn #1#2
{ \newCJKfontfamily \@@_stzhongs: {#1} [#2] }
\cs_new:Npn \@@_stzhongs:n { \@@_stzhongs:nn { 华文中宋 } }
\cs_new_protected:Npn \@@_loadfont_stzhongs:
{
\cs_if_exist_use:NF \@@_stzhongs:
{
\fontspec_font_if_exist:nTF { 华文中宋 }
{
\newCJKfontfamily \@@_stzhongs: { 华文中宋 }
[ \c_@@_name_fakebold_tl ]
}
{ \@@_stzhongs:n { \c_@@_name_fakebold_tl } }
{
\bool_if:NTF \g_@@_font_path_bool
{
\newCJKfontfamily \@@_stzhongs: { \c_@@_name_stzhongsfile_tl }
[ Path = \g_@@_font_path_tl, \c_@@_name_fakebold_tl ]
\@@_stzhongs:nn { \c_@@_name_stzhongsfile_tl }
{ Path = \g_@@_font_path_tl, \c_@@_name_fakebold_tl }
}
{
\cs_set_eq:NN \@@_stzhongs: \rmfamily
\msg_warning:nn { njuthesis } { missing-stzhongs }
}
}
}
}
Expand Down

0 comments on commit 6ced18a

Please sign in to comment.