Skip to content

Commit

Permalink
docs: add notes for trailing comma
Browse files Browse the repository at this point in the history
  • Loading branch information
github-young committed Dec 26, 2024
1 parent c34c7ce commit 3a9f5f7
Showing 1 changed file with 7 additions and 2 deletions.
9 changes: 7 additions & 2 deletions hkustthesis.dtx
Original file line number Diff line number Diff line change
Expand Up @@ -95,7 +95,7 @@ through XeTeX.
%
%<class>\NeedsTeXFormat{LaTeX2e}
%<class>\RequirePackage{expl3}
%<class>\GetIdInfo $Id: hkustthesis.dtx 0.9.2 2024-12-25 00:00:00 +0800 HKFoggyU$
%<class>\GetIdInfo $Id: hkustthesis.dtx 0.9.3 2024-12-26 00:00:00 +0800 HKFoggyU$
%<class> { Thesis template for HKUST }
%<class>\ProvidesExplClass{hkustthesis}
%<class>{\ExplFileDate}{\ExplFileVersion}{\ExplFileDescription}
Expand Down Expand Up @@ -153,7 +153,7 @@ through XeTeX.
%
% \author{\href{https://github.com/HKFoggyU}{\color{black}{\faGithub~@HKFoggyU}}}
%
% \date{v0.9.2 @ \dashedtoday\\
% \date{v0.9.3 @ \dashedtoday\\
% {\footnotesize 请确保阅读本文档的\href{https://github.com/HKFoggyU/hkust-thesis/releases}{最新版本}}\\
% {\footnotesize Please read the \href{https://github.com/HKFoggyU/hkust-thesis/releases}{latest version} of this documentation}
% }
Expand Down Expand Up @@ -189,6 +189,7 @@ through XeTeX.
% \changes{v0.9.0}{2024/10/12}{Change bibliography items to single-spacing, add and refactor documentation in main and dtx}
% \changes{v0.9.1}{2024/10/14}{Unset \pkg{hyperref} colors with switch added, let LoP to display full author list with switch for full name in main file}
% \changes{v0.9.2}{2024/12/25}{Enable LoP n-th authorship bold font}
% \changes{v0.9.3}{2024/12/26}{fix deprecated option for \pkg{biblatex}, add trailing comma for LoP}
%
% {
% \phantomsection
Expand Down Expand Up @@ -699,6 +700,10 @@ through XeTeX.
%
% This template displays the full author list in the ``List of Publications'' chapter, but displays partial authors in the ``References'' in the main text. In addition, a switch for displaying the full names of the authors is added in the main file.
%
% 观察到一个issue:发便文章列表此处使用的 \verb|\nocite| 命令,在最后一个文献条目后如果没有一个逗号 \verb|,|,编译器会产生一个警告并提示该条目未定义(Warning: Undefined citation: 'xxx'),但实际上编译产生的 PDF 文件是正常的。要消除该警告,可以在最后添加一个逗号。
%
% There is an issue: in case there is no trailing comman \verb|,| after the last citekey item inside the \verb|nocite| command used for the List of Publications here, the compiler will throw a warning (Warning: Undefined citation: 'xxx'), although the compiled PDF file is all correct. To fix this warning, you can add a trailing comma at the end.
%
% \myoptional{作者名加粗:} 通常情况下,发表文章列表会将本毕业论文的作者名字加粗显示。此处参考 StackExchange 的\href{https://tex.stackexchange.com/a/304968}{一个回答},实现此效果。
% 在 \file{mythesis.tex} 的导言区可以看到相关的重新定义代码,并且导入了一个 \file{mythesis_LoP.bib} 文件作为示例。需要在此 \file{mythesis_LoP.bib} 文件中,将自己的作者顺序 \verb|n| 写在 \verb|author+an = {n=highlight}| 中 \verb|n| 的位置。这一行需要被添加在每一个文献条目内,用来标记需要加粗的作者的顺序。作为一个更加具体的例子,在 \file{Appendix_Publications.tex} 文件中,我们同时插入了未添加标记的原本条目和添加了标记的条目,可以从编译后的 PDF 文件中直观地看出它们的差别。
%
Expand Down

0 comments on commit 3a9f5f7

Please sign in to comment.