diff options
Diffstat (limited to 'Master/texmf-dist/doc/latex/biblatex-gb7714-2015/README.md')
-rw-r--r-- | Master/texmf-dist/doc/latex/biblatex-gb7714-2015/README.md | 301 |
1 files changed, 207 insertions, 94 deletions
diff --git a/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/README.md b/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/README.md index 90ae644e994..3e3af10348a 100644 --- a/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/README.md +++ b/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/README.md @@ -1,4 +1,4 @@ -<b>Date of last change: 2018-08-14 to version v1.0m</b> +<b>Date of last change: 2018-11-04 to version v1.0n</b> # biblatex-gb7714-2015: a biblatex style package @@ -12,6 +12,8 @@ Maintainer: huzhenzhen <hzzmail@163.com> Homepage: <https://github.com/hushidong/biblatex-gb7714-2015> +ctan-pkg: <https://www.ctan.org/pkg/biblatex-gb7714-2015> + License: LaTeX Project Public License 1.3 or later @@ -20,7 +22,7 @@ A biblatex implementation of the `GB/T 7714-2015` bibliography style for Chinese The biblatex-gb7714-2015 package provides an implementation of the bibliography style of the `GB/T 7714-2015` bibliography style. This implementation follows `GB/T 7714-2015` standard, and can be used simply by loading biblatex with the appropriate option ## Usage -* for numerical sequence style +* for numerical sequence style: gb7714-2015 `\usepackage[backend=biber,style=gb7714-2015]{biblatex}` @@ -56,7 +58,7 @@ The biblatex-gb7714-2015 package provides an implementation of the bibliography `gbnamefmt = pinyin` for a common Chinese style, like: ZHANG Min-li, YI Shi-he and so on. - the name format can be set per-entry using a field `nameformat`, add this field such as `nameformat={pinyin}` to an entry in the bib file to set the entry's name format. + the name format can be set per-entry using a field `nameformat`, add this field like `nameformat={pinyin}` to an entry in the bib file to set the entry's name format. `\usepackage[backend=biber,style=gb7714-2015,gbnamefmt=uppercase]{biblatex}` @@ -110,6 +112,14 @@ The biblatex-gb7714-2015 package provides an implementation of the bibliography `\usepackage[backend=biber,style=gb7714-2015,gbcodegbk=true]{biblatex}` + - add an option `gbtitlelink` to control the hyperlink of title field (This option is also for author year style): + + `gbtitlelink = false` not to add hyperlink, this is the default setting. + + `gbtitlelink = true` to set the title as a hyperlink. + + `\usepackage[backend=biber,style=gb7714-2015,gbtitlelink=true]{biblatex}` + - add an option `gbstrict` to control the output of some unnecessary fields for GB/T7714-2015 (This option is also for author year style). `gbstrict=true`, not to print those fields such as language, eprint, this is the default setting. @@ -126,15 +136,15 @@ The biblatex-gb7714-2015 package provides an implementation of the bibliography `\usepackage[backend=biber,style=gb7714-2015,gbfieldstd=true]{biblatex}` - - add an option `gbtitlelink` to control the hyperlink of title field (This option is also for author year style): - - `gbtitlelink = false` not to add hyperlink, this is the default setting. + - `gbtitlelink = true` to set the title as a hyperlink. - - `\usepackage[backend=biber,style=gb7714-2015,gbtitlelink=true]{biblatex}` +* for multi-style: gb7714-2015ms + + In order to use two styles in a tex file, add a style gb7714-2015ms. option `gbstyle` is added to control the using mode. `gbstyle=true` means all references are printed with GB/T7714-2015 style, and `gbstyle=false` means the chinese references are printed with GB/T7714-2015 style while the other references are printed with standard style shipped by biblatex, and `gbstyle=true` is the default set. all the options for numerical sequence style gb7714-2015 can also be used in gb7714-2015ms. + + `\usepackage[backend=biber,style=gb7714-2015ms,gbstyle=false]{biblatex}` -* for author year style +* for author year style: gb7714-2015ay `\usepackage[backend=biber,style=gb7714-2015ay,gbpub=true]{biblatex}` @@ -162,9 +172,10 @@ please see the file 'biblatex-gb7714-2015.pdf' for further information! * [ECNU-Undergraduate-LaTeX(华东师范大学本科毕业论文模板)](https://github.com/YijunYuan/ECNU-Undergraduate-LaTeX) * [UCASthesis(中国科学院大学学位论文模板**国科大新版标准**)](https://github.com/xiaoyao9933/UCASthesis) * [Study-LaTeX(LaTeX学习笔记)](https://github.com/Zousiyu/Study-LaTeX) -* [LaTeX-template(开箱即用的 LaTeX 模板)](https://github.com/tsai1993/LaTeX-template) * [Zhejiang University thesis(浙江大学毕业设计/论文模板)](https://github.com/TheNetAdmin/zjuthesis) * [fjnu-bathesis (福建师范大学本科毕业论文LaTeX 模板)](https://github.com/fjnuer/fjnu-bathesis) +* [Thesis-Template-for-XJTU (西安交大毕业设计模板)](https://github.com/DXie123/Thesis-Template-for-XJTU) +* [CAUTemplate(中国农业大学课程论文模板)](https://github.com/Cdmium/CAUTemplate) * [...] @@ -179,7 +190,7 @@ please see the file 'biblatex-gb7714-2015.pdf' for further information! * [biblatex-caspervector: caspervector 设计的中文参考文献样式](https://github.com/CasperVector/biblatex-caspervector) * [gbt7714-bibtex-style: GB/T7714-2015 标准的bst实现版本](https://github.com/zepinglee/gbt7714-bibtex-style) * [LaTeX学习网站](http://www.latexstudio.net/) -* [LaTeX交流论坛](http://bbs.ctex.org/) +* [LaTeX交流论坛](http://www.ctex.org/) --------------------------------------------------------- @@ -205,47 +216,67 @@ linkcolor=blue,anchorcolor=violet,citecolor=magenta]{hyperref}%加载hyperref宏 citestyle=gb7714-2015%,backref=true%%其中后端backend使用biber ]{biblatex}%标注(引用)样式citestyle,著录样式bibstyle都采用gb7714-2015样式 -\addbibresource[location=local]{example.bib}%biblatex宏包的参考文献数据源加载方式 +\usepackage{filecontents} +\begin{filecontents}{egbibdata.bib} +@Book{Peebles2001-100-100, + Title = {Probability, random variable, and random signal Principles and \LaTeX{}}, + Address = {New York}, + Author = {von Peebles, Jr., P. Z.}, + Edition = {4}, + Pages = {100}, + Publisher = {McGraw-Hill}, + Year = {2001} +} -\begin{document}%正文区开始: +@Book{蔡敏2006--, + Title = {UML基础和Rose建模教程}, + Address = {北京}, + Author = {蔡敏 and 徐慧慧 and 黄柄强}, + Publisher = {人民邮电出版社}, + Year = {2006}, + Month = {1} +} +\end{filecontents} -%正文内容,引用参考文献 +\addbibresource[location=local]{egbibdata.bib}%biblatex宏包的参考文献数据源加载方式 -1. 不带页码的引用(顺序编码制上标,方括号包围;作者年制行内,括号包围): - \cite{Peebles2001-100-100} - \upcite{Peebles2001-100-100} - \supercite{Peebles2001-100-100} +\begin{document}%正文区开始: -2. 不带页码的引用(顺序编码制非上标,方括号包围;作者年制行内,括号包围): +%正文内容,引用参考文献 - \parencite{Miroslav2004--} +1. 不带页码的引用(顺序编码制上标,方括号包围;作者年制行内,括号包围):\\ + 见文献\cite{Peebles2001-100-100}\\ + 见文献\upcite{Peebles2001-100-100}\\ + 见文献\supercite{Peebles2001-100-100} -3. 带页码的引用(标准命令,默认样式; 增加命令,GB/T 7714-2015样式): +2. 不带页码的引用(顺序编码制非上标,方括号包围;作者年制行内,括号包围):\\ + 见文献\parencite{Peebles2001-100-100} - \cite[见][49页]{蔡敏2006--} - \parencite[见][49页]{Miroslav2004--} - \pagescite{Peebles2001-100-100} - \pagescite[201-301]{Peebles2001-100-100} +3. 带页码的引用(标准命令,默认样式; 增加命令,GB/T 7714-2015样式):\\ + 见文献\cite[见][49页]{蔡敏2006--}\\ + 见文献\parencite[见][49页]{Peebles2001-100-100}\\ + 见文献\pagescite{Peebles2001-100-100}\\ + 见文献\pagescite[201-301]{Peebles2001-100-100} -4. 顺序编码制中同时输出作者和顺序编码标签,比如: - \citeauthor{蔡敏2006--}\cite{蔡敏2006--} - \authornumcite{蔡敏2006--} - \textcite{蔡敏2006--} (顺序编码标签不上标) +4. 顺序编码制中同时输出作者和顺序编码标签,比如:\\ + 见\citeauthor{蔡敏2006--}\cite{蔡敏2006--}\\ + 见\authornumcite{蔡敏2006--}\\ + 见\textcite{蔡敏2006--} (顺序编码标签不上标) -5. 作者年制文中已有作者还需要年份和页码(顺序编码制与pagescite作用相同,作者年制年份行内页码上标): - 见赵耀东\yearpagescite[][205]{赵耀东1998--}和Simon\yearpagescite[][15]{Simon2001--} +5. 作者年制文中已有作者还需要年份和页码(顺序编码制与pagescite作用相同,作者年制年份行内页码上标):\\ + 见蔡敏\yearpagescite[][205]{蔡敏2006--}和Peebles\yearpagescite[][15]{Peebles2001-100-100} -6. 作者年制文中已有作者只需要年份(顺序编码制与pagescite作用相同,作者年制年份行内): - 见赵耀东\yearcite{赵耀东1998--} - 见赵耀东(\cite*{赵耀东1998--}) - 见赵耀东(\citeyear{赵耀东1998--}) +6. 作者年制文中已有作者只需要年份(顺序编码制与pagescite作用相同,作者年制年份行内):\\ + 见赵耀东\yearcite{蔡敏2006--}\\ + 见赵耀东(\cite*{蔡敏2006--})\\ + 见赵耀东(\citeyear{蔡敏2006--}) -7. 作者年制中由标注命令给出作者年份信息,作者以主语方式作为正文内容: - \textcite{赵耀东1998--} +7. 作者年制中由标注命令给出作者年份信息,作者以主语方式作为正文内容:\\ + 见\textcite{蔡敏2006--} -8. 在页脚中引用和打印文献表: - \footnote{在脚注中引用\footcite{赵学功2001--}} - \footfullcite{赵学功2001--} +8. 在页脚中引用和打印文献表:\\ + 见文献\footnote{在脚注中引用\footcite{蔡敏2006--}}\\ + 见文献\footfullcite{蔡敏2006--} %打印参考文献表 @@ -262,10 +293,19 @@ citestyle=gb7714-2015%,backref=true%%其中后端backend使用biber xelatex jobname.tex ``` +或者 + +``` + latexmk -xelatex jobname.tex +``` + + ### 3. Recommended environment/推荐使用环境 - Texlive+Winedt - Texlive+Texstudio +- texlive及其它发行版安装见[安装指南](https://github.com/sjtug/SJTUThesis/wiki/%E4%BD%BF%E7%94%A8%E6%8C%87%E5%8D%97) + ### 4. Common questions/常见问题 @@ -314,6 +354,27 @@ citestyle=gb7714-2015%,backref=true%%其中后端backend使用biber > 由于ctex2.9套装多年未更新,其中的biblatex宏包过于陈旧,所以需要更新 biblatex。 + +* <b>请问除了利用xelatex进行编译外,能不能用pdflatex进行编译?</b> + +> 能用pdflatex进行编译,但要注意的是因为某些样式比如authoryear等使用了xstring宏包中的一些命令,所以会产生错误,但numeric类样式通常没有问题。这一问题在biblatex更新到3.12版本后取消xstring宏包后得以解决。 + +> 中文用户需要注意一些编码的问题。utf-8编码的文档,采用xelatex编译没有任何注意事项,但使用pdflatex编译时,需要给ctex宏包加载UTF8选项,比如`\usepackage[UTF8]{ctex}`或者在文档类加载时给出也可以比如`\documentclass[[UTF8]{article}`,同时引用文献时使用的引用关键词应使用英文。当文档使用其他编码时,xelatex编译通常需要指定一个文档编码,比如windows环境下的GB2312编码的文档需要指定`\XeTeXinputencoding "GBK"`, 否则显示乱码。使用pdflatex进行编译,如果biblatex不能正确的处理编码问题,那么需要为其明确的指定texencoding和bibencoding选项。比如windows环境下的GB2312编码的文档,需要指定`\usepackge[texencoding=GBK]{biblatex}`。 + + +* <b>请问使用backref=true选项后,某个反向超链接总是链接到封面页是怎么回事?</b> + +> 对页码进行正确超链接需要一个前提是,当前链接的页码是唯一的。当有两页具有相同的页码时,超链接总是链接到第一各具有该页码的页面上。比如封面页页码是1,正文第一页页码也是1,那么到正文第一页的反向超链接总会链接到封面页上。解决该问题就是要解决页码的唯一性问题。当页码的表示形式不是同一种时,那么也会得到正确的区分。比如封面页用罗马字母I表示,而正文第一页用阿拉伯数字1表示,那么就能得到正确的反向超链接。类似于: +``` +\pagenumbering{roman} +\title{title} +\maketitle +\clearpage + +\pagenumbering{arabic} +\section{文献表} +``` + * <b>我希望参考文献表中的文献不是按引用顺序而是以文献作者的字母顺序排序,怎么实现?</b> @@ -463,7 +524,20 @@ biber -l zh__stroke jobname ```\usepackage[backend=biber,bibstyle=gb7714-2015,doi=false]{biblatex}``` + +* <b>如果对当前文献中的url或doi显示效果(包括间距和断行)不满意,能否进行调整?</b> + +> 能,可以通过设置三个计数器的值来调整,取值范围0到9999,计数器的值越大则越容易在相应的内容后断行: + +``` +\setcounter{biburlnumpenalty}{100}%大于0允许在数字后面断行 +\setcounter{biburlucpenalty}{100}%大于0允许在大写字母后面断行 +\setcounter{biburllcpenalty}{100}%大于0允许在小写字母后面断行 + +``` + + * <b>当参考文献没有作者时,希望用佚名或Anon代替作者时,请问该怎么处理?</b> @@ -478,6 +552,18 @@ biber -l zh__stroke jobname > 可通过设置选项maxbibnames,minbibnames实现,比如下面的设置用于显示5个作者: ```\usepackage[backend=biber,bibstyle=gb7714-2015,maxbibnames=5,minbibnames=5]{biblatex}``` + + +* <b>请问如何将作者之间的分隔符调整为and而不是用逗号?</b> + +> 可以通过重设两个分隔符来实现,分别是multinamedelim和finalnamedelim。低版本的biblatex直接重定义命令`\multinamedelim`和`\finalnamedelim`,高版本的biblatex可以使用分隔符环境,这样可以在标注、文献表等不同位置直接使用不同的分隔符,而不像低版本biblatex那样只能在不同的位置修改局部定义。比如: + +``` +\DeclareDelimFormat[bib]{multinamedelim}{\addspace and \addspace} +\DeclareDelimFormat[bib]{finalnamedelim}{\addspace and \addspace} +\DeclareDelimFormat[cite]{multinamedelim}{\addcomma\addspace} +\DeclareDelimFormat[cite]{finalnamedelim}{\addcomma\addspace} +``` @@ -588,17 +674,91 @@ biber -l zh__stroke jobname > 可通过设置选项uniquelist=false, uniquename=false实现,该设置标签中的作者只会是指定的1个且只用该作者的姓: ```\usepackage[backend=biber,style=gb7714-2015ay,uniquelist=false,uniquename=false]{biblatex}``` + + + + +* <b>请问上标的标注(引用)标签过长导致行溢出,该怎么处理?</b> + +> 上标的标注与行内的标注不一样,因此采用了上标的处理,所以上标的标注无法自动断行,因此在页边附近的长标注很有可能会溢出。由于上标标注的断行国标中并没有什么明确要求和说明,因此只能按照自己的方式进行处理,通常是将一个长标注手动分成两个短的标注,比如将: + +```\cite{key1,key2,key3,key4,key5,key6,key7}``` + +变换成: + +```\cite{key1,key2,key3}\linebreak\cite{key4,key5,key6,key7}``` + +如果两个cite之间还需要增加一个上标的逗号,那么可以手动处理比如增加`\textsuperscript{,}` + + + +* <b>在顺序编码制标签中,希望数字编码从两个连续编码就开始压缩,比如[1,2]压缩成[1-2],该怎么处理?</b> + +> biblatex中处理顺序数字编码压缩的代码默认从3个连续编码开始压缩,比如[1,2,3]压缩成[1-3]。如果要修改为从2个连续编码开始压缩,只需要做一个很简单的修改即可: + +``` +%该宏的目的是抛弃压缩内部的编号,而仅输出最后一个编号,主要通过cbx@tempcnta来控制 +%一般情况下cbx@tempcnta为0,所以该宏不输出任何内容。当cbx@tempcnta在cite:comp:comp宏中更改变大后 +%说明开始进入需要压缩的范围,当到压缩终点时,cbx@tempcnta必然大于1,则输出内容。 +%修改第二行的数字1为0即可将默认的3个开始压缩变为2个开始压缩。 +\renewbibmacro*{cite:dump}{ + \ifnumgreater{\value{cbx@tempcnta}}{0} + {\ifnumgreater{\value{cbx@tempcnta}}{1}%1改为0,可以将压缩起始3个编号改为2个编号 + {\bibrangedash} + {\multicitedelim}% + \bibhyperref[\cbx@lastkey]{% + \ifdef\cbx@lastprefix + {\printtext[labelprefix]{\cbx@lastprefix}} + {}% + \printtext[labelnumber]{\cbx@lastnumber}}} + {}% + \setcounter{cbx@tempcnta}{0}% + \global\undef\cbx@lastprefix} +``` + + + +* <b>在正文中的某一部分,希望取消顺序编码标签中的压缩,而其他部分保持这种压缩,该怎么处理?</b> + +> 顺序数字编码压缩的代码,主要有cite:comp:comp宏控制,因此需要局部取消压缩,可以局部的修改该宏。修改很简单,只需要注释掉其中的一行,在需要取消压缩的环境中,重定义该宏,比如: + +``` +\renewbibmacro*{cite:comp:comp}{% + \ifboolexpr{ + ( test {\iffieldundef{labelprefix}} and test {\ifundef\cbx@lastprefix} ) + or + test {\iffieldequals{labelprefix}{\cbx@lastprefix}} + } + {\ifnumequal{\thefield{labelnumber}}{\value{cbx@tempcntb}} + {\savefield{entrykey}{\cbx@lastkey}% + \savefield{labelnumber}{\cbx@lastnumber}% + \addtocounter{cbx@tempcnta}{1}} + {\ifnumequal{\thefield{labelnumber}}{\value{cbx@tempcntb}-1} + {} + {\usebibmacro{cite:dump}% + \ifnumgreater{\value{cbx@tempcntb}}{-1} + {\multicitedelim} + {}% + \printtext[bibhyperref]{% + \printfield{labelprefix}% + \printfield{labelnumber}}}}} + {\usebibmacro{cite:comp:end}}% + %\setcounter{cbx@tempcntb}{\thefield{labelnumber}}%%注释该行,以取消压缩 + \savefield{labelprefix}{\cbx@lastprefix}} +``` + + ### 5. Examples/著录和标注结果示例 * 顺序编码制 -![示例a](example/egaligngb7714-2015.png) +![示例a](example/fig-style-numeric.png) * 作者年制 -![示例b](example/egaligngb7714-2015ay.png) +![示例b](example/fig-style-authoryear.png) * 姓名的格式更改 @@ -639,7 +799,7 @@ biber -l zh__stroke jobname Year = {2003} } -![示例c](example/eggbnamefmt.png) +![示例c](example/fig-nameformat.png) --------------------------------------------------------- @@ -667,61 +827,14 @@ biber -l zh__stroke jobname * 2018/04/03 v1.0k * 2018/06/01 v1.0l * 2018/08/14 v1.0m,CTAN +* 2018/11/04 v1.0n --------------------------------------------------------- ## Update history: - -date of update: 2018-08-14 to version v1.0m - -* 更正由于更新cbx文件引入的标注中的空格。 - -correct a bug which add an extra space in citations after the previous update. - - -date of update: 2018-06-01 to version v1.0l - -* 根据的 Minyi Han 的建议,调整了issue域的输出,以及标注中作者和等之间的间隙。(20180704) - -adjust output of the field issue,and the separation space between author and 等 in citations which was suggested by Minyi Han. - - -* 增加gbctexset选项控制参考文献标题内容的设置方式,即,除了相同的printbibliography选项方式外,选择是通过 bibname 或 refname 控制还是通过定义本地化字符串 bibliography 或 references 控制。 (20180702) - -add an option `gbctexset` to control the bibliography title's setting method, i.e. besides the same printbibliography option method, two methods: control by \bibname or \refname and control by DefineBibliographyStrings is selected by this option. - - -* 增加gbbiblabel选项来控制顺序编码制文献表序号标签的格式,即用方括号、圆括号、点、方框、圆圈等来装饰序号数字。(20180623) - -add an option gbbiblabel to control the format of the numerical label, i.e. the label number is wrapped by bracket, parenthesis,dot,box,circle and so on. - -* 增加\bibitemindent尺寸配合\bibhang设置基于list的文献表环境的缩进。(20180615) - -add a length \bibitemindent to control the item indent of bibliography based on list env with \bibhang。 - -* 增加upcite命令为兼容一些老的文档,顺序编码制中同supercite,作者年制中同yearcite。(20180604) - -add upcite to be compatible with some old doc,it behaves like supercite in numerical style and yearcite in author year style. - -* 为更合理的表述选项值的意义,修改了gbnamefmt选项的值。(20180604) - -modify the values of the option gbnamefmt for standardising option terminology. - -* 为顺序编码样式gbalign增加了center选项值。(20180602) - -add a value: center of the gbalign option for numerical sequence style. - -* 进一步完善了说明文档。(20180601) - -update the documentataion. - -* 统一了url字体为roman字体。(20180601) - -font of url set to be same as the main text. - - [update: tex](example/updatehistory.tex) -[update: md](example/updatehistoryold.md) +[update: tex](example/updatehistoryold.tex) + |