From 8057c647880f05a2624b3d04ab0eb38d5cbf8c18 Mon Sep 17 00:00:00 2001 From: Norbert Preining Date: Fri, 26 May 2023 03:02:08 +0000 Subject: CTAN sync 202305260302 --- .../biblatex-gb7714-2015/README.md | 4 +- .../biblatex-gb7714-2015-preamble.tex | 10 +- .../biblatex-gb7714-2015/biblatex-gb7714-2015.pdf | Bin 1711489 -> 1722838 bytes .../biblatex-gb7714-2015/biblatex-gb7714-2015.tex | 403 ++++++++++++++------- .../biblatex-gb7714-2015/chinese-jmw.bbx | 81 +++-- .../biblatex-gb7714-2015/chinese-jmw.cbx | 7 + .../biblatex-gb7714-2015/gb7714-2015.bbx | 33 +- .../biblatex-gb7714-2015/gb7714-2015.cbx | 64 +++- .../biblatex-gb7714-2015/gb7714-2015ay.bbx | 33 +- .../biblatex-gb7714-2015/gb7714-2015ay.cbx | 119 +++++- .../biblatex-gb7714-2015/gb7714-2015ms.bbx | 1 + .../biblatex-gb7714-2015/gb7714-2015mx.bbx | 1 + .../biblatex-gb7714-2015/makeall.py | 4 +- macros/latex/contrib/listlbls/Makefile | 44 +-- macros/latex/contrib/listlbls/listlbls.dtx | 86 +++-- macros/latex/contrib/listlbls/listlbls.pdf | Bin 74422 -> 102919 bytes .../latex/contrib/nicematrix/nicematrix-code.dtx | 48 +-- .../latex/contrib/nicematrix/nicematrix-code.pdf | Bin 909639 -> 909512 bytes .../latex/contrib/nicematrix/nicematrix-french.pdf | Bin 577804 -> 575208 bytes .../latex/contrib/nicematrix/nicematrix-french.tex | 5 +- macros/latex/contrib/nicematrix/nicematrix.pdf | Bin 571224 -> 592717 bytes macros/latex/contrib/nicematrix/nicematrix.tex | 4 +- macros/latex/contrib/oststud/hsrstud-classes.pdf | Bin 127717 -> 127670 bytes macros/latex/contrib/oststud/hsrstud.pdf | Bin 143177 -> 143159 bytes macros/latex/contrib/oststud/oststud.dtx | 119 +++++- macros/latex/contrib/oststud/oststud.pdf | Bin 145415 -> 159801 bytes 26 files changed, 758 insertions(+), 308 deletions(-) (limited to 'macros/latex/contrib') diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/README.md b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/README.md index 91f89dbfdf..73958edc29 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/README.md +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/README.md @@ -1,4 +1,4 @@ -Date of last change: 2023-04-24 to version v1.1m +Date of last change: 2023-05-24 to version v1.1n # biblatex-gb7714-2015: a biblatex style package @@ -1600,6 +1600,8 @@ please see the file 'biblatex-gb7714-2015.pdf' for further information! * 2022/11/07 v1.1k,ctan,github * 2023/03/31 v1.1l,ctan,github * 2023/04/24 v1.1m,ctan,github +* 2023/05/24 v1.1n,ctan,github + --------------------------------------------------------- ## Update history: diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex index cdfafd74dd..cae76042ca 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex @@ -33,7 +33,7 @@ %\colorlet{gbemphcolor}{violet} %定义版面,showframe, -\usepackage[paperwidth=210mm,paperheight=290mm,left=35mm,right=20mm,top=25mm, bottom=20mm,showcrop]{geometry}%,showframe +\usepackage[paperwidth=210mm,paperheight=290mm,left=40mm,right=15mm,top=25mm, bottom=20mm,showcrop]{geometry}%,showframe \renewcommand{\baselinestretch}{1.35} %页面布局的标尺 \usepackage[type=none]{fgruler} @@ -96,6 +96,8 @@ \usepackage[colorlinks=true,% pdfstartview=FitH,allcolors=gbemphcolor, bookmarksopenlevel=4,% +bookmarksnumbered=true, +bookmarksopen=true, bookmarksdepth=4,]{hyperref} %linkcolor=gbblue,anchorcolor=gbblue,citecolor=gbblue %linkcolor=black,linkcolor=green,blue,red,cyan, magenta, @@ -331,7 +333,7 @@ theorem style=plain,fonttitle=\bfseries\heiti,coltitle=gbforestgreen %--------------列表环境--------------------------------------------- \usepackage[inline]{enumitem} %重设list环境 -\setlist[enumerate]{label=\bfseries\textcolor{gbemphcolor}{(\arabic*)},topsep=2pt,partopsep=0pt,parsep=0pt,% +\setlist[enumerate]{label=\textbf{(\arabic*)},topsep=2pt,partopsep=0pt,parsep=0pt,% align=left,leftmargin=0em,itemsep=0.5em,labelwidth=0.1em,itemindent=2.6em,listparindent=2em}%label=$\triangleright$,itemindent=1em \setlist[itemize]{topsep=2pt,partopsep=0pt,parsep=0pt,% leftmargin=3em,itemindent=0em} @@ -394,13 +396,13 @@ itemsep=0pt,leftmargin=0em,itemindent=0em}%注意,font或format中的最后一 \setlength{\parsep}{0pt} \setlength{\leftmargin}{0pt}% \setlength{\itemindent}{0pt}% -\renewcommand*{\makelabel}[1]{\hss\llap{\footnotesize\color{orange}\bfseries##1}}}} +\renewcommand*{\makelabel}[1]{\hss\llap{\footnotesize\color{gblabelcolor}\bfseries##1}}}} {\endlist} \makeatletter \newcommand{\updateinfo}[2][\@empty]{% \par\small\addvspace{2ex plus 1ex}% -\noindent{\color{gbemphcolor}\rule{\linewidth}{2pt}} +\noindent{\color{gblabelcolor}\rule{\linewidth}{2pt}} \vskip -\parskip \ifx\@empty#1 \begin{marglist} \item #2\end{marglist} \else \begin{marglist} \item[#1] #2\end{marglist} \fi} diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.pdf b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.pdf index 462c1f0409..23f368025f 100644 Binary files a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.pdf and b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.pdf differ diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.tex b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.tex index f2aabef29f..962aaae18a 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.tex +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/biblatex-gb7714-2015.tex @@ -62,39 +62,39 @@ biblatex-gb7714-2015 宏包是为满足《GB/T 7714-2015~~信息与文献~~参 \pagestyle{fancy} \section{概述} -《GB/T 7714-2015~~信息与文献~~参考文献著录规则》是国内科技文档参考文献著录的一般标准,国内多数大学、出版社、期刊编辑部对于学位论文、出版物、期刊论文的参考文献要求通常都基于该标准。对于\LaTeX{}用户来说,参考文献生成是典型的自动化应用,通常有两种方法,一是基于bibtex的传统方法,二是基于biblatex的新方法。生成符合GB/T 7714 标准要求的参考文献,这两条路子都已经实践多年。 -基于biblatex的方法,早期有李志奇(icetea)的gbtstyle实现以及Casper Ti. Vector的caspervector样式,然而由于biblatex宏包升级、样式包维护和完善方面的问题,未能达到精确符合国标要求、且具备高可用性、兼容性和可维护性的理想状态。开发biblatex-gb7714-2015 样式包的初衷首先是基于当时这样的状态,其次也为解决很多实际应用中的问题,因此考虑如下原则: +《GB/T 7714-2015~~信息与文献~~参考文献著录规则》是国内科技文档参考文献著录的一般标准,国内多数大学、出版社、期刊编辑部对于学位论文、出版物、期刊论文的参考文献要求通常都基于该标准。对于\LaTeX{}用户来说,参考文献生成是典型的自动化应用,主要有两种方法,一是基于bibtex的传统方法,二是基于biblatex的新方法。生成符合GB/T 7714 标准要求的参考文献,这两条路都已经实践多年。 +基于biblatex的方法,早期有李志奇(icetea)的gbtstyle实现以及Casper Ti. Vector的caspervector样式,然而由于biblatex宏包升级、样式包维护和完善等方面的问题,未能达到精确符合国标要求、且具备高可用性、兼容性和可维护性的理想状态。开发biblatex-gb7714-2015 样式包的初衷首先是基于当时这样的状态,其次也为解决很多实际应用中的问题,因此考虑如下原则: \subsection{设计原则} \begin{enumerate} \item 兼容性 -由于biblatex的持续升级,一些接口和功能的变化,会使得样式无法使用或者输出结果产生异变。因此biblatex-gb7714-2015宏包设计之初,就一直秉承兼容性原则,力图兼容各版本的biblatex,希望与biblatex v2.8 (in texlive2014) 以上所有版本适配(注意 ctex 2.9.4 的用户需升级 biblatex)。 +由于biblatex的持续升级,一些接口和功能的变化,会使得样式无法使用或者输出结果产生异变。因此biblatex-gb7714-2015宏包设计之初,就一直秉承兼容性原则,力图兼容各版本的biblatex,希望与biblatex v2.8 (in texlive2014) 以上所有版本适配(注意:使用ctex 2.9.4 套件的用户需升级 biblatex或更换使用最新版 texlive)。 出于兼容一些旧的bib文件的考虑,增加对传统参考文献条目类型比如www/electronic/conference/mastersthsis/phdthsis/techreport/standard等的支持。根据国标要求,考虑增加newspaper(报纸析出的文献)、database(数据库)、dataset(数据集)、 software(软件)、map(舆图)、archive(档案)等类型。也为兼容适用于不同样式的bib数据源,增加对一些自定义域的支持,比如gbt7714宏包的bst样式中mark和medium域。此外,也试图去完善样式在不同文档类包括beamer类中的使用问题。 \item 易用性 -参考文献是\LaTeX{}自动化应用之一,尽可能让其自动完成,减少用户的人工干预,包括数据的准备、格式的调整等等。因此宏包试图减少用户对于bib文件的调整,只需要简单地输入文献本身的信息,或者从各类学术网站或利用zotero等工具下载参考文献数据即可,而不需要为了符合国标格式而去手动增添参考文献类型和载体标识等一些数据域,也不必为了文献语言分集、文献排序等去增加语言、排序关键字等数据域,这些所有工作都由宏包自动完成。 +参考文献是\LaTeX{}自动化应用之一,尽可能让其自动完成,减少用户的人工干预,包括数据的准备、格式的调整等等。因此宏包试图减少用户对于bib文件的调整,只需要简单地输入文献本身的信息,或者从各类学术网站或利用zotero等工具下载参考文献数据即可,而不需要为了符合国标格式而去手动增添参考文献类型和载体标识等一些数据域,也不必为了文献语言分集、文献排序等去增加语言、排序关键字等数据域,所有这些工作都由会宏包自动处理。 -为了符合国标要求以及中文参考文献标注习惯,提供丰富的标注(引用)命令,用户只需熟悉几个命令的特性即能够完成两种编制样式下多样的标注格式,包括:顺序编码制的 \verb|\cite|(上标可设置页码)、 \verb|\parencite|(非上标可设置页码)、 \verb|\pagescite|(上标加自动页码)、 \verb|\textcite|(提供作者为主语加非上标编号)、 \verb|\authornumcite|(提供作者为主语加上标编号)、 \verb|\footfullcite|(脚注方式);著者-年份制的\verb|\cite|(作者加年份用括号包围可设置页码)、 \verb|\pagescite|(作者加年份用括号包围自动页码)、 +为了符合国标要求以及中文参考文献标注习惯,提供丰富的标注(引用)命令,用户只需熟悉几个命令的特性即能够完成两种编制样式下多样的标注格式,包括:顺序编码制的 \verb|\cite|(上标可设置页码)、 \verb|\parencite|(非上标可设置页码)、 \verb|\pagescite|(上标加自动页码)、 \verb|\textcite|(提供作者为主语加非上标编号)、 \verb|\authornumcite|(提供作者为主语加上标编号)、 \verb|\footfullcite|(脚注注释);著者-年份制的\verb|\cite|(作者加年份用括号包围可设置页码)、 \verb|\pagescite|(作者加年份用括号包围自动页码)、 \verb|\yearcite|(提供年份用括号包围)、 \verb|\yearpagescite|(提供年份用括号包围自动页码)、 -\verb|\textcite|(提供主语作者加括号包围年份)、 \verb|\footfullcite|(脚注方式)。 +\verb|\textcite|(提供主语作者加括号包围年份)、 \verb|\footfullcite|(脚注注释)。 -习惯natbib的用户也可以直接使用 \verb|\citet| 和 \verb|\citep| 命令, -也提供一些习惯使用的命令,比如\verb|\citetns|、\verb|\citepns|、 -\verb|\upcite|、\verb|\inlinecite|等让用户可以无缝衔接从bibtex转到biblatex。 +也提供与natbib宏包常用命令同名的命令 \verb|\citet| 和 \verb|\citep|, +和一些惯常使用的命令,如\verb|\citetns|、\verb|\citepns|、 +\verb|\upcite|、\verb|\inlinecite|等,让用户可以无缝衔接从bibtex转到biblatex。 另外,增加并完善对多语言混合文献表、多语言对照文献表的支持。不同语言文献可按文献自身语言录入,宏包自动识别语言并通过autolang选项自动完成语言切换,针对多语言对照文献表提供了基于条目集和关联条目概念的两种实现方式。 \item 灵活性 -在考虑实现严格符合GB/T 7714-2015标准的格式外,也希望能够针对用户的特殊格式需求,提供方便灵活的定制方式,比如通过设置选项来达到格式的变化。为此,增加了多个方面的设置选项,使用户可以根据自己的需求灵活地调整。主要包括: +在考虑实现严格符合GB/T 7714-2015标准的格式外,也希望能够针对用户的特殊格式需求,提供方便的定制方式,比如通过设置选项来达到格式的变化。为此,增加了多个方面的设置选项,使用户可以根据自身需求灵活地调整。主要包括: 著录表排序选项: -sorting选项值(gb7714-2015支持以语言著者-出版年标题升序排列,gbnytd支持以语言著者-出版年标题降序排列,gbynta支持以语言年份作者标题升序排列,gbyntd支持以语言年份作者标题降序排列)、gblanorder 选项(可以设置不同的文种(语言)文献的排列顺序)、sortlocale 选项(可以设置本地语言的排序调整方案,比如zh\_\_pinyin支持汉字字符以拼音排序,zh\_\_stroke以笔画排序,auto/zh以unicode编码排序,zh\_\_gb2312han 以gb2312编码排序)。使用拼音排序时遇到多音字也可以利用key域解决。 +sorting选项值(gb7714-2015支持以语言著者-出版年标题升序排列,gbnytd支持以语言著者-出版年标题降序排列,gbynta支持以语言年份作者标题升序排列,gbyntd支持以语言年份作者标题降序排列)、gblanorder 选项(可以设置不同的文种(语言)文献的排列顺序)、sortlocale 选项(可以设置本地语言的排序调整方案,比如zh\_\_pinyin支持汉字字符以拼音排序,zh\_\_stroke以笔画排序,auto/zh以unicode编码排序,zh\_\_gb2312han 以gb2312编码排序)。使用拼音排序时遇到多音字也可以利用添加key域或使用修改后的locale文件pinyin.pm解决。 @@ -112,11 +112,11 @@ sorting选项值(gb7714-2015支持以语言著者-出版年标题升序排列, 标签格式控制(gbbiblabel选项,可设置标签数字不同的包围符号)、 条目格式控制(gbstyle选项,利用gb7714-2015ms样式可实现中英文献分设不同格式)、 编制样式设置命令(利用\verb|\setaystylesection|和gb7714-2015mx样式实现不同文献节不同的编制方式)、 -格式命令\verb|\bibauthorfont|可设置作者项字体、 -格式命令\verb|\bibtitlefont|可设置标题项字体、 -格式命令\verb|\bibpubfont|可设置出版项字体、 -格式尺寸\verb|\bibitemindent|和\verb|\bibhang|可设置文献表的缩进、 -文献标题控制(gbctexset选项,可设置标题内容由\verb|\bibname|或\verb|\refname|宏调整); +文献标题控制(gbctexset选项,可设置标题内容由\verb|\bibname|或\verb|\refname|宏调整)、 +命令\verb|\bibauthorfont|可设置作者项字体等格式、 +命令\verb|\bibtitlefont|可设置标题项字体等格式、 +命令\verb|\bibpubfont|可设置出版项字体等格式、 +尺寸\verb|\bibitemindent|和\verb|\bibhang|可设置文献表的缩进等格式; 编码设置选项: GBK编码兼容(gbcodegbk选项,可设置GBK编码文档编译)等等。 @@ -126,7 +126,8 @@ GBK编码兼容(gbcodegbk选项,可设置GBK编码文档编译)等等。 \item 可维护性 -宏包的长期使用价值体现在宏包的维护和更新上面,追求宏包具有高的可读性、可理解性、可维护性,可为宏包长期发挥作用提供帮助。由于biblatex已经是一个相当成熟完善的宏包,即便是在样式方面考虑也相当全面,这可能与西方出版界对于参考文献的多样且细致的要求有关。而国内只有一个通用标准就是GB/T 7714标准,且除了一些特殊需求要具体实现外,标准中大多数格式要求的实现完全可以借用biblatex提供的标准样式,因此既不需要重新造轮子,也可以使gb7714-2015样式与biblatex宏包的标准样式保持一致的结构、风格和习惯,这样可以大大增加代码可读性和可维护性。通过在biblatex原有样式基础上增加有限修改的方式,并且对代码加上详细注释,可以使得样式包维护者,只需通过学习biblatex,即可轻松理解gb7714-2015样式做的工作,比如做了哪些修改,为什么这么修改,实现了什么样的效果。 +宏包的长期使用价值体现在宏包的维护和更新上面,追求宏包具有高的可读性、可理解性、可维护性,可为宏包长期发挥作用提供帮助。由于biblatex已经是一个相当成熟完善的宏包,即便是在样式方面考虑也相当全面,这可能与西方出版界对于参考文献的多样且细致的要求有关。而国内只有一个通用标准就是GB/T 7714标准,且除了一些特殊需求要具体实现外,标准中大多数格式要求的实现完全可以借用biblatex提供的标准样式,因此既不需要重新造轮子,也可以使gb7714-2015样式与biblatex宏包的标准样式保持一致的结构、风格和习惯,这样可以大大增加代码可读性和可维护性。通过在biblatex原有样式基础上增加有限修改,并对代码加上详细注释,可使维护者只需通过学习biblatex,即可轻松理解gb7714-2015样式的代码。 +%做的工作,比如做了哪些修改,为什么这么修改,实现了什么样的效果。 另外,为方便用户,样式包提供了全面、详实的说明,包括 @@ -225,13 +226,19 @@ GB/T 7714标准的理解和解释(\ref{sec:gbt:std}节)、 \end{figure} - +\section{使用说明} \subsection{最小示例} -基于biblatex宏包的参考文献生成方法非常简单,例 \ref{code:doc:structrue} 是一个最小工作示例。示例代码中给出了详细注释,介绍了使用biblatex 的tex源文档基本结构,其中gb7714-2015 样式随biblatex宏包加载, -参考文献数据文件example.bib利用 \verb|\addbibresource|加载 (注意:bib文件需另外准备,详见\ref{sec:bib:bibtex}节),文献表利用 \verb|\printbibliography| 命令输出(可在正文任意位置)。 +基于biblatex宏包的参考文献生成方法非常简单,例 \ref{code:doc:structrue} 是一个最小工作示例。示例代码中给出了详细注释,介绍了使用biblatex 的tex源文档基本结构,其中: +\begin{itemize} +\item gb7714-2015 样式随biblatex宏包加载; +\item bib(参考文献数据)文件利用 \verb|\addbibresource|加载 (注意:bib文件需另外准备,详见\ref{sec:bib:bibtex}节); +\item 引用文献则在正文中利用\verb|\cite|等命令带上entrykey(文献唯一标识)参数, +比如\verb|\cite{entrykey}|, +\item 打印文献表利用 \verb|\printbibliography| 命令输出(可放在正文任意位置)。 +\end{itemize} \begin{example}{biblatex参考文献生成的最小工作示例}{code:doc:structrue} \begin{texlist} @@ -243,7 +250,7 @@ GB/T 7714标准的理解和解释(\ref{sec:gbt:std}节)、 \usepackage[colorlinks=true,pdfstartview=FitH,linkcolor=blue,anchorcolor=violet,citecolor=magenta]{hyperref} %参考文献工具,加载biblatex宏包,,其后端backend使用biber,%标注(引用)样式citestyle,著录样式bibstyle都采用gb7714-2015样式,两者相同时可以合并为一个选项style \usepackage[backend=biber,style=gb7714-2015]{biblatex} - %biblatex宏包的参考文献数据源加载方式 + %biblatex宏包的参考文献数据源即bib文件加载方式 \addbibresource[location=local]{example.bib} \begin{document}%正文区开始: %正文内容,引用参考文献 @@ -284,13 +291,13 @@ GB/T 7714标准的理解和解释(\ref{sec:gbt:std}节)、 上述最小工作示例的编译结果如图\ref{fig:eg:ref}所示。所有基于 biblatex 生成参考文献的文档无论大小万变不离其宗, 若需更全面了解biblatex及参考文献生成高级功能另可参考: \href{https://github.com/plk/biblatex}{biblatex宏包手册} -\footnote{地址:\url{https://github.com/plk/biblatex}}、 +%\footnote{地址:\url{https://github.com/plk/biblatex}}、 \href{https://github.com/hushidong/biblatex-zh-cn}{中文版} -\footnote{地址:\url{https://github.com/hushidong/biblatex-zh-cn}} +%\footnote{地址:\url{https://github.com/hushidong/biblatex-zh-cn}} 或者 \href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}{LaTeX 文档中文参考文献的biblatex解决方案} -\footnote{地址:% -\url{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}}。 +%\footnote{地址:% +%\url{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}}。 \subsection{编译方式} @@ -311,7 +318,7 @@ latexmk -xelatex jobname.tex \end{example} -\section{使用说明} + \subsection{样式及选项加载} @@ -374,8 +381,8 @@ perl gb7714texttobib.pl in=textfilename out=bibfilename \end{example} 其中, -v1.0m版本增加的gb7714-2015ms样式文件,主要是为了在一个文献表中针对不同语言使用不同的样式,比如中文文献使用GB/T 7714-2015规定的著录格式,而其它语言文献使用biblatex提供的标准样式。 -v1.0r版本增加了gb7714-2015mx样式,主要是为了在一个文档中针对不同参考文献分节使用不同的参考文献样式,比如某些节使用著者年份制,某些节使用顺序编码制。 +v1.0m版本增加的gb7714-2015ms样式文件,主要是为了在一个文献表中针对不同语言使用不同的样式,即中文文献使用GB/T 7714-2015规定的著录格式,而其它语言文献使用biblatex提供的标准样式。 +v1.0r版本增加了gb7714-2015mx样式,主要是为了在一个文档中针对不同参考文献分节使用不同的样式,比如某些节使用著者年份制,某些节使用顺序编码制。 %尽管这些方式不常用,但偶尔也有需求,所以都做了实现。 尽管国标1987和2005版本已经过时,但仍然有些地方还在使用,所以1.0z版本增加了gb7714-1987和gb7714-2005两个版本的样式,也分顺序编码和著者年份制: @@ -398,11 +405,11 @@ v1.0r版本增加了gb7714-2015mx样式,主要是为了在一个文档中针 \end{example} -另外,根据国内大学的学位论文的文献生成需求,增加了几个与国标有明显区别的样式,包括:西北农林(gb7714-NWAFU)、华中师范(gb7714-CCNU)、东南大学(gb7714-SEU)等。其他大学的文献样式与国标基本一致,比如上海交大、浙大、复旦等,直接使用即可。另外一些大学与国标略有差别,可以通过简单的设置满足要求,比如清华、科学院大学、中科大、国防科大等,通常在学位论文模板中实现,在egthesis文件夹内,针对一些大学的学位论文参考文献做了测试。 +另外,根据国内大学的学位论文的文献生成需求,增加了几个与国标有明显区别的样式,包括:西北农林(gb7714-NWAFU)、华中师范(gb7714-CCNU)、东南大学(gb7714-SEU)等。其他大学的文献样式与国标基本一致,比如上海交大、浙大、复旦等,直接使用即可。另外一些大学与国标略有差别,可以通过简单的设置满足要求,比如清华、科学院大学、中科大、国防科大等,通常在学位论文模板中实现。而在egthesis文件夹内则对一些大学的学位论文参考文献做了测试。 此外,根据期刊文献生成需求,为文科类期刊增加了如下样式: -v1.0r版本增加了chinese-erj样式用于生成经济研究期刊的文献; -v1.1l版本增加了chinese-css样式用于生成社会科学期刊的脚注注释; +v1.0r版本增加了chinese-erj样式用于生成经济研究期刊的文献; +v1.1l版本增加了chinese-css样式用于生成社会科学期刊的脚注注释文献; v1.1m版本增加了chinese-jmw样式用于生成管理世界期刊的文献。 而理工类期刊文献通常与国标差别不大,部分期刊与国标的最大的差异主要是在双语对照文献中,比如计算机学报等,可以通过简单的设置来满足要求,具体可以参考github上的问题。 @@ -434,8 +441,10 @@ v1.1m版本增加了chinese-jmw样式用于生成管理世界期刊的文献。 \subsubsection{新增选项}\label{sec:added:opt} -样式包新增了一些选项和命令,新增选项更常用一些,所以在本节集中介绍,而新增命令往往涉及更细节的修改,所以在后面介绍各类格式调整的内容中介绍。 -新增选项用于标签对齐方式、出版项缺省处理、责任者(作者)缺省处理等功能的控制,其使用方式与biblatex宏包选项完全相同: +样式包新增了一些选项。 +%由于选项更为常用,所以在本节集中介绍。 +%而新增命令往往涉及更细节的修改,所以在后面各类格式调整的内容中介绍。 +新增选项用于处理标签对齐、缺省出版项、缺省责任者(作者)处理等,其使用方式与biblatex宏包选项完全相同,主要包括: \begin{description} \pdfbookmark[4]{gbalign}{gbalign} @@ -443,10 +452,11 @@ v1.1m版本增加了chinese-jmw样式用于生成管理世界期刊的文献。 为控制文献表数字序号标签增加的选项,用于选择是否生成序号标签及其对齐方式。 \begin{itemize} - \item gbalign=right,数字序号标签,是list环境中的标签右对齐,是gb7714-2015样式的默认选项; - \item gbalign=left,数字序号标签,是list环境中的标签左对齐; - \item gbalign=center,数字序号标签,是list环境中的等宽标签,数字在[]内居中; - \item gbalign=gb7714-2015,数字序号标签,是项对齐方式,即段落环境中标签使用原始宽度,标签与条目内容等间距。 + \item gbalign=right,是list环境中的右对齐数字序号标签,是gb7714-2015样式的默认选项; + \item gbalign=left,是list环境中的左对齐数字序号标签; + \item gbalign=center,是list环境中的等宽数字序号标签,数字在[]内居中; + \item gbalign=centpos,是list环境中的局中数字序号标签,带括号标签[1]在标签盒子内居中; + \item gbalign=gb7714-2015,是项对齐方式数字序号标签,即段落环境中标签使用原始宽度,标签与条目内容等间距。 \item gbalign=gb7714-2015ay,无数字序号标签,是author-year风格的文献表,是gb7714-2015ay样式的默认选项。 \end{itemize} 该选项对\textbf{著者年份制、顺序编码制均有效},也就是说当使用著者年份制时,加上gbalign选项后同样可以实现文献表的顺序序号标签(比如: @@ -527,6 +537,9 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \begin{itemize} \item gbbiblabel=bracket,序号数字由方括号包围,比如[1]; \item gbbiblabel=parens,序号数字由圆括号包围,比如(1); + \item gbcitelabel=bracketqj,标注标签由全角方括号包围,比如【1】; + \item gbcitelabel=parensqj,标注标签由全角圆括号包围,比如(1); + \item gbcitelabel=quanjiao,标注标签由全角方括号包围,比如【1】; \item gbbiblabel=dot,序号数字数字后面加点,比如1.; \item gbbiblabel=plain,序号数字无装饰,比如1; \item gbbiblabel=box,序号数字由方框包围,比如\framebox{1}; @@ -561,8 +574,11 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \item gbcitelabel=plain,标注标签无装饰,比如1; \item gbcitelabel=box,标注标签由方框包围,比如\framebox{1}; \item gbcitelabel=circle,标注标签由圆圈包围,比如\textcircled{1}。 + \item gbcitelabel=bracketqj,标签由全角方括号包围,比如【作者, 2001】 + \item gbcitelabel=parensqj,标签由全角圆括号包围,比如(作者, 2001) + \item gbcitelabel=quanjiao,标签由全角圆括号包围且内部标点为全角标点,比如(作者,2001) \end{itemize} - 顺序编码制和作者年制存在一定的差异,作者年制主要是方括号、圆括号、无括号的选择。 + 注意顺序编码制和作者年制存在一定的差异,作者年制主要是方括号、圆括号以及全角半角的选择。 顺序编码制默认是方括号,作者年制默认是圆括号。 @@ -940,8 +956,8 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] 为实现多种样式并存而增加的选项。仅用于gb7714-2015ms样式中。 \begin{itemize} - \item gbstyle=true,即默认全部文献使用gb7714-2015样式。 - \item gbstyle=false,仅中文文献使用gb7714-2015样式,其它语言文献使用biblatex默认样式。 + \item gbstyle=true,即默认全部文献使用国标样式。 + \item gbstyle=false,仅中文文献使用国标样式,其它语言文献使用biblatex默认样式。 \end{itemize} 该选项的实现原理是把所有国标格式设置局部化到每一条文献打印时,处理时首先判断gbstyle 选项及文献的语言,当满足要求则使用这些局部化格式,否则使用默认的标准样式。这种实现为一篇文档内实现两种样式提供解决思路,尽管目前非中文语言文献的著录格式是标准样式,但只要对标准样式做进一步的修改就可以形成符合某种格式规范的样式,比如像ieee,nature等的样式。因此存在中文使用GB/T 7714-2015 著录格式,而英文文献使用ieee等著录格式的可能性。测试文档见:\href{run:./example/opt-gbstyle.tex}{opt-gbstyle.tex}。 @@ -1021,7 +1037,7 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] 注意,若要让脚注计数器与其它计数器比如chapter等关联,那么采用latex的常规方法就能解决,比如使用latex内核常用的\verb|\@addtoreset|命令。 - + \item[gbstrict]=\textbf{true},false. \hfill default is true 为避免输出bib文件中多余的域信息而增加选项,目的是为了兼容一些bib文件,因为某些bst样式文件进行中英文判断需要在bib文件中增加类似language这样的域作为支撑,而其中某些域在标准的biblatex样式文件中是默认输出的。 @@ -1042,14 +1058,16 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \end{description} -\subsubsection{新增的重要命令}\label{sec:add:cmd} +\subsubsection{新增重要命令}\label{sec:add:cmd} \begin{description} - \item[defdoublelangentry] \{entrykey1\}\{entrykey2\} + \pdfbookmark[4]{defdblanentry}{defdblanentry} + \item[defdblanentry] \{entrykey1\}\{entrykey2\} - 用于定义双语对照文献,将entrykey2条目和entrykey1条目关联起来,在文献表中对照输出。比如: + 用于定义双语对照文献,将entrykey2条目和entrykey1条目关联起来,在文献表中对照输出。比如:\verb|\defdblanentry{entrykey1}{entrykey2}|或 \verb|\defdoublelangentry{entrykey1}{entrykey2}|,若entrykey1条目是中文的文献,entrykey2条目是对应entrykey1条目的英文形式,那么该命令会使得在文献表中,entrykey2的英文内容紧跟在entrykey1的中文内容后对照输出。该命令也只能出现在导言区中。 - + + \pdfbookmark[4]{addEntryField}{addEntryField} \item[addEntryField] \{entrykey or entrykey comma list\}\{field\}\{fieldvalue\} 用于给指定的文献条目(集)添加域。即将field=\{fieldvalue\}这样的域信息添加到指定的entrykey条目或者entrykey comma list条目集中。比如: @@ -1058,6 +1076,16 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] 将会为author2007en,author2014en两个条目添加nameformat域信息。 该命令也只能出现在导言区中。 + + + \pdfbookmark[4]{setlocalbibstring}{setlocalbibstring} + \item[setlocalbibstring] \{bibstringkey\}\{bibstringval\} + + 用于局部调整本地化字符串的内容。比如\verb|\setlocalbibstring{andothersincite}{et al.}|,就是临时将本地化字符串andothersincite的内容调整为“et al.”。 + +注意:如果要在本地化字符串的内容设置中使用biblatex提供的一些标点命令,比如adddot 等,那么需要对其进行保护,避免直接展开导致命令未定义的错误,比如: +\verb|\setlocalbibstring{andothersincite}{et al\protect\adddot}| + \end{description} @@ -1199,12 +1227,12 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \subsection{文献引用及标注格式}\label{sec:cbx:usage} -要生成参考文献,第一步就是在正文中引用参考文献。正文中因引用文献所形成的标注的格式称为参考文献标注样式,也称引用样式或引用标签样式,分为两类: 顺序编码制和著者-出版年(作者年)制。引用文献的基本命令是\verb|\cite|,但为了在一篇文档中实现不同的标签效果,通常还需要使用其它命令, -比如\verb|\parencite|, \verb|\textcite|, \verb|\pagescite|,\verb|\footfullcite|等。此外为遵循biblatex对于复数形式标注命令的使用习惯,也提供上述命令的复数形式,比如\verb|\cite|命令的复数形式命令\verb|\cites|,便于输出单个文献的页码等前后注信息。 +要生成参考文献,第一步就是在正文中引用参考文献。正文中因引用文献所形成的标注的格式称为参考文献标注样式,也称引用样式或引用标签样式,分为两类: 顺序编码制和著者-出版年(作者年)制。引用文献的基本命令是\verb|\cite|,但为了在一篇文档中实现不同的标签效果,通常还需要使用\verb|\parencite|等其它命令,以及这些命令的复数形式以实现同一处引用多篇文献的附加信息输入。 -熟悉natbib的用户也可以直接使用使用\verb|\citet|, \verb|\citep|命令。 -另外也可以使用一些习惯命令比如\verb|\citetns|、\verb|\citepns|、 -\verb|\upcite|、\verb|\inlinecite|等。 +%比如\verb|\parencite|, \verb|\textcite|, \verb|\pagescite|,\verb|\footfullcite|等。此外为遵循biblatex对于复数形式标注命令的使用习惯,也提供上述命令的复数形式,比如\verb|\cite|命令的复数形式命令\verb|\cites|,便于输出单个文献的页码等前后注信息。 +%熟悉natbib的用户也可以直接使用使用\verb|\citet|, \verb|\citep|命令。 +%另外也可以使用一些惯用命令比如\verb|\citetns|、\verb|\citepns|、 +%\verb|\upcite|、\verb|\inlinecite|等。 \subsubsection{两种编制的标注格式} @@ -1214,41 +1242,19 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] 为使用户免于输入文献作者,完善了\verb|\textcite|命令,提供作者为句子主语,并附带行内非上标的顺序编码, 并增加了\verb|\authornumcite|命令,以输出作者作为句子主语,并附带上标的顺序编码。 增加了\verb|\citec|命令,输出另一种形式的编码压缩标签,比如\textsuperscript{[2]-[4]}区别于一般的\textsuperscript{[2-4]}。 - 其它命令\verb|\citet|、\verb|\citep|、\verb|\citetns|、\verb|\citepns|、 \verb|\upcite|、\verb|\inlinecite|分别等价于 \verb|\authornumcite|、\verb|\cite|、\verb|\textcite|、\verb|\parencite|、 \verb|\cite|、\verb|\parencite|。 -上述命令均可在{bibtexkey}前面的[]内或第二个[]内(当有两个[]时),指定页码用于输出。若不指定页码,则仅有\verb|\pagescite|命令默认提取参考文献的页码信息进行输出。 +上述命令均可指定页码等信息用于输出,即在{entrykey}前面的[]内或第二个[]内(当有两个[]时)给出需要附加输出的信息,比如:\verb|\cite[p. 9]{entrykey}|或\verb|\cite[第九页]{中文entrykey}|。若不指定页码,则仅有\verb|\pagescite|命令默认提取参考文献的页码信息进行输出。 各引用命令的使用方式如表\ref{tab:cite:num}所示。 测试文档见\href{run:example/testallformat.tex}{testallformat.tex}。 -%各命令使用方式如例\ref{eg:citefornumeric}所示。 -%各引用命令的效果如图\ref{fig:cite:num}所示。 - -\qd{对于一个引用命令中同时给出多个文献bibtexkey的压缩形式,页码只会应用到最后一个参考文献后面,这是不正确的,但这种情况其实本不应出现,因为指定页码本来就需要具体化指向某一文献。使用时请尽可能使用 -\textbackslash pagescite\{key1\}\textbackslash pagescite\{key2\}这种形式 -而不是\textbackslash pagescite\{key1,key2\}|。当然除了多次使用标注命令外,也可以使用对应标注命令的复数形式来为每篇文献提供相应的页码信息。} -%著者-出版年制的标注样式文件大体使用标准引用样式authoryear的内容。 -\paragraph{\heiti 著者-出版年制的标注样式} -为满足GB/T 7714-2015第10.2节的要求, -考虑\verb|\cite|和\verb|\parencite|命令将引用标签用圆括号括起来。增加了\verb|\pagescite|命令,用于自动加页码。增加了\verb|\yearpagescite|, \verb|\yearcite|命令用于处理文中已有作者信息只需要年份和页码的情况(为兼容性考虑,顺序编码制也给出该命令,但作用与 -\verb|\pagescite| 命令相同),也完善了 \verb|\textcite| 命令,提供作者为句子主语,并附带行内非上标的页码,增加了\verb|\authornumcite|命令,以输出作者作为句子主语,并附带上标的页码。 - -其它命令\verb|\citet|、\verb|\citep|、\verb|\citetns|、\verb|\citepns|、 -\verb|\upcite|、\verb|\inlinecite|分别等价于 -\verb|\authornumcite|、\verb|\cite|、\verb|\textcite|、\verb|\parencite|、 -\verb|\cite|、\verb|\parencite|。 - -%各命令使用方式如例\ref{eg:citeforauthoryear}所示。 -%各引用命令的效果如图\ref{fig:cite:ay}所示。 -各引用命令的使用方式如表\ref{tab:cite:authoryear}所示。 -测试文档见\href{run:example/testallformat.tex}{testallformat.tex}。 - %\begin{table}[!htb] +\medskip \noindent\begin{minipage}{0.95\linewidth} \begin{refsection} \centering @@ -1282,9 +1288,38 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \end{tabular} \end{refsection} \end{minipage} +\medskip %\end{table} +%各命令使用方式如例\ref{eg:citefornumeric}所示。 +%各引用命令的效果如图\ref{fig:cite:num}所示。 + +注意:对于一个引用命令中同时给出多个文献entrykey的压缩形式,页码只会应用到最后一个参考文献后面。 +%这是不正确的,但这种情况其实本不应出现,因为指定页码本来就需要具体化指向某一文献。 +若要为每篇添加页码信息,则应多次使用标注命令 +\verb|\cite[p.2]{entrykey1}\cite[p.5]{entrykey2}|或使用复数形式的标注命令 +\verb|\cites[p.2]{entrykey1}[p.5]{entrykey2}|, +而不是\verb|\cite[p.5]{entrykey1,entrykey2}|。 + +%当然除了这种多次使用标注命令外,也可以使用对应标注命令的复数形式来为每篇文献提供相应的页码信息。 + + +%著者-出版年制的标注样式文件大体使用标准引用样式authoryear的内容。 +\paragraph{\heiti 著者-出版年制的标注样式} +为满足GB/T 7714-2015第10.2节的要求, +考虑\verb|\cite|和\verb|\parencite|命令将引用标签用圆括号括起来。增加了\verb|\pagescite|命令,用于自动加页码。增加了\verb|\yearpagescite|, \verb|\yearcite|命令用于处理文中已有作者信息只需要年份和页码的情况(为兼容性考虑,顺序编码制也给出该命令,但作用与 +\verb|\pagescite| 命令相同),也完善了 \verb|\textcite| 命令,提供作者为句子主语,并附带行内非上标的页码,增加了\verb|\authornumcite|命令,以输出作者作为句子主语,并附带上标的页码。 + +其它命令\verb|\citet|、\verb|\citep|、\verb|\citetns|、\verb|\citepns|、 +\verb|\upcite|、\verb|\inlinecite|分别等价于 +\verb|\authornumcite|、\verb|\cite|、\verb|\textcite|、\verb|\parencite|、 +\verb|\cite|、\verb|\parencite|。 + +%各命令使用方式如例\ref{eg:citeforauthoryear}所示。 +%各引用命令的效果如图\ref{fig:cite:ay}所示。 +各引用命令的使用方式如表\ref{tab:cite:authoryear}所示。 +测试文档见\href{run:example/testallformat.tex}{testallformat.tex}。 @@ -1331,22 +1366,24 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \subsubsection{标注格式局部调整} -标注在同一个文档中是可能存在不同格式需求的,比如:有的地方需要用上标,有的地方需要用行内,有的地方需要给出作者,有的地方需要给出页码等。一般情况下,不同标注格式可以通过使用不同的标注命令来得到,比如上一小节给出的大量不同的命令,不同命令能够产生独特的标注标签。 +标注在同一个文档中可能存在不同格式需求,比如:有的地方需要用上标,有的地方需要用行内,有的地方需要给出作者,有的地方需要给出页码等。一般情况下,不同标注格式可以通过使用不同的标注命令来得到,比如上一小节给出的不同命令。 +%,不同命令能够产生独特的标注标签。 -除了利用命令来调整标注格式外,还有更多的方法来进行局部格式调整。这利用了tex的编组特性,编组内的局部格式不影响编组外的格式,所以可以利用编组内的局部设置来调整标注的格式,类似的,文献表的著录格式也是可以局部调整的,见下一节。 +除了利用命令来调整标注格式外,还有更多方法可进行局部格式调整。这利用了tex的编组特性,编组内的局部格式不影响编组外的格式,所以可利用编组内的局部设置来调整标注的格式。类似的,文献表的著录格式也可局部调整,详见下一节。 -引用文献所产生标注标签的格式包括很多内容,包括作者数量,标点,本地化字符串等。最常见的局部调整需求是标点和本地化字符串。这里以双语图题中的引用标签的不同本地化字符串需求为例来展示局部调整的方法。 +引用文献所产生标注标签的格式包括很多内容,包括作者数量、标点、本地化字符串等。最常见的局部调整需求是本地化字符串和标点。这里以双语图题中的引用标注标签的不同本地化字符串需求为例来展示局部调整的方法。 -在中科院某类学位论文中,正文的标注标签要求两个英文作者之间用和而不是and连接,多个英文作者截断成一个作者时后面用等.而不是et al.表示。这可以容易通过设置本地化字符串来实现。然而对于双语的图题,英文图题中的出现等与和这样的字符实在不雅,所以又要求在这种全英文的环境中将和与等.更换为英文的表示符号,这就需要利用本地化字符串的局部调整。这种本地化字符串的局部调整其实已经是比较深入的内容,因为biblatex提供的接口DefineBibliographyStrings是全局的设置,如何进行局部调整并没有非常方便的接口,要解决这一需求,需要对biblatex以及gb7714-2015样式有比较深入的了解。 +\paragraph{标注中“等”“和”等本地化字符串调整} -因为gb7714-2015通过gbcitelocalcase计数器来选择使用中文或英文的本地化字符串,因此通过局部设置gbcitelocalcase可以局部的选择不同语言的本地化字符串,然而因为本地化字符串的内容通常是全局设置的,所以当中文的或者英文的本地化字符串设置都不满足要求时,就需要局部的调整本地化字符串的内容,如\ref{eg:str:localset}所示,对本地化字符串andothersincite的内容做了调整,从全局设置的等.转换为et al.,和转换为and,这种局部设置是通过csdef对保存字符串信息的命令直接做的调整。比如\verb|\csdef{abx@sstr@andothersincite}{et al.}|就是将andothersincite本地化字符串的内容临时调整为et al.。 +在中科院某类学位论文中,正文的标注标签要求两个英文作者之间用“和”而不是“and”连接,多个英文作者则截断成一个作者时后面用“等.”而不是“et al.”表示。这可以容易通过设置本地化字符串来实现。然而对于双语的图题,英文图题中不适合出现“等”与“和”这样的字符,所以又要求在这种全英文的环境中将“和”与“等.”更换为英文符号,这就需要利用本地化字符串的局部调整。这种本地化字符串的局部调整其实已经是比较深入的内容,因为biblatex提供的接口DefineBibliographyStrings是全局的设置,而局部调整则需要使用其它方式。 +%如何进行局部调整并没有非常方便的接口,要解决这一需求,需要对biblatex以及gb7714-2015样式有比较深入的了解。 -为方便用户使用,提供了 -\verb|\setlocalbibstring|命令来替代上述直接定义的csdef命令,比如: -\verb|\setlocalbibstring{andothersincite}{et al.}|,等价于与前面csdef那条命令。 -另外,如果要在本地化字符串的内容设置中使用biblatex提供的一些标点命令,比如adddot等,那么需要对其进行保护,避免直接展开导致命令未定义的错误,比如: -\verb|\setlocalbibstring{andothersincite}{et al\protect\adddot}| +因为gb7714-2015通过gbcitelocalcase计数器来选择使用中文或英文的本地化字符串,因此通过局部设置gbcitelocalcase可以局部的选择不同语言的本地化字符串,比如在一个编组内,局部化设置计数器为:\verb|\defcounter{gbcitelocalcase}{1}|,那么这个编组内的所有本地化字符串会使用默认的中文字符串,反之若设置为2,则本地化字符串会使用默认的英文字符串。 +然而因为本地化字符串的内容通常是全局设置的,所以当中文的或者英文的本地化字符串设置都不满足要求时,就需要局部的调整本地化字符串的内容,如例\ref{eg:str:localset}所示,对本地化字符串andothersincite的内容做了调整,从全局设置的“等.”转换为“et al.”,“和”转换为“and”,这种局部设置可通过csdef对保存字符串信息的命令直接做的调整,比如\verb|\csdef{abx@sstr@andothersincite}{et al.}|就是将andothersincite本地化字符串的内容临时调整为“et al.”。 +但为方便用户使用,提供了 +宏包提供了\verb|\setlocalbibstring|命令来替代上述直接定义的csdef命令, +如例\ref{eg:str:localset}所示。 具体的测试见\href{egthesis/thesis-ucas-m.tex}{thesis-ucas-m.tex} \begin{example}{双语图题内的标注标签的本地化字符串局部设置}{eg:str:localset} @@ -1362,8 +1399,82 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \end{example} -\paragraph{标注中的全半角标点设置} +\paragraph{标注中的全半角标点和括号调整} + +除了本地化字符串外,标注中的括号和标点也是需要调整的内容。这里两个默认采用英文的半角符号。首先可以通过选项调整,gbcitelabel选项提供了不同的选择,可以设置标注的括号,为全局或半角,同时提供了一个gbcitelabel=quanjiao,可以将标点和括号全部改为全角。 + +如果选项提供的效果还不够,那么可以局部调整mkbibleftborder和mkbibrightborder,来更换需要的括号。例\ref{eg:parens:localset}中的局部调整可以将标注中的括号改变为『和』。 + +\begin{example}{局部调整标注标签中的括号}{eg:parens:localset} +\begin{texlist} +{\renewrobustcmd{\mkbibleftborder}{『}% +\renewrobustcmd{\mkbibrightborder}{』}% +中文段落\cite{Aaa_2018,Aaa_2018a}\cite{Aaa_2021,Aaa_2018}\\ +中文段落\textcite{Aaa_2018,Aaa_2018a},\textcite{Aaa_2021,Aaa_2018} \\ +中文段落\cite{Aaa_2018,Bbb_2019}\parencite{Aaa_2018,Bbb_2019}} +\end{texlist} +\end{example} + +对于标点来说,若默认的设定不满足要求,则可以在导言区进行调整, +如例\ref{eg:punct:globalset}中的第一段代码所示,除了其中标点外,有时还需要设置finalnamedelim。这是标签中除姓名外的标点调整,至于姓名内的标点调整则是需要从另外的接口修改,比如:通过gbcaselocalset等来修改revsdnamepunct,bibinitperiod等等,这些在标注标签中通常不太需要修改。 + +但有的时候,我们需要对中英文文献的标注标签使用不同的符号,比如中文的标签使用中文全角标点,而英文的标签使用英文的标点,那么可以在标点设置时做一个判断,如例 +\ref{eg:punct:globalset}中的第二段代码所示。 + +而还有的时候,文档中存在独立的中文段落和英文段落,期望在中文段落中使用中文的标点,而在英文段落中则使用英文的标点,此时可以利用gbcitelocal选项的内部设置的计数器gbcitelocalcase来局部化调整。如例 +\ref{eg:punct:globalset}中的第三段代码所示,做如此设置后,那么只要在指定的段落局部化计数器gbcitelocalcase的值就可以达到临时调整标点的目的。 + +\begin{example}{标注标签中的标点的全局和局部设置}{eg:punct:globalset} +\begin{texlist} +%第一段代码:导言区重设标注标签的标点 +\renewcommand*{\multicitedelim}{;}%\addsemicolon\addspace; +\renewcommand*{\compcitedelim}{,} +\renewcommand{\compextradelim}{,} +\DeclareDelimFormat[cite,parencite,pagescite]{nameyeardelim}{,}%\addcomma\space +\DeclareDelimFormat[textcite]{nameyeardelim}{,}%\addcomma\space +\DeclareDelimFormat[cite,parencite,pagescite]{andothersdelim}{,}% +\DeclareDelimFormat[textcite]{andothersdelim}{,}% + +%第二段代码:导言区重设标注标签的标点,根据文献的中英文调整标点形式 +\renewcommand*{\multicitedelim}{\iffieldequalstr{userf}{chinese}{;}{\addsemicolon\addspace}}%; +\renewcommand*{\compcitedelim}{\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}} +\renewcommand{\compextradelim}{\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}} +\DeclareDelimFormat[cite,parencite,pagescite,citep]{nameyeardelim} +{\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}}% +\DeclareDelimFormat[textcite,authornumcite,citet]{nameyeardelim} +{\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}}% +\DeclareDelimFormat[cite,parencite,pagescite,citep]{andothersdelim} +{\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}}% +\DeclareDelimFormat[textcite,authornumcite,citet]{andothersdelim} +{\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}}% + +%第二段代码:导言区重设标注标签的标点,可根据计数器gbcitelocalcase局部设置调整中英文标点 +\renewcommand*{\multicitedelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{;}{\addsemicolon\addspace}% +\or ;\or\addsemicolon\addspace\fi}%; +\renewcommand*{\compcitedelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}% +\or ,\or\addcomma\space\fi} +\renewcommand{\compextradelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}% +\or ,\or\addcomma\space\fi} +\DeclareDelimFormat[cite,parencite,pagescite,citep]{nameyeardelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}% +\or ,\or\addcomma\space\fi} +\DeclareDelimFormat[textcite,authornumcite,citet]{nameyeardelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}% +\or ,\or\addcomma\space\fi} +\DeclareDelimFormat[cite,parencite,pagescite,citep]{andothersdelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}% +\or ,\or\addcomma\space\fi} +\DeclareDelimFormat[textcite,authornumcite,citet]{andothersdelim} +{\ifcase\value{gbcitelocalcase}\iffieldequalstr{userf}{chinese}{,}{\addcomma\space}% +\or ,\or\addcomma\space\fi} +\end{texlist} +\end{example} + +示例可以参考:\href{run:example/test-punct-quanjiao.tex}{test-punct-quanjiao.tex} 参考:\url{https://blog.csdn.net/xenonhu/article/details/124686522} @@ -1374,15 +1485,18 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] 引用文献后,可以在文档需要的位置利用 \verb|\printbibliography| 命令输出文献表。文献表的输出格式称为参考文献著录样式,也称著录表样式或著录格式,也分两类: 顺序编码制和著者-出版年制(作者年制)。 %顺序编码制的参考文献样式基于标准样式numeric-comp/numeric -\paragraph{\heiti 顺序编码制样式} 中各条参考文献条目以数字序号按引用先后顺序组织。 +\subsubsection{顺序编码制样式} + +文献表中各参考文献条目以数字序号按引用先后顺序组织。 著录格式中序号格式见\ref{sec:bib:serialno}节, 各类型文献条目的著录格式见\ref{sec:numeric:data}节, 参考文献条目中各信息域及其录入方式见\ref{sec:bib:bibtex}节。 %著者-出版年制的参考文献样式则基于标准样式authoryear -\paragraph{\heiti 著者-出版年制样式} 中各条参考文献条目以作者-年为标签以一定的顺序排列。著者-出版年制的著录格式与顺序编码制基本相同,差别仅在于把年份提前到作者后面作为条目的标签。数据源bib文件中各条目的数据录入与顺序编码制完全一致。 +\subsubsection{著者-出版年制样式} +文献表中各参考文献条目以作者-年为标签以一定的顺序排列。著者-出版年制的著录格式与顺序编码制基本相同,差别仅在于把年份提前到作者后面作为条目的标签。数据源bib文件中各条目的数据录入与顺序编码制完全一致。 -\qd{著者-出版年制有文献按文种集中的要求,因此gb7714-2015ay样式设计了gblanorder选项来配合专用的排序模板,可以方便地设置不同文种的先后顺序,默认文种顺序是中日韩英法俄。如需其他顺序则可利用gblanorder选项重设,设置方法见第\ref{sec:added:opt}节。此外,由于排序需要根据文献所使用的语言判断,因此使用language域,该域由biblatex-gb7714-2015宏包自动判断处理,一般不需过多关注,如果当语言判断出现问题,可以在bib文件中手动设置language域为正确的语言,比如chinese,japanese,english,french等。} +注意:著者-出版年制有文献按文种集中的要求,因此gb7714-2015ay样式设计了gblanorder选项来配合专用的排序模板,可以方便地设置不同文种的先后顺序,默认文种顺序是中日韩英法俄。如需其他顺序则可利用gblanorder选项重设,设置方法见第\ref{sec:added:opt}节。此外,由于排序需要根据文献所使用的语言判断,因此使用language域,该域由biblatex-gb7714-2015宏包自动判断处理,一般不需过多关注,如果当语言判断出现问题,可以在bib文件中手动设置language域为正确的语言,比如chinese,japanese,english,french等。 %前一段为20190331更新 %\qd{著者-出版年制有分文种文献集中的要求,因此gb7714-2015排序模板以nyt模板为基础,增加 language 作为 name 前的排序域。默认情况下,本样式文件将标题(或作者)为中文的文献的 language 域设置成 chinese,英文的设置成 english。这一设置过程,在biber 处理时自动完成。当出现问题或者有更多文种分集且有特殊顺序时,可以在bib文件中为相应文种文献的 language 域手动设置适合排序的字符串。比如: 中文文献设置为 chinese,英文文献设置为 enlish,法文文献设置为 french,那么排序中,相应的中文文献排在最前面,英文文献在中间,法文文献最后,因为升序情况下字母顺序是c然后e然后f。} @@ -1406,18 +1520,17 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \end{texlist} \end{example} -更多的设置方法,请参考: -\href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography/blob/master/biblatex-solution-to-latex-bibliography.pdf}% -{biblatex高级使用方法和样式包设计实现方法} +%更多的设置方法,请参考: +%\href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography/blob/master/biblatex-solution-to-latex-bibliography.pdf}% +%{biblatex高级使用方法和样式包设计实现方法} \subsubsection{段落格式控制} \paragraph{\heiti 文献表字体、颜色} 为方便用户改变文献表段落格式、内容字体和颜色等,在 biblatex 提供的 \verb|\bibfont| 命令基础上, -增加了\verb|\bibauthorfont|、\verb|\bibtitlefont|、\verb|\bibpubfont| 等命令用于控制文献部分著录项的格式,比如作者,标题,出版项等。增加了\verb|\SlashFont| -用法具体见例\ref{eg:biblist:fontset},结果如图\ref{fig:par:fmt}所示。 +增加了\verb|\bibauthorfont|、\verb|\bibtitlefont|、\verb|\bibpubfont| 等命令用于控制文献部分著录项的格式,比如作者,标题,出版项等。增加了\verb|\SlashFont|用于控制斜杠的字体。 +具体用法见例\ref{eg:biblist:fontset},结果如图\ref{fig:par:fmt}所示。 测试用例见\href{run:example/testfontinbiblio.tex}{testfontinbiblio.tex}。 - \begin{example}{文献表段落格式、字体、颜色}{eg:biblist:fontset} \begin{texlist} % 文献项之间的间隔符控制(比如是否换行) @@ -1432,7 +1545,7 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \renewcommand{\bibpubfont}{\itshape\color{violet}}% % url和doi字体 \def\UrlFont{\ttfamily}%\rmfamily %\urlstyle{sf} %\def\UrlFont{\bfseries} - %斜杠的字体,比如[J/OL]中的斜杠 + %斜杠的字体,比如[J/OL]或析出文献符号//中的斜杠 \def\SlashFont{\ttfamily}%\rmfamily等 \end{texlist} \end{example} @@ -1466,34 +1579,36 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \paragraph{\heiti 文献表水平间距(缩进)控制} 增加了尺寸\verb|\bibitemindent| 用于控制参考文献条目在文献表中的缩进, 其意义与 list 环境中 \verb|\itemindent| 相同。 -文献表的水平缩进控制,两种编制方式下是不同的。 +文献表的水平缩进控制,两种编制方式下是不同的,调整方法见例\ref{eg:biblist:hspace}。 -(a) 对于\emph{著者-出版年}制文献表,bibitemindent表示 +\textbf{(a)} 对于\emph{著者-出版年}制文献表 + +bibitemindent表示 \emph{一条文献中第一行相对后面各行的缩进},bibhang 表示\emph{页边到文献各行起始位置的距离}。因此要调整缩进则直接设置这两尺寸。 当使用著者-出版年样式又需要使用顺序编码数字标签的文献表时(此时使用gbalign选项),缩进方式与顺序编码制文献表类似,但又略有差异。 数字标签盒子默认宽度为2em,可以调整biblabelextend来增大或缩小(使用正或负的长度)该宽度,数字标签的盒子与文献内容之间的间距为4.5pt,通过直接设置biblabelsep尺寸来调整。 -(b) 对于\emph{顺序编码}制文献表,由于存在数字标签,且其宽度与参考文献数量相关,所以这个宽度是动态变化的,不能提前设定,而是在文献表生成时给出,所以调整缩进需要根据文献表输出环境的情况做针对性处理。 - -顺序编码样式使用了两类输出环境,所以设定选项也区分两类: +\textbf{(b)} 对于\emph{顺序编码}制文献表 -一是采用list环境的文献表,即设置gbalign=left、right、center时(即顺序编码标签是左对齐、右对齐和居中对齐的情况)。 +由于存在数字标签,且其宽度与参考文献数量相关,所以这个宽度是动态变化的,不能提前设定,而是在文献表生成时给出,所以调整缩进需要根据文献表输出环境的情况做针对性处理。 -此时文献表环境,数字标签盒子默认宽度为labelnumberwidth,由biblatex根据文献数量自动计算后设定,因此改变缩进主要通过调整biblabelsep和bibitemindent两个尺寸来实现。biblabelsep设置数字标签的盒子与文献内容之间的间距。bibitemindent设置第一行和后面其它行的缩进,默认情况下bibitemindent为0pt,则一条文献内所有行缩进相同,若bibitemindent>0pt则第一行相比后面各行缩进,若bibitemindent<0pt则后面各行相比第一行缩进。 - -顺序编码样式下bibitemindent与bibhang的意义与著者-出版年制下相同,但由于数字标签盒子的存在,所以页边到各行起始位置的距离bibhang=labelnumberwidth +biblabelsep -bibitemindent。 +顺序编码样式使用了两类输出环境,所以设定选项也区分两类: -当采用某些字体导致计算的标签宽度不足时,可以设置biblabelextend尺寸,来增加labelnumberwidth的宽度避免缩进格式产生问题,使得:bibhang=labelnumberwidth +biblabelextend +biblabelsep -bibitemindent。默认情况下biblabelextend尺寸为0pt。 +\begin{itemize} +\item 一是采用list环境的文献表,即设置gbalign=left、right、center时(即顺序编码标签是左对齐、右对齐和居中对齐的情况)。此时需要调整的尺寸包括三个:biblabelsep,bibitemindent,biblabelextend。 -二是采用正常段落环境的文献表,即设置gbalign=gb7714-2015时(即项对齐情况,就是各条文献是自身对齐的情况)。 -此时数字标签盒子默认宽度根据标签实际宽度自动设定,因此不会存在数字标签盒子宽度不足的情况,所以不用设置biblabelextend尺寸。数字标签的盒子与文献内容之间的间距通过调整biblabelsep可设置。\emph{每条参考文献第二行开始的缩进距离}通过调整bibitemindent尺寸设置,bibitemindent默认为0pt,则一条文献内所有行缩进相同,若bibitemindent>0pt则第一行相比后面各行缩进,若bibitemindent<0pt则后面各行相比第一行缩进。 +\hspace{2em}此时的文献表环境中,数字标签盒子默认宽度为labelnumberwidth,由biblatex根据文献数量自动计算后设定,因此改变缩进主要通过调整biblabelsep和bibitemindent两个尺寸来实现。biblabelsep设置数字标签盒子与文献内容之间的间距。bibitemindent设置第一行相对后面其它行的缩进,默认情况下bibitemindent为0pt,则一条文献内所有行缩进相同,若bibitemindent>0pt则第一行相比后面各行缩进,若bibitemindent<0pt则后面各行相比第一行缩进。 +\hspace{2em}顺序编码样式下bibitemindent与bibhang的意义与著者-出版年制下相同,但由于数字标签盒子的存在,所以页边到各行起始位置的距离bibhang=labelnumberwidth +biblabelsep -bibitemindent。 +当采用某些字体导致默认计算的标签宽度不足时,可以设置biblabelextend尺寸,来增加labelnumberwidth的宽度避免缩进格式产生问题,使得:bibhang=labelnumberwidth +biblabelextend +biblabelsep -bibitemindent。默认情况下biblabelextend尺寸为0pt。 -调整方法见例\ref{eg:biblist:hspace}。 +\item 二是采用正常段落环境的文献表,即设置gbalign=gb7714-2015时(即项对齐情况,每条文献严格按从左到右的顺序输出,顺序数字标签宽度等于实际宽度,文献内容与其间隔biblabelsep)。此时需要调整的尺寸包括两个:biblabelsep,bibitemindent。 +\hspace{2em}此时数字标签盒子默认宽度根据标签实际宽度自动设定,因此不存在数字标签盒子宽度不足的情况,因而无需设置biblabelextend尺寸。数字标签盒子与文献内容之间的间距可通过调整biblabelsep设置。\emph{每条参考文献第二行开始的缩进距离}通过调整bibitemindent尺寸设置,bibitemindent默认为0pt,则一条文献内所有行缩进相同,若bibitemindent>0pt则第一行相比后面各行缩进,若bibitemindent<0pt则后面各行相比第一行缩进。 +\end{itemize} \begin{example}{文献表水平缩进控制}{eg:biblist:hspace} @@ -1512,7 +1627,7 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \end{texlist} \end{example} -(c) 其它形式的文献表。 +\textbf{(c)} 其它形式的文献表 除了使用这种段落形式的文献表外,也有生成\emph{表格文献表}的需求,即把文献表放到一个表格里面,要求每一条文献占据表格的一行。这也是能实现的,具体参考我的博客文章 \href{https://blog.csdn.net/xenonhu/article/details/121696116}{latex中生成表格形式的参考文献表}。 @@ -1581,18 +1696,28 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \renewcommand*{\finentrypunct}{\iffieldequalstr{userd}{chinese}{。}{\adddot}} %姓名格式相关的标点 -\DeclareDelimFormat{nameyeardelim}{,}%\addcomma\addspace -%\DeclareDelimFormat[bib,biblist]{nameyeardelim}{,}%\addcomma\addspace -\DeclareDelimFormat{multinamedelim}{,}%[bib,biblist] -\DeclareDelimFormat{finalnamedelim}{,} -\DeclareDelimFormat{andothersdelim}{,} -\renewcommand*{\revsdnamepunct}{,}% +\DeclareDelimFormat[bib,biblist]{nameyeardelim}{,}%\addcomma\addspace +\DeclareDelimFormat[bib,biblist]{multinamedelim}{,}%[bib,biblist] +\DeclareDelimFormat[bib,biblist]{finalnamedelim}{,} +\DeclareDelimFormat[bib,biblist]{andothersdelim}{,} + +%姓名内部的相关标点,包括如下等设置 +%注意这类设置与gbnamefmt选项相关,不同的选项值对应不同的gb...localset +%除了如下命令外还有其它设置,有需要可以查biblatex文档 +\def\gbcaselocalset{% +\renewcommand*{\revsdnamepunct}{,}%% +\renewrobustcmd*{\bibinitperiod}{}%将名字简写后的点去掉 +\renewrobustcmd*{\bibinithyphendelim}{}%.\mbox{-} +\renewrobustcmd*{\bibnamedelima}{} %%\mbox{-} +} \end{texlist} \end{example} -\subsubsection{条目著录格式的选项控制}\label{sec:entry:fmt} +\subsubsection{条目著录格式控制}\label{sec:entry:fmt} -文献表输出的格式即参考文献著录样式,除了整体的段落格式外,还有条目内部的格式可以控制,条目内部的这些项称为著录项,这些著录项的格式通常可由选项控制。可用选项除了biblatex 提供的标准选项外,也包括样式包提供的选项。 +文献表输出的格式即参考文献著录样式,除了整体的段落格式外,还有条目内部的格式可以控制,条目内部的这些项称为著录项,这些著录项的格式通常可由选项控制。 + +可用选项除了biblatex 提供的标准选项外,也包括样式包提供的选项。 图\ref{fig:content:fmta}、\ref{fig:content:fmtb}、\ref{fig:content:fmtc}给出了一些选项设置后的格式控制效果, 更多选项的详细说明见第\ref{sec:added:opt}、\ref{sec:old:opt}小节。 @@ -1651,9 +1776,11 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \caption{文献表条目著录格式示例三}\label{fig:content:fmtc} \end{figure} -\subsubsection{条目著录格式的局部调整}\label{sec:entry:fmtlocal} -得益于biblatex利用tex宏控制著录格式的特点,加上tex语言本身编组的局部化特性,所以在利用biblatex生成参考文献的过程中可以有丰富手段来进行参考文献著录格式的局部调整。因为是局部的格式调整,所以通常是结合refsection或者refsegment来操作的。前面提到过的一个很简单的例子,当在学位论文的写作中需要正文部分的参考文献使用顺序编码制,而附录中研究成果部分使用作者年制这样的需求就是一个典型的局部化格式调整。这一问题的解决方式为:在研究成果部分使用refsection将其局部化,并结合gb7714-2015mx样式,并利用setaystylesection命令设置该refsection为作者年制样式。 +\subsubsection{参考文献表的局部调整}\label{sec:entry:fmtlocal} + +文档中有时需要多个文献表,而且可能具有不同的格式,因此全局的设置不一定满足要求,所以需要进行局部的调整,调整的内容也包括:文献表的标题、段落格式和著录格式。 +得益于biblatex利用tex宏控制著录格式的特点,加上tex语言本身编组的局部化特性,所以在利用biblatex生成参考文献的过程中可以有丰富手段来进行参考文献表的局部调整。因为是局部的格式调整,所以通常是结合refsection或者refsegment来操作的。前面提到过的一个很简单的例子,当在学位论文的写作中需要正文部分的参考文献使用顺序编码制,而附录中研究成果部分使用作者年制这样的需求就是一个典型的局部化格式调整。这一问题的解决方式为:在研究成果部分使用refsection将其局部化,并结合gb7714-2015mx样式,并利用setaystylesection命令设置该refsection为作者年制样式。 因为tex宏的局部化调整特性,因此几乎biblatex中所有格式设置都是可以做局部调整的,限于篇幅,这里仅介绍一些常见的简单的调整方式: @@ -1828,7 +1955,8 @@ biber -l zh__stroke jobname 为避免这一添加拼音到key域的操作,这里提供另一种可能更为方便的方法。biber在做排序时实际上是利用 perl 的 Unicode::Collation::locale 模块,其中的Pinyin.pm提供了汉字的拼音顺序,对该文件做临时的修改,可以调整多音字的顺序。 -因为在参考文献排序中通常会使用字的姓名音,所以我们对这个文件做非正式的修改,并放到github上(\href{https://github.com/hushidong/biblatex-gb7714-2015/files/11120449/Pinyin.zip}{Pinyin.zip}),若用户需要正确的姓的多音字排序,那么只要用该文件替换biber临时工作目录中的文件即可。注意:目前该文件只修改了“曾”“沈”两个字,而“翟”“仇”等没有做修改,若用户有需求后面再增加。 +因为在参考文献排序中通常会使用字的姓名音,所以我们对这个文件做非正式的修改,并放到github上(\href{https://github.com/hushidong/biblatex-gb7714-2015/files/11147697/Pinyin-modified-zhai.zip}{Pinyin.zip}),若用户需要正确的姓的多音字排序,那么只要用该文件替换biber临时工作目录中的文件即可。 +%注意:目前该文件只修改了“曾”“沈”两个字,而“翟”“仇”等没有做修改,若用户有需求后面再增加。 通常biber在第一次运行的时候,会构建一个依赖目录,这也是biber的临时工作路径,而所有的依赖文件就在其中。 在windows下通常会在临时目录temp下构建类似\verb|par-/cache-|的目录(其它系统也是类似命名,可以搜索一下),所有的依赖包括Pinyin.pm都会在其内部,找到并替换即可(Pinyin.pm文件通常在\verb|cache-\inc\lib\Unicode\Collate\CJK|下)。 @@ -1934,7 +2062,8 @@ leftrule=0pt,rightrule=0pt,toprule=0.4pt,bottomrule=0.4pt] \paragraph{\heiti 利用条目集类型满足双语文献要求} -设置条目集类型(set)有静态和动态两种方法。其中动态方法使用更为方便,只需在写文档时利用\verb|\defbibentryset|将两条文献不同语言的文献设置成一个set条目,然后引用set的bibtex键。比如: +设置条目集类型(set)有静态和动态两种方法。其中动态方法使用更为方便, +只需在写文档时利用\verb|\defbibentryset|将两条文献不同语言的文献设置成一个set条目,然后引用set的bibtex键。比如: \begin{example}{设置set条目集用于双语文献的动态方法}{eg:setforbilangentry} \begin{texlist} \defbibentryset{bilangyi2013}{易仕和2013--,Yi2013--} @@ -1955,9 +2084,9 @@ biblatex v3.7及之前版本,因为 set 带有第一个子条目的信息, \end{texlist} \end{example} -\bc{在biblatex3.8以上版本中,例{eg:setforbilangentry}的作者年制标注标签会是“易仕和,等,2013”,注意到其中的逗号是中文全角逗号,与其它标签的英文逗号的存在差异,正因为此,该方法并没有完美解决问题。} +\bc{在biblatex3.8以上版本中,例\ref{eg:setforbilangentry}的作者年制标注标签会是“易仕和,等,2013”,注意到其中的逗号是中文全角逗号,与其它标签的英文逗号的存在差异,正因为此,该方法并没有完美解决问题。} -\bc{由于顺序编码制使用的时数字标签,前述的问题对于顺序编码制并不存在。而作者年制中的标签问题,可以采用下面的静态条目集方法和关联(related)方法来解决。} +\bc{由于顺序编码制使用的是数字标签,前述的问题对于顺序编码制并不存在。而作者年制中的标签问题,可以采用下面的静态条目集方法和关联(related)方法来解决。} 静态方法是在bib源文件中给出条目集(set)并使用biber后端进行解析,条目的域信息定义方法如下: @@ -1965,7 +2094,7 @@ biblatex v3.7及之前版本,因为 set 带有第一个子条目的信息, \begin{example}{设置set条目集用于双语文献的静态方法}{eg:set:static} \begin{texlist} @Set{set1, -entryset = {key1,key2,key3}, +entryset = {entrykey1,entrykey2,entrykey3}, } %如果要达到上例动态设置set一样的结果,在bib文件中静态设置set条目如下: @Set{bilangyi2013, @@ -1977,10 +2106,10 @@ entryset = {易仕和2013--,Yi2013--}, 然而例\ref{eg:set:static}这般简单的静态条目集设置,还存在两个小的问题: \begin{enumerate} \item 中文排序会出现问题,条目集会出现在文献表末尾,这是因为条目集没有设置language域用于排序,而其它常规条目都会利用动态数据修改设置language域,但因为静态条目集需要在biber运行时解析,所以无法对language域进行处理。而使用动态条目集方法则没有这一问题,因为其解析过程直接会利用第一个子条目的排序信息。 - \item 著者-出版年制中的标注标签问题,对于静态条目集,v3.8以上版本的biblatex同样不复制第一个子条目信息,因此著者- 出版年制中的引用也无法生成正确的标注标签,这也就是前面动态条目集方法中提到的问题 + \item 著者-出版年制中的标注标签问题,对于静态条目集,v3.8以上版本的biblatex同样不复制第一个子条目信息,因此著者- 出版年制中的引用也无法生成正确的标注标签,这也就是前面动态条目集方法中提到的问题。 \end{enumerate} -但静态条目集方法有自己的解决方便,对于第一个问题,可以通过在set条目中手动设置language域来解决;第二个问题,也可以通过在set条目中手动设置label域来解决。比如: +但静态条目集方法有自己的解决之道,对于第一个问题,可以通过在set条目中手动设置language域来解决;第二个问题,也可以通过在set条目中手动设置label域来解决。比如: \begin{example}{在bib文件中正确设置set条目集的静态方法}{eg:set:staticright} \begin{texlist} @@ -2005,7 +2134,8 @@ language={chinese} 除上述给出的条目集方案外,关联条目方法则是另一种可行方案\footnote{Again about the \@ set label for authoryear style:\url{https://github.com/plk/biblatex/issues/681}}。该方案同样也有静态和动态两种方法,静态就是直接修改bib文件的内容,动态则是在tex源文档中做设置,然后通过biblatex的动态数据修改机制做临时修改。 -静态方法很简单,bib文件中条目设置如例\ref{eg:related:staticright}所示,它能解决双语同时显示的问题,也能解决排序和标注标签问题,唯一的问题在于修改了bib文件后,当不需要双语文献时还需改回来,这会带来不便,因此可以考虑下面的动态方法。但要注意动态方法需要利用多个\verb|\DeclareStyleSourcemap|,因此该方法只适用于biblatex v3.7及以上版本。 +静态方法很简单,bib文件中条目设置如例\ref{eg:related:staticright}所示,它能解决双语同时显示的问题,也能解决排序和标注标签问题,唯一的问题在于修改了bib文件后,当不需要双语文献时还需改回来,这会带来不便,因此可以考虑下面的动态方法。 +但要注意动态方法需要利用多个\verb|\DeclareStyleSourcemap|,因此该方法只适用于biblatex v3.7及以上版本。 \begin{example}{在bib文件中正确设置关联条目的静态方法}{eg:related:staticright} \begin{texlist} @@ -2029,7 +2159,7 @@ language={chinese} \end{texlist} \end{example} -动态方法利用动态数据修改自动添加related域,避免对bib文件做直接修改。本样式中对该过程进行了封装,定义一个新的命令\verb|\defdoublelangentry|,例如: +动态方法利用动态数据修改自动添加related域,避免对bib文件做直接修改。本样式中对该过程进行了封装,定义一个新的命令\verb|\defdblanentry|和一个等价命令\verb|\defdoublelangentry|来实现,例如: \begin{example}{设置关联条目的动态方法}{eg:related:dynamic} \begin{texlist} \defdoublelangentry{易仕和2013--}{Yi2013--} @@ -2038,7 +2168,7 @@ language={chinese} 使用该命令后,可以引用主条目“易仕和2013--”生成双语文献。 但要注意由于\verb|\DeclareStyleSourcemap|命令只能在导言区中使用, -因此\verb|\defdoublelangentry|命令也只能出现在导言区中,这也是相比条目集动态方法的唯一遗憾。 +因此\verb|\defdblanentry|或\verb|\defdoublelangentry|命令也只能出现在导言区中,这也是相比条目集动态方法的唯一遗憾。 实现的具体细节见 \href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}% {biblatex-solution-to-latex-bibliography}。 @@ -2303,11 +2433,16 @@ bib文件中的参考文献信息是以条目形式组织,一篇文献创建 需要注意的是, \begin{itemize} - \item note域在本样式中也做特殊用途,即在book类型的note域中输入standard表示标准,在aritcle类型的note域中输入news或newspaper表示报纸,当然也可以不做特殊用,而只是表示杂项信息。因为报纸和标准也可以在entrysubtype域中输入new|newspaper和standard表示,或者标准和报纸直接用standard 和newspaper 类型表示,尽管这两种类型不是biblatex 原生支持的条目类型。 + \item note域在本样式中也做特殊用途,即在book类型的note域中输入standard表示标准,在aritcle类型的note域中输入news或newspaper表示报纸。 + 当然也可以不做特殊用,而只是表示杂项信息,因为报纸和标准也可以在entrysubtype域中输入new或newspaper和standard表示报纸和标准类型,亦或者直接用standard 和newspaper 类型表示两者,尽管这两种类型不是biblatex 原生支持的条目类型。 - \item usera域用于表示参考文献类型和载体标识符(为兼容Lee zeping 的bst样式使用的bib文件也可以用mark和medium 表示)。一般情况下usera,mark,medium这些域不用在bib文件中输入,而由样式文件自动处理得到,既为了使bib文件更纯粹,也为了兼容不同的样式。想象一下如果在bib文件中给出usera域,但另一样式需要使用usera域且用途不同,那么就会有兼容性问题。不用手动输入更重要的目的是为用户减负,因为用户可以直接使用从网络(各种学术网站)导出参考文献信息而不用再额外添加一个参考文献类型和载体标识符。 + \item usera域用于表示参考文献类型和载体标识符(为兼容Lee zeping 的bst样式使用的bib文件也可以用mark和medium 表示)。一般情况下usera,mark,medium这些域不用在bib文件中输入,而由样式文件自动处理得到,既为了使bib文件更纯粹,也为了兼容不同的样式。 + %想象一下如果在bib文件中给出usera域,但另一样式需要使用usera域且用途不同,那么就会有兼容性问题。不用手动输入更重要的目的是为用户减负,因为用户可以直接使用从网络(各种学术网站)导出参考文献信息而不用再额外添加一个参考文献类型和载体标识符。 + 因此,用户可以直接使用从网络(各种学术网站)导出参考文献本身的信息而不用再额外手动添加参考文献类型和载体标识符。 - \item 本样式自动判断语言,用户一般不需要直接给出表示文献语言的域language,因为样式在处理过程中会对各个域的字符做语言判断,这对于一篇文献存在多种语言的情况非常有用,比如一本英文著作被翻译为中文,原作者仍用英文,而译者则使用中文。那么该文献无法用一个language 标识文献的语言,简单来说,标记language域更多的目的是用在多种语言混合的文档中,可以用language 来标记英语、中文、日语、法语和俄语等用于分文种排序。当然这种标记也是由样式自动处理的,用户仅需在自动判断出现问题时手动干预。 + \item 本样式自动判断语言,用户一般不需要直接给出表示文献语言的域language,因为样式在处理过程中会对各个域的字符做语言判断,这对于一篇文献存在多种语言的情况非常有用,比如一本英文著作被翻译为中文,原作者仍用英文,而译者则使用中文。那么该文献无法用一个language 标识文献的语言,但会对不同的域如作者和译者做额外的判断,从而使输出的格式正确。 + 所以,使用language域更多的是用于多种语言混合文献表的排序,即用language 来标记英语、中文、日语、法语和俄语等用于分文种排序。 + %当然这种标记也是由样式自动处理的,用户仅需在自动判断出现问题时手动干预。 \end{itemize} @@ -2433,7 +2568,7 @@ bib文件中的参考文献信息是以条目形式组织,一篇文献创建 -\subsection{其它注意事项}\label{sec:pkg:hints} +\subsection{其它事项}\label{sec:pkg:hints} \begin{enumerate} \item biblatex 的优点 @@ -3057,7 +3192,7 @@ gb7714-2015实现了GB/T 7714-2015第8.8节要求的析出文献相关格式。 %读者若查看样式文件内容可以看到作者对各目标要求所做的修改及,读者也可以根据自己的需求进行修改,作者设计样式文件的思路以及在设计过程中用到的一些biblatex宏包功能说明,详见第\ref{sec:biblatex:mech}节和LaTeX文档中文参考文献的biblatex解决方案的第2.7节。 最后要感谢如下各位师长和朋友,正是在各位的帮助建议下,本样式不断升级逐渐完善。包括: moewew (biblatex 现在的维护者之一,给予不少有益的建议和指导)、 李志奇(基于biblatex的符合GBT7714-2005的中文文献生成工具的作者,工具中的一些设计如usera域的使用/卷期范围解析等带来很多启发,本人之前一直使用该工具,之所以开发biblatex-gb7714-2015其实主要是因为该工具因biblatex升级而无法使用)、caspervector(虽然未曾真正交流,但从biblatex-caspervector样式包中学到很多,包括排序/GBK编码等问题的解决思路)、LeoLiu(刘海洋,给出的CJK字符判断函数 -\footnote{\url{http://bbs.ctex.org/forum.php?mod=viewthread&tid=152663&extra=page\%3D3}} 对本宏包非常有帮助)、chinatex(china tex版主,给了很多建议和帮助,并且一起合作)、Sheng wenbo(biblatex用户手册合作译者,LaTeX2e 插图指南第三版译者,我们一起翻译的过程相互激励相互促进)、zepinglee(gbt7714-2015 bst样式作者,给了很多建议和讨论)、Harry Chen(ctex套件维护者之一,给了不少好的建议)、liubenyuan(关于项目组织给出了很好的建议)、刘小涛(讨论了关于zotero的使用并提出了建议)、ghiclgi(讨论了GB中著者-出版年制标注标签的一些问题)、邓东升(很很多建议和讨论)、秀文工作组、leipility、qingkuan、湘厦人、秋平、任蒲军、fredericky123、qiuzhu、chaoxiaosu、Old Jack、Wu Nailong、Yibai Zhang、wayne508、 钟乙源、Xiaodong Yao、dsycircle、rpjshu、zjsdut、谢澜涛、Zutian Luo、海阔天空、zzqzyx、程晨、xmtangjun、蔡伟 等等。当然还有更多朋友提供了bug报告,提出了issue,提供了热心帮助,限于篇幅这里不再一一列举,在此一并表示感谢! +\footnote{\url{http://bbs.ctex.org/forum.php?mod=viewthread&tid=152663&extra=page\%3D3}} 对本宏包非常有帮助)、chinatex(china tex版主,给了很多建议和帮助,并且一起合作)、Sheng wenbo(biblatex用户手册合作译者,LaTeX2e 插图指南第三版译者,我们一起翻译的过程相互激励相互促进)、zepinglee(gbt7714-2015 bst样式作者,给了很多建议和讨论)、Harry Chen(ctex套件维护者之一,给了不少好的建议)、liubenyuan(关于项目组织给出了很好的建议)、刘小涛(讨论了关于zotero的使用并提出了建议)、ghiclgi(讨论了GB中著者-出版年制标注标签的一些问题)、邓东升(很多建议和讨论)、秀文工作组、leipility、qingkuan、湘厦人、秋平、任蒲军、fredericky123、qiuzhu、chaoxiaosu、Old Jack、Wu Nailong、Yibai Zhang、wayne508、 钟乙源、Xiaodong Yao、dsycircle、rpjshu、zjsdut、谢澜涛、Zutian Luo、海阔天空、zzqzyx、程晨、xmtangjun、蔡伟 等等。当然还有更多朋友提供了bug报告,提出了issue,提供了热心帮助,限于篇幅这里不再一一列举,在此一并表示感谢! \section{存在的问题和下一步工作} diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.bbx index cba4e06459..a8031346b2 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.bbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.bbx @@ -27,6 +27,11 @@ \DeclareBibliographyOption{gbpunctcn}[true]{%biblatex低版本 \ifstrequal{#1}{false}{\execgbpuncten}{}} +\newtoggle{bbx:gbvolnum} +\DeclareBibliographyOption{gbvolnum}[false]{% + \settoggle{bbx:gbvolnum}{#1}} + \ExecuteBibliographyOptions{gbvolnum} + \newbibmacro*{bbx:ifmergeddate}{\@secondoftwo} \newbibmacro*{date+extradate}{} @@ -41,18 +46,12 @@ {\printdateextra} {\printlabeldateextra}}}}% \renewbibmacro*{bbx:ifmergeddate}{\iflabeldateisdate}% -% \renewbibmacro*{issue+date}{% -% \ifboolexpr{test {\usebibmacro{bbx:ifmergeddate}} -% and -% test {\iffieldundef{issue}}} -% {} -% {\printtext[parens]{% -% \printfield{issue}% -% \setunit*{\addspace}% -% \usebibmacro{bbx:ifmergeddate} -% {} -% {\printdate}}}% -% \newunit} + \renewbibmacro*{issue+date}{%去掉括号 + \iffieldundef{issue} + {\usebibmacro{date}}% + {\iftoggle{bbx:gbstrict}{}{\printfield{issue}% + \setunit*{\addspace}}% + \usebibmacro{date}}}% } @@ -91,6 +90,7 @@ dateabbrev=false, maxbibnames=99, mergedate=true, + gbfootbibfmt =true, %datezeros=false, } @@ -122,7 +122,7 @@ \def\gbpunctttr{》}% } -\DefineBibliographyExtras{english}{\renewcommand*{\bibrangedash}{$\sim$}}%将页码间隔符替换会英文的短横线 +\DefineBibliographyExtras{english}{\renewcommand*{\bibrangedash}{\textasciitilde}}%将页码间隔符替换会英文的短横线 %================================================== %为标注和文献表中标点格式,重设and本地化字符串 @@ -130,10 +130,10 @@ \DefineBibliographyStrings{english}{ and = { and},%and后面的空格在finalnamedelim已经加过了,所以这里去掉20191009 andcn = {\gbpunctmark\unspace},%\gbpunctmark - %andotherscn={等}, mathesiscn={硕士学位论文}, phdthesiscn={博士学位论文}, bytranslator= {trans\adddot\ \lbx@sfromlang\ by}, + in={in\space}, } @@ -153,7 +153,10 @@ \DeclareFieldFormat[article,incollection,inbook,inproceedings,misc]{title}{% \iffieldequalstr{userd}{chinese}{\gbpunctttl#1\gbpunctttr}{\mkbibquote{#1}\isdot}} \DeclareFieldFormat*{journaltitle}{% -\iffieldequalstr{userd}{chinese}{\gbpunctttl#1\gbpunctttr}{\textbf{\textit{#1}}}}% +\iffieldequalstr{userd}{chinese}{\gbpunctttl#1\gbpunctttr}% +{\iffieldequalstr{entrysubtype}{workpaper}{#1}% +{\textbf{\textit{#1}}}% +}}% \DeclareFieldFormat{booktitle}{% \iffieldequalstr{userd}{chinese}{\gbpunctttl#1\gbpunctttr}{\textbf{\textit{#1}}}} \renewcommand*{\revsdnamepunct}{% @@ -216,9 +219,10 @@ % 调整页码前的标点和去掉期刊文章等页码后面的标点 % \renewbibmacro*{note+pages}{%源来自standard.bbx -% \iffieldundef{postnote}{\iffieldundef{pages}{}{% -% \setunit{\bibpagespunct}% -% \printfield{pages}}}{}% +\iffieldequalstr{userd}{chinese}{}% + {\iffieldundef{pages}{}{% + \setunit{\bibpagespunct}% + \printfield{pages}}}% } @@ -239,7 +243,13 @@ \printdelim{finalpunct}} %调整标注的注释中的条目结尾标点 \DeclareDelimFormat{finalpunct}{\iffieldequalstr{userd}{chinese}{\gbpunctdot}{\adddot}} -\DeclareDelimFormat[fullinnercite]{finalpunct}{} +%注意由于usedriver中biblatex自动把\finenty定义为\blx@finentry@usedrv +%而\blx@finentry@usedrv的标点默认设置为空,所以userdriver最后本来没有标点 +%这里将其恢复成文献表中的标点\blx@imc@finentry,所以会与文献表一致 +\AtUsedriver{% + \let\finentry\blx@imc@finentry%\blx@finentry@usedrv +} + %出版项中:出版社地址后面的标点 \renewcommand{\publocpunct}{% @@ -408,7 +418,9 @@ \renewbibmacro*{in:}{% -\iftoggle{bbx:gbpunctin}{\gbpunctcomma}%\addthinspace +\iftoggle{bbx:gbpunctin}{\iffieldequalstr{userd}{chinese}% + {\gbpunctcomma}% + {\newunit\printtext{\bibstring{in}}}}%\addthinspace {\setunit{\adddot\addspace}% \iffieldequalstr{userd}{chinese}% {\gbpunctcomma}% @@ -431,11 +443,12 @@ \printtext{\bibstring{serialcn}\addthinspace\arabic{numberwithoutzero} 期}}% {\printtext{\bibstring{serialcn}\addthinspace #1 期}}% }}% - {\newunit\setcounter{numberwithoutzero}{#1}\printtext{\bibstring{number}}\arabic{numberwithoutzero}}% + {\setcounter{numberwithoutzero}{#1}\printtext{\bibstring{number}}~\arabic{numberwithoutzero}}% } \DeclareFieldFormat[book,inbook,incollection,misc]{number}% -{\iffieldequalstr{userd}{chinese}{\iffieldint{number}% +{\iffieldequalstr{userd}{chinese} + {\iffieldint{number}% {% \bibstring{serialcn}#1\bibstring{numbercn}% }{#1}% @@ -516,13 +529,31 @@ \iffieldequalstr{userd}{chinese}% {\iffieldundef{volume}{}{\printfield{volume}}% \iffieldundef{number}{}{\printfield{number}}}%区别于顺序编码制 - {\newunit\printfield{volume}% - \printfield{number}% - \setunit{\addcomma\space}% + {\newunit% + \iftoggle{bbx:gbvolnum}% + {\usebibmacro{gb+volume+number}}% + {\iffieldundef{volume}{}{\printfield{volume}}% + \newunit\iffieldundef{number}{}{\printfield{number}}}% \printfield{eid}}% } +\DeclareFieldFormat{plainvolume}{#1}% + + +\newbibmacro*{gb+volume+number} +{% +\ifboolexpr{ + not test {\iffieldundef{volume}} and not test {\iffieldundef{number}} + } + {\printfield[plainvolume]{volume}\printfield[parens]{number}} + {% + \iffieldundef{volume}{}{\printfield{volume}}% + \iffieldundef{number}{}{\printfield{number}}% + }% +} + + % % 期刊的标题做修改 % diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.cbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.cbx index d8a89fb535..9b21ea69f4 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.cbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/chinese-jmw.cbx @@ -78,6 +78,13 @@ \DeclareDelimFormat[parencite]{andothersdelim}{\iffieldequalstr{userf}{chinese}{}{\addspace}}% +%去掉footfullcite后面的点 +%注意由于usedriver中biblatex自动把\finenty设置为空,所以userdriver最后本来没有标点 +%默认了加了period所以把它去掉 +\renewcommand{\bibfootnotewrapper}[1]{% + \bibsentence#1}% + + %标注压缩时,直接用date+extradate代替extradate实现2006a,2006b的效果 %\DeclareDelimFormat*{compcitedelim}{\gbpunctmarkcite}%\addcomma\addspace \newbibmacro*{cite:extradate}{% diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.bbx index b5233fc1f9..d68a55d403 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.bbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.bbx @@ -11,7 +11,7 @@ % % 版本和时间信息 % -\def\versionofgbtstyle{2023/04/24 v1.1m} +\def\versionofgbtstyle{2023/05/24 v1.1n} \def\versionofbiblatex{\abx@version} \ProvidesFile{gb7714-2015.bbx}[\versionofgbtstyle biblatex bibliography style] %\RequireBiber[3]%显式指定用biber后端,当用bibtex时会报错,但其实不会影响编译,只是采用bibtex后无法达成格式需求 @@ -215,14 +215,21 @@ %% 20220625,hzz,v1.1i \newlength{\BracketLift} \setlength{\BracketLift}{0.0ex} -\renewcommand*{\bibleftparen}{\blx@postpunct\raise\BracketLift\hbox{(}} -\renewcommand*{\bibrightparen}{\blx@postpunct\raise\BracketLift\hbox{)}\midsentence} -\renewcommand*{\bibleftbracket}{\blx@postpunct\raise\BracketLift\hbox{[}} -\renewcommand*{\bibrightbracket}{\blx@postpunct\raise\BracketLift\hbox{]}\midsentence} -\newcommand*{\gbleftparen}{\raise\BracketLift\hbox{(}} -\newcommand*{\gbrightparen}{\raise\BracketLift\hbox{)}} -\newcommand*{\gbleftbracket}{\raise\BracketLift\hbox{[}} -\newcommand*{\gbrightbracket}{\raise\BracketLift\hbox{]}} +%如下4个字符可以做全局性的改变,无论是在citation还是bibliography中 +\def\CharParenLeft{(} +\def\CharParenRight{)} +\def\CharBracketLeft{[} +\def\CharBracketRight{]} +%如下4个用于改变biblatex提供的括号命令中的字符的位置抬升 +\renewcommand*{\bibleftparen}{\blx@postpunct\raise\BracketLift\hbox{\CharParenLeft}} +\renewcommand*{\bibrightparen}{\blx@postpunct\raise\BracketLift\hbox{\CharParenRight}\midsentence} +\renewcommand*{\bibleftbracket}{\blx@postpunct\raise\BracketLift\hbox{\CharBracketLeft}} +\renewcommand*{\bibrightbracket}{\blx@postpunct\raise\BracketLift\hbox{\CharBracketRight}\midsentence} +%如下4个用于改变biblatex-gb7714-2015相关的括号命令中的字符的位置抬升 +\newcommand*{\gbleftparen}{\raise\BracketLift\hbox{\CharParenLeft}} +\newcommand*{\gbrightparen}{\raise\BracketLift\hbox{\CharParenRight}} +\newcommand*{\gbleftbracket}{\raise\BracketLift\hbox{\CharBracketLeft}} +\newcommand*{\gbrightbracket}{\raise\BracketLift\hbox{\CharBracketRight}} %===================================================================== @@ -689,7 +696,10 @@ %为数字标签格式选择增加的计数器/命令 \newcommand{\mkgbnumlabel}[1]{\mkbibbrackets{#1}} \def\gbbiblabelopt@bracket{\renewcommand{\mkgbnumlabel}[1]{\mkbibbrackets{##1}}} + \def\gbbiblabelopt@bracketqj{\renewcommand{\mkgbnumlabel}[1]{【##1】}} + \def\gbbiblabelopt@quanjiao{\renewcommand{\mkgbnumlabel}[1]{【##1】}} \def\gbbiblabelopt@parens{\renewcommand{\mkgbnumlabel}[1]{\mkbibparens{##1}}} + \def\gbbiblabelopt@parensqj{\renewcommand{\mkgbnumlabel}[1]{(##1)}} \def\gbbiblabelopt@dot{\renewcommand{\mkgbnumlabel}[1]{##1\adddot}} \def\gbbiblabelopt@plain{\renewcommand{\mkgbnumlabel}[1]{##1}} \def\gbbiblabelopt@box{\renewcommand{\mkgbnumlabel}[1]{\framebox{##1}}} @@ -801,6 +811,7 @@ \ifstrequal{#1}{right}{\setcounter{gbalignlabel}{0}}{} \ifstrequal{#1}{left}{\setcounter{gbalignlabel}{1}}{} \ifstrequal{#1}{center}{\setcounter{gbalignlabel}{2}}{} + \ifstrequal{#1}{centpos}{\setcounter{gbalignlabel}{3}}{} \ifstrequal{#1}{gb7714-2015}{\setaligngbstyle}{} \ifstrequal{#1}{gb7714-2015ay}{\setaligngbstyleay}{} } @@ -845,6 +856,7 @@ \ifstrequal{#1}{right}{\setcounter{gbalignlabel}{0}}{} \ifstrequal{#1}{left}{\setcounter{gbalignlabel}{1}}{} \ifstrequal{#1}{center}{\setcounter{gbalignlabel}{2}}{} + \ifstrequal{#1}{centpos}{\setcounter{gbalignlabel}{3}}{} \ifstrequal{#1}{gb7714-2015}{}{} \ifstrequal{#1}{gb7714-2015ay}{\setaligngbstyleay}{} } @@ -2229,6 +2241,8 @@ test {\iftoggle{iftlseven}}%biblatex<=3.7 \mkgbnumlabel{#1}\hfill% \or%中间对齐,比如:序号数字居于[]中间 \hfil\mkgbnumlabel{\hfill#1\hfill}\hfil% +\or%中间对齐,但是整个标签位于中间,比如:[1]位于中间 + \hfil\mkgbnumlabel{#1}\hfil% \fi} % @@ -3185,6 +3199,7 @@ test {\iftoggle{iftlseven}}%biblatex<=3.7 } } } + \let\defdblanentry=\defdoublelangentry } % diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.cbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.cbx index 7c39e23385..7d9d75eefe 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.cbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015.cbx @@ -58,6 +58,18 @@ \renewrobustcmd{\mkbibleftborder}{\gbleftparen}% \renewrobustcmd{\mkbibrightborder}{\gbrightparen}% } +\def\gbcitelabelopt@parensqj{% +\renewrobustcmd{\mkbibleftborder}{\allowbreak(}% +\renewrobustcmd{\mkbibrightborder}{)\unspace}% +} +\def\gbcitelabelopt@bracketqj{% +\renewrobustcmd{\mkbibleftborder}{\allowbreak【}% +\renewrobustcmd{\mkbibrightborder}{】\unspace}% +} +\def\gbcitelabelopt@quanjiao{% +\renewrobustcmd{\mkbibleftborder}{\allowbreak(}% +\renewrobustcmd{\mkbibrightborder}{)\unspace}% +} \def\gbcitelabelopt@dot{% \renewrobustcmd{\mkbibleftborder}{}% \renewrobustcmd{\mkbibrightborder}{.}% @@ -100,12 +112,13 @@ % 20210121,v1.0w,hzz % \iftoggle{iftlatest}% -{\renewbibmacro*{textcite}{% +{% +\renewbibmacro*{textcite}{% \iffieldequals{namehash}{\cbx@lasthash} {\usebibmacro{cite:comp}} {\usebibmacro{cite:dump}% \ifbool{cbx:parens} - {\printtext{\bibclosebracket}\global\boolfalse{cbx:parens}} + {\printtext{\mkbibrightborder}\global\boolfalse{cbx:parens}}%\bibclosebracket {}% \iffirstcitekey {} @@ -115,14 +128,37 @@ {\printfield[citetitle]{labeltitle}} {\iftoggle{bbx:gblabelref}{\printtext[bibhyperref]{\printnames{labelname}}}{\printnames{labelname}}}% \setunit*{\printdelim{namelabeldelim}}% - \printtext{\bibopenbracket}\global\booltrue{cbx:parens}% + \printtext{\mkbibleftborder}\global\booltrue{cbx:parens}%\bibopenbracket \ifnumequal{\value{citecount}}{1} {\usebibmacro{prenote}} {}% \usebibmacro{cite:comp}% \stepcounter{textcitecount}% - \savefield{namehash}{\cbx@lasthash}}}% - } + \savefield{namehash}{\cbx@lasthash}}} +%这是老版本的textcite,上面是新版本的,使用新版本后,对于老版本的biblatex的兼容性可能会受影响 +%\renewbibmacro*{textcite}{% +% \iffieldequals{namehash}{\cbx@lasthash} +% {\usebibmacro{cite:comp}} +% {\usebibmacro{cite:dump}% +% \ifbool{cbx:parens} +% {\printtext{\mkbibrightborder}\global\boolfalse{cbx:parens}}%\bibclosebracket +% {}% +% \iffirstcitekey +% {} +% {\setunit{\textcitedelim}}% +% \usebibmacro{cite:init}% +% \ifnameundef{labelname} +% {\printfield[citetitle]{labeltitle}} +% {\iftoggle{bbx:gblabelref}{\printtext[bibhyperref]{\printnames{labelname}}}{\printnames{labelname}}}% +% \setunit*{\printdelim{namelabeldelim}}% +% \printtext{\mkbibleftborder}\global\booltrue{cbx:parens}%\bibopenbracket +% \ifnumequal{\value{citecount}}{1} +% {\usebibmacro{prenote}} +% {}% +% \usebibmacro{cite:comp}% +% \stepcounter{textcitecount}% +% \savefield{namehash}{\cbx@lasthash}}}% +} % @@ -178,7 +214,7 @@ % 定义一个上标方括号wrapper % \newcommand*\mkbibsuperbracket[1]{% - \mkbibsuperscript{\mkbibbrackets{#1}}% + \mkbibsuperscript{\mkbibleftborder{#1}\mkbibrightborder}% } % 修改postnote的输出格式 @@ -201,7 +237,7 @@ \begingroup% \protected\long\def\mkbibsuperscriptusp##1{% \blx@warning{Nested superscript}% - \mkbibbrackets{##1}}% + \mkbibleftborder{##1}\mkbibrightborder}% #1\endgroup}} @@ -243,7 +279,7 @@ % 重定义parencite命令,以满足标签带页码的国标要求 % \DeclareCiteCommand{\parencite}%[\mkbibbrackets] - {\addspace\mkbibleftborder\usebibmacro{cite:init}% + {\mkbibleftborder\usebibmacro{cite:init}% \usebibmacro{prenote}}% {\usebibmacro{citeindex}% \usebibmacro{cite:comp}} @@ -352,7 +388,8 @@ {\usebibmacro{cite:comp}}% {\usebibmacro{cite:dump}% \ifbool{cbx:parens}% - {\mkbibsuperscript{{\hspace{-0.075em}\bibclosebracket}}\global\boolfalse{cbx:parens}}%\printtext + {\mkbibsuperscript{{\hspace{-0.075em}\mkbibrightborder}}%\bibclosebracket + \global\boolfalse{cbx:parens}}%\printtext {}% \iffirstcitekey {} @@ -362,7 +399,8 @@ {\printfield[citetitle]{labeltitle}} {\printnames{labelname}}% %\setunit*{\printdelim{namelabeldelim}}% - \mkbibsuperscript{\printtext{\bibopenbracket}\global\booltrue{cbx:parens}% + \mkbibsuperscript{\printtext{\mkbibleftborder}%\bibopenbracket + \global\booltrue{cbx:parens}% \ifnumequal{\value{citecount}}{1} {\usebibmacro{prenote}}% {}% @@ -378,11 +416,13 @@ {}% {\ifbool{cbx:incitet}% {\mkbibsuperscript{\usebibmacro{cite:dump}\usebibmacro{postnote}% - \ifbool{cbx:parens}{\hspace{-0.075em}\bibclosebracket\global\boolfalse{cbx:parens}}{}% + \ifbool{cbx:parens}{\hspace{-0.075em}\mkbibrightborder%\bibclosebracket + \global\boolfalse{cbx:parens}}{}% }% }% {\usebibmacro{cite:dump}\usebibmacro{postnote}% - \ifbool{cbx:parens}{\bibclosebracket\global\boolfalse{cbx:parens}}{}% + \ifbool{cbx:parens}{\mkbibrightborder%\bibclosebracket + \global\boolfalse{cbx:parens}}{}% }% } diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.bbx index a1f7a23492..3ebe52afca 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.bbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.bbx @@ -10,7 +10,7 @@ % % 版本和时间信息 % -\def\versionofgbtstyle{2023/04/24 v1.1m} +\def\versionofgbtstyle{2023/05/24 v1.1n} \def\versionofbiblatex{\abx@version} \ProvidesFile{gb7714-2015ay.bbx}[\versionofgbtstyle biblatex bibliography style] %\RequireBiber[3]%显式指定用biber后端,当用bibtex时会报错,但其实不会影响编译,只是采用bibtex后无法达成格式需求 @@ -212,14 +212,21 @@ %% 20220625,hzz,v1.1i \newlength{\BracketLift} \setlength{\BracketLift}{0.0ex} -\renewcommand*{\bibleftparen}{\blx@postpunct\raise\BracketLift\hbox{(}} -\renewcommand*{\bibrightparen}{\blx@postpunct\raise\BracketLift\hbox{)}\midsentence} -\renewcommand*{\bibleftbracket}{\blx@postpunct\raise\BracketLift\hbox{[}} -\renewcommand*{\bibrightbracket}{\blx@postpunct\raise\BracketLift\hbox{]}\midsentence} -\newcommand*{\gbleftparen}{\raise\BracketLift\hbox{(}} -\newcommand*{\gbrightparen}{\raise\BracketLift\hbox{)}} -\newcommand*{\gbleftbracket}{\raise\BracketLift\hbox{[}} -\newcommand*{\gbrightbracket}{\raise\BracketLift\hbox{]}} +%如下4个字符可以做全局性的改变,无论是在citation还是bibliography中 +\def\CharParenLeft{(} +\def\CharParenRight{)} +\def\CharBracketLeft{[} +\def\CharBracketRight{]} +%如下4个用于改变biblatex提供的括号命令中的字符的位置抬升 +\renewcommand*{\bibleftparen}{\blx@postpunct\raise\BracketLift\hbox{\CharParenLeft}} +\renewcommand*{\bibrightparen}{\blx@postpunct\raise\BracketLift\hbox{\CharParenRight}\midsentence} +\renewcommand*{\bibleftbracket}{\blx@postpunct\raise\BracketLift\hbox{\CharBracketLeft}} +\renewcommand*{\bibrightbracket}{\blx@postpunct\raise\BracketLift\hbox{\CharBracketRight}\midsentence} +%如下4个用于改变biblatex-gb7714-2015相关的括号命令中的字符的位置抬升 +\newcommand*{\gbleftparen}{\raise\BracketLift\hbox{\CharParenLeft}} +\newcommand*{\gbrightparen}{\raise\BracketLift\hbox{\CharParenRight}} +\newcommand*{\gbleftbracket}{\raise\BracketLift\hbox{\CharBracketLeft}} +\newcommand*{\gbrightbracket}{\raise\BracketLift\hbox{\CharBracketRight}} %===================================================================== @@ -634,7 +641,10 @@ %为数字标签格式选择增加的计数器/命令 \newcommand{\mkgbnumlabel}[1]{\mkbibbrackets{#1}} \def\gbbiblabelopt@bracket{\renewcommand{\mkgbnumlabel}[1]{\mkbibbrackets{##1}}} + \def\gbbiblabelopt@bracketqj{\renewcommand{\mkgbnumlabel}[1]{【##1】}} + \def\gbbiblabelopt@quanjiao{\renewcommand{\mkgbnumlabel}[1]{【##1】}} \def\gbbiblabelopt@parens{\renewcommand{\mkgbnumlabel}[1]{\mkbibparens{##1}}} + \def\gbbiblabelopt@parensqj{\renewcommand{\mkgbnumlabel}[1]{(##1)}} \def\gbbiblabelopt@dot{\renewcommand{\mkgbnumlabel}[1]{##1\adddot}} \def\gbbiblabelopt@plain{\renewcommand{\mkgbnumlabel}[1]{##1}} \def\gbbiblabelopt@box{\renewcommand{\mkgbnumlabel}[1]{\framebox{##1}}} @@ -744,6 +754,7 @@ \ifstrequal{#1}{right}{\setcounter{gbalignlabel}{0}\setaligngbnumeric}{} \ifstrequal{#1}{left}{\setcounter{gbalignlabel}{1}\setaligngbnumeric}{} \ifstrequal{#1}{center}{\setcounter{gbalignlabel}{2}\setaligngbnumeric}{} + \ifstrequal{#1}{centpos}{\setcounter{gbalignlabel}{3}\setaligngbnumeric}{} \ifstrequal{#1}{gb7714-2015}{\setaligngbstyle}{} \ifstrequal{#1}{gb7714-2015ay}{}{}%默认就是ay样式的 }% @@ -791,6 +802,7 @@ \ifstrequal{#1}{right}{\setcounter{gbalignlabel}{0}\setaligngbnumeric}{} \ifstrequal{#1}{left}{\setcounter{gbalignlabel}{1}\setaligngbnumeric}{} \ifstrequal{#1}{center}{\setcounter{gbalignlabel}{2}\setaligngbnumeric}{} + \ifstrequal{#1}{centpos}{\setcounter{gbalignlabel}{3}\setaligngbnumeric}{} \ifstrequal{#1}{gb7714-2015}{\setaligngbstyle}{} \ifstrequal{#1}{gb7714-2015ay}{}{} }% @@ -2005,6 +2017,7 @@ } } } + \let\defdblanentry=\defdoublelangentry } @@ -2103,6 +2116,8 @@ test {\iftoggle{iftlseven}}%biblatex<=3.7 \mkgbnumlabel{#1}\hfill% \or%中间对齐,比如:序号数字居于[]中间 \hfil\mkgbnumlabel{\hfill#1\hfill}\hfil% +\or%中间对齐,但是整个标签位于中间,比如:[1]位于中间 + \hfil\mkgbnumlabel{#1}\hfil% \fi} % diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.cbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.cbx index 454e5cc7e6..739528dc1b 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.cbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ay.cbx @@ -28,6 +28,9 @@ % 增加标签包围符号格式处理选项 % 20211030,1.1a,hzz % +\def\gbpunctcommacite{\addcomma\addspace} +\def\gbpunctmarkcite{\addcomma\addspace}% +\def\gbpunctsemicoloncite{\addsemicolon\addspace} \newrobustcmd{\mkbibleftborder}{\gbleftparen} \newrobustcmd{\mkbibrightborder}{\gbrightparen} \DeclareBibliographyOption[string]{gbcitelabel}[bracket]{% @@ -43,6 +46,21 @@ \renewrobustcmd{\mkbibleftborder}{\gbleftparen}% \renewrobustcmd{\mkbibrightborder}{\gbrightparen}% } +\def\gbcitelabelopt@parensqj{% +\renewrobustcmd{\mkbibleftborder}{\allowbreak(}% +\renewrobustcmd{\mkbibrightborder}{)\unspace}% +} +\def\gbcitelabelopt@bracketqj{% +\renewrobustcmd{\mkbibleftborder}{\allowbreak【}% +\renewrobustcmd{\mkbibrightborder}{】\unspace}% +} +\def\gbcitelabelopt@quanjiao{% +\renewrobustcmd{\mkbibleftborder}{\allowbreak(}% +\renewrobustcmd{\mkbibrightborder}{)\unspace}% +\def\gbpunctcommacite{,}% +\def\gbpunctmarkcite{、}% +\def\gbpunctsemicoloncite{;}% +} \def\gbcitelabelopt@dot{% \renewrobustcmd{\mkbibleftborder}{}% \renewrobustcmd{\mkbibrightborder}{.}% @@ -116,14 +134,20 @@ test {\iftoggle{iftlseven}}%3.7=biblatex % v1.0t,20200320,hzz,修改如下 % 在cbx中增加标注中的nameyeardelim标点定义,避免bbx使用其它样式时出现问题 % 同时设置textcite的nameyeardelim为一个短空格,似乎原来直接连上去的不够美观 -\DeclareDelimFormat[cite,parencite,pagescite]{nameyeardelim}{\addcomma\space}%\addcomma\space -\DeclareDelimFormat[textcite]{nameyeardelim}{\addthinspace}%\addcomma\space -\DeclareDelimFormat[textcite]{andothersdelim}{\iffieldequalstr{userf}{chinese}{\addthinspace}{\addspace}}% -\AtEveryCitekey{% -\iffieldequalstr{userf}{chinese}{\renewcommand*{\andothersdelim}{\addthinspace}}%\addthinspace - {\renewcommand*{\andothersdelim}{\addspace}}% -} -\newcommand{\compextradelim}{\addcomma\addthinspace} %标注中压缩后相同年份后附加标签a、b之间的标点 +\renewcommand*{\multicitedelim}{\gbpunctsemicoloncite}%\addsemicolon\addspace; +\renewcommand*{\compcitedelim}{\gbpunctmarkcite} +\newcommand{\compextradelim}{\gbpunctcommacite} %标注中压缩后相同年份后附加标签a、b之间的标点 +\DeclareDelimFormat[cite,parencite,pagescite,citep]{nameyeardelim}{\gbpunctcommacite}%\addcomma\space +\DeclareDelimFormat[textcite,authornumcite,citet]{nameyeardelim}{\addthinspace}%\addcomma\space +\DeclareDelimFormat[cite,parencite,pagescite,citep]{andothersdelim} + {\iffieldequalstr{userf}{chinese}{\addthinspace}{\addspace}}% +\DeclareDelimFormat[textcite,authornumcite,citet]{andothersdelim} + {\iffieldequalstr{userf}{chinese}{\addthinspace}{\addspace}}% +%\AtEveryCitekey{% +%\iffieldequalstr{userf}{chinese}{\renewcommand*{\andothersdelim}{\addthinspace}}%\addthinspace +% {\renewcommand*{\andothersdelim}{\addspace}}% +%} + % % 修订使可用选项gblabelref来控制是否将标准标签中的作者加上超链接 @@ -152,12 +176,12 @@ test {\iftoggle{iftlseven}}%3.7=biblatex {\usebibmacro{cite:shorthand}% \usebibmacro{cite:reinit}}% \setunit{\multicitedelim}} -\renewbibmacro*{textcite}{% +\newbibmacro*{textcite}{% \iffieldequals{namehash}{\cbx@lasthash} {\iffieldundef{shorthand} {\ifthenelse{\iffieldequals{labelyear}{\cbx@lastyear}\AND \(\value{multicitecount}=0\OR\iffieldundef{postnote}\)} - {\setunit{\compextradelim}% + {\setunit{\addcomma}% \usebibmacro{cite:extradate}} {\setunit{\compcitedelim}% \usebibmacro{cite:labeldate+extradate}% @@ -170,7 +194,7 @@ test {\iftoggle{iftlseven}}%3.7=biblatex {\usebibmacro{cite:label}% \setunit{% \global\booltrue{cbx:parens}% - \printdelim{nonameyeardelim}\bibopenparen}% + \printdelim{nonameyeardelim}\mkbibleftborder}%\bibopenparen \ifnumequal{\value{citecount}}{1} {\usebibmacro{prenote}} {}% @@ -179,7 +203,7 @@ test {\iftoggle{iftlseven}}%3.7=biblatex {\iftoggle{bbx:gblabelref}{\printtext[bibhyperref]{\printnames{labelname}}}{\printnames{labelname}}% \setunit{% \global\booltrue{cbx:parens}% - \printdelim{nameyeardelim}\bibopenparen}% + \printdelim{nameyeardelim}\mkbibleftborder}%\bibopenparen \ifnumequal{\value{citecount}}{1} {\usebibmacro{prenote}} {}% @@ -194,9 +218,69 @@ test {\iftoggle{iftlseven}}%3.7=biblatex \savefield{namehash}{\cbx@lasthash}}% \setunit{% \ifbool{cbx:parens} - {\bibcloseparen\global\boolfalse{cbx:parens}} + {\mkbibrightborder\global\boolfalse{cbx:parens}}%\bibcloseparen {}% - \textcitedelim}}}{} + \textcitedelim}} +\newbibmacro*{textcite:postnote}{% + \usebibmacro{postnote}% + \ifthenelse{\value{multicitecount}=\value{multicitetotal}} + {\setunit{}% + \printtext{% + \ifbool{cbx:parens} + {\mkbibrightborder\global\boolfalse{cbx:parens}}%\bibcloseparen + {}}} + {\setunit{% + \ifbool{cbx:parens} + {\mkbibrightborder\global\boolfalse{cbx:parens}}%\bibcloseparen + {}% + \textcitedelim}}} +%这是老版本的textcite,上面是新版本的,使用新版本后,对于老版本的biblatex的兼容性可能会受影响 +%\renewbibmacro*{textcite}{% +% \iffieldequals{namehash}{\cbx@lasthash} +% {\iffieldundef{shorthand} +% {\ifthenelse{\iffieldequals{labelyear}{\cbx@lastyear}\AND +% \(\value{multicitecount}=0\OR\iffieldundef{postnote}\)} +% {\setunit{\compextradelim}% +% \usebibmacro{cite:extradate}} +% {\setunit{\compcitedelim}% +% \usebibmacro{cite:labeldate+extradate}% +% \savefield{labelyear}{\cbx@lastyear}}} +% {\setunit{\compcitedelim}% +% \usebibmacro{cite:shorthand}% +% \global\undef\cbx@lastyear}} +% {\ifnameundef{labelname} +% {\iffieldundef{shorthand} +% {\usebibmacro{cite:label}% +% \setunit{% +% \global\booltrue{cbx:parens}% +% \printdelim{nonameyeardelim}\bibopenparen}%\bibopenparen\mkbibleftborder +% \ifnumequal{\value{citecount}}{1} +% {\usebibmacro{prenote}} +% {}% +% \usebibmacro{cite:labeldate+extradate}} +% {\usebibmacro{cite:shorthand}}} +% {\iftoggle{bbx:gblabelref}{\printtext[bibhyperref]{\printnames{labelname}}}{\printnames{labelname}}% +% \setunit{% +% \global\booltrue{cbx:parens}% +% \printdelim{nameyeardelim}\bibopenparen}%\mkbibleftborder +% \ifnumequal{\value{citecount}}{1} +% {\usebibmacro{prenote}} +% {}% +% \iffieldundef{shorthand} +% {\iffieldundef{labelyear} +% {\usebibmacro{cite:label}} +% {\usebibmacro{cite:labeldate+extradate}}% +% \savefield{labelyear}{\cbx@lastyear}} +% {\usebibmacro{cite:shorthand}% +% \global\undef\cbx@lastyear}}% +% \stepcounter{textcitecount}% +% \savefield{namehash}{\cbx@lasthash}}% +% \setunit{% +% \ifbool{cbx:parens} +% {\bibcloseparen\global\boolfalse{cbx:parens}}%\bibcloseparen\mkbibrightborder +% {}% +% \textcitedelim}}% +}{} @@ -229,6 +313,7 @@ test {\iftoggle{iftlseven}}%3.7=biblatex {\mkbibrightborder\mkbibsuperscript{\usebibmacro{postnote}}%\usebibmacro{postnote} } + % % 定义upcite命令 % 20180604,v1.0l,hzz @@ -332,7 +417,7 @@ test {\iftoggle{iftlseven}}%3.7=biblatex \savefield{labelyear}{\cbx@lastyear}}} {\iftoggle{bbx:gblabelref}{\printtext[bibhyperref]{\printnames{labelname}}}{\printnames{labelname}}%% %\setunit{\printdelim{nameyeardelim}}% - \gbleftparen\usebibmacro{cite:labeldate+extradate}\gbrightparen% + \mkbibleftborder\usebibmacro{cite:labeldate+extradate}\mkbibrightborder% \savefield{namehash}{\cbx@lasthash}% \savefield{labelyear}{\cbx@lastyear}}}} {\usebibmacro{cite:shorthand}% @@ -385,11 +470,11 @@ test {\iftoggle{iftlseven}}%3.7=biblatex {\setunit{}% \printtext{% \ifbool{cbx:parens} - {\bibcloseparen\global\boolfalse{cbx:parens}} + {\mkbibrightborder\global\boolfalse{cbx:parens}}%\bibcloseparen {}}} {\setunit{% \ifbool{cbx:parens} - {\bibcloseparen\global\boolfalse{cbx:parens}} + {\mkbibrightborder\global\boolfalse{cbx:parens}}%\bibcloseparen {}% \textcitedelim}}% \renewbibmacro*{postnote}{% diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ms.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ms.bbx index f60044ae8a..fe97e02286 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ms.bbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015ms.bbx @@ -1786,6 +1786,7 @@ } } } + \let\defdblanentry=\defdoublelangentry % 关联文献的输出格式 % diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015mx.bbx b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015mx.bbx index 7f090e434a..e829ef3c3a 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015mx.bbx +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/gb7714-2015mx.bbx @@ -2359,6 +2359,7 @@ } } } + \let\defdblanentry=\defdoublelangentry % % 关联文献间的分隔符 diff --git a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/makeall.py b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/makeall.py index b783537cb5..10b5db33dc 100644 --- a/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/makeall.py +++ b/macros/latex/contrib/biblatex-contrib/biblatex-gb7714-2015/makeall.py @@ -20,7 +20,9 @@ def compileall(): pwd=os.getcwd() filesneedcopy=['gb7714-CCNU.bbx','gb7714-CCNU.cbx','gb7714-NWAFU.bbx','gb7714-NWAFU.cbx','gb7714-SEU.bbx','gb7714-SEU.cbx', - 'chinese-erj.bbx','chinese-erj.cbx','chinese-css.bbx','chinese-css.cbx','example.bib', 'gb7714-1987.bbx', 'gb7714-1987.cbx', + 'chinese-erj.bbx','chinese-erj.cbx','chinese-css.bbx','chinese-css.cbx', + 'chinese-jmw.bbx','chinese-jmw.cbx', + 'example.bib', 'gb7714-1987.bbx', 'gb7714-1987.cbx', 'gb7714-1987ay.bbx', 'gb7714-1987ay.cbx', 'gb7714-2005.bbx', 'gb7714-2005.cbx', 'gb7714-2005ay.bbx', 'gb7714-2005ay.cbx', 'gb7714-2015-gbk.def', 'gb7714-2015.bbx', 'gb7714-2015.cbx', 'gb7714-2015ay.bbx', 'gb7714-2015ay.cbx', 'gb7714-2015ms.bbx', 'gb7714-2015ms.cbx', 'gb7714-2015mx.bbx', 'gb7714-2015mx.cbx'] diff --git a/macros/latex/contrib/listlbls/Makefile b/macros/latex/contrib/listlbls/Makefile index 20ecc6f468..64df745ce7 100644 --- a/macros/latex/contrib/listlbls/Makefile +++ b/macros/latex/contrib/listlbls/Makefile @@ -1,13 +1,17 @@ -NAME = listlbls -SHELL = bash -PWD = $(shell pwd) -TEMP := $(shell mktemp -d) -TDIR = $(TEMP)/$(NAME) -VERS = $(shell ltxfileinfo -v $(NAME).dtx) -LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL) -UTREE = $(shell kpsewhich --var-value TEXMFHOME) - -all: $(NAME).pdf README.md README clean +NAME = listlbls +SHELL = bash +PWD = $(shell pwd) +TEMP := $(shell mktemp -d) +TDIR = $(TEMP)/$(NAME) +VERS = $(shell ltxfileinfo -v $(NAME).dtx) +LOCAL = $(shell kpsewhich --var-value TEXMFLOCAL) +UTREE = $(shell kpsewhich --var-value TEXMFHOME) +PREFIX ?= $(LOCAL) +LATEX = xelatex +SUDO = sudo + +all: $(NAME).pdf README.md README + $(MAKE) clean README: README.txt cp README.txt README @@ -17,11 +21,12 @@ README.txt: $(NAME).pdf README.md: $(NAME).pdf $(NAME).pdf: $(NAME).dtx - xelatex -shell-escape -recorder -interaction=batchmode $(NAME).dtx >/dev/null + $(LATEX) -shell-escape -recorder $(NAME).dtx if [ -f $(NAME).glo ]; then makeindex -q -s gglo.ist -o $(NAME).gls $(NAME).glo; fi if [ -f $(NAME).idx ]; then makeindex -q -s gind.ist -o $(NAME).ind $(NAME).idx; fi - xelatex -shell-escape -recorder -interaction=nonstopmode $(NAME).dtx > /dev/null - xelatex -shell-escape -recorder -interaction=nonstopmode $(NAME).dtx > /dev/null + $(LATEX) -shell-escape -recorder -interaction=scrollmode $(NAME).dtx + $(LATEX) -shell-escape -recorder -interaction=scrollmode $(NAME).dtx + $(LATEX) -shell-escape -recorder -interaction=scrollmode $(NAME).dtx clean: rm -f *.fls @@ -31,16 +36,13 @@ distclean: clean rm -f $(NAME).{pdf,sty} README{,.{md,txt}} inst: all - mkdir -p $(UTREE)/{tex,source,doc}/latex/$(NAME) - cp $(NAME).dtx $(UTREE)/source/latex/$(NAME) - cp $(NAME).sty $(UTREE)/tex/latex/$(NAME) - cp $(NAME).pdf $(UTREE)/doc/latex/$(NAME) + $(MAKE) install PREFIX=$(UTREE) SUDO="" install: all - sudo mkdir -p $(LOCAL)/{tex,source,doc}/latex/$(NAME) - sudo cp $(NAME).dtx $(LOCAL)/source/latex/$(NAME) - sudo cp $(NAME).sty $(LOCAL)/tex/latex/$(NAME) - sudo cp $(NAME).pdf $(LOCAL)/doc/latex/$(NAME) + $(SUDO) mkdir -p $(PREFIX)/{tex,source,doc}/latex/$(NAME) + $(SUDO) cp $(NAME).dtx $(PREFIX)/source/latex/$(NAME) + $(SUDO) cp $(NAME).sty $(PREFIX)/tex/latex/$(NAME) + $(SUDO) cp $(NAME).pdf $(PREFIX)/doc/latex/$(NAME) zip: all mkdir $(TDIR) diff --git a/macros/latex/contrib/listlbls/listlbls.dtx b/macros/latex/contrib/listlbls/listlbls.dtx index 52da33c381..a52b55a6cf 100644 --- a/macros/latex/contrib/listlbls/listlbls.dtx +++ b/macros/latex/contrib/listlbls/listlbls.dtx @@ -120,17 +120,17 @@ Running "make install" installs the files in the local TeX tree. %\NeedsTeXFormat{LaTeX2e}[1999/12/01] %\ProvidesPackage{listlbls} %<*package> - [2014/08/04 v1.03 Creates a list of all labels used throughout a document] + [2023/05/24 v1.04 Creates a list of all labels used throughout a document] % %<*driver> \documentclass{ltxdoc} \usepackage{microtype} -\usepackage{libertine} -\usepackage[a4paper,margin=25mm,left=50mm,nohead]{geometry} -\usepackage{colordoc} +\usepackage{lmodern} +\usepackage{fontawesome5} +\usepackage[a4paper,margin=25mm,left=45mm,nohead]{geometry} \usepackage{multicol} -\usepackage{dox} -\doxitem{Option}{option}{option} +\usepackage[reportchangedates]{doc} +\usepackage{dtxdescribe} \usepackage[numbered]{hypdoc} \usepackage{xspace} \usepackage{nameref} @@ -140,6 +140,10 @@ Running "make install" installs the files in the local TeX tree. \CodelineIndex \RecordChanges \newcommand\TSE{\href{http://tex.stackexchange.com/}{\TeX-Stackexchange}\xspace} + +\newcommand\link[2]{\href{#1}{#2}\footnote{\nolinkurl{#1}}} +\newcommand\ghissue[3]{\link{https://github.com/#1/#2/issues/#3}{\faIcon{github}~#1/#2\##3}} +\newcommand\thisissue[1]{\ghissue{nobbz}{listlbls}{#1}} \begin{document} \DocInput{\jobname.dtx} \end{document} @@ -160,9 +164,11 @@ Running "make install" installs the files in the local TeX tree. %\changes{v1.00}{2014/07/25}{First public release} %\changes{v1.01}{2014/07/25}{Changed maintainer email} %\changes{v1.01}{2014/07/25}{Changed some internal stuff to make it releaseable on CTAN} -%\changes{v1.02}{2014/07/26}{Local option wins agains global option} +%\changes{v1.02}{2014/07/27}{Local option wins agains global option} %\changes{v1.02}{2014/07/27}{Added languag-support for English, German and French.} %\changes{v1.03}{2014/08/04}{Proceeding with namespacing internal macros} +%\changes{v1.04}{2023/05/24}{Fix build problems due to bitrotten dependencies} +%\changes{v1.04}{2023/05/24}{Switch back to lmodern for documentation} % \begin{abstract} % This is a package meant to help a \LaTeX-writer to keep track all the defined labels by typesetting a complete list of labels whereever the author requests it. Keep in mind, that you might need to have additional \LaTeX\ runs to get the references right. % @@ -183,8 +189,10 @@ Running "make install" installs the files in the local TeX tree. % \subsection{From Github}\label{ssec:inst-gh} % % \begin{enumerate} -% \item Check out the sourcecode from \href{https://github.com/}{GitHub}:\\ -% |git clone git@github.com:NobbZ/listlbls.git| +% \item Check out the sourcecode from \link{https://github.com/}{GitHub}:\\ +% |git clone https://github.com/NobbZ/nixos-config.git| or\\ +% |git clone git@github.com:NobbZ/listlbls.git| or\\ +% |gh repo clone NobbZ/listlbls| % \item Switch to the source-folder:\\|cd listlbls| % \item Checkout the branch/tag you desire: |master| for latest release, |develop| for latest builds (might be broken) or the version number desired.\\ % |git checkout | @@ -240,9 +248,12 @@ Running "make install" installs the files in the local TeX tree. % % Then anywhere in your document, you can use the |\listoflabels|-macro to typeset a list of labels. An example can be seen on page \pageref{special:listoflabels}. % -% \DescribeMacro{\label} Use |\label| as you are used to it! +% \DescribeMacro{\label} \marg{name} +% Use |\label| as you are used to it! % -% \DescribeMacro{\listoflabels} This macro will typeset the list of labels when this module is in draft mode. It will itself register the label ``|special:listoflabels|''. +% \DescribeMacro{\listoflabels} \oarg{label} +% This macro will typeset the list of labels when this module is in draft mode. +% It will itself register the label from the optional arg, defaulting to ``|special:listoflabels|''. % %\StopEventually{^^A % \PrintChanges @@ -254,11 +265,11 @@ Running "make install" installs the files in the local TeX tree. % % \section{Contribution and bugreports}\label{sec:contribute} % -% If you have feature-requests or bug-reports, please feel free to report them on the \href{https://github.com/NobbZ/listlbls}{project page at GitHub}. +% If you have feature-requests or bug-reports, please feel free to report them on the \link{https://github.com/NobbZ/listlbls}{project page at GitHub}. % % If you want to contribute then follow these steps: % \begin{enumerate} -% \item Visit the \href{https://github.com/NobbZ/listlbls}{project page at GitHub}, +% \item Visit the \link{https://github.com/NobbZ/listlbls}{project page at GitHub}, % \item forkt it, % \item clone it to your local machine, % \item create a branch ``|feature/|\meta{feature name}'', @@ -268,6 +279,17 @@ Running "make install" installs the files in the local TeX tree. % \item and wait for approval. % \end{enumerate} % After approval your code will be merged to the |development|-branch and I will generally not accept pull-requests that edit |develop| directly. +% +% \section{Known issues and limitations}\label{sec:issues} +% \changes{v1.04}{2023/05/24}{Add issues and limitations section} +% +% \subsection{\texttt{\textbackslash{}include}}\label{ssec:issues-include} +% +% Documents containing |\include| will not work. +% Currently there is no logic to recurse through the different |.aux|-files. +% +% Please see \thisissue{4} for more information. +% % \section{Implementation}\label{sec:implementation} % % \begin{macrocode} @@ -280,7 +302,7 @@ Running "make install" installs the files in the local TeX tree. % \subsection{Options}\label{ssec:impl-options} % \begin{option}{draft} % \changes{v1.01}{2014/07/25}{Added option} -% \changes{v1.02}{2014/07/26}{Introduced @ifdraft} +% \changes{v1.02}{2014/07/27}{Introduced @ifdraft} % Check for |draft|-option: % \begin{macrocode} \DeclareOption{draft}{\llbls@drafttrue} @@ -288,21 +310,21 @@ Running "make install" installs the files in the local TeX tree. % \end{option} % \begin{option}{final} % \changes{v1.01}{2014/07/25}{Added option} -% \changes{v1.02}{2014/07/26}{Introduced @ifdraft} +% \changes{v1.02}{2014/07/27}{Introduced @ifdraft} % Check for |final|-option: % \begin{macrocode} \DeclareOption{final}{\llbls@draftfalse} % \end{macrocode} % \end{option} % \begin{option}{totoc} -% \changes{v1.02}{2014/07/26}{Added option} +% \changes{v1.02}{2014/07/27}{Added option} % Check for |totoc|-option: % \begin{macrocode} \DeclareOption{totoc}{\llbls@totoctrue} % \end{macrocode} % \end{option} % \begin{option}{notoc} -% \changes{v1.02}{2014/07/26}{Added option} +% \changes{v1.02}{2014/07/27}{Added option} % Check for |notoc|-option: % \begin{macrocode} \DeclareOption{notoc}{\llbls@totocfalse} @@ -368,14 +390,27 @@ Running "make install" installs the files in the local TeX tree. {llbls-onpage}% {\`a la page} % \end{macrocode} +% \subsubsection{Portuguese}\label{sssec:impl-i18n-pt} +% \changes{v1.04}{2023/05/24}{Add Portuguese translation} +% \begin{macrocode} +\DeclareTranslation{Portuguese}% + {llbls-listoflabels}% + {Lista de R\'{o}tulos} +\DeclareTranslation{Portuguese}% + {llbls-onpage}% + {na p\'{a}gina} +% \end{macrocode} % \subsection{Internal stuff}\label{ssec:impl-internal} % \begin{macro}{\llbls@headline}\begin{macro}{\llbls@toccommand}\begin{macro}{\llbls@tocgroup} % Determine if we have |\chapter|s or not and create a command that maps to |\chapter| or |\section| as needed. % \begin{macrocode} -\ifdefined\chapter* +\ifdefined\chapter \ifllbls@numtoc \def\llbls@headline{% - \chapter{List of Labels}\label{special:listoflabels}} +% \end{macrocode} +% We are using |\llbls@labelname| here and in the other possible definitions of |\llbls@headline| to be able to set the label name in the |\listoflabels| macro. +% \begin{macrocode} + \chapter{List of Labels}\label{\llbls@labelname}} \else \def\llbls@toccommand{\chapter*} \def\llbls@tocgroup{chapter} @@ -383,7 +418,7 @@ Running "make install" installs the files in the local TeX tree. \else \ifllbls@numtoc \def\llbls@headline{% - \section{List of Labels}\label{special:listoflabels}} + \section{List of Labels}\label{\llbls@labelname}} \else \def\llbls@toccommand{\section*} \def\llbls@tocgroup{section} @@ -392,7 +427,7 @@ Running "make install" installs the files in the local TeX tree. \ifdefined\llbls@headline\else \def\llbls@headline{% \llbls@toccommand{\GetTranslation{llbls-listoflabels}}% - \label{special:listoflabels}% + \label{\llbls@labelname}% \ifllbls@totoc% \addcontentsline{toc}% {\llbls@tocgroup}% @@ -428,7 +463,7 @@ Running "make install" installs the files in the local TeX tree. % \end{macro} % % \begin{macro}{\llbls@showlabel} -% \changes{v1.03}{2014/07/27}{Add support for nameref-package} +% \changes{v1.02}{2014/08/04}{Add support for nameref-package} % Displays a single entry in the |\listoflabels| % \begin{macrocode} \def\llbls@showlabel#1#2{% @@ -454,13 +489,16 @@ Running "make install" installs the files in the local TeX tree. \ifllbls@draft % \end{macrocode} % \begin{macro}{\listoflabels} +% \changes{v1.04}{2023/05/24}{add optional argument to change the name of the label used.} +% \begin{macro}{\llbls@labelname} % Print a list of all available lables that are defined throughout the document. % \begin{macrocode} - \newcommand\listoflabels{% + \newcommand{\listoflabels}[1][special:listoflabels]{% + \def\llbls@labelname{#1}% \llbls@headline% \the\llbls@lablist} % \end{macrocode} -% \end{macro} +% \end{macro}\end{macro} % \begin{macrocode} \else \let\listoflabels=\relax diff --git a/macros/latex/contrib/listlbls/listlbls.pdf b/macros/latex/contrib/listlbls/listlbls.pdf index 15a732d799..537f54e51a 100644 Binary files a/macros/latex/contrib/listlbls/listlbls.pdf and b/macros/latex/contrib/listlbls/listlbls.pdf differ diff --git a/macros/latex/contrib/nicematrix/nicematrix-code.dtx b/macros/latex/contrib/nicematrix/nicematrix-code.dtx index 4c28160949..93555aa1e5 100644 --- a/macros/latex/contrib/nicematrix/nicematrix-code.dtx +++ b/macros/latex/contrib/nicematrix/nicematrix-code.dtx @@ -17,8 +17,8 @@ % % \fi % \iffalse -\def\myfileversion{6.19} -\def\myfiledate{2023/05/15} +\def\myfileversion{6.19a} +\def\myfiledate{2023/05/25} % % %<*batchfile> @@ -1743,7 +1743,10 @@ version 2005/12/01 or later. \seq_map_indexed_inline:Nn \g_@@_notes_seq { \tl_if_eq:nnT { { #1 } { #2 } } { ##2 } - { \int_set:Nn \l_tmpa_int { ##1 } \seq_map_break: } + { + \int_set:Nn \l_tmpa_int { ##1 } + \seq_map_break: + } } \int_compare:nNnF \l_tmpa_int = \c_zero_int { \int_add:Nn \l_tmpa_int \g_@@_notes_caption_int } @@ -1829,31 +1832,20 @@ version 2005/12/01 or later. { \int_gzero:N \c@tabularnote } % \end{macrocode} % Now, we try to detect duplicate notes in the caption. +% Be careful! We must put |\tl_if_in:NnF| and not |\tl_if_in:NnT|! % \begin{macrocode} - \bool_set_false:N \l_tmpa_bool - \seq_map_inline:Nn \g_@@_notes_in_caption_seq - { \@@_if_eq_two_three:nnn ##1 { #2 } } -% \end{macrocode} -% Be careful! We must put |\bool_if:NF| and not |\bool_if:NT|! -% \begin{macrocode} - \bool_if:NF \l_tmpa_bool + \seq_if_in:NnF \g_@@_notes_in_caption_seq { { #1 } { #2 } } { \@@_error:n { Identical~notes~in~caption } } } { % \end{macrocode} % In the following code, we are in the first composition of the caption or at -% the first |\tabularnote| of the second composition. We have -% to see whether the text of our tabular note is among the texts of the -% tabularnotes stored in |\g_@@_notes_in_caption_seq|. For that, we will loop on -% |\g_@@_notes_in_caption_seq| and we will raise |\l_tmpa_bool| if the text is found. +% the first |\tabularnote| of the second composition. % \begin{macrocode} - \bool_set_false:N \l_tmpa_bool - \seq_map_inline:Nn \g_@@_notes_in_caption_seq - { \@@_if_eq_two_three:nnn ##1 { #2 } } - \bool_if:NTF \l_tmpa_bool + \seq_if_in:NnTF \g_@@_notes_in_caption_seq { { #1 } { #2 } } { % \end{macrocode} -% Now, we known that are in the second composition of the caption since we are +% Now, we know that are in the second composition of the caption since we are % reading a tabular note which has yet been read. Now, the value of % |\g_@@_notes_caption_int| won't change anymore: it's the number of uses % \emph{without optional argument} of the command |\tabularnote| in the caption. @@ -1884,16 +1876,6 @@ version 2005/12/01 or later. } % \end{macrocode} % -% \begin{macrocode} -\cs_new_protected:Npn \@@_if_eq_two_three:nnn #1 #2 #3 - { - \tl_if_eq:nnT { #2 } { #3 } - { - \bool_set_true:N \l_tmpa_bool - \seq_map_break: - } - } -% \end{macrocode} % % \begin{macrocode} \cs_new_protected:Npn \@@_count_novalue_first:nn #1 #2 @@ -9218,7 +9200,8 @@ version 2005/12/01 or later. % % In the |\CodeAfter|, the command |\@@_line:nn| will be linked to |\line|. This % command takes two arguments which are the specifications of two cells in the -% array (in the format $i$-$j$) and draws a dotted line between these cells. +% array (in the format $i$-$j$) and draws a dotted line between these cells. In +% fact, if also works with names of blocks. % % \medskip % First, we write a command with the following behaviour: @@ -9284,7 +9267,10 @@ version 2005/12/01 or later. { \@@_error:nnn { unknown~cell~for~line~in~CodeAfter } { #1 } { #2 } } - { \@@_draw_line_ii:nn { #1 } { #2 } } +% \end{macrocode} +% The test of |measuring@| is a security (cf. question 686649 on TeX StackExchange). +% \begin{macrocode} + { \legacy_if:nF { measuring@ } { \@@_draw_line_ii:nn { #1 } { #2 } } } } % \end{macrocode} % diff --git a/macros/latex/contrib/nicematrix/nicematrix-code.pdf b/macros/latex/contrib/nicematrix/nicematrix-code.pdf index 6cc99d6835..923fd4f553 100644 Binary files a/macros/latex/contrib/nicematrix/nicematrix-code.pdf and b/macros/latex/contrib/nicematrix/nicematrix-code.pdf differ diff --git a/macros/latex/contrib/nicematrix/nicematrix-french.pdf b/macros/latex/contrib/nicematrix/nicematrix-french.pdf index fcc05694fd..d7c7d18c98 100644 Binary files a/macros/latex/contrib/nicematrix/nicematrix-french.pdf and b/macros/latex/contrib/nicematrix/nicematrix-french.pdf differ diff --git a/macros/latex/contrib/nicematrix/nicematrix-french.tex b/macros/latex/contrib/nicematrix/nicematrix-french.tex index 1b5bf2b9df..b27ce64a4e 100644 --- a/macros/latex/contrib/nicematrix/nicematrix-french.tex +++ b/macros/latex/contrib/nicematrix/nicematrix-french.tex @@ -1808,7 +1808,10 @@ l'extension \pkg{xcolor} ; rowcolor}, etc.)} \colorbox{yellow!50}{\textbf{Nouveau 6.18}} -une spécification d'opacité selon la forme \texttt{opacity = \textsl{valeur}}. +une spécification d'opacité selon la forme \texttt{opacity = + \textsl{valeur}}.\footnote{Attention : cette fonctionnalité génère des instructions de + transparence dans le \textsc{pdf} résultant et certains lecteurs de + \textsc{pdf} n'acceptent pas la transparence.} \end{itemize} diff --git a/macros/latex/contrib/nicematrix/nicematrix.pdf b/macros/latex/contrib/nicematrix/nicematrix.pdf index 474dac2ee0..9f3a9dfb70 100644 Binary files a/macros/latex/contrib/nicematrix/nicematrix.pdf and b/macros/latex/contrib/nicematrix/nicematrix.pdf differ diff --git a/macros/latex/contrib/nicematrix/nicematrix.tex b/macros/latex/contrib/nicematrix/nicematrix.tex index 6cf322afa9..f09d282e10 100644 --- a/macros/latex/contrib/nicematrix/nicematrix.tex +++ b/macros/latex/contrib/nicematrix/nicematrix.tex @@ -1755,7 +1755,9 @@ by a comma) the extension \pkg{xcolor}; \item \index{opacity (key of commands such as\newline \texttt{\textbackslash rowcolor}, etc.)} \colorbox{yellow!50}{\textbf{New 6.18}}\par\nobreak -a specification of opacity f the form \texttt{opacity = \textsl{value}}. +a specification of opacity of the form \texttt{opacity = + \textsl{value}}.\footnote{Caution : that feature creates instructions of + transparency in the \textsc{pdf} and some \textsc{pdr} don't support such instructions.} \end{itemize} \bigskip diff --git a/macros/latex/contrib/oststud/hsrstud-classes.pdf b/macros/latex/contrib/oststud/hsrstud-classes.pdf index 29590a39a7..8fc79d86d6 100644 Binary files a/macros/latex/contrib/oststud/hsrstud-classes.pdf and b/macros/latex/contrib/oststud/hsrstud-classes.pdf differ diff --git a/macros/latex/contrib/oststud/hsrstud.pdf b/macros/latex/contrib/oststud/hsrstud.pdf index cf1ad1e27f..0f3a59381e 100644 Binary files a/macros/latex/contrib/oststud/hsrstud.pdf and b/macros/latex/contrib/oststud/hsrstud.pdf differ diff --git a/macros/latex/contrib/oststud/oststud.dtx b/macros/latex/contrib/oststud/oststud.dtx index 35539e7b19..c9aadcfbb8 100644 --- a/macros/latex/contrib/oststud/oststud.dtx +++ b/macros/latex/contrib/oststud/oststud.dtx @@ -19,7 +19,7 @@ %\NeedsTeXFormat{LaTeX2e}[2005/12/01] %\ProvidesPackage{oststud} %<*package> - [2023/04/18 v0.3 OST Student's package] + [2023/05/20 v0.4 OST Student's package] % % %<*driver> @@ -27,6 +27,7 @@ \usepackage{oststud} \usepackage{enumitem} +\usepackage{esint} \usepackage{tikz} \usepackage{framed} \usepackage[ @@ -50,6 +51,7 @@ % \changes{v0.1}{2022/11/18}{Initial version} % \changes{v0.2}{2022/11/22}{Port features of \texttt{hsrstud}} % \changes{v0.3}{2023/04/18}{Cleanup for CTAN upload} +% \changes{v0.4}{2023/05/20}{Fix probability operators and improve documentation} % % \GetFileInfo{oststud.dtx} % @@ -87,8 +89,12 @@ % derivatives. Instead the symbols \(\vec{\nabla}, \vec{\nabla}\dotp, % \vec{\nabla}\crossp, \nabla^2, \vec{\nabla}^2\) are be replaced with % grad, div, curl and div grad. -% \item[|bfemph|] \textit{Work in progress.} -% \item[|bbprobability|] \textit{Work in progress.} +% \item[|bfemph|] Change the behaviour of |\emph| to use a bold font for +% emphasis (instead of italics). This option cannot be used together +% with the |dontrenew| option. +% \item[|bbprobability|] Use blackboard symbols $\mathbb{P}$, $\mathbb{E}$ +% and $\mathbb{V}$ instead of Pr, E and Var for the probability, +% expectation and variance respectively. % \item[|scrtransforms|] \textit{Work in progress.} % \end{description} % @@ -106,6 +112,9 @@ % arrow ($\oldvec{u}$) is replaced by bold and the arrow notation saved in % |\oldvec|. In vector calculus it is common to denote unit vectors by putting % a hat, so there is a macro |\uvec| that does just that: +% ^^A \begin{leftbar} +% ^^A |\uvec{u} = \vec{u}/u| +% ^^A \end{leftbar} % \[ % \uvec{u} = \vec{u}/u. % \] @@ -115,6 +124,9 @@ % To differentiate the dot and cross products (between vectors) from normal % product between scalars ($a \cdot b$ and $a \times b$), the macros |\dotp| % and |\crossp| provide a bold variant: +% \begin{leftbar} +% |\vec{u} \dotp \vec{v}, \vec{u} \crossp \vec{v}| +% \end{leftbar} % \[ % \vec{u} \dotp \vec{v}, \qquad % \vec{u} \crossp \vec{v}. @@ -133,6 +145,9 @@ % divergence and the symbol $\divsymb$ is saved in |\divsymb|. For a scalar % field $\phi$ or a vector field $\vec{F}$ the notation (in order) of the % gradient, divergence and curl appear as follows: +% \begin{leftbar} +% |\grad \phi, \div \vec{F}, \curl \vec{F}| +% \end{leftbar} % \[ % \grad \phi, \quad % \div \vec{F}, \quad @@ -143,6 +158,9 @@ % \DescribeMacro{\vlaplacian} % Continuing with the (ab)use of the ``Nabla'' or ``Del'' notation, the % there is a macro |\laplacian| for the Laplacian operator +% \begin{leftbar} +% |\laplacian \equiv \div \grad \equiv \sum_i \partial^2_i| +% \end{leftbar} % \[ % \laplacian \equiv \div \grad \equiv \sum_i \partial^2_i. % \] @@ -191,9 +209,15 @@ % \DescribeMacro{\tr} % This package also provides a macro for the trace of a matrix. % -% \subsection{Complex Numbers} +% \subsection{Mathematical Programming} % +% \DescribeMacro{\argmin} +% \DescribeMacro{\argmax} % ^^A TODO: write section +% \textit{Work in progress.} +% +% \subsection{Complex Numbers} +% % \DescribeMacro{\Re} % \DescribeMacro{\Im} % AMS maths's default notation for the real and imaginary parts of a complex @@ -206,17 +230,76 @@ % % \subsection{Probability Operators} % -% ^^A TODO: write section -% \textit{Work in progress.} +% \DescribeMacro{\Pr} +% \DescribeMacro{\E} +% \DescribeMacro{\Var} +% Since according to quantum mechanics it seems that ultimately the universe +% can only be described using probabilities there are the operators |\Pr|, |\E| +% and |\Var| for the probability, expectation and variance respectively. If the +% |dontrenew| option is set, the probability is defined in the csname |\P|. +% +% All three operators take an argument \marg{expression} which is automatically +% surrounded using curly braces. If the expression contains multiple random +% variables, to disambiguate with respect to which variable the operation is +% being taken it is possible to specify an optional argument \oarg{rv}. An +% example: +% \begin{leftbar} +% |\E[x]{g(x)} = \int_\mathcal{X} g(\bar{x}) p_x(\bar{x}) \, d\bar{x}| +% \end{leftbar} +% \[ +% \E[x]{g(x)} = \int_\mathcal{X} g(\bar{x}) p_x(\bar{x}) \, d\bar{x}. +% \] +% +% Because some people like to use the blackboard font for the probability +% operators (such as in the machine learning community), there is an option +% |bbprobability| that changes the look of the three operators to $\mathbb{P}$, +% $\mathbb{E}$ and $\mathbb{V}$. % % \subsection{Transformation Operators} % -% ^^A TODO: write section -% \textit{Work in progress.} +% \DescribeMacro{\corresponds} +% \DescribeMacro{\rcorresponds} +% When working with transformations it is common to use the ``correspondence +% symbol'' show below for example with the Laplace transformation: +% \begin{leftbar} +% |\laplace\{f(t)\} = F(s) \corresponds f(t) \rcorresponds F(s)| +% \end{leftbar} % \[ % \laplace\{f(t)\} = F(s) \corresponds f(t) \rcorresponds F(s) % \] % +% \DescribeMacro{\fourier} +% \DescribeMacro{\ifourier} +% \DescribeMacro{\laplace} +% \DescribeMacro{\ilaplace} +% \DescribeMacro{\ztransf} +% \DescribeMacro{\iztransf} +% \DescribeMacro{\hilbert} +% As shown in the example above the for the Laplace transform operator symbol +% there is a macro |\laplace|. Similar operators are also defined for other +% transformations and their inverses. Here is their usual definition: +% \begin{align*} +% \fourier\left\{f(t)\right\}(\omega) +% &= \frac{1}{\sqrt{2\pi}} \int_\mathbb{R} f(t) e^{-i\omega t} \, dt, & +% \ifourier\left\{F(\omega)\right\}(t) +% &= \frac{1}{\sqrt{2\pi}} \int_\mathbb{R} F(\omega) e^{i\omega t} \, d\omega, \\ +% \laplace\left\{f(t)\right\}(s) +% &= \int_\mathbb{R^+} f(t) e^{-st} \, dt, & +% \ilaplace\left\{F(s)\right\}(t) +% &= \frac{1}{2\pi i}\int_{\gamma + i\mathbb{R}} F(s) e^{st} \, ds, \\ +% \ztransf \left\{f_k\right\}(z) +% &= \sum_{k \in \mathbb{Z}^+} f_k z^{-k}, & +% \iztransf \left\{F(z)\right\}(k) +% &= \frac{1}{2\pi i} \ointctrclockwise_C F(z) z^{k-1} \, dz, \\ +% \hilbert \left\{ f(t) \right\}(\tau) +% &= \mathrm{P.V.} \frac{1}{\pi} \int_\mathbb{R} \frac{f(t)}{\tau - t} \, dt, +% \end{align*} +% in order they are the Fourier transform (|\fourier|, |\ifourier|), the +% Laplace transform (|\laplace|, |\ilaplace|), the Z-transform (|\ztransf|, +% |\iztransf|), and the Hilbert transform (|\hilbert|). The Hilbert has no +% inverse since $-\hilbert \hilbert f(t) = f(t)$, tough of course one could +% write |\hilbert^{-1}| to get $\hilbert^{-1}$. +% % \subsection{References} % % ^^A TODO: write section @@ -460,11 +543,11 @@ % Expectation of a random variable. % \begin{macrocode} \ifost@bbprobability - \DeclareMathOperator{\ost@expectation}{\mathbb{E}} + \DeclareMathOperator*{\ost@expectation}{\mathbb{E}} \else - \DeclareMathOperator{\ost@expectation}{E} + \DeclareMathOperator*{\ost@expectation}{E} \fi -\newcommand{\E}[1]{\ost@expectation\left\{#1\right\}} +\newcommand*{\E}[2][]{\ost@expectation_{#1}\left\{#2\right\}} % \end{macrocode} % \end{macro} % @@ -472,11 +555,11 @@ % Variance of a random variable. % \begin{macrocode} \ifost@bbprobability - \DeclareMathOperator{\ost@variance}{\mathbb{V}} + \DeclareMathOperator*{\ost@variance}{\mathbb{V}} \else - \DeclareMathOperator{\ost@variance}{Var} + \DeclareMathOperator*{\ost@variance}{Var} \fi -\newcommand{\Var}[1]{\ost@variance\left\{#1\right\}} +\newcommand*{\Var}[2][]{\ost@variance_{#1}\left\{#2\right\}} % \end{macrocode} % \end{macro} % @@ -484,14 +567,14 @@ % Probability operator. % \begin{macrocode} \ifost@bbprobability - \DeclareMathOperator{\ost@probability}{\mathbb{P}} + \DeclareMathOperator*{\ost@probability}{\mathbb{P}} \else - \DeclareMathOperator{\ost@probability}{Pr} + \DeclareMathOperator*{\ost@probability}{Pr} \fi \ifost@dontrenew - \newcommand{\P}[1]{\ost@probability\left\{#1\right\}} + \newcommand*{\P}[2][]{\ost@probabiliy_{#1}\left\{#2\right\}} \else - \renewcommand{\Pr}[1]{\ost@probability\left\{#1\right\}} + \renewcommand*{\P}[2][]{\ost@probabiliy_{#1}\left\{#2\right\}} \fi % \end{macrocode} % \end{macro} diff --git a/macros/latex/contrib/oststud/oststud.pdf b/macros/latex/contrib/oststud/oststud.pdf index 74abd99be0..1e0148e24b 100644 Binary files a/macros/latex/contrib/oststud/oststud.pdf and b/macros/latex/contrib/oststud/oststud.pdf differ -- cgit v1.2.3