From 6bcb7fafe11bbc913072dca4f243b91c57f087b9 Mon Sep 17 00:00:00 2001 From: Karl Berry Date: Mon, 2 Jul 2018 20:40:02 +0000 Subject: biblatex-gb7714-2015 (2jul18) git-svn-id: svn://tug.org/texlive/trunk@48123 c570f23f-e606-0410-a88d-b1316a301751 --- .../doc/latex/biblatex-gb7714-2015/README.md | 490 +++- .../biblatex-gb7714-2015-content.tex | 2439 +++++++------------- .../biblatex-gb7714-2015-preamble.tex | 261 ++- .../biblatex-gb7714-2015/biblatex-gb7714-2015.pdf | Bin 734097 -> 552491 bytes .../biblatex-gb7714-2015/biblatex-gb7714-2015.tex | 7 +- .../example/egaligngb7714-2015.jpg | Bin 264716 -> 0 bytes .../example/egaligngb7714-2015.pdf | Bin 54417 -> 0 bytes .../example/egaligngb7714-2015.png | Bin 0 -> 94458 bytes .../example/egaligngb7714-2015.tex | 37 - .../example/egaligngb7714-2015ay.jpg | Bin 299042 -> 0 bytes .../example/egaligngb7714-2015ay.pdf | Bin 52898 -> 0 bytes .../example/egaligngb7714-2015ay.png | Bin 0 -> 101374 bytes .../example/egaligngb7714-2015ay.tex | 34 - .../biblatex-gb7714-2015/example/egalignleft.pdf | Bin 59190 -> 0 bytes .../biblatex-gb7714-2015/example/egalignleft.tex | 22 - .../biblatex-gb7714-2015/example/egalignright.pdf | Bin 59198 -> 0 bytes .../biblatex-gb7714-2015/example/egalignright.tex | 22 - .../biblatex-gb7714-2015/example/egbeamer.pdf | Bin 140490 -> 189552 bytes .../biblatex-gb7714-2015/example/egbeamer.tex | 628 ++++- .../biblatex-gb7714-2015/example/egbeameray.pdf | Bin 140547 -> 145549 bytes .../latex/biblatex-gb7714-2015/example/egbooks.pdf | Bin 129178 -> 0 bytes .../latex/biblatex-gb7714-2015/example/egbooks.tex | 67 - .../biblatex-gb7714-2015/example/egbooksay.pdf | Bin 147769 -> 0 bytes .../biblatex-gb7714-2015/example/egbooksay.tex | 67 - .../biblatex-gb7714-2015/example/eggbnamefmt.jpg | Bin 477701 -> 0 bytes .../biblatex-gb7714-2015/example/eggbnamefmt.png | Bin 0 -> 84331 bytes .../biblatex-gb7714-2015/example/eggbnamefmta.pdf | Bin 42684 -> 0 bytes .../biblatex-gb7714-2015/example/eggbnamefmta.tex | 36 - .../biblatex-gb7714-2015/example/eggbnamefmtb.pdf | Bin 42661 -> 0 bytes .../biblatex-gb7714-2015/example/eggbnamefmtb.tex | 36 - .../example/eggbnoauthorfalse.pdf | Bin 25697 -> 0 bytes .../example/eggbnoauthorfalse.tex | 48 - .../example/eggbnoauthorfalseay.pdf | Bin 35408 -> 0 bytes .../example/eggbnoauthorfalseay.tex | 48 - .../example/eggbnoauthortrue.pdf | Bin 25700 -> 0 bytes .../example/eggbnoauthortrue.tex | 48 - .../example/eggbnoauthortrueay.pdf | Bin 24501 -> 0 bytes .../example/eggbnoauthortrueay.tex | 48 - .../biblatex-gb7714-2015/example/eggbpubfalse.pdf | Bin 27849 -> 0 bytes .../biblatex-gb7714-2015/example/eggbpubfalse.tex | 33 - .../biblatex-gb7714-2015/example/eggbpubtrue.pdf | Bin 28458 -> 0 bytes .../biblatex-gb7714-2015/example/eggbpubtrue.tex | 33 - .../biblatex-gb7714-2015/example/egjournal.pdf | Bin 101591 -> 0 bytes .../biblatex-gb7714-2015/example/egjournal.tex | 48 - .../biblatex-gb7714-2015/example/egjournalay.pdf | Bin 105135 -> 0 bytes .../biblatex-gb7714-2015/example/egjournalay.tex | 48 - .../biblatex-gb7714-2015/example/egonline.pdf | Bin 28319 -> 0 bytes .../biblatex-gb7714-2015/example/egonline.tex | 33 - .../biblatex-gb7714-2015/example/egonlineay.pdf | Bin 28415 -> 0 bytes .../biblatex-gb7714-2015/example/egonlineay.tex | 33 - .../example/egprcdorinprcd.pdf | Bin 50301 -> 0 bytes .../example/egprcdorinprcd.tex | 37 - .../example/egprcdorinprcday.pdf | Bin 49930 -> 0 bytes .../example/egprcdorinprcday.tex | 37 - .../biblatex-gb7714-2015/example/egreport.pdf | Bin 40694 -> 0 bytes .../biblatex-gb7714-2015/example/egreport.tex | 38 - .../biblatex-gb7714-2015/example/egreportay.pdf | Bin 41305 -> 0 bytes .../biblatex-gb7714-2015/example/egreportay.tex | 38 - .../biblatex-gb7714-2015/example/egspecialchar.bib | 4 +- .../latex/biblatex-gb7714-2015/example/egtest.bib | 86 - .../latex/biblatex-gb7714-2015/example/egtest.pdf | Bin 50813 -> 100848 bytes .../latex/biblatex-gb7714-2015/example/egtest.tex | 808 ++++++- .../example/egthesispatent.pdf | Bin 50849 -> 0 bytes .../example/egthesispatent.tex | 48 - .../example/egthesispatentay.pdf | Bin 50019 -> 0 bytes .../example/egthesispatentay.tex | 49 - .../latex/biblatex-gb7714-2015/example/example.bib | 102 +- .../biblatex-gb7714-2015/example/filecodegbkeg.tex | 207 ++ .../biblatex-gb7714-2015/example/filecodeutfeg.tex | 253 ++ .../biblatex-gb7714-2015/example/makeclear.bat | 2 +- .../example/makecompilerec.dat | 40 +- .../biblatex-gb7714-2015/example/makefileeg.bat | 7 + .../example/makefileegtest.bat | 25 - .../biblatex-gb7714-2015/example/makefilegbk.bat | 44 + .../biblatex-gb7714-2015/example/makefiletest.bat | 41 + .../example/testaligngb7714-2015.pdf | Bin 0 -> 54146 bytes .../example/testaligngb7714-2015.tex | 37 + .../example/testaligngb7714-2015ay.pdf | Bin 0 -> 52900 bytes .../example/testaligngb7714-2015ay.tex | 36 + .../biblatex-gb7714-2015/example/testalignleft.tex | 22 + .../example/testalignright.tex | 22 + .../biblatex-gb7714-2015/example/testbooks.tex | 67 + .../biblatex-gb7714-2015/example/testbooksay.tex | 67 + .../biblatex-gb7714-2015/example/testciteay.tex | 218 ++ .../biblatex-gb7714-2015/example/testcitenum.tex | 212 ++ .../example/testcollection.tex | 32 + .../example/testcollectionay.tex | 32 + .../example/testentrytypes.tex | 320 +++ .../example/testfontinbiblio.tex | 74 + .../example/testgbnoauthorfalseay.tex | 48 + .../example/testgbnoauthortrueay.tex | 48 + .../example/testgbpubfalse.tex | 33 + .../biblatex-gb7714-2015/example/testgbpubtrue.tex | 33 + .../biblatex-gb7714-2015/example/testjournal.tex | 48 + .../biblatex-gb7714-2015/example/testjournalay.tex | 48 + .../biblatex-gb7714-2015/example/testmultilan.tex | 90 + .../example/testmultilanay.tex | 95 + .../biblatex-gb7714-2015/example/testnamefmt.tex | 237 ++ .../biblatex-gb7714-2015/example/testonline.tex | 33 + .../biblatex-gb7714-2015/example/testonlineay.tex | 33 + .../biblatex-gb7714-2015/example/testonlyurl.tex | 48 + .../biblatex-gb7714-2015/example/testonlyurlay.tex | 48 + .../example/testopttitlelink.tex | 52 + .../example/testproceedings.tex | 35 + .../example/testproceedingsay.tex | 35 + .../biblatex-gb7714-2015/example/testreport.tex | 38 + .../biblatex-gb7714-2015/example/testreportay.tex | 38 + .../biblatex-gb7714-2015/example/testtextcite.tex | 110 + .../example/testtextciteay.tex | 110 + .../example/testthesispatent.tex | 48 + .../example/testthesispatentay.tex | 49 + .../biblatex-gb7714-2015/example/updatehistory.tex | 84 + .../example/updatehistoryold.md | 83 +- .../example/updatehistoryold.tex | 911 +------- .../doc/latex/biblatex-gb7714-2015/makeclear.sh | 2 +- .../doc/latex/biblatex-gb7714-2015/makefileeg.sh | 17 - .../source/latex/biblatex-gb7714-2015/makeall.bat | 4 + .../latex/biblatex-gb7714-2015/makeclear.bat | 2 +- .../source/latex/biblatex-gb7714-2015/makefile.bat | 52 +- .../latex/biblatex-gb7714-2015/gb7714-2015-gbk.def | 19 + .../tex/latex/biblatex-gb7714-2015/gb7714-2015.bbx | 1764 ++++++++------ .../tex/latex/biblatex-gb7714-2015/gb7714-2015.cbx | 74 +- .../latex/biblatex-gb7714-2015/gb7714-2015ay.bbx | 1727 ++++++++------ .../latex/biblatex-gb7714-2015/gb7714-2015ay.cbx | 48 +- 124 files changed, 8302 insertions(+), 5413 deletions(-) delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015.jpg delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015.png delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015ay.jpg delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015ay.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015ay.png delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egaligngb7714-2015ay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egalignleft.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egalignleft.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egalignright.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egalignright.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egbooks.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egbooks.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egbooksay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egbooksay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnamefmt.jpg create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnamefmt.png delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnamefmta.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnamefmta.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnamefmtb.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnamefmtb.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthorfalse.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthorfalse.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthorfalseay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthorfalseay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthortrue.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthortrue.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthortrueay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbnoauthortrueay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbpubfalse.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbpubfalse.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbpubtrue.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/eggbpubtrue.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egjournal.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egjournal.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egjournalay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egjournalay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egonline.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egonline.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egonlineay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egonlineay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egprcdorinprcd.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egprcdorinprcd.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egprcdorinprcday.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egprcdorinprcday.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egreport.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egreport.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egreportay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egreportay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egtest.bib delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egthesispatent.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egthesispatent.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egthesispatentay.pdf delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/egthesispatentay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/filecodegbkeg.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/filecodeutfeg.tex delete mode 100755 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/makefileegtest.bat create mode 100755 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/makefilegbk.bat create mode 100755 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/makefiletest.bat create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testaligngb7714-2015.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testaligngb7714-2015.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testaligngb7714-2015ay.pdf create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testaligngb7714-2015ay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testalignleft.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testalignright.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testbooks.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testbooksay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testciteay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testcitenum.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testcollection.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testcollectionay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testentrytypes.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testfontinbiblio.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testgbnoauthorfalseay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testgbnoauthortrueay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testgbpubfalse.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testgbpubtrue.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testjournal.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testjournalay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testmultilan.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testmultilanay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testnamefmt.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testonline.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testonlineay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testonlyurl.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testonlyurlay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testopttitlelink.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testproceedings.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testproceedingsay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testreport.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testreportay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testtextcite.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testtextciteay.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testthesispatent.tex create mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/example/testthesispatentay.tex delete mode 100644 Master/texmf-dist/doc/latex/biblatex-gb7714-2015/makefileeg.sh create mode 100644 Master/texmf-dist/tex/latex/biblatex-gb7714-2015/gb7714-2015-gbk.def (limited to 'Master') 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 ffcd1ec442b..9c1dc3129cb 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 @@ -Date of last change: 2018-04-03 to version v1.0k +Date of last change: 2018-06-01 to version v1.0i # biblatex-gb7714-2015: a biblatex style package @@ -24,7 +24,15 @@ The biblatex-gb7714-2015 package provides an implementation of the bibliography `\usepackage[backend=biber,style=gb7714-2015]{biblatex}` - - add an option `gbalign` for the numerical label, option value maybe `right` or `left` or `gb7714-2015` + - add an option `gbalign` to control the align style of the numerical label： + + `gbalign=right` for the label ragged left in a list environment + + `gbalign=center` for the same width label in a list environment with the number centered in the bracket + + `gbalign=left` for the label ragged right in list environment + + `gbalign=gb7714-2015` for the label in paragraph with same separator space between label and entry content `\usepackage[backend=biber,style=gb7714-2015,gbalign=gb7714-2015]{biblatex}` @@ -38,17 +46,59 @@ The biblatex-gb7714-2015 package provides an implementation of the bibliography `gbnamefmt = lowercase` for gb7714 style with no case switch of names - `gbnamefmt = none` for standard style. + `gbnamefmt = givenahead` for standard style, given-family style, like ieee style + + `gbnamefmt = familyahead` for standard style, family-given style, like apa style. `gbnamefmt = pinyin` for a common Chinese style, like: ZHANG Min-li, YI Shi-he and so on. - This option is also for author year style. + the name format can be set per-entry using a field：`nameformat`=`pinyin` or others. This option is also for author year style. `\usepackage[backend=biber,style=gb7714-2015,gbnamefmt=uppercase]{biblatex}` - - add an option `gbtype` for dealing the reference type and carrier identifier like a [J/OL] for an on-line article, option value = `true` for gb7714 style or `false` for none identifier, e.g. An article title followed by empty string instead of the [J/OL]. This option is also for author year style. + - add an option `gbbiblabel` to control the format of the numerical label： + + `gbbiblabel=bracket` for the numerical number in the label wrapped by bracket + + `gbbiblabel=parens` for the numerical number in the label wrapped by parenthesis + + `gbbiblabel=plain` for the numerical number in the label wrapped by nothing + + `gbbiblabel=dot` for the numerical number in the label followed with dot + + `gbbiblabel=box` for the numerical number in the label wrapped by box which generated by `\framebox` + + `gbbiblabel=circle` for the numerical number in the label wrapped by circle which generated by `\textcircled` + + `\usepackage[backend=biber,style=gb7714-2015,gbbiblabel=bracket]{biblatex}` + + - add an option `gbtype` to control the output of the reference type and carrier identifier like [J/OL], option value = `true` for gb7714 style, print a title like: `an on-line article [J/OL]`, option value = `false` for none identifier, print a title like: `an on-line article`. This option is also for author year style. `\usepackage[backend=biber,style=gb7714-2015,gbtype=true]{biblatex}` + + - add an option `gbpunctin` to control the output of `//` before bookauthor for entrytypes like inbook/incollection/inproceedings. `gbpunctin=true` to output `//`, `gbpunctin=false` to output a bibstring, for English it is `IN:`, If you want to eliminate it at all, please redefine the bibstring like `\DefineBibliographyStrings{english}{in={}}` in the preamble. This option is also for author year style. + + `\usepackage[backend=biber,style=gb7714-2015,gbpunctin=true]{biblatex}` + + - add an option `gbctexset` to control the bibliography title's setting method. default is `gbctexset=true` with the title can be set by `\bibname` or `\refname` and the printbibliography option `title=title you want`, if `gbpunctin=false`, the title can be set by bibstring like `\DefineBibliographyStrings{english}{bibliography={title you want}}` or `\DefineBibliographyStrings{english}{references={title you want}}` and the printbibliography option `title=title you want`. This option is also for author year style. + + `\usepackage[backend=biber,style=gb7714-2015,gbctexset=true]{biblatex}` + + - add an option `gbcodegbk` to deal the tex source file encoded with GBK. if you want to compile GBK file with pdflatex or latex，set `gbcodegbk=true` is needed. if compile with xelatex, it should be none or `gbcodegbk=false`. This option is also for author year style. + + `\usepackage[backend=biber,style=gb7714-2015,gbcodegbk=false]{biblatex}` + + - add an option `gbstrict` to control the output of some unnecessary fields for GB/T7714-2015. If you want to output them as the standard styles, it should be `gbstrict=false`. default is `gbstrict=true`. This option is also for author year style. + + `\usepackage[backend=biber,style=gb7714-2015,gbstrict=true]{biblatex}` + + - add an option `gbfieldstd` to control the format of some fields such as title, url and pages. option value = `false` for gb7714 style or `true` for standard style. This option is also for author year style. + + `\usepackage[backend=biber,style=gb7714-2015,gbfieldstd=false]{biblatex}` + + - add an option `gbtitlelink` to control the hyperlink of title field. option value = `false` with none link or `true` to set the hyperlink. This option is also for author year style. + + `\usepackage[backend=biber,style=gb7714-2015,gbtitlelink=true]{biblatex}` * for author year style @@ -62,7 +112,7 @@ The biblatex-gb7714-2015 package provides an implementation of the bibliography `perl gb7714texttobib.pl in=textfilename out=bibfilename` -A demonstration database is provided to show how to format input for the style. The biblatex-gb7714-2015 style works with texlive2014, texlive2015, texlive2016, texlive2017 and so on. +A demonstration database is provided to show how to format input for the style. The biblatex-gb7714-2015 style works with texlive2014, texlive2015, texlive2016, texlive2017 , texlive2018 and so on. please see the file 'biblatex-gb7714-2015.pdf' for further information! @@ -70,15 +120,25 @@ please see the file 'biblatex-gb7714-2015.pdf' for further information! ## Applications * [SJTUThesis(上海交通大学学位论文模板)](https://github.com/sjtug/SJTUThesis)(母校的论文模板，不得不说缘分真的很神奇) -* [ECNU-Undergraduate-LaTeX(华东师范大学本科毕业论文模板 )](https://github.com/YijunYuan/ECNU-Undergraduate-LaTeX) +* [fduthesis(复旦大学论文模板)](https://github.com/Stone-Zeng/fduthesis) +* [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) +* [...] + + ## Related Links * [Biblatex 宏包](https://github.com/plk/biblatex) * [Beamer 文档类](https://github.com/josephwright/beamer) -* [Biblatex说明文档 中文版](https://github.com/hushidong/biblatex-zh-cn) -* [LaTeX中文参考文献的biblatex解决方案](https://github.com/hushidong/biblatex-solution-to-latex-bibliography) +* [biblatex 宏包中文手册 ](https://github.com/hushidong/biblatex-zh-cn) +* [biblatex 简明使用手册](https://github.com/hushidong/biblatex-solution-to-latex-bibliography) +* [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/) @@ -94,67 +154,74 @@ please see the file 'biblatex-gb7714-2015.pdf' for further information!

1. Tex source file/tex文档一般结构

``` - \documentclass{article}%文档类%导言区开始: - - \usepackage{ctex}%加载ctex宏包，中文支持 - - \usepackage[left=20mm,right=20mm,top=25mm, bottom=15mm]{geometry}%加载geometry宏包，定义版面 - - \usepackage[colorlinks=true,pdfstartview=FitH,% - linkcolor=blue,anchorcolor=violet,citecolor=magenta]{hyperref}%加载hyperref宏包，使用超链接 +\documentclass{article}%文档类%导言区开始: - \usepackage[backend=biber,bibstyle=gb7714-2015,%nature,%%加载biblatex宏包，使用参考文献 - citestyle=gb7714-2015%,backref=true%%其中后端backend使用biber - ]{biblatex}%标注(引用)样式citestyle，著录样式bibstyle都采用gb7714-2015样式 - - \addbibresource[location=local]{example.bib}%biblatex宏包的参考文献数据源加载方式 +\usepackage{ctex}%加载ctex宏包，中文支持 - - \begin{document}%正文区开始: +\usepackage[left=20mm,right=20mm,top=25mm, bottom=15mm]{geometry}%加载geometry宏包，定义版面 - %正文内容，引用参考文献 - - 1. 不带页码的引用(上标，方括号包围): - \cite{Peebles2001-100-100} - - 2. 不带页码的引用(非上标，方括号包围): - \parencite{Miroslav2004--} - - 3. 带页码的引用: - \cite[见][49页]{蔡敏2006--} \parencite[见][49页]{Miroslav2004--} - \pagescite{Peebles2001-100-100} \pagescite[][201-301]{Peebles2001-100-100} - - 4. 作者年制文中已有作者还需要年份和页码的情况，使用命令yearpagescite，比如: - 见赵耀东\yearpagescite[][205]{赵耀东1998--}和Simon\yearpagescite[][15]{Simon2001--} - - 5. 作者年制文中已有作者只需要年份的情况，使用命令yearcite和手动方式，比如: - 见赵耀东\yearcite{赵耀东1998--} - 见赵耀东(\cite*{赵耀东1998--}) - 见赵耀东(\citeyear{赵耀东1998--}) - - 6. 在页脚中引用和打印文献表: - \footnote{在脚注中引用\footcite{赵学功2001--}} \footfullcite{赵学功2001--} - +\usepackage[colorlinks=true,pdfstartview=FitH,% +linkcolor=blue,anchorcolor=violet,citecolor=magenta]{hyperref}%加载hyperref宏包，使用超链接 + +\usepackage[backend=biber,bibstyle=gb7714-2015,%nature,%%加载biblatex宏包，使用参考文献 +citestyle=gb7714-2015%,backref=true%%其中后端backend使用biber +]{biblatex}%标注(引用)样式citestyle，著录样式bibstyle都采用gb7714-2015样式 + +\addbibresource[location=local]{example.bib}%biblatex宏包的参考文献数据源加载方式 + + +\begin{document}%正文区开始: + +%正文内容，引用参考文献 - %打印参考文献表 - \printbibliography[heading=bibliography,title=参考文献] - \end{document} +1. 不带页码的引用(顺序编码制上标，方括号包围；作者年制行内，括号包围): +\cite{Peebles2001-100-100}\upcite{Peebles2001-100-100}\supercite{Peebles2001-100-100} + +2. 不带页码的引用(顺序编码制非上标，方括号包围；作者年制行内，括号包围): +\parencite{Miroslav2004--} + +3. 带页码的引用(标准命令，默认样式; 增加命令，GB/T 7714-2015样式): +\cite[见][49页]{蔡敏2006--} \parencite[见][49页]{Miroslav2004--} +\pagescite{Peebles2001-100-100} \pagescite[][201-301]{Peebles2001-100-100} + +4. 顺序编码制中同时输出作者和顺序编码标签，比如： +（一）直接的方法：见\citeauthor{refb}\cite{refb},\citeauthor{refc}\cite{refc} +（二）定义新的标注命令：见\authornumcite{refb,refc} +（三）用textcite但没有上标：见\textcite{refb,refc} + +5. 作者年制文中已有作者还需要年份和页码(顺序编码制与pagescite作用相同，作者年制年份行内页码上标): +见赵耀东\yearpagescite[][205]{赵耀东1998--}和Simon\yearpagescite[][15]{Simon2001--} + +6. 作者年制文中已有作者只需要年份(顺序编码制与pagescite作用相同，作者年制年份行内): +见赵耀东\yearcite{赵耀东1998--} +见赵耀东(\cite*{赵耀东1998--}) +见赵耀东(\citeyear{赵耀东1998--}) + +7. 作者年制中由标注命令给出作者年份信息，作者以主语方式作为正文内容： +\textcite{赵耀东1998--} + +8. 在页脚中引用和打印文献表: +\footnote{在脚注中引用\footcite{赵学功2001--}} \footfullcite{赵学功2001--} + + +%打印参考文献表 +\printbibliography[heading=bibliography,title=参考文献] +\end{document} ``` ### 2. Compile method/文档编译方式 ``` - xelatex jobname.tex - biber jobname - xelatex jobname.tex - xelatex jobname.tex +xelatex jobname.tex +biber jobname +xelatex jobname.tex +xelatex jobname.tex ``` ### 3. Recommended environment/推荐使用环境 - - Texlive+Winedt - - - Texlive+Texstudio +- Texlive+Winedt +- Texlive+Texstudio ### 4. Common questions/常见问题 @@ -164,41 +231,62 @@ please see the file 'biblatex-gb7714-2015.pdf' for further information! > (1)在导言区加载biblatex宏包，并使用gb7714-2015样式: -> `\usepackage[backend=biber,style=gb7714-2015]{biblatex}` +```\usepackage[backend=biber,style=gb7714-2015]{biblatex}``` > (2)正文中引用参考文献: -> `见文献\cite{referencbibtexkey}` +```见文献\cite{referencbibtexkey}``` > (3)在需要的地方打印参考文献表: -> `\printbibliography` +```\printbibliography``` -更直接的例子见前述的[tex文档](#jumptotexsrcf) +更直接的例子见前述的[tex源文档](#jumptotexsrcf) + + * 请问我应该怎么安装和更新biblatex-gb7714-2015宏包？ -> biblatex-gb7714-2015宏包是基于biblatex的样式宏包，目前texlive，miktex都已收录，因此可以直接使用，不需要安装。 -> 当你使用的环境下，系统提示找不gb7714-2015.bbx或gb7714-2015ay.bbx文件时，说明系统不存在gb7714-2015样式文件， -> 这时需要安装。最简单的方法是从本项目源码中下载gb7714-2015.bbx,gb7714-2015ay.bbx,gb7714-2015.cbx, -> gb7714-2015ay.cbx四个文件放到你要编译的主文档所在目录。对于已经安装的用户需要更新到最新版， -> 则可以下载这四个文件替换系统已经安装的文件。 +> biblatex-gb7714-2015宏包是基于biblatex的样式宏包，目前texlive，miktex都已收录，因此可以直接使用，一般不需要安装。如果使用时，系统提示找不gb7714-2015.bbx或gb7714-2015ay.bbx文件的错误，说明当前tex系统未安装biblatex-gb7714-2015样式包，这时需要安装它。最简单的方法是从本项目源码中下载 gb7714-2015.bbx, gb7714-2015ay.bbx, gb7714-2015.cbx, gb7714-2015ay.cbx 四个文件放到你要编译的主文档所在目录，如果需要使用gbk编码，则还需复制 gb7714-2015-gbk.def 文件。对于已经安装的用户需要更新到最新版，则可以下载这些文件替换系统已经安装的文件。 + -* 为什么利用ctex2.9套装进行编译时，编译出现错误？ +* 为什么我之前使用样式`style=caspervector`进行编译没有问题，换成`style=gb7714-2015`后，编译就出现错误？ -> 由于ctex2.9套装多年未更新，其中的biblatex宏包过老，所以需要更新一下biblatex。 - -* 我希望参考文献表中的文献不是按引用顺序而是以文献的字母顺序排序，怎么实现？ +> 可能有三个原因： + +> 1. 辅助文件没有清理导致，当采用caspervector样式时编译产生的辅助文件中可能带有该样式的一些特有信息，由此产生一些不兼容。因此需要的操作是，清除辅助文件，然后再进行编译。清除命令为(下面的命令是windows下的，linux下的是类似的只需把删除命令换成`rm -f`)： + +```del /q *.aux *.bbl *.blg *.log *.out *.toc *.bcf *.xml *.synctex *.nlo *.nls *.bak *.ind *.idx *.ilg *.lof *.lot *.ent-x *.tmp *.ltx *.los *.lol *.loc *.listing *.gz *.synctex(busy) *.nav *.snm *.vrb *.fls *.xdv *.fdb_latexmk``` + +> 2. biblatex-gb7714-2015 版本过于陈旧，旧版本对于一些特殊情况可能考虑不全面。因此需要的操作是更新biblatex-gb7714-2015，方法见上一个问题。 + +> 3. 编译命令问题，通常情况下tex文档和bib文档是utf8编码的，因此最好采用xelatex编译，而不用pdflatex。因此如果编译时用pdflatex出现错误，请换成xelatex。 + + + +* 为什么利用 ctex2.9 套装进行编译时，出现错误？ + +> 由于ctex2.9套装多年未更新，其中的biblatex宏包过于陈旧，所以需要更新 biblatex。 + + + +* 我希望参考文献表中的文献不是按引用顺序而是以文献作者的字母顺序排序，怎么实现？ > 一般情况下文献表是按引用顺序进行排列，标签是顺序的数字，这种方式称为顺序编码制。 -> 如果要以文献作者字母顺序排列，那么需要换一种编制方式，称为作者年制: +> 如果要以文献作者字母顺序排列，那么可以换一种编制方式，称为作者年制: -> `\usepackage[backend=biber,bibstyle=gb7714-2015ay]{biblatex}` +```\usepackage[backend=biber,style=gb7714-2015ay]{biblatex}``` + +> 如果要求使用顺序编码制文献表，又要以文献作者字母顺序排列，那么可以增加排序选项`sorting=nyt`: -* 英文文献能按字母顺序排列，那么参考文献表中的中文文献能否以拼音或者笔画进行排序呢？ +```\usepackage[backend=biber,style=gb7714-2015,sorting=nyt]{biblatex}``` + + -> 可以，主要通过编译时，在biber编译参考文献信息命令中设置参数选项来实现: +* 作者年制中英文文献能按字母顺序排列，那么中文文献能否以拼音或者笔画进行排序呢？ + +> 能，可以通过编译时给biber设置选项来实现: ``` %按拼音排序，biber命令 @@ -206,22 +294,71 @@ biber -l zh__pinyin jobname %按笔画排序，biber命令 biber -l zh__stroke jobname ``` + +> 或者，也可以通过增加 biblatex 选项来实现（此时biber编译无需另加选项），比如： + +```\usepackage[backend=biber,style=gb7714-2015ay,sortlocale=zh__pinyin]{biblatex}``` + + * 作者年制参考文献表目前的排序时升序排列，能不能改成降序排序？ > 能，这需要通过修改gb7714-2015ay.bbx中的代码来实现，找到: -> `\sort{%[direction=descending]` + +```\sort{%[direction=descending]``` + > 修改为: -> `\sort[direction=descending]{%` + +```\sort[direction=descending]{%``` + + + +* 我希望文献表以阿拉伯数字编号，而正文中的引用标签使用作者和年份标注而不是数字，请问我该如何处理？ + +> 可以设置不同的标注和著录样式，比如标注样式用作者年制，而著录样式用顺序编码制，比如: + +```\usepackage[backend=biber,citestyle=gb7714-2015ay,bibstyle=gb7714-2015]{biblatex}``` + +> 参见:[issue:参考文献的顺序](https://github.com/sjtug/SJTUThesis/issues/300) + + + +* 如果我还希望顺序编码的文献著录表以拼音排序，请问该怎么操作？ + +> 顺序编码文献著录表默认是按引用顺序排序，但可以通过设置sorting选项进行调整，比如sorting=nyt表示按作者姓名年份以及文献标题进行排序。要使中文能按拼音排序，可以设置本地化排序调整方案，即sortlocale选项，比如: + +```\usepackage[backend=biber,citestyle=gb7714-2015ay,bibstyle=gb7714-2015,sorting=nyt,sortlocale=zh__pinyin]{biblatex}``` + + -* 请问参考文献中存在一些特殊字符比如&或者一些特殊命令比如\LaTex{}是不是会出现问题？ +* 请问如果参考文献中存在一些特殊字符比如&或者一些特殊命令比如\LaTex{}等，是不是会出现问题？ > 通常不会出现问题，直接输入即可，当出现问题时可以手动调整比如修改为`\&`和`{\LaTex{}}` + + + +* 如果希望在参考文献中直接使用一些unicode字符比如希腊字母等而不想用数学环境中的命令，请问该怎么处理？ + +> 直接显示希腊字母等unicode字符需要字体的支持，比如CMU Serif等，可以在整个文档全局使用该字体，也可以仅在文献表中使用该字体，比如： + +``` +{ +\newcommand{\ftcmu}{\fontspec{CMU Serif}\selectfont} +\renewcommand{\bibfont}{\ftcmu}%设置英文字体不影响中文字体 +\printbibliography +} +``` + +> 当然字体设置需要fontspec宏包的支持。 + + * 我习惯用传统的bst文件来生成参考文献，有没有GB/T 7714-2015标准的实现版本？ > GB/T 7714-2015标准实现的bst版本，已经由[zeping lee](https://github.com/zepinglee/gbt7714-bibtex-style)开发完毕，直接使用即可。 - + + + * 我在使用过程中遇到了一些无法理解和无法解决的问题，怎么办？ > 请邮件联系hzzmail@163.com或在项目内发issue提问即可。 @@ -237,15 +374,18 @@ biber -l zh__stroke jobname > 如果要求标签左侧对齐，且标签与内容等间距必须放弃使用list。 > biblatex-7714-2015的顺序编码制样式特别设计了这样的环境，以保持和word一致。通过设置选项gbalign来实现: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,gbalign=gb7714-2015]{biblatex}` +```\usepackage[backend=biber,bibstyle=gb7714-2015,gbalign=gb7714-2015]{biblatex}``` + -* 请问如果不希望在参考文献表中出现类似“出版地不详”“出版者不详”等信息时，该怎么处理？ + +* 如果不希望在参考文献表中出现类似“出版地不详”“出版者不详”等信息时，请问该怎么处理？ > 设置选项gbpub可以实现，当gbpub=false时，biblatex-gb7714-2015宏包会放弃国标的要求，不使用“出版地不详”等补充信息: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,gbpub=false]{biblatex}` +```\usepackage[backend=biber,bibstyle=gb7714-2015,gbpub=false]{biblatex}``` + * 我觉得文献表中英文作者全部用大写不好看，请问能换一种大小写方式么？ > 能，通过设置gbnamefmt可以实现，默认情况下gbnamefmt=uppercase，作者姓名字母全部大写。 @@ -253,116 +393,168 @@ biber -l zh__stroke jobname > 这时可以在bib文件中手动设置想要的大小写方式。 > 当要实现类似ZHAO Yu-xin这样的拼音方式，则可以设置gbnamefmt=pinyin: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,gbnamefmt=lowercase]{biblatex}` +```\usepackage[backend=biber,bibstyle=gb7714-2015,gbnamefmt=lowercase]{biblatex}``` -* 请问如果不希望在参考文献表中出现类似“[M]”“[J]”等文献类型标识符时，该怎么处理？ + + +* 如果不希望在参考文献表中出现类似“[M]”“[J]”等文献类型标识符时，请问该怎么处理？ > 可通过设置选项gbtype=false实现: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,gbtype=false]{biblatex}` +```\usepackage[backend=biber,bibstyle=gb7714-2015,gbtype=false]{biblatex}``` + -* 请问如果不希望在参考文献表中出现网址信息时，该怎么处理？ + +* 如果不希望在参考文献表中出现网址信息时，请问该怎么处理？ > 可通过设置选项url=false实现: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,url=false]{biblatex}` - -* 请问如果不希望在参考文献表中出现DOI信息时，该怎么处理？ +```\usepackage[backend=biber,bibstyle=gb7714-2015,url=false]{biblatex}``` + + + +* 如果不希望在参考文献表中出现DOI信息时，请问该怎么处理？ > 可通过设置选项doi=false实现: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,doi=false]{biblatex}` +```\usepackage[backend=biber,bibstyle=gb7714-2015,doi=false]{biblatex}``` + -* 请问参考文献没有作者时，希望用佚名或Noauthor代替作者时，该怎么处理？ + +* 当参考文献没有作者时，希望用佚名或Anon代替作者时，请问该怎么处理？ -> 可通过设置选项gbnoauthor=true实现，注意该方式主要用在作者年制中: +> 可通过设置选项gbnoauthor=true实现，注意该处理主要用在作者年制中: + +```\usepackage[backend=biber,bibstyle=gb7714-2015,gbnoauthor=true]{biblatex}``` -> `\usepackage[backend=biber,bibstyle=gb7714-2015,gbnoauthor=true]{biblatex}` -* 请问希望参考文献表中参考文献作者数量超过国标规定的3个时，该怎么处理？ + +* 如果希望参考文献表中文献作者数量超过国标规定的3个时，请问该怎么处理？ > 可通过设置选项maxbibnames，minbibnames实现，比如下面的设置用于显示5个作者: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,maxbibnames=5,minbibnames=5]{biblatex}` +```\usepackage[backend=biber,bibstyle=gb7714-2015,maxbibnames=5,minbibnames=5]{biblatex}``` + -* 请问如何使文献表中文献的标题的是句首字母大写而其它所有字母均小写？ +* 请问如何使文献表中文献标题的是句首字母大写而其它所有字母均小写？ > 默认情况下，biblatex-gb7714-2015不对标题的字母大小写做处理，因此要得到想要的字母大小写格式， > 需要在bib文件输入参考文献信息时给出需要的大小写格式。 -* 请问如何使文献表中期刊名的是单词首字母大写的？ + + +* 请问如何使文献表中的期刊名是单词首字母大写的？ > 默认情况下，biblatex-gb7714-2015不对期刊名的字母大小写做处理， > 因此需要在bib文件输入参考文献信息时给出需要的大小写格式。 -* 请问我想得到中英文对照的双语参考文献，该如何处理？ + +* 我想得到中英文对照的双语参考文献，请问该如何处理？ > biblatex-gb7714-2015设计了两种多语言对照参考文献的实现方式， > 一种是利用条目集的概念，另一种是利用关联条目的概念。 > 因此有两种方法: > 方法一，动态定义条目集: -> `\defbibentryset{易仕和，等，2013}{易仕和2013--,Yi2013--} -> 双语文献引用\cite{易仕和，等，2013}` +> 在导言区或正文中定义: +```\defbibentryset{易仕和，等，2013}{易仕和2013--,Yi2013--}``` + +> 在正文中引用: +``双语文献引用\cite{易仕和，等，2013}``` > 方法二，动态定义关联条目: > 在导言区定义: -> `\defdoublelangentry{易仕和2013--}{Yi2013--}` +```\defdoublelangentry{易仕和2013--}{Yi2013--}``` > 在正文中引用: -> `双语文献引用\cite{易仕和2013--}` +```双语文献引用\cite{易仕和2013--}``` -#### 4.3 Citation format/正文引用标注格式 +#### 4.3 Citation format/正文引用的标注格式 -* 我希望在正文中同时使用上标和非上标的引用标签，该怎么操作？ +* 我希望在正文中同时使用上标和非上标的引用标签，请问该怎么操作？ > 可以使用不同的命令来实现上标和非上标的标签， > 上标标签的命令为`\cite{bibtexkey}`，非上标标签的命令为`\parencite{bibtexkey}`。 -> 当希望上标的标签也给出国标要求的页码时，则可以使用`\pagescite[][50-55]{bibtexkey}`给出指定页码 -> 或者`\pagescite{bibtexkey}`使用bib文件中的页码。 - +> 当希望上标的标签也给出国标要求的页码时，则可以使用`\pagescite[50-55]{bibtexkey}`给出指定页码 +> 或者`\pagescite{bibtexkey}`直接使用bib文件中的页码。 + + + * 我在引用文献时已经给出作者信息，希望引用标签仅包含年份和页码信息或者仅包含年份信息时，该怎么操作？ -> 需要给出年份的标签是作者年制的标签，可以使用命令`yearpagescite{bibtex}`给出仅包含年份和页码信息的标签， -> 使用命令`yearcite{bibtex}`给出仅包含年份的标签。 -> 可以使用不同的命令来实现上标和非上标的标签，上标标签的命令为`\cite{bibtexkey}`， -> 非上标标签的命令为`\parencite{bibtexkey}`。 -> 当希望上标的标签也给出国标要求的页码时，则可以使用`\pagescite[][50-55]{bibtexkey}`给出指定页码 -> 或者`\pagescite{bibtexkey}`使用bib文件中的页码信息。 +> 需要给出年份的标签是作者年制的标签，可以使用命令`\yearpagescite{bibtexkey}`给出包含年份和页码信息的标签， +> 使用命令`\yearcite{bibtexkey}`给出仅包含年份的标签。 + + + +* 在使用作者年制时，我希望文献表是按作者年份标题排序，而正文某处一个cite命令引用多个参考文献，且这些文献的标签是按年份作者标题排序，该怎么操作？ + +> 有两种方法: + +> 一是自动排序 + +> 宏包加载时使用: + +```\usepackage[backend=biber,style=gb7714-2015ay,sortcite,sorting=ynt]{biblatex}``` + +> 正文中引用: + +```\cite{refa2010,refb2008,refc2009}``` + +> 然后在文献打印前加 + +```\newrefcontext[sorting=nyt]``` + +> 二是手动给出排序 + +> 宏包加载时使用 + +```\usepackage[backend=biber,style=gb7714-2015ay]{biblatex}``` + +> 引用多个文献时按照年份顺序给出引用关键字，即正文中引用: + +```\cite{refb2008,refc2009,refa2010}``` + +> 参考:[issue:citation的顺序和bibliography的顺序如何不关联](https://github.com/hushidong/biblatex-gb7714-2015/issues/30) + + * 请问希望正文中作者年制的标注(引用)标签中作者数量超过国标规定的1个时，该怎么处理？ > 可通过设置选项maxcitenames，mincitenames实现，比如下面的设置用于显示5个作者: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,maxcitenames=5,mincitenames=5]{biblatex}` +```\usepackage[backend=biber,style=gb7714-2015ay,maxcitenames=5,mincitenames=5]{biblatex}``` + * 请问希望正文中作者年制的标注(引用)标签中作者数量只能是1个，而不管是否存在歧义时，该怎么处理？ > 可通过设置选项uniquelist=false实现，该设置标签中的作者只会是指定的1个: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,uniquelist=false]{biblatex}` +```\usepackage[backend=biber,style=gb7714-2015ay,uniquelist=false]{biblatex}``` + + * 请问希望正文中作者年制的标注(引用)标签中作者数量只能是1个，且只用其作者的姓而不管是否存在歧义时，该怎么处理？ > 可通过设置选项uniquelist=false, uniquename=false实现，该设置标签中的作者只会是指定的1个且只用该作者的姓: -> `\usepackage[backend=biber,bibstyle=gb7714-2015,uniquelist=false,uniquename=false]{biblatex}` +```\usepackage[backend=biber,style=gb7714-2015ay,uniquelist=false,uniquename=false]{biblatex}``` ### 5. Examples/著录和标注结果示例 * 顺序编码制 -![示例a](example/egaligngb7714-2015.jpg) +![示例a](example/egaligngb7714-2015.png) * 作者年制 -![示例b](example/egaligngb7714-2015ay.jpg) +![示例b](example/egaligngb7714-2015ay.png) * 姓名的格式更改 @@ -403,23 +595,75 @@ biber -l zh__stroke jobname Year = {2003} } -![示例c](example/eggbnamefmt.jpg) +![示例c](example/eggbnamefmt.png) --------------------------------------------------------- ## Need to do: * special characters in all fields? - * citestyle is gb7714-2015ay, bibstyle is gb7714-2015? * entry without author: the delimiter between title and year? - * more languages, to be compatible with language field in old bib file? - * more complex citation cmd? + * TEST FOR texlive 2015,2016 + * [1]，(1)，1.，box{1}，superscript，compress，noncompress --------------------------------------------------------- +## Version history: + +* 2016/05/20 v1.0 +* 2016/10/23 v1.0a +* 2016/11/11 v1.0b +* 2016/11/14 v1.0c +* 2016/11/24 v1.0d +* 2016/12/07 v1.0e +* 2017/02/26 v1.0g +* 2017/04/11 v1.0h +* 2017/11/21 v1.0i +* 2018/01/20 v1.0j +* 2018/04/03 v1.0k +* 2018/06/01 v1.0l + +--------------------------------------------------------- ## Update history: -[update latest](example/updatehistory.tex) +date of update: 2018-06-01 to version v1.0l + + +* 增加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 v1.0-v1.0j](example/updatehistoryold.md) +[update: md](example/updatehistoryold.md) diff --git a/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-content.tex b/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-content.tex index 72770b9ea87..e0d7603ff0b 100644 --- a/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-content.tex +++ b/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-content.tex @@ -10,85 +10,151 @@ %\addcontentsline{toc}{section}{目录} \tableofcontents %\renewcommand{\numberline}[1]{#1~} -\phantomsection -\addcontentsline{toc}{section}{示例} +%\phantomsection +%\addcontentsline{toc}{section}{示例} +\listoffigures +\listoftables \listofegcode %------------------------------------------------------------ \section{概述} -提供了符合GB/T 7714-2015~信息与文献~参考文献著录规则要求的biblatex参考文献样式。分为两种编制方式:一、顺序编码制；二、作者年制。主要特点包括: +提供了符合《GB/T 7714-2015~信息与文献~参考文献著录规则》要求的biblatex参考文献样式。分为两种编制方式:一、顺序编码制；二、著者-出版年制。主要特点包括: \begin{enumerate} \item 兼容性 -自biblatex-gb7714-2015宏包发布以来，一直秉承兼容各版本biblatex的原则，可与所有biblatex 2.8(texlive2014) 以上版本配合使用。并解决在不同文档类特别是beamer类中使用问题。兼容一些老的参考文献类型，比如www/electronic/conference/mastersthsis/phdthsis/techreport/standard，并为报纸析出的文献新增加了newpaper类型。 +自biblatex-gb7714-2015宏包发布以来，一直秉承兼容各版本biblatex的原则，可与biblatex v2.8 (contained in texlive2014) 以上所有版本配合使用(注意 ctex 2.9.4 的用户需升级 biblatex)。并完善在不同文档类特别是beamer类中的使用问题。兼容一些传统的参考文献条目类型，比如www/electronic/conference/mastersthsis/phdthsis/techreport/standard，并根据国标要求增加了newspaper(报纸析出的文献)、database(数据库)、dataset(数据集)、 software(软件)、map(舆图)、archive(档案)等类型。兼容适用于不同样式的bib数据源，例如gbt7714宏包的bst样式中mark和medium域等。 \item 易用性 -从biblatex-gb7714-2015宏包设计的最开始就遵守尽可能让用户减少对于bib文件准备等方面的关注，用户可以很简单的输入或者从网络上下载(如百度学术、zotero等)参考文献信息然后直接使用，而不需要因为参考文献包的要求而特别地去修改增添参考文件信息，如参考文献类型和载体标识、语言等。并为用户提供全面、详实的说明，包括 +从biblatex-gb7714-2015宏包设计的最开始就遵守尽可能让用户减少对于bib文件准备等方面的关注，用户可以用最简单的输入或者从网上下载(如各种学术、zotero等)参考文献信息后直接使用，能够自动判断文献类型和载体并区分不同的语言，而不需要用户手动增添类似参考文献类型和载体标识、语言等额外信息。保持biblatex习惯基础上，为用户提供既能满足国标要求又具实用性的标注(引用)命令，如cite(上标)、parencite(非上标)、textcite(提供作者为主语)、authornumcite(提供作者和上标编码)、pagescite(满足国标)、yearpagescite(提供年份页码)、yearcite(提供年份)等。并为用户提供全面、详实的说明，包括条目类型、域、域信息输入方法以及 \href{https://github.com/hushidong/biblatex-gb7714-2015/wiki}{WIKI}， -\href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography/blob/master/biblatex-solution-to-latex-bibliography.pdf}{LaTeX 文档参考文献的biblatex解决方案}等，以帮助用户更好的入门。 +\href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography/blob/master/biblatex-solution-to-latex-bibliography.pdf}{LaTeX 文档参考文献的biblatex解决方案}等文档，以帮助用户更好的入门。 \item 灵活性 -biblatex-gb7714-2015宏包除了能提供严格遵守GB/T 7714-2015标准的格式外，还通过增加很多新的用户设置选项，使用户可以根据自己的需求很灵活调整参考文献表的生成。包括标签的对齐方式、出版项缺省时的处理、作者缺失时的处理、作者姓名格式的调整、文献类型和载体标识等信息的输出控制等。能通过标注和著录分别采用作者年制、顺序编码制样式实现特殊的参考文献格式，并尽最大可能利用biblatex的选项来实现一些特殊需求，比如文献表中作者数量大于3、标注中严格仅给出第一作者的姓、参考文献表按拼音或笔画排序等等。 -\end{enumerate} - -具体来讲，完成了4个方面的工作: -\begin{enumerate} - \item 完成了GB/T 7714-2015标准的完整实现，包括两种编制方式下的各类型参考文献著录格式和标注格式等基本内容，还包括: 双语文献格式，带页码的标注格式，作者年制下仅有年的标注格式和文献按语言集中并自动排序，起止卷期自动解析，增加gbnoauthor选项控制作者年制责任者缺省的处理，增加gbpub选项控制出版信息缺省时的处理，增加gbalign选项控制顺序编码制文献表的标签对齐方式，提供右对齐、左对齐和项对齐三种方式。 - \item 实现了用户文献数据录入优化，用户在录入参考文献数据时，只需要录入文献的实际信息即可，不需要录入文献标识符和载体标识符，无需录入language或者其它域信息来区分中英文参考文献，实现中英文自动判断并处理。支持一些特殊或老的条目类型，比如standard，newspaper，www，mastersthesis，phdthesis等。 - \item 实现了对biblatex不同版本的兼容，能够应用于biblatex3.2以前的老版本，也能用于3.3版姓名处理方式改变后的版本。即可以与texlive2014/2015/2016/2017配合使用，无需升级biblatex情况下直接使用biblatex-gb7714-2015宏包(即本样式)。 - \bc{当然 ctex2.9.4 的用户可能要升级一下biblatex，因为ctex多年没有更新，其中的biblatex版本过低}。 - \item 测试了样式文件在book/report/article文档类以及beamer类下的适用性，结果表明均能满足要求。文档详细介绍了样式文件的使用方法和注意事项，说明了各条目类型的著录格式及其在biblatex 中对应信息域的构成，以及域信息的录入方法，并严格按照GB/T 7714-2015 标准测试了各种类型的文献。 +biblatex-gb7714-2015宏包除了提供严格遵守GB/T 7714-2015标准的格式外，还通过增加新的用户设置选项，使用户可以根据自己的需求很灵活地调整参考文献表的生成。包括标签的对齐方式(gbalign选项)、出版项缺省时的处理(gbpub选项)、作者缺省时的处理(gbnoauthor选项)、作者姓名格式的调整(gbnamefmt选项)、文献类型和载体标识的输出控制(gbtype选项)、析出文献标识符\texttt{//}控制(gbpunctin选项)、GBK编码文档兼容性(gbcodegbk选项)、域的默认格式还原(gbfieldstd选项)、标题的超链接控制(gbtitlelink选项)、双语对照文献表等。能通过标注和著录分别采用著者-出版年制（即作者年制）、顺序编码制样式实现特殊的参考文献格式，并尽最大可能利用biblatex的选项来实现一些特殊需求，比如文献表中作者数量大于3、标注中仅给出第一作者的姓、参考文献表按拼音或笔画排序等等。 \end{enumerate} -样式文件由如下文件构成: - -顺序编码制的 \zd{gb7714-2015.bbx}，\zd{gb7714-2015.cbx} 文件和作者年制的 -\zd{gb7714-2015ay.bbx}，\zd{gb7714-2015ay.cbx} 文件。 - -说明文档源文件包括: - -\zd{biblatex-gb7714-2015.tex}，\zd{eg*.tex}分别是本样式说明文档和测试用例。 - -脚本文件包括: - -\zd{*.bat}和\zd{*.sh}分别是windows下和linux下的编译脚本。\zd{*.pl}是用来将gb7714格式的著录文献文本转换为bib文件的perl脚本， -\zd{*.dat}是用于转换的测试文本文件。 - -\subsection{biblatex宏包的参考文献生成方法} -biblatex生成参考文献有其优越性。笔者从最初开始学习latex时利用thebibliography环境生成参考文献，到后来对格式化参考文献有更多需求，开始寻求利用参考文献宏包，再到最后选择了使用biblatex宏包[也由于对bibtex语言不熟悉，偷懒不想学$( \hat{} \bot \hat{} )$]，经过大量的实践总结biblatex宏包参考文献生成的优点如下: - +%具体来讲，完成了4个方面的工作: +%\begin{enumerate} +% \item 完成了GB/T 7714-2015标准的完整实现，包括两种编制方式下的各类型参考文献著录格式和标注格式等基本内容，还包括: 双语文献格式，带页码的标注格式，作者年制下仅有年的标注格式和文献按语言集中并自动排序，起止卷期自动解析，增加gbnoauthor选项控制作者年制责任者缺省的处理，增加gbpub选项控制出版信息缺省时的处理，增加gbalign选项控制顺序编码制文献表的标签对齐方式，提供右对齐、左对齐和项对齐三种方式。 +% \item 实现了用户文献数据录入优化，用户在录入参考文献数据时，只需要录入文献的实际信息即可，不需要录入文献标识符和载体标识符，无需录入language或者其它域信息来区分中英文参考文献，实现中英文自动判断并处理。支持一些特殊或老的条目类型，比如standard，newspaper，www，mastersthesis，phdthesis等。 +% \item 实现了对biblatex不同版本的兼容，能够应用于biblatex3.2以前的老版本，也能用于3.3版姓名处理方式改变后的版本。即可以与texlive2014/2015/2016/2017配合使用，无需升级biblatex情况下直接使用biblatex-gb7714-2015宏包(即本样式)。 +% \bc{当然 ctex2.9.4 的用户可能要升级一下biblatex，因为ctex多年没有更新，其中的biblatex版本过低}。 +% \item 测试了样式文件在book/report/article文档类以及beamer类下的适用性，结果表明均能满足要求。文档详细介绍了样式文件的使用方法和注意事项，说明了各条目类型的著录格式及其在biblatex 中对应信息域的构成，以及域信息的录入方法，并严格按照GB/T 7714-2015 标准测试了各种类型的文献。 +%\end{enumerate} + +宏包文件结构如图\ref{fig:pkg:structure}所示: +\begin{figure}[!htb] +\centering +\begin{tikzpicture}[node distance=1.5cm] +%\definecolor{bluea}{rgb}{0.05,0.62,0.94} +\ttfamily +\node[align=center,fill=gbyellow!15,text width=4cm,inner sep=8pt] (project) {\textcolor{black}{Biblatex-gb7714-2015}}; + +\node[align=center,below of=project,draw=red,thick,text width=3.5cm] (manual) {\textcolor{black}{Manual of Package}}; +\node[align=center,left of=manual,xshift=-3cm,draw=blue,thick,text width=3.5cm] (style) {\textcolor{black}{Style Files}}; +\node[align=center,right of=manual,xshift=3cm,draw=orange,thick,text width=3.5cm] (script) {\textcolor{black}{Compiling Scripts}}; +\draw[color=cyan,thick] (project.south) -- (manual.north) ; +\draw[color=cyan,thick] (style.north) -- ($(style.north)+(0mm,3mm)$) ; +\draw[color=cyan,thick] (script.north) -- ($(script.north)+(0mm,3mm)$) ; +\draw[color=cyan,thick] ($(style.north)+(0mm,3mm)$) -- ($(script.north)+(0mm,3mm)$); + +\node[below of=style,fill=gbgrey!20,yshift=0.5cm,xshift=2mm,text width=2cm] (numbbx) {\tiny \textcolor{black}{gb7715-2015.bbx}}; +\node[below of=numbbx,fill=gbgrey!20,yshift=8mm,text width=2cm] (numcbx) {\tiny \textcolor{black}{gb7715-2015.cbx}}; +\node[below of=numcbx,fill=gbgrey!20,yshift=8mm,text width=2cm] (aybbx) {\tiny \textcolor{black}{gb7715-2015ay.bbx}}; +\node[below of=aybbx,fill=gbgrey!20,yshift=8mm,text width=2cm] (aycbx) {\tiny \textcolor{black}{gb7715-2015ay.cbx}}; +\node[below of=aycbx,fill=gbgrey!20,yshift=8mm,text width=2cm] (gbkdef) {\tiny \textcolor{black}{gb7715-2015-gbk.def}}; +\draw[color=blue,semithick] (numbbx.west) -- ($(numbbx.west)+(-3mm,0mm)$) ; +\draw[color=blue,semithick] (numcbx.west) -- ($(numcbx.west)+(-3mm,0mm)$) ; +\draw[color=blue,semithick] (aybbx.west) -- ($(aybbx.west)+(-3mm,0mm)$) ; +\draw[color=blue,semithick] (aycbx.west) -- ($(aycbx.west)+(-3mm,0mm)$) ; +\draw[color=blue,semithick] (gbkdef.west) -- ($(gbkdef.west)+(-3mm,0mm)$) ; +\draw[color=blue,semithick] ($(gbkdef.west)+(-3mm,0mm)$) -- ($(aycbx.west)+(-3mm,28.1mm)$) ; + +\node[below of=manual,fill=gbsteelblue!15,yshift=0.5cm,xshift=2mm,text width=2.8cm] (mtex) {\tiny \textcolor{black}{biblatex-gb7714-2015.tex}}; +\node[below of=mtex,fill=gbsteelblue!15,yshift=8mm,text width=2.8cm] (mpdf) {\tiny \textcolor{black}{biblatex-gb7714-2015.pdf}}; +\node[below of=mpdf,fill=gbsteelblue!15,yshift=8mm,text width=2.8cm] (egtex) {\tiny \textcolor{black}{example/eg*.tex}}; +\node[below of=egtex,fill=gbsteelblue!15,yshift=8mm,text width=2.8cm] (egbib) {\tiny \textcolor{black}{example/*.bib}}; +\draw[color=red,semithick] (mtex.west) -- ($(mtex.west)+(-3mm,0mm)$) ; +\draw[color=red,semithick] (mpdf.west) -- ($(mpdf.west)+(-3mm,0mm)$) ; +\draw[color=red,semithick] (egtex.west) -- ($(egtex.west)+(-3mm,0mm)$) ; +\draw[color=red,semithick] (egbib.west) -- ($(egbib.west)+(-3mm,0mm)$) ; +\draw[color=red,semithick] ($(egbib.west)+(-3mm,0mm)$) -- ($(egbib.west)+(-3mm,28.1mm)$) ; + +\node[below of=script,fill=gbblue!10,yshift=0.5cm,xshift=2mm,text width=2cm] (cpall) {\tiny \textcolor{black}{makeall.bat/sh}}; +\node[below of=cpall,fill=gbblue!10,yshift=8mm,text width=2cm] (cpfil) {\tiny \textcolor{black}{makefile.bat/sh}}; +\node[below of=cpfil,fill=gbblue!10,yshift=8mm,text width=2cm] (cpcln) {\tiny \textcolor{black}{makeclear.bat/sh}}; +\node[below of=cpcln,fill=gbblue!10,yshift=8mm,text width=2cm] (plspt) {\tiny \textcolor{black}{gb7714text*.pl/dat}}; +\draw[color=orange,semithick] (cpall.west) -- ($(cpall.west)+(-3mm,0mm)$) ; +\draw[color=orange,semithick] (cpfil.west) -- ($(cpfil.west)+(-3mm,0mm)$) ; +\draw[color=orange,semithick] (cpcln.west) -- ($(cpcln.west)+(-3mm,0mm)$) ; +\draw[color=orange,semithick] (plspt.west) -- ($(plspt.west)+(-3mm,0mm)$) ; +\draw[color=orange,semithick] ($(plspt.west)+(-3mm,0mm)$) -- ($(plspt.west)+(-3mm,28.1mm)$) ; +\end{tikzpicture} +\caption{宏包文件结构}\label{fig:pkg:structure} +\end{figure} + +其中，\zd{gb7714-2015.bbx/cbx}、\zd{gb7714-2015ay.bbx/cbx}分别为顺序编码制和作者年制样式文件，\zd{gb7715-2015-gbk.def}为GBK编码文档编译所需的支撑文件。 +\zd{biblatex-gb7714-2015.tex}，\zd{eg*.tex}为说明文档和测试用例。\zd{*.bat}、\zd{*.sh}分别为windows和linux下说明文档的编译脚本。\zd{*.pl}为gb7714格式著录文献表到bib文件的perl转换脚本，\zd{*.dat}为转换测试文献表。 + +\subsection{基于biblatex的参考文献生成方法} +笔者从最初开始学习latex时利用 thebibliography 环境生成参考文献，到对格式化有更多需求后开始寻求利用参考文献宏包，再到最后选择使用biblatex宏包，越发感觉到biblatex 在生成参考文献方面的巨大潜力。经过大量实践，总结其优点如下: +%[也由于对bibtex语言不熟悉，偷懒不想学$( \hat{} \bot \hat{} )$] \begin{enumerate} -\item 使用简单。样式随宏包加载，参考文献源bib文件利用addbibresource加载，打印文献表利用printbibliography命令可以在文档任意位置打印。参考文献只需三步编译，第一遍xelatex，第二遍biber，第三遍xelatex，当然如果需要反向超链接，除设置backref 选项外，还需要第四遍xelatex。例\ref{eg:compile:cmd} 给出编译命令，其中xelatex命令也可以用mklatex -xelatex 代替，--synctex=-1选项也可以是-synctex=1。 +\item 使用简单。样式随宏包加载，参考文献源bib文件利用addbibresource加载，打印文献表利用printbibliography命令可以在文档任意位置打印。参考文献只需三步编译，第一遍xelatex，第二遍biber，第三遍xelatex，当然如果需要反向超链接，除设置backref 选项外，还需要第四遍xelatex。例\ref{eg:compile:cmd} 给出编译命令，其中--synctex=-1 选项也可以是-synctex=1。而且这四步命令可以用一条命令latexmk -xelatex jobname.tex 代替。 - \begin{codetex}{使用biblatex宏包的文档编译命令}{eg:compile:cmd} + \begin{example}{使用biblatex宏包的文档编译命令}{eg:compile:cmd} + \begin{texlist} xelatex --synctex=-1 jobname.tex biber jobname xelatex --synctex=-1 jobname.tex xelatex --synctex=-1 jobname.tex - \end{codetex} + \end{texlist} + \end{example} %使用够方便 \item 划分自由。利用biblatex宏包可以在一个文档中生成任意数量的参考文献表，而不需要用include把分档划分成不同的文件来生成分章参考文献。利用refsection 和refsegment可以很方便地划分参考文献节，甚至还可以嵌套使用。 %划分很自由，划分无限制 %处理无限制，支持更全面 -\item 支持全面。后端处理程序biber处理大数据量参考文献毫无压力，不用担心bibtex可能存在的内存不足等局限，字符编码也支持utf-8，完全支持中文的bibtex键(引用关键字)。此外，biber还具有根据拼音和笔画排序(例\ref{eg:sort:bibercmd})、输出引用文献的数据(例\ref{eg:bibercmd:outbibfile})等其它更多功能。 +\item 支持全面。后端处理程序biber处理大数据量参考文献毫无压力，不用担心bibtex 可能存在的内存不足等局限，字符编码支持utf-8，完全支持中文的bibtex 键(引用关键字)。biber除了自身提供的大量功能，比如：动态数据修改、参考文献数据检查、输出引用文献的数据(例\ref{eg:bibercmd:outbibfile})等外， + 还能利用一些perl模块来实现一些其它功能，比如： + 实现文件编码的转换（perl 的Encode::CN 模块）， + 排序的本地化调整（perl的Unicode::Collation::locale 模块， + 根据拼音和笔画排序见例\ref{eg:sort:opts}、例\ref{eg:sort:bibercmd}）等。 - \begin{codetex}{中文文献排序时的biber选项}{eg:sort:bibercmd} - %按拼音排序，biber命令 - biber -l zh__pinyin jobname - %按笔画排序，biber命令 - biber -l zh__stroke jobname - \end{codetex} + \begin{example}{输出引用文献数据时的biber选项}{eg:bibercmd:outbibfile} + \begin{texlist} + biber jobname --output-format=bibtex + \end{texlist} + \end{example} - \begin{codetex}{输出引用文献数据时的biber选项}{eg:bibercmd:outbibfile} - biber jobname.tex --output-format=bibtex - \end{codetex} + \begin{example}{中文文献排序可利用biblatex选项}{eg:sort:opts} + \begin{texlist} + %按拼音排序，biblatex加载选项 + \usepackage[backend=biber,style=gb7714-2015ay,sortlocale=zh__pinyin]{biblatex} + %按笔画排序，biblatex加载选项 + \usepackage[backend=biber,style=gb7714-2015ay,sortlocale=zh__stroke]{biblatex}% + %此时，biber则正常编译不需手动加选项，因为排序调整方案（sort tailoring）已由biblatex给出。 + biber jobname + \end{texlist} + \end{example} + \begin{example}{中文文献排序也可利用biber选项}{eg:sort:bibercmd} + \begin{texlist} + %biblatex正常加载，即不设置排序的本地化调整方案 + \usepackage[backend=biber,style=gb7714-2015ay]{biblatex} + + %此时需利用biber选项给出本地化排序调整方案： + %按拼音排序，则设置-l zh__pinyin + biber -l zh__pinyin jobname + %按笔画排序，则设置-l zh__pinyin + biber -l zh__stroke jobname + \end{texlist} + \end{example} -\item 定制方便。biblatex宏包实现参考文献著录格式使用的是tex语言，相比传统的bibtex 语言学习更为容易。biblatex 提供了很多不同类型的参考文献标准样式，查看、参考和引用都很方便，因此定制起需要的参考文献格式也很便捷。 +\item 定制方便。biblatex宏包实现参考文献著录格式使用的是tex语法，相比传统的bibtex 语言学习更为容易。biblatex 提供了很多不同类型的参考文献标准样式，参考和引用都很方便，因此定制起需要的参考文献格式也很便捷。 %定制很容易 %\item 学习无障碍，因为biblatex宏包用的是tex语言，所以查看代码，学习都很方便，自然也便于生成需要的参考文献样式。 %\item 定制很容易，biblatex提供了很多不同的参考文献标准样式，学习参考都很方便，因此定制起需要的参考文献格式来非常容易。 @@ -96,10 +162,18 @@ biblatex生成参考文献有其优越性。笔者从最初开始学习latex时 %上述这些优点也是笔者决定编写符合GB/T 7714-2015标准的参考文献样式文件的原因之一。 -下面直接给出最小工作示例的tex源文档(例\ref{code:doc:structrue})，用以简单介绍biblatex宏包参考文献生成的一般方法。给出的详细注释，说明了使用biblatex的文档基本结构，所有基于biblatex生成参考文献的文档无论大小万变不离其宗，当然除tex文档外另需准备保存参考文献信息的bib文件(详见\ref{sec:bib:bibtex}节)。要进一步了解biblatex参考文献生成相关内容可以参考: biblatex宏包手册或者LaTeX 文档中文参考文献的biblatex解决方案 -\footnote{地址:\url{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}}。 - -\begin{codetex}{biblatex参考文献生成最小工作示例}{code:doc:structrue} +下面直接给出最小工作示例，用以介绍biblatex宏包参考文献生成的一般方法。 +例\ref{code:doc:structrue}对应的结果如图\ref{fig:eg:ref}所示。 +示例源代码给出了详细注释，说明了使用biblatex的tex文档的基本结构，所有基于 biblatex 生成参考文献的文档无论大小万变不离其宗，当然除tex源文档外还需准备保存参考文献信息的bib文件(详见\ref{sec:bib:bibtex}节)。要更全面深入了解biblatex的参考文献生成，可以参考: +\href{https://github.com/plk/biblatex}{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}} +或者 +\href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}{LaTeX 文档中文参考文献的biblatex解决方案} +\footnote{地址: +\url{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}}。 + +\begin{example}{biblatex参考文献生成最小工作示例}{code:doc:structrue} +\begin{texlist} \documentclass{article}%文档类 %导言区开始: %加载ctex宏包，中文支持 @@ -120,77 +194,263 @@ citestyle=gb7714-2015%,backref=true% %正文区开始: \begin{document} %正文内容，引用参考文献 -详见文献\cite{Peebles2001-100-100}\parencite{Miroslav2004--} -参考文献\cite[见][49页]{蔡敏2006--}\parencite[见][49页]{Miroslav2004--} +详见文献\cite{Peebles2001-100-100}\parencite{Babu2014--} +参考文献\cite[见][49页]{于潇2012-1518-1523}\parencite[见][49页]{Babu2014--} %打印参考文献表 \printbibliography[heading=bibliography,title=参考文献] \end{document} -\end{codetex} +\end{texlist} +\end{example} +\begin{refsection} +\begin{figure}[!htb] +\centering +\fbox{ +\parbox{16cm}{%\raggedright +详见文献\cite{Peebles2001-100-100}\parencite{Babu2014--} +参考文献\cite[见][49页]{于潇2012-1518-1523}\parencite[见][49页]{Babu2014--} +\renewcommand{\bibfont}{\zihao{-5}} +\printbibliography[heading=subbibliography,title=参考文献] +} +} +\caption{最小工作示例的结果}\label{fig:eg:ref} +\end{figure} +\end{refsection} -\subsection{gb7714-2015样式加载方式和选项说明} -\subsubsection{样式加载方式} -例\ref{code:doc:structrue}中给出了宏包和样式的基本加载方式，gb7714-2015样式类似。注意，当著录样式bibstyle和标注样式citestyle相同时，两者可以合并为一个选项style。比如: -\begin{codetex}{gb7714-2015顺序编码制加载方式}{eg:gb7714numeric} -\usepackage[backend=biber,bibstyle=gb7714-2015,citestyle=gb7714-2015]{biblatex} -%如果要设置参考文献表序号标签对齐方式的话请设置gbalign选项，如果要取消缺省出版项自动填补的话设置gbpub=false，比如: -\usepackage[backend=biber,style=gb7714-2015,gbalign=left,gbpub=true]{biblatex} -\end{codetex} +\subsection{gb7714-2015样式加载方式和选项} +\subsubsection{加载方式} +例\ref{code:doc:structrue}中给出了宏包和样式的基本加载方式。注意，当著录样式bibstyle和标注样式citestyle相同时，两者可以合并为一个选项style。比如: -\begin{codetex}{gb7714-2015作者年制加载方式}{eg:gb7714authoryear} +\begin{example}{顺序编码制(gb7714-2015)加载方式}{eg:gb7714numeric} +\begin{texlist} +%简单方式： +\usepackage[backend=biber,style=gb7714-2015]{biblatex} +%设置gbalign选项以改变文献表序号标签对齐方式，设置gbpub=false取消缺省出版项自填补信息，比如: +\usepackage[backend=biber,style=gb7714-2015,gbalign=gb7714-2015,gbpub=false]{biblatex} +%当文档为GBK编码且用pdflatex/latex编译时，应设置选项gbcodegbk=true： +\usepackage[backend=biber,style=gb7714-2015,gbcodegbk=true]{biblatex} +\end{texlist} +\end{example} + +\begin{example}{著者-出版年制(gb7714-2015ay)加载方式}{eg:gb7714authoryear} +\begin{texlist} +%简单方式： \usepackage[backend=biber,style=gb7714-2015ay]{biblatex} -%如果要取消缺省出版项自动填补的话设置gbpub=false，如果要使用佚名或NOAUTHOR代替补充缺失的author信息可以设置gbnoauthor=true，比如: -\usepackage[backend=biber,style=gb7714-2015ay,gbpub=true,gbnoauthor=true]{biblatex} -\end{codetex} +%设置gbpub=false取消缺省出版项自动填补信息，设置gbnoauthor=true以使用佚名或NOAUTHOR填补缺失的author信息: +\usepackage[backend=biber,style=gb7714-2015ay,gbpub=false,gbnoauthor=true]{biblatex} +%当文档为GBK编码且用pdflatex/latex编译时，应设置选项gbcodegbk=true： +\usepackage[backend=biber,style=gb7714-2015ay,gbcodegbk=true]{biblatex} +\end{texlist} +\end{example} -\begin{codetex}{参考文献文本转换为bib文件perl脚本使用方式}{eg:transtobib} +\begin{example}{参考文献文本转换为bib文件perl脚本使用方式}{eg:transtobib} +\begin{texlist} perl gb7714texttobib.pl in=textfilename out=bibfilename -\end{codetex} +\end{texlist} +\end{example} -\subsubsection{增加的选项}\label{sec:added:opt} -gb7714-2015样式增加了部分用于控制标签对齐、出版项缺省处理、责任者(作者)缺省处理的选项，使用方式与biblatex宏包选项完全相同: +\subsubsection{新增选项}\label{sec:added:opt} +样式包新增了一些选项，用于标签对齐方式、出版项缺省处理、责任者(作者)缺省处理等功能的控制，其使用方式与biblatex宏包选项完全相同: \begin{description} - \item[gbalign]=right，left，gb7714-2015. \hfill default is right + \item[gbalign]=\textbf{right}，left，center，gb7714-2015. \hfill default is right + + 为顺序编码制增加的选项，用于选择参考文献表序号标签的对齐方式。 + \begin{itemize} + \item gbalign=right，默认的list环境中的标签右对齐； + \item gbalign=left，是list环境中的标签左对齐； + \item gbalign=center，是list环境中的等宽标签，数字在[]内居中； + \item gbalign=gb7714-2015，是项对齐方式，即段落环境中标签使用原始宽度，标签与条目内容等间距。 + \end{itemize} + 该选项对作者年制无效。顺序编码制序号标签对齐方式测试， + 右对齐见: + \href{run:./example/testalignright.tex}{testalignright.tex}， + %\href{run:./example/egalignright.pdf}{egalignright.pdf}。 + 左对齐见: + \href{run:./example/testalignleft.tex}{testalignleft.tex}， + %\href{run:./example/egalignleft.pdf}{egalignleft.pdf}。 + 项对齐见: + \href{run:./example/testaligngb7714-2015.tex}{testaligngb7714-2015.tex}。 + %\href{run:./example/egaligngb7714-2015.pdf}{egaligngb7714-2015.pdf}。 + + \item[gbpub]=\textbf{true}，false. \hfill default is true + + 为控制出版信息缺失处理增加的选项。 + \begin{itemize} + \item gbpub=true，自动利用:[出版地不详]、[出版者不详]、[S.l.]、[s.n.]等填补缺省信息； + \item gbpub=false 则取消自动处理，使用标准样式的方式取消相应项的输出。 + \end{itemize} + 顺序编码制测试（作者年制类似）见: + \href{run:./example/testgbpubtrue.tex}{testgbpubtrue.tex}， + %\href{run:./example/eggbpubtrue.pdf}{eggbpubtrue.pdf}。 + \href{run:./example/testgbpubfalse.tex}{testgbpubfalse.tex}， + %\href{run:./example/eggbpubfalse.pdf}{eggbpubfalse.pdf}。 + + \item[gbbiblabel]=\textbf{bracket}，parens，plain，dot，box，circle. \hfill default is bracket + + 为顺序编码制增加的选项，用于选择参考文献表序号数字的格式。 + \begin{itemize} + \item gbbiblabel=bracket，序号数字由方括号包围，比如[1]； + \item gbbiblabel=parens，序号数字由圆括号包围，比如(1)； + \item gbbiblabel=dot，序号数字数字后面加点，比如1.； + \item gbbiblabel=plain，序号数字无装饰，比如1； + \item gbbiblabel=box，序号数字由方框包围，比如\framebox{1}； + \item gbbiblabel=circle，序号数字由圆圈包围，比如\textcircled{1}。 + \end{itemize} + + \item[gbnoauthor]=true，\textbf{false}. \hfill default is false + + 为作者年制增加的选项，用于控制责任者缺失时的处理。 + \begin{itemize} + \item gbnoauthor=false，当作者信息缺失时默认不做处理，使用标准样式的处理方式； + \item gbnoauthor=true，则根据GB/T 7714-2015 的要求进行处理，中文文献使用佚名来代替author，英文文献用 NOAUTHOR 来代替author。 + \end{itemize} + 测试结果见: + \href{run:./example/testgbnoauthortrueay.tex}{testgbnoauthortrueay.tex}， + %\href{run:./example/eggbnoauthortrueay.pdf}{eggbnoauthortrueay.pdf}。 + \href{run:./example/testgbnoauthorfalseay.tex}{testgbnoauthorfalseay.tex}， + %\href{run:./example/eggbnoauthorfalseay.pdf}{eggbnoauthorfalseay.pdf}。 + + \item[gbnamefmt]=\textbf{uppercase}，lowercase，givenahead，familyahead，pinyin. \hfill default is uppercase + + 为姓名大小写格式控制增加的选项。 + \begin{itemize} + \item gbnamefmt=uppercase，使大小写符合GB/T 7714-2015 的要求； + \item gbnamefmt=lowercase，大小写由输入信息确定不做改变； + \item gbnamefmt=givenahead，姓名的格式与biblatex标准样式的given-family格式一致，即名在前姓在后，类似于ieee的样式； + \item gbnamefmt=familyahead时，姓名的格式与biblatex 标准样式的family-given格式一致，即姓在前名在后，类似于APA 的样式； + \item gbnamefmt=pinyin 时，姓名的格式采用一种常见的中文拼音方式，比如对于 Zhao, Yu Xin 或 Yu Xin Zhao 这个姓名拼音格式化为ZHAO Yu-xin。 + \end{itemize} + \bc{注意：还可以利用 nameformat 域为某一具体条目设置该条目的姓名格式，比如：要在一个文献表中实现英文文献是givenahead 格式，而拼音的文献是pinyin风格，那么可以设置拼音文献的 nameformat 域为pinyin，而gbnamefmt设置为givenahead。条目中nameformat 域的局部设置优先于gbnamefmt的全局设置。}\par + \emph{注意：使用pinyin选项时，bib文件中文献的作者应给出完整的名而不是缩写，否则出来的效果未必令人满意}。 + 测试结果见： + \href{run:./example/testgbnamefmt.tex}{testgbnamefmta.tex}， + \href{run:./example/testcitenum.tex}{testcitenum.tex}， + \href{run:./example/testciteay.tex}{testciteay.tex}。 + + + \item[gbtype]=\textbf{true}，false. \hfill default is true + + 为控制是否输出题名后面的文献类型和载体标识符而增加的选项。 + \begin{itemize} + \item gbtype=true，根据GB/T 7714-2015 要求输出标识符，例如“在线的期刊析出文献题名[J/OL]”。 + \item gbtype=false，则不输出标识符，例如“在线的期刊析出文献题名”。 + \end{itemize} + + + + \item[gbpunctin]=\textbf{true}，false. \hfill default is true + + 为控制inbook,incollection,inproceedings中析出来源文献前的\texttt{//}符号而增加的选项。 + \begin{itemize} + \item gbpunctin=true，根据GB/T 7714-2015 要求输出\texttt{//}。 + \item gbpunctin=false，则输出默认的本地字符串， + 在英语中是\texttt{in:}，若要完全去掉该符号则可以在导言区增加命令 + \lstinline!\DefineBibliographyStrings{english}{in={}}!。 + \end{itemize} + + \item[gbctexset]=\textbf{true}，false. \hfill default is true + + 为控制参考文献标题内容的设置方式增加的选项。 + \begin{itemize} + \item gbctexset=true，参考文献标题内容可以通过重定义 bibname 或 refname 宏设置。比如利用ctex宏包进行设置： + \lstinline[breaklines]!\ctexset{bibname={title you want}}! + \item gbctexset=false，参考文献标题内容可以通过重定义本地字符串设置，比如： + + \lstinline[breaklines=true]!\DefineBibliographyStrings{english}{bibliography={title you want}}! + + \lstinline[breaklines=true]!\DefineBibliographyStrings{english}{references={title you want}}!。 + \end{itemize} + 当然除此之外，利用 printbibliography 命令的 title 选项进行设置依然是有效方式之一。比如: + + \lstinline[breaklines=true]!\printbibliography[title=title you want]!。 + + + \item[gbcodegbk]=true，\textbf{false}. \hfill default is false + + 为兼容GBK编码的文档增加的选项。 + \begin{itemize} + \item gbcodegbk=false，即默认是utf-8编码的文档。 + \item gbcodegbk=true，为利用pdflatex/latex编译GBK编码文档时使用。 + \end{itemize} + 当在源文档前面增加 XeTeX 原语：\lstinline!\XeTeXinputencoding "GBK"! 后，GBK编码的文档也可以使用xelatex编译，这时应设置为false或不给出该选项。测试文件见： + \href{run:example/filecodegbkeg.tex}{filecodegbkeg.tex}， + \href{run:example/filecodeutfeg.tex}{filecodeutfeg.tex}。 + + \item[gbstrict]=\textbf{true}，false. \hfill default is true + + 为避免输出bib文件中多余的域信息而增加选项，目的是为了兼容一些bib文件，因为某些bst样式文件进行中英文判断需要在bib文件中增加类似language这样的域作为支撑，而其中某些域在标准的biblatex样式文件中是默认输出的。 + \begin{itemize} + \item gbstrict=true，即默认不输出。 + \item gbstrict=false，需要还原标准样式的输出情况时使用。 + \end{itemize} - 为顺序编码制增加的选项，用于选择参考文献表序号标签的对齐方式。gbalign=right 是默认的右对齐; gbalign=left是左对齐; gbalign=gb7714-2015是项对齐方式。对于作者年制该选项无效。测试结果见第\ref{sec:align:test}节 - \item[gbpub]=true，false. \hfill default is true + \item[gbfieldstd]=true，\textbf{false}. \hfill default is false - 为控制出版信息缺失处理增加的选项。默认选择gbpub=true，自动利用:[出版地不详]，[出版者不详]，[S.l.]，[s.n.]等填补缺省信息; 设置gbpub=false 时，则取消自动处理，使用标准样式的方式取消相应项的输出。 - 测试结果见第\ref{sec:opt:gbpub}节。 + 为控制一些域如标题，网址，卷域的格式而增加选项。目的是使用一些标准样式的处理来增加格式多样性。 + \begin{itemize} + \item gbfieldstd=false，即默认使用GB/T 7714-2015要求的样式。 + \item gbfieldstd=true，即还原使用标准样式的格式，比如使用引号，字体，加引导词等。当然要调整这些格式也可采用biblatex提供的更为直接的设置域格式的方式。 + \end{itemize} - \item[gbnoauthor]=true，false. \hfill default is false - 为作者年制增加的选项，用于控制责任者缺失时的处理。默认选择gbnoauthor=false，当作者信息缺失时不做处理，使用标准样式的处理方式; 设置gbnoauthor=true 时，则根据GB/T 7714-2015 的要求进行处理，中文文献使用佚名来代替author，英文文献用NOAUTHOR 来代替author。 - 测试结果见第\ref{sec:opt:noauthor}节。 + \item[gbtitlelink]=true，\textbf{false}. \hfill default is false - \item[gbnamefmt]=uppercase，lowercase，none，pinyin. \hfill default is uppercase + 为设置标题的超链接增加的选项。 + \begin{itemize} + \item gbtitlelink=false，即默认不给标题设置超链接。 + \item gbtitlelink=true，当文献存在url 域时为文献标题设置超链接。 + \end{itemize} + 测试文件见： + \href{run:example/testopttitlelink.tex}{testopttitlelink.tex}。 - 为姓名大小写格式控制增加的选项。默认选择gbnamefmt=uppercase，大小写要求符合GB/T 7714-2015 的要求。gbnamefmt=lowercase 时，大小写根据输入信息确定。gbnamefmt=none时，姓名的格式与biblatex标准样式一致。gbnamefmt=pinyin时，姓名的格式采用一种常用的中文拼音全拼方式，比如对于 Zhao, Yu Xin 或 Yu Xin Zhao 这个姓名拼音格式化为ZHAO Yu-xin。\emph{需要注意当使用pinyin选项时，姓名中应给出完整的名而不是名的缩写，否则出来的效果未必好看}。 - 测试结果见第\ref{sec:opt:namefmt}节。 - - \item[gbtype]=true，false. \hfill default is true - - 为控制是否输出题名后面的文献类型和载体标识符而增加的选项。默认选择gbtype=true，根据GB/T 7714-2015 要求输出标识符，例如“在线的期刊析出文献题名[J/OL]”。而gbtype=false 时，不输出标识符，例如“在线的期刊析出文献题名”。 \end{description} \subsubsection{与标准选项的兼容性} -绝大部分biblatex标准样式选项可与gb7714-2015样式联合使用，下面给出一些经过兼容性测试的选项说明。需要注意的是:使用gb7714-2015样式时(即style=gb7714-2015)，backend选择应指定为biber，还有一些选项已经在样式设计中固定，不能修改设置。比如sorting，maxnames，minnames，date，useprefix，giveninits等。 +绝大部分biblatex标准样式选项可与gb7714-2015样式联合使用，下面给出一些经过兼容性测试的选项说明。需要注意的是:使用gb7714-2015样式时(即style=gb7714-2015)，backend选择应指定为biber，还有一些选项已经在样式设计中固定，如果要严格使用国标样式，一般不应做修改，比如sorting，maxnames，minnames，date，useprefix，giveninits等，但如果用户有自己的其它需求，则可按需修改。 \begin{description} \item[url]=true, false. \hfill default: true 该选项控制是否打印 url 域并获取日期。该选项只影响 url 信息是可选的那些条目类型。而 @online 条目的 url 域总是会打印出来。它是导言区选项，与样式相关，gb7714-2015样式做了特别支持，可以兼容使用。 + \item[giveninits]=true, false. \hfill default: true + + 启用该选项时姓名中的名部分会用首字母表示。 + \item[uniquelist]=true, false, minyear \hfill default: minyear 该选项用于作者年制样式，用于正文中引用(标注)标签的作者列表控制(目的是消除歧义)。当uniquelist=true时，自动利用扩展作者姓名列表长度的方式消除labelname 列表的歧义; 当=false 时则禁用扩展，标签仅使用一个作者，消除歧义通过跟在年份后面的字母实现; 默认使用minyear，即当被截短的作者姓名列表存在歧义时，只有当年份相同，才会扩展列表长度以消除歧义。 注意当使用uniquelist=false后标签只有一个作者，但文中可能有同姓作者的文献，这时根据uniquename选项的设置，biblatex会使用姓名的其它部分比如名来消除歧义，但如果想强制要求仅用姓作为文中的标注标签，那么可以设置uniquename=false，但此时标注是可能存在歧义的。 + \item[maxnames]=整数 \hfill default: 3 + + 影响所有名称列表（\bibfield{author}、\bibfield{editor} 等）的阈值。如果某个列表超过了该阈值，即，它包含的姓名数量超过 \prm{integer}，那么就会根据 \opt{minnames} 选项的设置进行自动截断。\opt{maxnames} 是设置 \opt{maxbibnames} 和 \opt{maxcitenames} 两个选项的支配选项。 + + \item[minnames]=整数 \hfill default: 3 + + 影响所有名称列表（\bibfield{author}、\bibfield{editor} 等）的限制值。如果某个列表包含的姓名数量超过 \prm{integer}，那么就会自动截断至\opt{minnames}个姓名。\prm{minnames} 的值必须小于或等于 \prm{maxnames}。\opt{minnames} 是设置 \opt{minbibnames} 和 \opt{mincitenames} 两个选项的支配选项。 + + \item[maxbibnames]=整数 \hfill default: \prm{maxnames} + + 类似于 \opt{maxnames} 但只影响参考文献表。 + + \item[minbibnames]=整数 \hfill default: \prm{minnames} + + 类似于 \opt{minnames} 但只影响参考文献表。 + + \item[maxcitenames]=整数 \hfill default: \prm{maxnames} + + 类似于 \opt{maxnames} 但只影响正文中的标注(引用)。 + + \item[mincitenames]=整数 \hfill default: \prm{minnames} + + 类似于 \opt{minnames} 但只影响正文中的标注(引用)。 + \item[hyperref]=true, false, auto. \hfill default: auto 是否将引用和后向引用转化为可点击的超链接。这是宏包的载入时选项，与样式无关，自然可以使用。 @@ -215,21 +475,60 @@ gb7714-2015样式增加了部分用于控制标签对齐、出版项缺省处理 类似于 date 选项，但控制的是由DeclareLabeldate 选择的日期域的格式。 + \item[doi]=true,false. \hfill default: true + + 该选项控制是否打印 \bibfield{doi} 域。 + + \item[isbn]=true,false. \hfill default: true + + 该选项控制是否打印 \bibfield{isbn}\slash \bibfield{issn}\slash \bibfield{isrn} 等域。 + + \item[sortlocale]=auto, locale. \hfill default: auto + + 该选项控制排序的本地化调整方案。对于英文文献，该选项不需要设置。对于中文文献当有按拼音或笔划等进行排序的需求时，可以设置相应的本地化调整方案。主要的调整方案有： + \begin{itemize} + \item \verb|sortlocale=auto| 或者不设置该选项，为unicode编码顺序 + \item \verb|sortlocale=zh|，为unicode编码顺序 + \item \verb|sortlocale=zh__pinyin|，为拼音顺序 + \item \verb|sortlocale=zh__big5han|，为big5 编码顺序 + \item \verb|sortlocale=zh__gb2312han|，为GB-2312 顺序 + \item \verb|sortlocale=zh__stroke|，为笔划数顺序 + \item \verb|sortlocale=zh__zhuyin|，为注音顺序 + \end{itemize} + + \item[language]=autobib, autocite, auto, \prm{language}. \hfill default: autobib + + 详细说明见biblatex手册。 + + \item[autolang]=none, hyphen, other, other*, \prm{langname}. \hfill default: + + 结合langid/langidopts域，结合babel/polyglossia宏包，可以对西文做基于条目的本地化处理。详细说明见biblatex 手册。 + + \item[sortcites]=true, false. \hfill default: false + + 详细说明见biblatex手册。 + + \item[autocite]=plain, inline, footnote, superscript. \hfill default: plain + + 详细说明见biblatex手册。 + + \item[block]=none, space, par, nbpar, ragged. \hfill default: none + + 详细说明见biblatex手册。 + + \item[indexing]=true, false, cite, bib. \hfill default: false + + 详细说明见biblatex手册。 + \item[其它]=下面还有很多选项，有些是宏包载入时选项，与样式无关，一般可以使用，但笔者没有做测试，各位朋友可以测试使用。选项的作用可以参考biblatex 使用手册，以及笔者和Wenbo 翻译的中文版。 \begin{itemize} \item related=true, false. default: true \item defernumbers=true, false default: false - \item sortcites=true, false default: false \item maxitems=integer default: 3 \item minitems=integer default: 1 - \item autocite=plain, inline, footnote, superscript, ... \item autopunct=true, false default: true - \item language=autobib, autocite, auto,language default: autobib \item clearlang=true, false default: true - \item autolang=none, hyphen, other, other*, langname default: none - \item block=none, space, par, nbpar, ragged default: none \item notetype=foot+end, footonly, endonly default: foot+end - \item indexing=true, false, cite, bib default: false \item backrefstyle=none, three, two, two+, three+, all+ default: three \item backrefsetstyle=setonly, memonly, setormem, setandmem, memandset, setplusmem default: setonly \item loadfiles=true, false default: false @@ -239,55 +538,62 @@ gb7714-2015样式增加了部分用于控制标签对齐、出版项缺省处理 \item arxiv=abs, ps, pdf, format default: abs \item mincrossrefs=integer default: 2 \item minxrefs=integer default: 2 - \item isbn=true, false default: true - \item doi=true, false default: true \item eprint=true, false default: true \end{itemize} \end{description} -\subsection{样式文件的进一步说明} +\subsection{gb7714-2015样式的进一步说明} \subsubsection{关于参考文献数据源: bib文件的说明}\label{sec:bib:bibtex} 参考文献数据以bibtex格式保存在bib文件中。生成参考文献除tex源文档外，还需创建参考文献数据源文件即bib文件。bib文件数据源准备完成后，在加载biblatex宏包时，使用addbibresource命令将其加载进tex源文档中。\bc{注意:数据源可以加载多个，比如多个章节的参考文献放在不同的bib文件中，那么全部加载进来即可}。 -bib文件中的参考文献信息是以条目形式组织，一篇文献创建一条记录即一个参考文献条目，一个条目由若干个数据域构成。文献的各部分信息应录入到条目的对应数据域中。GB/T 7714-2015标准中的文献类型与本样式中条目类型对应关系如表\ref{tab:entrytypes}所示，各类条目具体的著录格式详见\ref{sec:numeric:data}节。 +bib文件中的参考文献信息是以条目形式组织，一篇文献创建一条记录即一个参考文献条目，一个条目由若干数据域构成。文献的各部分信息应录入到条目的对应数据域中。GB/T 7714-2015标准中的文献类型与本样式中条目类型对应关系 +如表\ref{tab:entrytypes}所示， +各类条目具体的著录格式详见\ref{sec:numeric:data}节。 \begin{table}[!htb] \centering \caption{常见条目类型}\label{tab:entrytypes} -\begin{tabular}{cl} +\small +\begin{tabular}{clc} \hline - GB/T 7714-2015标准中的参考文献类型 & biblatex中的条目类型\\ \hline - 专著& book\\ - 标准& standard/book or inbook with field note=standard\\ - 专著中的析出文献& inbook\\ - 连续出版物& periodical\\ - 连续出版物的析出文献& article\\ - 报纸析出的文献& newspaper/article with field note=standard\\ - 专利& patent\\ - 电子资源& online/www/electronic\\ - 会议录或会议文集& proceedings\\ - 会议文集中析出的文献& inproceedings/conference\\ - 汇编或论文集& collection\\ - 汇编或论文集析出中的文献& incollection\\ - 学位论文& thesis/mastersthsis/phdthsis\\ - 报告& report/techreport\\ - 手册或档案& manual\\ - 未出版物& unpublished\\ \hline + GB/T 7714-2015标准中的参考文献类型 & biblatex中的条目类型 & 类型标识代码\\ \hline + 专著& book & M\\ + 标准& standard/book or inbook with field note=standard& S\\ + 专著中的析出文献& inbook & M\\ + 连续出版物& periodical& J\\ + 连续出版物的析出文献& article& J\\ + 报纸析出的文献& newspaper/article with field note=standard& N\\ + 专利& patent& P\\ + 电子资源或电子公告& online/www/electronic& EB\\ + 会议录或会议文集& proceedings& C\\ + 会议文集中析出的文献& inproceedings/conference& C\\ + 汇编或论文集& collection& G\\ + 汇编或论文集析出中的文献& incollection& G\\ + 学位论文& thesis/mastersthsis/phdthsis& D\\ + 报告& report/techreport& R\\ + 手册& manual& A\\ + 档案& archive/manual& A\\ + 数据库& database& DB\\ + 数据集& dataset& DS\\ + 软件& software& CP\\ + 舆图& map& CM\\ + 未出版物& unpublished& Z\\ + 其它& misc& Z\\ + \hline \end{tabular} \end{table} 组成各个条目的不同数据域(字段)保存有参考文献的各部分信息，比如作者、标题、出版项、日期等等，这些在标准中称为著录项目， -其对应关系如表\ref{tab:entryfields}所示。需要注意的是，note域在本样式中也做特殊用途，即在book类型的note域中输入standard表示标准，在aritcle类型的note域中输入news表示报纸，当然也可以不做特殊用，而只是表示杂项信息，因为标准和报纸可以用standard和newspaper类型表示，尽管这两种类型不是biblatex原生的条目类型。而usera域用于表示参考文献类型和载体标识符，一般不用出现在bib文件中，而由样式文件自动处理得到，这也为了使bib文件更纯粹，也为了兼容不同的样式，因为如果在bib文件中给出usera域，如果某一样式需要使用usera域且用途不同，那么就会有兼容性问题。当然不用手动输入这一信息也可以为用户减负，因为用户可以直接使用从网络导出参考文献信息而不用再额外添加一个参考文献类型和载体标识符。本宏包自动判断语言，而不使用一个表示语言的域比如language来标记文献的语言类型也处于同样的考虑，当然还有一篇文献中存在多语言的情况是无法用一个language标识的，比如一本英文著作被翻译为中文，那么原作者是英文，而译者则是英文，这时标记language就存在困难。 - -各个数据域的录入应符合bib文件规范。\bc{需要注意: 有时直接从网络获取的参考文献信息中可能带有一些特殊字符比如\%，\&等，这些字符在tex中通常需要做转义处理，本样式中对像title，journal等常见的域中出现的特殊字符已经做了转义，但是一些不常见的域比如abstract等没有考虑，所以用户需要手动处理，例如把\%改为\textbackslash \%，否则可能导致出错}。下面详细介绍本样式中使用的域及其数据录入方式: +其对应关系如表\ref{tab:entryfields}所示。 \begin{table}[!htb] \centering \caption{常见信息域}\label{tab:entryfields} +\small \begin{tabular}{cl} \hline GB/T 7714-2015中的文献著录项目 & biblatex中的域\\ \hline @@ -312,11 +618,16 @@ bib文件中的参考文献信息是以条目形式组织，一篇文献创建 引用日期 & urldate\\ 数字对象标识符 & doi\\ 杂项 & note\\ - 文献类型载体标识符 & usera\\ + 文献类型标识符 & usera/mark\\ + 文献载体标识符 & medium\\ \hline \end{tabular} \end{table} +需要注意的是，note域在本样式中也做特殊用途，即在book类型的note域中输入standard表示标准，在aritcle类型的note域中输入news表示报纸，当然也可以不做特殊用，而只是表示杂项信息，因为标准和报纸可以用standard和newspaper类型表示，尽管这两种类型不是biblatex原生的条目类型。而usera域用于表示参考文献类型和载体标识符（为兼容Lee zeping的bst样式使用的bib文件也可以用mark和medium表示）。一般情况下usera，mark，medium这些域不用在bib文件中输入，而由样式文件自动处理得到，既为了使bib文件更纯粹，也为了兼容不同的样式。想象一下如果在bib文件中给出usera域，但另一样式需要使用usera域且用途不同，那么就会有兼容性问题。不用手动输入更重要的目的是为用户减负，因为用户可以直接使用从网络（各种学术）导出参考文献信息而不用再额外添加一个参考文献类型和载体标识符。本宏包自动判断语言而不使用一个表示语言的域比如language来标记文献的语言类型也出于同样的考虑，当然也有一种情况即一篇文献中存在多中语言是无法用一个language标识的，比如一本英文著作被翻译为中文，那么原作者是英文，而译者则是中文，这时标记language的意义不大。标记language更多的是用在多种语言混合的文档中，可以用language来标记英语、中文、日语、法语和德语等用于分语言排序。 + +各个数据域的录入应符合bib文件规范。\bc{需要注意: 有时直接从网络获取的参考文献信息中可能带有一些特殊字符比如\%，\&等，这些字符在 tex 中通常需要做转义处理，本样式中对像title，journal等常见域中出现的特殊字符已经做了转义，但是一些不常见的域比如 abstract 等没有考虑，所以用户需要手动处理，例如把\%改为\textbackslash \%，否则可能导致出错}。下面详细介绍本样式中使用的域及其数据录入方式: + \begin{description} \item[author] 在biblatex中author域属于name数据类型，输入数据时，各姓名间用and 连接，当姓名过多省略时，用others代替。 @@ -342,7 +653,6 @@ bib文件中的参考文献信息是以条目形式组织，一篇文献创建 \{International Federation of Library Association and Institutions\} \item[title] 直接输入需要打印的内容，subtitle或titleaddon域类似 - \item[usera] 不用输入，自动处理 \item[translator] 与author域类似，只是输入的是译者 \item[edition] 直接输入整数，或者需要打印的内容 \item[location] 直接输入需要打印的地址内容，而address域在biblatex中作为location别名，表示相同的内容。 @@ -372,7 +682,13 @@ bib文件中的参考文献信息是以条目形式组织，一篇文献创建 \item[volume] 连续出版物的卷，格式化输入用整数，当有范围时中间用短横线连接，比如:1-4。当无法解析时，输入内容被认为是需要完整打印的内容。 \item[number] 连续出版物的期或报纸的版次，输入与volume类似。或者是专利等的号时，直接输入需要打印的内容。 \item[journal] 用于连续出版物析出文献，表示连续出版物的题名，直接输入需要打印的内容。journaltitle，journalsubtitle域类似处理。 - \item[version] 用于report和manual的版本信息，直接输入需要打印的内容。 + \item[version] 用于report和manual的版本信息，直接输入需要打印的内容。 + \item[mark/usera] 不用输入，自动处理。也可以输入文献类型标识符比如M, J, DB, CP等。 + \item[medium] 不用输入，自动处理。也可以输入文献载体标识符比如MT, DK, CD, OL 等。 + \item[language] 不用输入，自动处理。也可以输入语言类型比如english, russian, french, japnese, korean, chinese等。 + \item[langid] 不用输入，自动处理。也可以输入语言名比如english, russian, french等，中日韩语一般用english。 + \item[nameformat] 不用输入。当需要调整当前条目的作者姓名的格式时，可以输入格式名：uppercase, lowercase, givenahead, familyahead, pinyin等。 + \item[namefmtid] 不用输入。 \end{description} 除了上述输入内容要求外，GB/T 7714-2015还有对数字、字母大小写等有一些格式要求，这些细节需要注意，请参考: @@ -388,59 +704,289 @@ bib文件中的参考文献信息是以条目形式组织，一篇文献创建 \subsubsection{关于参考文献著录样式: bbx文件的说明}\label{sec:usage:bbx} -参考文献著录样式也称著录表样式或著录格式，主要分两类:顺序编码制和编码年制。 +参考文献著录样式也称著录表样式或著录格式，主要分两类:顺序编码制和作者年制(著者-出版年制)。 + %顺序编码制的参考文献样式基于标准样式numeric-comp/numeric修改得到 -顺序编码制样式中各条参考文献条目以数字序号按引用先后顺序组织。著录格式中序号格式见\ref{sec:bib:serialno}节，各类型文献条目的著录格式见\ref{sec:numeric:data}节，参考文献条目中各信息域及其录入方式见\ref{sec:bib:bibtex}节。 +\paragraph{顺序编码制样式}中各条参考文献条目以数字序号按引用先后顺序组织。著录格式中序号格式见\ref{sec:bib:serialno}节，各类型文献条目的著录格式见\ref{sec:numeric:data}节，参考文献条目中各信息域及其录入方式见\ref{sec:bib:bibtex}节。 %作者年制的参考文献样式则基于标准样式authoryear修改。 -作者年制样式中各条参考文献条目以作者-年为标签以一定的顺序排列。作者年制的著录格式与顺序编码制基本相同(除了把年份提到了作者后面作为文献条目内的标签)。数据源bib文件中各条目的数据录入与顺序编码制完全一致。 +\paragraph{作者年制样式}中各条参考文献条目以作者-年为标签以一定的顺序排列。作者年制的著录格式与顺序编码制基本相同(除了把年份提到了作者后面作为文献条目内的标签)。数据源bib文件中各条目的数据录入与顺序编码制完全一致。 -\qd{注意: 因为作者年制有分文种文献集中的要求，所以修改nyt排序格式，增加userb作为name前的排序域，默认情况下，本样式文件将作者为中文的文献的userb域设置成cn，英文的设置成en。这一设置过程，在biber处理时自动完成。当出现问题或者有更多文种分集且有特殊顺序时，可以为bib文件中给相应文种文献的userb域手动设置适合排序的字符串。比如: 中文文献设置为cn，英文文献设置为en，法文文献设置为fr，那么排序中，相应的中文文献排在最前面，英文文献在中间，法文文献最后，因为升序情况下字母顺序是c然后e然后f。} +\qd{作者年制有分文种文献集中的要求，因此gb7714-2015排序模板以nyt模板为基础，增加 language 作为 name 前的排序域。默认情况下，本样式文件将标题(或作者)为中文的文献的 language 域设置成 chinese，英文的设置成 enlish。这一设置过程，在biber 处理时自动完成。当出现问题或者有更多文种分集且有特殊顺序时，可以在bib文件中为相应文种文献的 language 域手动设置适合排序的字符串。比如: 中文文献设置为 chinese，英文文献设置为 enlish，法文文献设置为 french，那么排序中，相应的中文文献排在最前面，英文文献在中间，法文文献最后，因为升序情况下字母顺序是c然后e然后f。} %上一段2016-1114更新，下面是以前的说法。 %\qd{根据文种文献集中的要求，修改了nyt排序格式，增加了userb作为name前的排序域，当有需求进行多文种分集且有特殊顺序时，在bib文件中给相应文种的文献设置适合排序的字符串。比如中文文献设置为cn，英文文献设置为en，法文文献设置为fr，那么排序中，相应的中文文献排在最前面，英文文献在中间，法文文献最后，因为升序情况下字母顺序是c然后e然后f。} +\paragraph{文献表字体、颜色、间距、缩进控制} 为方便用户改变文献表内容的字体和颜色等，在biblatex提供的bibfont命令基础上，增加了bibauthorfont、bibtitlefont、bibpubfont 等命令用于控制文献不同部分的格式，比如作者，标题，出版项等。增加了尺寸bibitemindent 用于控制参考文献条目在文献表中的缩进，其意义与 list 环境中 itemindent 相同。 +用法具体见例\ref{eg:biblist:fontset}， +测试用例见\href{run:example/testfontinbiblio.tex}{testfontinbiblio.tex}。 + +\begin{example}{文献表字体、颜色、间距、缩进控制}{eg:biblist:fontset} +\begin{texlist} +% 换行的控制 +% +% 选项 block=none , space , par , nbpar , ragged +%\renewcommand*{\newblockpunct}{\par\nobreak} + +% 字体的控制：\textit，sl，emph-楷体，\textbf，sf-黑体，\texttt-仿宋，\textsc，md，up-宋体 +% +% 全局字体 +\renewcommand{\bibfont}{\zihao{-5}}%\fangsong +% 标题字体 +\renewcommand{\bibauthorfont}{\bfseries\color{teal}}% +\renewcommand{\bibtitlefont}{\ttfamily\color{blue}}% +\renewcommand{\bibpubfont}{\itshape\color{violet}}% +% url和doi字体 +\def\UrlFont{\ttfamily} %\urlstyle{sf} %\def\UrlFont{\bfseries} + +% 间距的控制 +\setlength{\bibitemsep}{0ex} +\setlength{\bibnamesep}{0ex} +\setlength{\bibinitsep}{0ex} + +% 文献表中各条文献的缩进控制 +%\setlength{\bibitemindent}{0em} % bibitemindent表示一条文献中第一行相对后面各行的缩进 +%\setlength{\bibhang}{0pt} % 作者年制中 bibhang 表示的各行起始位置到页边的距离，顺序编码制中 bibhang+labelnumberwidth 表示各行起始位置到页边的距离 + + +% 标点类型的控制（全局字体能控制标点的字体） +\end{texlist} +\end{example} + \subsubsection{关于参考文献标注样式: cbx文件的说明}\label{sec:cbx:usage} 正文中的参考文献标注样式也称引用样式或引用标签样式，也分两类: 顺序编码制和作者年制。 + %顺序编码制的标注样式文件大体使用标准引用样式numeric-comp的内容 -顺序编码制的标注样式大体使用标准标注样式numeric，仅对cite等部分命令做了修改。为满足GB/T 7714-2015第10.1.3节的要求，增加了pagescite命令。为方便在同一文章中同时使用上标和非上标的标注方式，仅将cite命令修改为上标模式，而parencite保留标准样式提供的非上标模式。这些命令使用方式如下: +\paragraph{顺序编码制的标注样式} 大体使用标准标注样式numeric，仅对cite等部分命令做了修改。为满足GB/T 7714-2015第10.1.3节的要求，增加了pagescite命令。为方便在同一文章中同时使用上标和非上标的标注方式，仅将cite命令修改为上标模式，而parencite保留标准样式提供的非上标模式。为使用户免于输入文献作者来作为句子主语，完善了textcite命令并增加了authornumcite命令以同时输出作者和顺序编码。 +使用方式如例\ref{eg:citefornumeric}所示。 +测试文档见\href{run:example/testtextcite.tex}{testtextcite.tex}， +\href{run:example/testcitenum.tex}{testcitenum.tex}。 -\begin{codetex}{顺序编码制cbx样式命令使用说明}{eg:citefornumeric} +\begin{example}{顺序编码制cbx样式命令使用说明}{eg:citefornumeric} +\begin{texlist} 不带页码的引用(上标，方括号包围): - \cite{Peebles2001-100-100} + \cite{Peebles2001-100-100}\upcite{Peebles2001-100-100} + \supercite{Peebles2001-100-100} 不带页码的引用(非上标，方括号包围): \parencite{Miroslav2004--} 带页码的引用: \cite[见][49页]{蔡敏2006--} \parencite[见][49页]{Miroslav2004--} - \pagescite{Peebles2001-100-100} \pagescite[][201-301]{Peebles2001-100-100} + \pagescite{Peebles2001-100-100}\pagescite[150]{Peebles2001-100-100} + \pagescite[][201-301]{Peebles2001-100-100} +同时输出作者和顺序编码的三种引用方式： + （a）直接的方法：见\citeauthor{refb}\cite{refb}, \citeauthor{refc}\cite{refc} + （b）定义新的标注命令：见\authornumcite{refb,refc} + （c）用textcite但没有上标：见\textcite{refb,refc} 在页脚中引用和打印文献表: \footnote{在脚注中引用\footcite{赵学功2001--}} \footfullcite{赵学功2001--} -\end{codetex} + \end{texlist} +\end{example} -其中，当不指定页码时，pagescite命令默认调用参考文献的页码数据进行输出，如果需要指定页码，那么需要在第二个[]内输入页码内容。 +其中，当不指定页码时，pagescite命令默认调用参考文献的页码数据进行输出，如果需要指定页码，那么需要在[]内或第二个[]内(当有两个[]时)输入页码。 + +\qd{对于多个文献一起的压缩形式，指定页码只会应用最后一个参考文献的页码，这是不正确的，但这种情况其实本不应出现，因为指定页码本来就需要具体化指某一文献。使用时请尽可能使用pagescite\{key1\}pagescite\{key2\}这种形式而不是pagescite\{key1,key2\}。} -\qd{注意:对于多个文献一起的压缩形式，指定页码只会应用最后一个参考文献的页码，这是不正确的，但这种情况其实本不应出现，因为指定页码本来就需要具体化指某一文献。使用时请尽可能使用pagescite\{key1\}pagescite\{key2\}这种形式而不是pagescite\{key1,key2\}。} %作者年制的标注样式文件大体使用标准引用样式authoryear的内容。 -作者年制的标注样式情况类似。对cite，parencite进行了修改，将引用标签用圆括号括起来。为满足GB/T 7714-2015第10.2.4节的要求，增加了pagescite命令。为满足GB/T 7714-2015第10.2.1节的要求，增加了yearpagescite命令用于处理文中已有作者信息只需要年份和页码的情况(为兼容考虑，顺序编码制也给出该命令，但作用与pagescite命令相同)。使用方式如下: +\paragraph{作者年制的标注样式} 情况类似。对cite，parencite进行了修改，将引用标签用圆括号括起来。为满足GB/T 7714-2015第10.2.4节的要求，增加了pagescite命令。为满足GB/T 7714-2015第10.2.1节的要求，增加了yearpagescite，yearcite命令用于处理文中已有作者信息只需要年份和页码的情况(为兼容性考虑，顺序编码制也给出该命令，但作用与pagescite命令相同)，也完善了textcite命令为句子提供主语。 +使用方式如例\ref{eg:citeforauthoryear}所示。 +测试文档见\href{run:example/testtextciteay.tex}{testtextciteay.tex}， +\href{run:example/testciteay.tex}{testciteay.tex}。 + -\begin{codetex}{作者年制cbx样式命令使用说明}{eg:citeforauthoryear} +\begin{example}{作者年制cbx样式命令使用说明}{eg:citeforauthoryear} +\begin{texlist} 不带页码的引用: \cite{Peebles2001-100-100} \parencite{Miroslav2004--} 带页码的引用: \cite[见][49页]{蔡敏2006--} \parencite[见][49页]{Miroslav2004--} - \pagescite{Peebles2001-100-100} \pagescite[][201-301]{Peebles2001-100-100} -作者年制文中已有作者只需要年份和页码的情况，使用命令yearpagescite，比如: + \pagescite{Peebles2001-100-100}\pagescite[150]{Peebles2001-100-100} + \pagescite[][201-301]{Peebles2001-100-100} +作者年制文中已有作者只需给出年份和页码的引用: 见赵耀东\yearpagescite[][205]{赵耀东1998--}和Simon\yearpagescite[][15]{Simon2001--}。 - -需要注意，\yearpagescite命令在输出年份的同时也输出页码，但有时有些参考文献格式不要求页码，此时可以用\yearcite命令，或者也可利用cite*和citeyear命令手动实现(如果要用超链接目前可以使用cite*)，比如: +作者年制文中已有作者只需给出年份的引用，三种方式: 见赵耀东\yearcite{赵耀东1998--} 见赵耀东(\cite*{赵耀东1998--}) 见赵耀东(\citeyear{赵耀东1998--}) +作者年制文中无作者需要标注命令给出作者作为主语的引用： + 见\textcite{赵耀东1998--} 在页脚中引用和打印文献表: \footnote{在脚注中引用\footcite{赵学功2001--}} \footfullcite{赵学功2001--} -\end{codetex} + \end{texlist} +\end{example} + +各引用命令的效果见\ref{sec:test:book}节。%\ref{sec:cite:cmd:test} + +\subsubsection{样式使用的注意事项} + +\begin{enumerate} + \item 本样式包的设计与实现方法以及设计到的一些biblatex功能介绍，以项目示例的形式总结在 + \href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}{\LaTeX 文档中文参考文献的biblatex解决方案}中，本文档不再重复给出，有需要了解的用户可以参见其中的第3.1节。 + + \item 当tex源文档采用UTF-8编码时，可以采用xelatex编译。当tex源文档为GBK 编码时，可以利用notepad++ 或notepad2 等编辑器将其转换为UTF-8编码，然后用xelatex编译，或者也可以直接利用pdflatex或latex进行编译，本样式已经做了支持。 + %增加了对GBK支持的说明，2018-05-11 + + \item 当顺序编码和作者年制切换，或者biblatex版本切换，或者不同样式切换时，如果编译出错，可先清理一下辅助文件，完成后再重新编译。 + + \item 当bibtex键中含有中文的时候，texlive2015中的biblatex3.0版的对参考文献条目的超链接会出现问题，而texlive2016中的biblatex3.4或以后的版本则没有问题。 + + \item GB/T 7714-2015中的作者年制要求参考文献按文种集合，且中文在前英文在后。主要通过定义DeclareSortingScheme\{gb7714-2015\} (biblatex3.7 以前版本) 或 DeclareSortingTemplate\{gb7714-2015\} (biblatex3.8以后版本)，利用自动设定的language 域实现排序。默认情况下，样式能基本正确的区分中文和英文文献并排序。当如果出现错误的情况，用户可以手动修改bib源文件，将language 域设置成合适的字符串，用于排序，详见\ref{sec:usage:bbx}节的说明。 + +%上一段2016-1114更新，下面这段是旧的说法， +%通过定义DeclareSortingScheme\{nyt\}，设置方向为direction=descending，可以实现中文在前英文在后但两个文种的文献各自也是降序的。还有一种变通的方法是，在录入bib文件时，在userb域填入用于排序的信息，比如需要排前面中文文献填cn，排后面的英文文献用en。这样因为修改后的排序格式nyt会在author域前先用userb进行排序，自然会把中文文献放在前面。 + + \item 当出版地和出版者同时缺省时，GB/T 7714-2015中没有给出明确的说明，但英文给出了一个例子(见GB/T 7714-2015 附录A.3)而中文没有，英文的形式是[S.l. : s.n.]，这种形式本样式没有给出，而直接用两者分开的形式，[S.l.] : [s.n.] + + %事实上这里作者认为没有必要把s.l.和s.n. 合起来，不仅与缺省两者之一的情况不统一，样式处理起来也增加不必要的麻烦。 + + \item 目前符合GB/T7714-2005或GB/T7714-2015参考文献著录规则的biblatex 样式有好几个实现，除本样式外，还有李志奇(icetea)\footnote{\url{http://bbs.ctex.org/forum.php?mod=viewthread&tid=74474}} 和沈周(szsdk)\footnote{\url{http://bbs.ctex.org/forum.php?mod=viewthread&tid=152561&extra=page\%3D1}} 分别提供的样式文件，效果是类似的。此外，Casper Ti. Vector提供的biblatex 样式caspervector也是不错的中文参考文献样式 + \footnote{\url{https://gitlab.com/CasperVector/biblatex-caspervector}}。 感谢各位作者的分享! + +% \item 本文档根据GB/T 7714-2015提供的参考文献表著录格式示例做了测试和验证，详见第\ref{sec:eg:gb77142015}节。 +% 测试系统环境为: +% \begin{itemize} +% \item windows7x86+texlive 2014，采用xelatex编译; +% +% \item windows7x64+texlive 2015，采用xelatex编译; +% +% \item 虚拟机xp+texlive 2016，采用xelatex编译; +% +% \item Deepin linux-x64v15.3+texlive 2016，采用xelatex编译。 +% +% \item windows7x64+texlive 2017，采用xelatex编译; +% \end{itemize} + +\end{enumerate} + + + + + +\subsection{gb7714-2015样式的多语言支持}\label{sec:multilan:implement} + +\subsubsection{多语言混合文献} + +一般情况中，在国内不太会超过两种语言混合的情况，比如中英文混合的情况。但有时可能也会存在多种语言，比如存在中/英/日/俄这种多语言环境。 -各引用命令的效果见\ref{sec:test:book}，\ref{sec:cite:cmd:test}节。 +使用xelatex编译时下，由于其原生支持unicode的特性，在tex文档内实现多语言混合比较容易实现，要正确显示关键在于合适的字体设置。一般情况下中/日/韩语利用ctex宏包可以解决。而西文如英/法/俄可以利用fontspec宏包选择合适的字体来解决。 + +对于参考文献来说还有一个更重要的问题是本地化字符串问题。中英文情况下，中文利用在英文本地化文件基础上新增本地化字符串加以解决。但其它语言需要自己的解决方案。 + +如第\ref{sec:usage:bbx}节所述，本样式使用language域来区分文献的语言类型，默认情况下该域不需要人工输入，可由biber根据文献信息自动判断，但也可以手动输入来人工指定。根据 biblatex 提供的多语言解决方案，还需要利用langid/langidopt域，以及babel/polyglossia宏包的支持。 + +目前的解决方案做如下的考虑： +\begin{enumerate} + \item 日韩语采用类似中文的方式处理，即通过在英语本地化文件基础上处理。因此langid通常设为english。对于日文通常作者这种信息都是用的汉字，因此用中文的字符串。韩语暂没有考虑它自身的字符串，而使用英文的字符串。当不存在除英文外的其它西语时，langid也不需要处理。注意：默认情况下 langid 都是自动处理的，用户无需过多关注。 + \item 如俄语/法语这样的西方语言，通过biblatex提供的方案解决。即：使用babel/polyglossia宏包和langid/langidopt域。这时如果存在中日韩语，那么相应文献也需要设置langid。因此，需要在tex文档内加入babel宏包以及需要使用的语言，需要使用本地化字符串的西语都要加入，否则无法自动切换。然后在加载biblatex宏包时使用 autolang=other 选项。 +\end{enumerate} + +本样式做了中日韩英俄法六种语言的测试，详细内容见： +\href{run:example/testmultilan.tex}{testmultilan.tex}， +\href{run:example/testmultilanay.tex}{testmultilanay.tex}。 + + +\subsubsection{多语言对照文献表} + +某些期刊对于参考文献表有双语文献对照的要求，那么可以通过条目集类型(set)/或者条目关联(related)来解决。具体要求见GB/T 7714-2015第6.1节。 + +\paragraph{利用条目集类型满足双语文献要求} + +设置条目集类型(set)有静态和动态两种方法: +动态方法使用更为方便，在写文档时候，直接利用defbibentryset设置双语文献的set，然后引用set的bibtex键。比如: +\begin{example}{设置set条目集用于双语文献动态方法}{eg:setforbilangentry} +\begin{texlist} +\defbibentryset{bilangyi2013}{易仕和2013--,Yi2013--} +专著，双语文献引用\cite{bilangyi2013} +\end{texlist} +\end{example} + +得到的参考文献打印结果见\ref{sec:test:book}节。\bc{在biblatex v3.8及以上版本中，因为set条目类型除了子条目关键词信息外，并无其他信息，因此它的标注标签通常会是空的。这个问题目前的解决方法是设置一个指定格式和内容中间无空格无英文逗号的关键字，用它来作为标签。这个问题与biblatex版本升级有关，biblatex v3.7及之前版本没有这个问题，因为这些版本中 set 中带有第一个子条目的信息}。比如: +\begin{example}{设置set条目集用于双语文献动态方法}{eg:setforbilangentry} +\begin{texlist} +\defbibentryset{易仕和，等，2013}{易仕和2013--,Yi2013--} +专著，双语文献引用\cite{易仕和，等，2013} +\end{texlist} +\end{example} + +\qd{注意到“易仕和，等，2013”中的逗号是中文全角逗号，这样使得“易仕和，等，2013”以一个整体字符串当作关键字，而不会被分开解析。但是这种解决方案中的中文全角逗号与其它标签的英文逗号的差异使得该问题并没有完美解决。这可以用静态方法手动添加标签来解决，对于biblatex v3.8及以上版本还可以利用后面介绍的关联(related)方法来解决。} + +静态方法是在bib源文件中给出条目集(set)并使用biber后端进行解析，条目的域信息采用如下方法定义: +%当使用bibtex后端时，则需要进一步设置，具体参考biblatex宏包说明文档。 +\begin{example}{设置set条目集用于双语文献静态方法}{eg:set:static} +\begin{texlist} +@Set{set1, +entryset = {key1,key2,key3}, +} +%如果要达到上例动态设置set一样的结果，在bib文件中静态设置set条目如下: +@Set{bilangyi2013, +entryset = {易仕和2013--,Yi2013--}, +} +\end{texlist} +\end{example} + +\qd{使用静态条目集时，如果仅采用上述这般简单设置，中文排序会出现问题，条目集会出现在文献表末尾，这是因为条目集没有设置language域用于排序，而通常的条目都会利用动态数据修改设置language域，在biber运行中因为要解析文献集，所以无法对language域进行处理。 + +但使用动态条目集方法没有这一问题，因为其解析过程直接会利用第一个子条目的排序信息。静态方法的这个问题可以在set条目中手动设置language域来修正。此外，对于v3.8以上版本的biblatex，无论动态方法还是静态方法，条目集不复制第一个子条目信息，因此引用时也无法生成标注标签，这就是前面介绍动态方法时讨论过的问题，该问题也可以通过在set条目中手动设置label域来解决。} + +设置方法为: + +\begin{example}{在bib文件中正确设置set条目集的静态方法}{eg:set:staticright} +\begin{texlist} +%在bib文件中静态设置set条目如下，其中: +%手动设置userb域用于解决排序问题 +%手动设置label域用于解决标注标签问题 +@Set{bilangyi2013, +entryset = {易仕和2013--,Yi2013--}, +label={易仕和, 等, 2013}, +language={chinese} +} +\end{texlist} +\end{example} + +\bc{还要注意：动态set条目集等价于使用nocite命令，因此只要定义了动态条目集的文献都会出现在文献表中，因此如果不引用相应的文献，那么就不应该对其定义动态条目集}。 + +\paragraph{利用条目关联满足双语文献要求} + +除上述给出的条目集方案外，关联条目方法则是另一种可行方案，该方案的讨论可以见“Again about the \@ set label for authoryear style”\footnote{\url{https://github.com/plk/biblatex/issues/681}}。该方案同样也有静态和动态两种方法，静态就是修改bib文件内容，动态则是在tex源文档中做设置。 + +静态方法很简单，bib文件中条目设置如例\ref{eg:related:staticright}所示，它能解决双语同时显示的问题，也能解决排序和标注标签问题，唯一的问题在于修改了bib文件后当不需要双语文献时，它还需要改回来，这会带来不便，因此可以考虑下面的动态方法，但要注意动态方法需要利用多个DeclareStyleSourcemap，因此该方法只适用于biblatex v3.7及以上版本。 + +\begin{example}{在bib文件中正确设置关联条目的静态方法}{eg:related:staticright} +\begin{texlist} +%在bib文件中静态设置条目如下，其中: +%易仕和2013--条目中增加了related域用于关联其对应的英文条目Yi2013-- +@Book{易仕和2013--, + Title = {超声速和高超声速喷管设计}, + Address = {北京}, + Author = {易仕和 and 赵玉新 and 何霖 and 张敏莉}, + Publisher = {国防工业出版社}, + Year = {2013} + related = {Yi2013--} +} +@Book{Yi2013--, + Title = {Supersonic and hypersonic nozzle design}, + Address = {BeiJing}, + Author = {Yi, S H and Zhao, Y X and He, L and Zhang, M L}, + Publisher = {National Defense Industry Press}, + Year = {2013} +} +\end{texlist} +\end{example} + +动态方法利用动态数据修改自动添加related域，避免对bib文件做直接修改。本样式中对该过程进行了封装，定义一个新的命令defdoublelangentry，例如: +\begin{example}{设置关联条目的动态方法}{eg:related:dynamic} +\begin{texlist} +\defdoublelangentry{易仕和2013--}{Yi2013--} +\end{texlist} +\end{example} + +使用该命令后，可以引用主条目“易仕和2013--”生成双语文献。但要注意由于DeclareStyleSourcemap命令只能在导言区中使用，因此defdoublelangentry命令也只能出现在导言区中，这也是相比条目集动态方法的唯一遗憾。 +实现的具体细节见 +\href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}% +{biblatex-solution-to-latex-bibliography}。 + +双语对照文献的两种动态方法基于set和related的方法测试，参见: +\href{run:./example/testaligngb7714-2015ay.tex}{testaligngb7714-2015ay.tex}， +%\href{run:./example/egaligngb7714-2015ay.pdf}{egaligngb7714-2015ay.pdf}。 \section{GB/T 7714-2015 标准说明与实现} @@ -468,9 +1014,9 @@ GB/T 7714-2015规定采用作者年制组织时，各篇文献首先按文种组 %(因为需要根据语言进行划分，所以语言(language)域对于录入文献来说可能是必要的，因为作者的测试仅涉及中英文两种语言，没有遇到需要language域的情况。) \subsubsection{文献标注法} -各篇文献的标注内容由著者姓(lastname)和出版年构成，并置于()内。对于使用汉字的语言来说，整个姓名都是lastname所以标注的是全名。机构团体名也整体标注。 +各篇文献的标注内容由著者姓(lastname/family)和出版年构成，并置于()内。对于使用汉字的语言来说，整个姓名都是 lastname/family 所以标注的是全名。机构团体名也整体标注。 -若正文中已有著者姓名，则()内只标注出版年，这一点样式文件无法判断，只能是文档作者自身把握，当然样式文件提供了标签只有年份、附加年份和页码信息的引用命令yearpagescite，方便文档写作者使用，使用方法详见第\ref{sec:cbx:usage}节。 +若正文中已有著者姓名，则()内只标注出版年，这一点样式文件无法判断，只能是文档作者自身把握，当然本样式提供了标签只有年份、附加年份和页码信息的引用命令yearpagescite/yearcite，方便文档作者使用，使用方法详见第\ref{sec:cbx:usage}节。当然文档作者还可以使用textcite命令同时给出满足格式要求的作者和年份信息，本样式已做支持。 引用多个著者的文献时，对西文只需标注第一著者的姓(而在参考文献列表中的作者按最大数量三个处理，这与顺序编码制一致，参考GB/T 7714-2015第8.1.2节)，其后附“et al.”，对于中文著者，标注第一著者的姓名，其后附“等”。姓名与“et al.”“等”间留适当空隙。 @@ -482,140 +1028,152 @@ GB/T 7714-2015规定采用作者年制组织时，各篇文献首先按文种组 标注要求具体参考GB/T 7714-2015第10.2节。 -\qd{注意:一般情况下，当文献作者缺省时，作者年制就没有作者可以用，因此文献题名用来生成标签，这样会导致文献表中文献题名后的文献类型标识/文献载体标识消失(这是因为题名用于生产标签后，题名域会被清除，自然也就不输出题名相关的信息了，见“\hyperlink{entrystdwithoutauthor}{Information and documentation-the Dublin core metadata element set}”)。但是可以用佚名替代缺省作者的方式避免这个问题，即可以使用样式文件提供的选项gbnoauthor=true，一旦设置该选项为true，则缺省的作者会根据文献语种填充为佚名或NOAUTHOR。默认情况下，不进行这种处理，即相当于设置选项gbnoauthor=false。而顺序编码制因为标签是数字序号，所以不存在这个问题。} +\qd{一般情况下，当文献作者缺省时，作者年制就没有作者可以用，因此文献题名用来生成标签，这样会导致文献表中文献题名后的文献类型标识/文献载体标识消失(这是因为题名用于生成标签后，题名域会被清除，自然也就不输出题名相关的信息了，见后面的示例文献“\hyperlink{entrystdwithoutauthor}{Information and documentation-the Dublin core metadata element set}”)。此时可以用佚名替代缺省作者的方式避免这个问题，即可以使用样式文件提供的选项gbnoauthor=true，一旦设置该选项为true，则缺省的作者会根据文献语种填充为佚名或NOAUTHOR。默认情况下，不进行这种处理，即相当于设置选项gbnoauthor=false。而顺序编码制因为标签是数字序号，所以不存在这个问题。} %本样式文件默认情况下采用佚名方式，如果不需要使用佚名，那么需要在样式文件中注释掉一段代码，这段代码在本文档末尾2016-11-14的更新历史中有说明，见\pageref{up:20161114}页。} \subsection{各类文献在biblatex中对应的条目和域}\label{sec:numeric:data} -gb7714-2015.bbx是按照GB/T 7714-2015要求实现的biblatex参考文献著录样式文件。 - -根据GB/T 7714-2015要求并结合biblatex的条目类型和数据域，对各类参考文献做如下考虑: +biblatex-gb7714-2015宏包设计的重要原则是要符合GB/T 7714-2015标准。因此根据GB/T 7714-2015的要求并结合biblatex的条目类型和数据域，对各类参考文献做如下考虑: \subsubsection{专著/book} \begin{refentry}{}{} 专著对应的biblatex的entrytype为:book，文献类型标识用M表示。 -\paragraph{其著录格式为}(参考GB/T 7714-2015第4.1节):\\ +\bibliofmt{其著录格式为}(参考GB/T 7714-2015第4.1节):\\ 主要责任者.题名:其他题名信息[文献类型标识/文献载体标识].其他责任者.版本项.出版地:出版者,出版年:引文页码[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{专著/book条目的域格式}{eg:bookfieldfmt} +\begin{example}{专著/book条目的域格式}{eg:bookfieldfmt} +\begin{texlist} author.title[usera].translator.edition.location:publisher,date或year:pages[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} -其中标题相关的附加信息除了可以直接在title域中录入外，还可以在subtitle或titleaddon域中添加，后面出现的booktitle，journaltitle，也有类似情况，可以在booktitleaddon或者journalsubtitle中附加信息。其中出版地用location域表示，也可以用传统的address表示，biblatex将address作为location的别名处理，使用两者中的任何一个都可以表示出版地信息。\bc{特别强调:usera域不用录入，该域内容由bbx样式文件根据条目类型自动处理得到。} +其中标题相关的附加信息除了可以直接在title域中录入外，还可以在subtitle或titleaddon域中添加，后面出现的booktitle，journaltitle，也有类似情况，可以在booktitleaddon或者journalsubtitle中附加信息。其中出版地用location域表示，也可以用传统的address表示，biblatex将address作为location的别名处理，使用两者中的任何一个都可以表示出版地信息。\bc{特别强调: usera域不用录入，该域内容由bbx样式文件根据条目类型自动处理得到。} -\qd{注意:由于biblatex不支持standard条目类型，所以“标准”类型可以用book或inbook替代，但使用note域等于standard作为一个区分，当note域数据存在且内容等于standard时，就将其作为“标准”文献进行处理，其文献类型标识用S表示。这里为什么使用note域而不是type域和keywords域，是因为考虑到note域一般情况没有什么特殊意义，使用它不会导致冲突，而type域在biblatex标准样式中没有被book和article条目类型当作支持的域，对于支持该域的条目比如thesis，type域又有特殊的意义，是用来区分master和doctor的，而keywords域倒是可以使用，只是该域一般很少在jabref之类软件的默认域中，需要进一步设置，而且可能带来不通用的问题。} +\qd{由于biblatex不支持standard条目类型，所以“标准”类型可以用book或inbook替代，但使用note域等于standard作为一个区分，当note域数据存在且内容等于standard时，就将其作为“标准”文献进行处理，其文献类型标识用S表示。这里为什么使用note域而不是type域和keywords域，是因为考虑到note域一般情况没有什么特殊意义，使用它不会导致冲突，而type域在biblatex标准样式中没有被book和article条目类型当作支持的域，对于支持该域的条目比如thesis，type域又有特殊的意义，是用来区分master和doctor的，而keywords域倒是可以使用，只是该域一般很少在jabref之类软件的默认域中，需要进一步设置，而且可能带来不通用的问题。} \subsubsection{标准/standard}\label{sec:standard} “标准”(standard)作为一种文献条目类型biblatex并不支持，因此可以如上一小节所述，直接利用book或inbook类型加note域代替。 或者使用本节下面给出的方式。 -因为在一些bib文件中可能存在standard类型，为兼容性考虑，本样式实现了对standard条目类型的支持。著录格式的处理原理与前一节所述相同，只是利用动态数据将standard类型转换为book/inbook类型。因此在bib文件中可以直接使用standard类型，但要注意使用其它样式时可能存在移植障碍，因为其它样式可能不支持standard类型，为样式移植性考虑最好使用上一节的方式。 +因为在一些bib文件中可能存在standard类型，为兼容性考虑，本样式对standard条目类型做了支持。著录格式的处理原理与前一节所述相同，只是利用动态数据将standard类型转换为book/inbook类型。因此在bib文件中可以直接使用standard类型，但要注意使用其它样式时可能存在移植障碍，因为其它样式可能不支持standard类型，为样式移植性考虑最好使用上一节的方式。 \begin{refentry}{}{} -标准对应的biblatex的entrytype为:standard。文献类型标识用S表示。 +标准对应的biblatex的entrytype为: standard。文献类型标识用S表示。 -\paragraph{其著录格式为}(与book和inbook类型类似，其中圆括号内是与inbook类似时存在的内容，同时当出版地和出版者不存在时直接忽略，这是与book和inbook不同的地方。):\\ +\bibliofmt{其著录格式为}(与book和inbook类型类似，其中圆括号内是与inbook类似时存在的内容，同时当出版地和出版者不存在时直接忽略，这是与book和inbook不同的地方。):\\ 主要责任者.文献题名[文献类型标识/文献载体标识].其他责任者(//所在文献集主要责任者.文献集题名:其他题名信息).版本项.出版地:出版者,出版年:文献的页码[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{标准/standard条目的域格式}{eg:standardfieldfmt} +\begin{example}{标准/standard条目的域格式}{eg:standardfieldfmt} +\begin{texlist} author.title[usera](//bookauthor.booktitle).edition.location:publisher,date或year:pages[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} \subsubsection{专著中的析出文献/inbook} \begin{refentry}{}{} -专著中的析出文献对应的biblatex的entrytype为:inbook。文献类型标识用M表示。 +专著中的析出文献对应的biblatex的entrytype为: inbook。文献类型标识用M表示。 -\paragraph{其著录格式为}(参考GB/T 7714-2015第4.2节):\\ +\bibliofmt{其著录格式为}(参考GB/T 7714-2015第4.2节):\\ 析出文献主要责任者.析出文献题名[文献类型标识/文献载体标识].析出文献其他责任者//专著主要责任者.专著题名:其他题名信息.版本项.出版地:出版者,出版年:析出文献的页码[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{专著析出文献/inbook条目的域格式}{eg:inbookfieldfmt} +\begin{example}{专著析出文献/inbook条目的域格式}{eg:inbookfieldfmt} +\begin{texlist} author.title[usera]//bookauthor.booktitle.edition.location:publisher,date或year:pages[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} \subsubsection{连续出版物/periodical} \begin{refentry}{}{} -连续出版物对应的biblatex的entrytype为:periodical。文献类型标识用J表示。 +连续出版物对应的biblatex的entrytype为: periodical。文献类型标识用J表示。 -\paragraph{其著录格式为}(参考GB/T 7714-2015第4.3节):\\ +\bibliofmt{其著录格式为}(参考GB/T 7714-2015第4.3节):\\ 主要责任者.题名:其他题名信息[文献类型标识/文献载体标识].年,卷(期)-年,卷(期).出版地:出版者,出版年[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{连续出版物/periodical条目的域格式}{eg:periodicalfieldfmt} +\begin{example}{连续出版物/periodical条目的域格式}{eg:periodicalfieldfmt} +\begin{texlist} author/editor.title[usera].year或date,volume(number)-endyear, endvolume(endnumber).location:institution,date或year[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} 其中连续出版物的出版者用institution表示。 -\bc{需要注意: 因为连续出版物可能用到两个日期，两个卷，两个期，所以录入数据时需要特别处理。不需要录入endyear等信息，只需要在到year或date域录入日期，由biber自动解析，两个日期之间用/分隔。而卷和期由于可能有合订模式，合订卷期之间用/分隔(参考GB/T 7714-2015第8.8.3节)，因此如果需要解析有起止范围的卷和期，录入到volume和number域的信息中起止值之间应用-分隔}。 +\qd{因为连续出版物可能用到两个日期，两个卷，两个期，所以录入数据时需要特别处理。不需要录入endyear等信息，只需要在到year或date域录入两个日期，由biber自动解析，两个日期之间用/分隔。而卷和期由于可能有合订模式，且合订卷期之间用/分隔(参考GB/T 7714-2015第8.8.3节)，因此如果需要解析有起止范围的卷和期，录入到volume和number域的信息中起止值之间应用-分隔。} \subsubsection{连续出版物的析出文献/article} \begin{refentry}{}{}%[break at=0.5cm/0pt] -连续出版物的析出文献对应的biblatex的entrytype为:article。文献类型标识用J表示。 +连续出版物的析出文献对应的biblatex的entrytype为: article。文献类型标识用J表示。 -\paragraph{其著录格式为}(参考GB/T 7714-2015第4.4节):\\ +\bibliofmt{其著录格式为}(参考GB/T 7714-2015第4.4节):\\ 析出文献主要责任者.析出文献题名[文献类型标识/文献载体标识].连续出版物题名:其他题名信息,年,卷(期):页码[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{连续出版物析出文献/article条目的域格式}{eg:articlefieldfmt} +\begin{example}{连续出版物析出文献/article条目的域格式}{eg:articlefieldfmt} +\begin{texlist} author.title[usera].journaltitle或journal,year,volume(number):pages[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} -\qd{需要注意:由于biblatex不支持newspaper 条目类型，所以条目类型报纸析出的文献用article表示，但使用note域等于news作为一个区分，当note域数据存在且内容等于news时，就将其作为报纸的析出文献进行处理。报纸文献类型标识用N表示，报纸的版次用number域描述。} +\qd{由于biblatex不支持newspaper 条目类型，所以条目类型报纸析出的文献用article表示，但使用note域等于news作为一个区分，当note域数据存在且内容等于news时，就将其作为报纸的析出文献进行处理。报纸文献类型标识用N表示，报纸的版次用number域描述。} \subsubsection{报纸析出的文献/newspaper}\label{sec:standard} -biblatex没有将报纸的析出文献(newspaper)作为一种文献条目类型，因此可以如上一小节所述，直接利用article类型加note域代替。 -或者使用本节下面给出的方式。 +biblatex没有将报纸的析出文献(newspaper)作为一种文献条目类型，因此可以如上一小节所述，直接利用article类型加note域代替。或者使用本节下面给出的方式。 -因为报纸析出的文献的文献标识码比较特殊不是J而是N，所以可以把报纸析出的文献独立出来进行处理。 -为方便使用考虑，本样式增加了对一个全新的类型newspaper的支持，这种支持通过类似于standard类型的方式实现，没有对数据模型进行改动或增加，而完全利用动态数据修改将newspaper类型转换为article类型。因此在bib文件中可以直接使用newspaper类型，但要注意使用其它样式时可能存在移植障碍，因为其它样式可能不支持newspaper类型，为样式移植性考虑最好使用上一节的方式。 +因为报纸析出的文献的文献标识码比较特殊不是J而是N，所以可以把报纸析出的文献独立出来进行处理。为方便使用考虑，本样式增加了对一个全新的类型newspaper的支持，这种支持通过类似于standard类型的方式实现，没有对数据模型进行改动或增加，而完全利用动态数据修改将newspaper类型转换为article类型。因此在bib文件中可以直接使用newspaper类型，但要注意使用其它样式时可能存在移植障碍，因为其它样式可能不支持newspaper类型，为样式移植性考虑最好使用上一节的方式。 \begin{refentry}{}{} -报纸析出的文献对应一个新的entrytype为:newspaper。文献类型标识用N表示。 +报纸析出的文献对应一个新的entrytype为: newspaper。文献类型标识用N表示。 -\paragraph{其著录格式为}(类似于article):\\ +\bibliofmt{其著录格式为}(类似于article):\\ 析出文献主要责任者.析出文献题名[文献类型标识/文献载体标识].报纸题名:其他题名信息,日期(版号)[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{报纸析出的文献/newspaper条目的域格式}{eg:newspaperfieldfmt} +\begin{example}{报纸析出的文献/newspaper条目的域格式}{eg:newspaperfieldfmt} +\begin{texlist} author.title[usera].journaltitle或journal,date(number)[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} \subsubsection{专利/patent} \begin{refentry}{}{}%[break at=3cm/0pt] -专利文献对应的biblatex的entrytype为:patent。文献类型标识用P表示。 +专利文献对应的biblatex的entrytype为: patent。文献类型标识用P表示。 -\paragraph{其著录格式为}(参考GB/T 7714-2015第4.5节):\\ +\bibliofmt{其著录格式为}(参考GB/T 7714-2015第4.5节):\\ 专利申请者或所有者.专利题名:专利号[文献类型标识/文献载体标识].公告日期或公开日期[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{专利文献/patent条目的域格式}{eg:patentfieldfmt} +\begin{example}{专利文献/patent条目的域格式}{eg:patentfieldfmt} +\begin{texlist} author.title:number[usera].date或year[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} \subsubsection{电子资源/online} \begin{refentry}{}{}%[break at=0.4cm/0pt] -电子资源对应的biblatex的entrytype为:online或electronic或者www。文献类型标识用EB表示。(注意:biblatex将electronic或www作为online条目类型的别名，对于标准样式来说这两者出现在bib文件中等同于online，但这种等同标准样式是在驱动层进行处理的，而gb7714样式还需要处理文献类型标识，本样式文件做了进一步支持。因此bib文件中也可以直接使用electronic和www) +电子资源对应的biblatex的entrytype为: online或electronic或者www。文献类型标识用EB表示。\bc{(注意: biblatex将electronic或www作为online条目类型的别名，对于标准样式来说这两者出现在bib文件中等同于online，但这种等同标准样式是在驱动层进行处理的，而gb7714-2015样式还需要处理文献类型标识，本样式文件做了进一步支持。因此bib文件中也可以直接使用electronic和www。)} -\paragraph{其著录格式为}(参考GB/T 7714-2015第4.6节):\\ +\bibliofmt{其著录格式为}(参考GB/T 7714-2015第4.6节):\\ 主要责任者.题名:其他题名信息[文献类型标识/文献载体标识].出版地:出版者,出版年:引文页码(更新或修改日期)[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{电子资源/online/electronic/www条目的域格式}{eg:onlinefieldfmt} +\begin{example}{电子资源/online/electronic/www条目的域格式}{eg:onlinefieldfmt} +\begin{texlist} author.title[usera].organization,date或year:pages(date/enddate/eventdate)[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} -注意: 尽管GB/T 7714-2015中给出的著录格式包含出版地和出版者，但通常情况下具有出版地和出版者的文献会归类到其它条目类型中，至于存在的url信息，只要标识文献载体即可，即一般情况下(出版地:出版者,出版年:引文页码)这些信息很少出现在online[EB]条目中。因此默认情况下，gb7714-2015样式只处理出现organization中的出版项信息，此外用date表示更新或修改日期，urldate表示引用(访问)日期。如果出现复杂情况，更新或修改日期还可以利用enddate/eventdate表示。 +\qd{尽管GB/T 7714-2015中给出的著录格式包含出版地和出版者，但通常情况下具有出版地和出版者的文献会归类到其它条目类型中，至于存在的url信息，只要标识文献载体即可，即一般情况下(出版地:出版者,出版年:引文页码)这些信息很少出现在online[EB]条目中。因此默认情况下，gb7714-2015样式只处理出现organization中的出版项信息，此外用date表示更新或修改日期，urldate表示引用(访问)日期。如果出现复杂情况，更新或修改日期还可以利用enddate/eventdate表示。} 以上是GB/T 7714-2015直接给出著录格式的条目类型，还有一些类型并没有给出具体格式，但在例子中也有所体现，本样式文件根据这些例子，给出了著录格式。 @@ -624,14 +1182,14 @@ author.title[usera].organization,date或year:pages(date/enddate/eventdate)[urlda \begin{refentry}{}{} 汇编文献对应的biblatex的entrytype为:collection。文献类型标识用G表示。 -\paragraph{其著录格式为} 采用与book一致的格式。 +\bibliofmt{其著录格式为} 采用与book一致的格式。 \end{refentry} \subsubsection{汇编或论文集析出中的文献/incollection} \begin{refentry}{}{} 汇编中的析出文献对应的biblatex的entrytype为:incollection。文献类型标识用G表示。 -\paragraph{其著录格式为} 采用与inbook一致的格式。 +\bibliofmt{其著录格式为} 采用与inbook一致的格式。 \end{refentry} \subsubsection{会议录或会议文集/proceedings} @@ -643,143 +1201,74 @@ author.title[usera].organization,date或year:pages(date/enddate/eventdate)[urlda \subsubsection{会议文集中析出的文献/inproceedings} \begin{refentry}{}{} -会议文集中析出的文献对应的biblatex的entrytype为:inproceedings。文献类型标识用C表示。(注意:biblatex将conference作为inproceedings条目类型的别名，对于标准样式来说conference出现在bib文件中等同于inproceedings，但这种等同，标准样式是在驱动层进行处理的，而gb7714-2015样式还需要处理文献类型标识，本样式文件做了进一步支持。因此bib文件中也可以直接使用conference。) +会议文集中析出的文献对应的biblatex的entrytype为:inproceedings。文献类型标识用C表示。\bc{(注意: biblatex将conference作为inproceedings条目类型的别名，对于标准样式来说conference出现在bib文件中等同于inproceedings，但这种等同标准样式是在驱动层进行处理的，而gb7714-2015样式还需要处理文献类型标识，本样式文件做了进一步支持。因此bib文件中也可以直接使用conference。)} -\paragraph{其著录格式为} 采用与inbook类似的格式。 +\bibliofmt{其著录格式为} 采用与inbook类似的格式。 \end{refentry} \subsubsection{学位论文/thesis} \begin{refentry}{}{} -学位论文对应的biblatex的entrytype为:thesis。文献类型标识用D表示。(注意:biblatex将mastersthesis或phdthesis作为thesis条目类型的别名，对于标准样式来说这两者出现在bib文件中基本等同于thesis，但却会增加type信息。但这种等同，标准样式是在驱动层进行处理的，而gb7714-2015样式还需要处理文献类型标识并且不需要type信息，本样式文件做了进一步支持。因此bib文件中也可以使用mastersthesis和phdthesis)。 +学位论文对应的biblatex的entrytype为: thesis。文献类型标识用D表示。\bc{(注意:biblatex将mastersthesis或phdthesis作为thesis条目类型的别名，对于标准样式来说这两者出现在bib文件中基本等同于thesis，但却会增加type信息。但这种等同，标准样式是在驱动层进行处理的，而gb7714-2015样式还需要处理文献类型标识并且不需要type信息，本样式文件做了进一步支持。因此bib文件中也可以使用mastersthesis和phdthesis)。} -\paragraph{其著录格式为} 由biblatex的标准thesis格式修改得到。 +\bibliofmt{其著录格式为} 由biblatex的标准thesis格式修改得到。 主要责任者.题名:其他题名信息[文献类型标识/文献载体标识].其他责任者.出版地:出版者,出版年:引文页码[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{学位论文/thesis/mastersthesis/phdthesis条目的域格式}{eg:thesisfieldfmt} +\begin{example}{学位论文/thesis/mastersthesis/phdthesis条目的域格式}{eg:thesisfieldfmt} +\begin{texlist} author.title[usera].translator.location:institution,date或year:pages[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} -注意: thesis和后面report及manual的出版者用institution域表示，体现的是机构而不是一般的出版社。 + \bc{thesis和后面report及manual的出版者用institution域表示，体现的是机构而不是一般的出版社。} \subsubsection{报告/report} \begin{refentry}{}{} -报告对应的biblatex的entrytype为: report。文献类型标识用R表示。(注意:biblatex将techreport作为report条目类型的别名，对于标准样式，techreport出现在bib文件中等同于report，但这种等同标准样式是在驱动层处理的，而gb7714-2015样式还需要处理文献类型标识，本样式文件做了进一步支持。因此bib文件中也能直接使用techreport类型。) +报告对应的biblatex的entrytype为: report。文献类型标识用R表示。\bc{(注意:biblatex将techreport作为report条目类型的别名，对于标准样式，techreport出现在bib文件中等同于report，但这种等同标准样式是在驱动层处理的，而gb7714-2015样式还需要处理文献类型标识，本样式文件做了进一步支持。因此bib文件中也能直接使用techreport类型。)} -\paragraph{其著录格式为} (由biblatex的标准report格式修改得到，注意当出版地和出版者不存在时忽略这两项) +\bibliofmt{其著录格式为} (由biblatex的标准report格式修改得到，注意当出版地和出版者不存在时忽略这两项) 主要责任者.题名:其他题名信息[文献类型标识/文献载体标识].其他责任者.类型.号码.版本项.出版地:出版者,出版年:引文页码[引用日期].获取和访问路径.数字对象唯一标识符. \end{refentry} 其对应的biblatex数据域为: -\begin{codetex}{报告/report/techreport条目的域格式}{eg:reportfieldfmt} +\begin{example}{报告/report/techreport条目的域格式}{eg:reportfieldfmt} +\begin{texlist} author.title[usera].translator.type number.version.location:institution,date 或year:pages[urldate].url.doi -\end{codetex} +\end{texlist} +\end{example} -注意:因为有的报告文献可能存在类型和报告号信息，比如AIAA 9076或AD 730029等，所以著录格式需要有所体现，而这两个数据体现在type和number两个域中，或者在version域中体现也可，而对于标题中的出现的报告号，可以直接在标题或子标题或者附加标题中体现。 -需要注意: report和后面manual的版本信息放在version域中，而不是book等条目的edition域中。 +\qd{因为有的报告文献可能存在类型和报告号信息，比如AIAA 9076或AD 730029等，所以著录格式需要有所体现，而这两个数据体现在type和number两个域中，或者在version域中体现也可，而对于标题中的出现的报告号，可以直接在标题或子标题或者附加标题中体现。report和后面manual的版本信息放在version域中，而不是book等条目的edition域中。} -\subsubsection{手册或档案/manual} +\subsubsection{手册或档案/manual/archive} \begin{refentry}{}{} -手册和档案采用一种格式，对应的biblatex的entrytype为:manual。文献类型标识用A表示。 +手册和档案采用一种格式，对应的biblatex的entrytype为: manual或archive。文献类型标识用A表示。 -\paragraph{其著录格式为} 直接采用report的格式，而不是标准样式中的manual格式，这种方式下，当没有出版地和出版者时，完全省略，因为GB/T 7714-2015并没有明确这种情况怎么处理。 +\bibliofmt{其著录格式为} 借用report格式处理，而不是标准样式中的manual格式，这种方式下，当没有出版地和出版者时，完全省略，因为GB/T 7714-2015并没有明确这种情况怎么处理。 \end{refentry} \subsubsection{未出版物/unpublished} \begin{refentry}{}{} -未出版物，对应的biblatex的entrytype为:unpublished。文献类型标识用Z表示。 +未出版物，对应的biblatex的entrytype为: unpublished。文献类型标识用Z表示。 -\paragraph{其著录格式为} 也直接采用report格式处理。 +\bibliofmt{其著录格式为} 借用report格式处理。 \end{refentry} -\subsection{多语言文献}\label{sec:multilan:implement} - -某些期刊对于参考文献有双语文献要求，那么可以通过条目集类型(set)/或者条目关联(related)来解决。具体要求见GB/T 7714-2015第6.1节。 - -\paragraph{利用条目集类型满足双语文献要求} - -使用条目集类型(set)时，有静态和动态两种方法: -动态方法使用更为方便，在写文档时候，直接利用defbibentryset设置双语文献的set，然后引用set的bibtex键。比如: -\begin{codetex}{设置set条目集用于双语文献动态方法}{eg:setforbilangentry} -\defbibentryset{bilangyi2013}{易仕和2013--,Yi2013--} -专著，双语文献引用\cite{bilangyi2013} -\end{codetex} - -得到的参考文献打印结果见\ref{sec:test:book}节的参考文献表。\bc{需要注意的是:因为set条目类型除了子条目关键词信息外，并无其他信息，因此它的标注标签通常会是空的。这个问题目前的解决方法是设置一个指定格式和内容中间无空格无英文逗号的关键字，用它来作为标签，这个问题与biblatex版本有关，v3.7及之前版本没有这个问题，因为set中还带有第一个子条目的信息，但v3.8及以上版本就不行了}。比如: -\begin{codetex}{设置set条目集用于双语文献动态方法}{eg:setforbilangentry} -\defbibentryset{易仕和，等，2013}{易仕和2013--,Yi2013--} -专著，双语文献引用\cite{易仕和，等，2013} -\end{codetex} -注意到“易仕和，等，2013”中的逗号是中文全角逗号，这样使得“易仕和，等，2013”以一个整体字符串当作关键字，而不会被分开解析。但是这种解决方案中的中文全角逗号与其它标签的英文逗号的差异使得该问题并没有完美解决。对于v3.8及以上版本，可以利用后面介绍的关联(related)方法来解决，或者也可以用静态方法手动添加标签来解决。 - -静态方法是在bib源文件中给出条目集(set)并使用biber后端进行解析，条目的域信息采用如下方法定义: -%当使用bibtex后端时，则需要进一步设置，具体参考biblatex宏包说明文档。 -\begin{codetex}{设置set条目集用于双语文献静态方法}{eg:set:static} -@Set{set1, -entryset = {key1,key2,key3}, -} -%如果要达到上例动态设置set一样的结果，在bib文件中静态设置set条目如下: -@Set{bilangyi2013, -entryset = {易仕和2013--,Yi2013--}, -} -\end{codetex} - -需要注意，使用静态条目集时，如果仅采用上述这般简单设置，中文排序会出现问题，条目集会出现在文献表末尾，这是因为条目集没有设置userb域用于排序，而通常的条目都是利用动态数据修改设置了userb域，在biber运行中因为要解析文献集，所以无法对userb域进行处理。但动态方法没有这一问题，因为其解析过程直接会利用第一个子条目的排序信息。静态方法的这个问题可以在set条目中手动设置userb域来修正。此外，对于v3.8以上版本的biblatex，无论动态方法还是静态方法，条目集不复制第一个子条目信息，因此引用时也无法生成标注标签，这就是前面介绍动态方法时讨论过的问题，该问题也可以通过在set条目中手动设置label域来解决。比如: - -\begin{codetex}{在bib文件中正确设置set条目集的静态方法}{eg:set:staticright} -%在bib文件中静态设置set条目如下，其中: -%手动设置userb域用于解决排序问题 -%手动设置label域用于解决标注标签问题 -@Set{bilangyi2013, -entryset = {易仕和2013--,Yi2013--}, -label={易仕和, 等, 2013}, -userb={cn} -} -\end{codetex} - -还要注意的是，\emph{动态set条目集等价于使用nocite命令，因此只要定义了动态条目集的文献都会出现在文献表中，因此如果不引用相应的文献，那么就不应该对其定义动态条目集}。 - -\paragraph{利用条目关联满足双语文献要求} - -除上述给出的条目集方案外，关联条目方法则是另一种可行方案，该方案的讨论可以见“Again about the \@ set label for authoryear style”\footnote{https://github.com/plk/biblatex/issues/681}。该方案同样也有静态和动态两种方法，静态就是修改bib文件内容，动态则是在源文档中做设置。 - -静态方法很简单，bib文件中条目设置如例\ref{eg:related:staticright}所示，它能解决双语同时显示的问题，也能解决排序和标注标签问题，唯一的问题在于修改了bib文件后当不需要双语文献时，它还需要改回来，这会带来不便，因此可以考虑下面的动态方法，但要注意动态方法需要利用多个DeclareStyleSourcemap，因此该方法只适用于biblatex3.7及以上版本。 +\subsubsection{更多类型} +\begin{refentry}{}{} +数据库（database）、数据集（dataset）、软件（software）、舆图（map）、其它（misc）分别使用自己的数据类型和类型标识符。 -\begin{codetex}{在bib文件中正确设置关联条目的静态方法}{eg:related:staticright} -%在bib文件中静态设置条目如下，其中: -%易仕和2013--条目中增加了related域用于关联其对应的英文条目Yi2013-- -@Book{易仕和2013--, - Title = {超声速和高超声速喷管设计}, - Address = {北京}, - Author = {易仕和 and 赵玉新 and 何霖 and 张敏莉}, - Publisher = {国防工业出版社}, - Year = {2013} - related = {Yi2013--} -} -@Book{Yi2013--, - Title = {Supersonic and hypersonic nozzle design}, - Address = {BeiJing}, - Author = {Yi, S H and Zhao, Y X and He, L and Zhang, M L}, - Publisher = {National Defense Industry Press}, - Year = {2013} -} -\end{codetex} +\bibliofmt{其著录格式为} 借用report格式处理。 +\end{refentry} -动态方法利用动态数据修改自动添加related域，避免对bib文件做直接修改。本样式中对该过程进行了封装，定义一个新的命令defdoublelangentry，例如: -\begin{codetex}{设置关联条目的动态方法}{eg:related:dynamic} -\defdoublelangentry{易仕和2013--}{Yi2013--} -\end{codetex} -使用该命令后，可以引用主条目“易仕和2013--”生成双语文献。但要注意由于DeclareStyleSourcemap命令只能在导言区中使用，因此defdoublelangentry命令也只能出现在导言区中，这也是相比条目集动态方法的唯一遗憾。 -实现的具体细节见\ref{sec:data:mdf:forrelated}节。 \subsection{标准的其它细节要求} -除了第\ref{sec:numeric:data}节针对不同条目类型的著录格式要求外，GB/T 7714-2015还有一些细节要求比如文字、符号等需要满足，可以采用如下方法： +除了第\ref{sec:numeric:data}节针对不同条目类型的著录格式要求外，GB/T 7714-2015 还有一些细节要求比如文字、符号等需要满足，可以采用如下方法： \subsubsection{数字}\label{sec:fmt:number} @@ -790,12 +1279,11 @@ userb={cn} \subsubsection{英文字母}\label{sec:fmt:lettercase} \begin{property}{}{} -为了符合西文文献责任者的字母大小写习惯，本bbx样式文件，通过判断是否存在first name来确定是否是个人作者，当存在first name 时认为是个人作者，不存在则是机构作者，当是个人作者时lastname按GB/T 7714-2015要求全大写，是机构作者则仅大写首字母。所以对于仅有lastname的个人作者，填入信息英文姓的字母请全用大写。个人著者的格式要求参考GB/T 7714-2015第6.3节。 +为了符合西文文献责任者的字母大小写习惯，本样式通过判断是否存在givenname/firstname来确定是否是个人作者，当存在givenname/firstname 时认为是个人作者，不存在则是机构作者，当是个人作者时familyname/lastname按GB/T 7714-2015 要求全大写，是机构作者则仅大写首字母。所以对于仅有lastname的个人作者，填入信息英文姓的字母请全用大写。个人著者的格式要求见GB/T 7714-2015第6.3节。 -用户给bib源文件录入出版项、西文期刊名缩写以及西文文献的字母时，应按照GB/T 7714-2015第6.4节，第6.5节，6.6节要求，使用符合要求的习惯用法和大小写方式。本样式文件使用原样打印的方式进行处理。 +用户给bib源文件录入出版项、西文期刊名缩写以及西文文献的字母时，应按照GB/T 7714-2015第6.4节，第6.5节，6.6节要求，使用符合要求的习惯用法和大小写方式。本样式使用原样打印的方式进行处理。 -实际上，对于英文大小写问题，GB/T 7714-2015除了责任者的大写要求外，其它的要求相对比较模糊，所以一般不同的期刊会有各自不同的要求，比如不能使用缩写，而GB/T 7714-2015规定可参照ISO 4的要求等。从作者的经验看，一般国内的期刊对于字母大小写通常要求: -责任者(全部大写);题名(句首字母大写其它全部小写);期刊名会议名(单词首字母大写);出版项和其它(单词首字母大写)。所以在录入bib文件时可以按照这种常见方式来输入可以减少后期的修改。 +实际上，对于英文大小写问题，GB/T 7714-2015除了责任者的大写要求外，其它要求均比较模糊，但提到可参照ISO 4的要求。而一般不同的期刊会有各自不同的要求。从作者的经验看，一般国内的期刊对于字母大小写通常要求:责任者(全部大写);题名(句首字母大写其它全部小写);期刊名会议名(单词首字母大写);出版项和其它(单词首字母大写)。所以在录入bib文件时可以按照这种常见方式来输入以减少后期的修改。 \end{property} \subsubsection{标点} @@ -803,7 +1291,7 @@ userb={cn} \begin{property}{}{} 用户给bib源文件录入引文信息时不需要考虑标点符号问题，只需录入各数据域的信息即可。 -本样式文件实现了GB/T 7714-2015第7部分所给出的著录用符号要求。 +本样式实现了GB/T 7714-2015第7部分所给出的著录用符号要求。 \end{property} \subsubsection{责任者} @@ -813,7 +1301,7 @@ userb={cn} 当责任者是个人英文名，且具有名、姓、前缀和后缀，应按照第\ref{sec:bib:bibtex}节给出姓名录入方式处理才能才能正确解析，比如：von Peebles, Jr., P. Z.，其中von为姓前的前缀，Jr.为姓后的后缀，P. Z.为缩写名(包括first name 和middle name)。 -本样式文件实现了GB/T 7714-2015第8.1节要求的责任者样式，能自动判断责任者是中文还是英文，并分别处理。并且设置了全局选项useprefix=true，可以使用前缀。 +本样式实现了GB/T 7714-2015第8.1节要求的责任者样式，能自动判断责任者是中文还是英文，并分别处理。并且设置了全局选项useprefix=true，可以使用前缀。 \end{property} \subsubsection{文献类型标识和载体} @@ -821,7 +1309,7 @@ userb={cn} \begin{property}{}{} 用户在给bib源文件录入引文题名信息时，不需要给出文献类型标识/文献载体标识。同一责任者的合订题名，应用户根据GB/T 7714-2015 第8.2.1节的要求，在多个题名间用英文分号分隔，并整体录入到title数据域中。而分卷号，卷次，册次等信息时，除了专利号用number域录入外，其它可以直接在title数据域或者subtitle/titleaddon等数据域中给出。 -本样式文件实现了符合GB/T 7714-2015第8.2节要求的格式，能根据条目类型选择文献类型标识/文献载体标识，自动录入到自定义域usera中，并在各类参考文献条目驱动中直接使用。各不同类型文献的文献类型标识/文献载体标识，参考GB/T 7714-2015表B.1和B.2。 +本样式实现了符合GB/T 7714-2015第8.2节要求的格式，能根据条目信息确定文献类型标识/文献载体标识，并在各类参考文献条目驱动中直接使用。各不同类型文献的类型标识/文献载体标识，参考GB/T 7714-2015表B.1和B.2。 \end{property} \subsubsection{版次}\label{sec:fmt:edition} @@ -829,7 +1317,7 @@ userb={cn} \begin{property}{}{} 用户在给bib源文件录入版次信息时，只要录入版次的整数数字或者录入需要打印的字符串。 -本样式文件实现了GB/T 7714-2015第8.3节要求的格式，对于一般的版式格式，根据edition/version域输入的整数进行处理，其它特殊的版本说明，比如新1版，明刻本等直接在edition域录入后原样打印。 +本样式实现了GB/T 7714-2015第8.3节要求的格式，对于一般的版次格式，根据edition/version域输入的整数进行处理，其它特殊的版本说明，比如新1版，明刻本等直接在edition域录入后原样打印。 \end{property} \subsubsection{出版项}\label{sec:fmt:pubitem} @@ -837,7 +1325,7 @@ userb={cn} \begin{property}{}{} 用户在给bib源文件录入出版项信息时，当出版日期有其它形式的纪年时，将其置于公元纪年后面的()内，并整体录入到 year 数据域中，比如: 1845(清同治四年)。而引用日期应录入到 urldate 数据域。当除了出版日期外还有修改/更新日期等时，可在year或date数据域录入第二个日期，并用/符号与前一个出版日期隔开。而专利的公告日期和其它条目类型的出版年应录入到 date 域中。 -本样式文件实现了GB/T 7714-2015第8.4节要求的格式。当出版地和出版者缺省时，中英文自动区分处理。对于用/符号隔开的两个日期，biblatex后端biber能自动解析，后一个日期数据自动解析到endyear等域可作为修改日期等在样式文件中使用。 +本样式实现了GB/T 7714-2015第8.4节要求的格式。当出版地和出版者缺省时，中英文自动区分处理。对于用/符号隔开的两个日期，biblatex后端biber能自动解析，后一个日期数据自动解析到endyear等域可作为修改日期等使用。 \end{property} \subsubsection{页码}\label{sec:fmt:pages} @@ -851,14 +1339,14 @@ userb={cn} \begin{property}{}{} 用户在给bib源文件录入获取和访问路径、数字对象唯一标识符信息时，将访问路径录入到url域中，数字对象唯一标识符录入到doi域中即可。 -本样式文件实现了GB/T 7714-2015第8.6,8.7节要求的格式。 +本样式实现了GB/T 7714-2015第8.6,8.7节要求的格式。 \end{property} \subsubsection{卷和期}\label{sec:fmt:volnum} \begin{property}{}{}%[break at=0.4cm/0pt] 用户在给bib源文件录入卷、期等信息时，如\ref{sec:bib:bibtex}节中所述，合期的期号用/间隔，比如9/10，填入number域，报纸的版次也填入number域。 -本样式文件实现了GB/T 7714-2015第8.8节要求的析出文献相关格式。 +本样式实现了GB/T 7714-2015第8.8节要求的析出文献相关格式。 \end{property} @@ -951,7 +1439,7 @@ userb={cn} \cite{Dublin2012-06-14--} -\printbibliography[heading=subbibliography,type=book,notkeyword=standard,title=【A1-普通图书-著录格式示例】]%subbibintoc +\printbibliography[heading=subbibliography,type=book,notkeyword=standard,title=【A1- 普通图书-著录格式示例】]%subbibintoc \defbibfilter{collections}{% type=collection or type=proceedings @@ -968,8 +1456,8 @@ and keyword=standard } \printbibliography[heading=subbibliography,filter=standard,title=【A6-标准文献-著录格式示例】] \hypertarget{entrystdwithoutauthor}{注意:这里最后一篇标准文献没有责任者，所以作者年制默认情况下无法给出文献标识符。} -\printbibliography[heading=subbibliography,type=inbook,notkeyword=standard,title=【A7-专著中析出的文献-著录格式示例】] -\printbibliography[heading=subbibliography,type=article,notkeyword=news,title=【A8-期刊中析出的文献-著录格式示例】] +\printbibliography[heading=subbibliography,type=inbook,notkeyword=standard,title=【A7- 专著中析出的文献-著录格式示例】] +\printbibliography[heading=subbibliography,type=article,notkeyword=news,title=【A8- 期刊中析出的文献-著录格式示例】] \printbibliography[heading=subbibliography,keyword=news,title=【A9-报纸析出的文献-著录格式示例】]%type=article,有时type是newspaper所以不指定type为article \printbibliography[heading=subbibliography,type=online,title=【A10-电子资源-著录格式示例】] \end{refsection} @@ -979,141 +1467,103 @@ and keyword=standard 专著book和专著中的析出文献inbook及标准standard文献测试，参见: 顺序编码制: -\href{run:./example/egbooks.tex}{egbooks.tex}， -\href{run:./example/egbooks.pdf}{egbooks.pdf}。 +\href{run:./example/testbooks.tex}{testbooks.tex}， +%\href{run:./example/egbooks.pdf}{egbooks.pdf}。 作者年制: -\href{run:./example/egbooksay.tex}{egbooksay.tex}， -\href{run:./example/egbooksay.pdf}{egbooksay.pdf}。 +\href{run:./example/testbooksay.tex}{testbooksay.tex}， +%\href{run:./example/egbooksay.pdf}{egbooksay.pdf}。 \subsection{测试:连续出版物periodical和连续出版物中的析出文献article} 连续出版物periodical和连续出版物中的析出文献article文献测试，参见: 顺序编码制: -\href{run:./example/egjournal.tex}{egjournal.tex}， -\href{run:./example/egjournal.pdf}{egjournal.pdf}。 +\href{run:./example/testjournal.tex}{testjournal.tex}， +%\href{run:./example/egjournal.pdf}{egjournal.pdf}。 作者年制: -\href{run:./example/egjournalay.tex}{egjournalay.tex}， -\href{run:./example/egjournalay.pdf}{egjournalay.pdf}。 +\href{run:./example/testjournalay.tex}{testjournalay.tex}， +%\href{run:./example/egjournalay.pdf}{egjournalay.pdf}。 \subsection{测试:电子资源或在线资源online} 在线资源online文献测试，参见: 顺序编码制: -\href{run:./example/egonline.tex}{egonline.tex}， -\href{run:./example/egonline.pdf}{egonline.pdf}。 +\href{run:./example/testonline.tex}{testonline.tex}， +%\href{run:./example/egonline.pdf}{egonline.pdf}。 作者年制: -\href{run:./example/egonlineay.tex}{egonlineay.tex}， -\href{run:./example/egonlineay.pdf}{egonlineay.pdf}。 +\href{run:./example/testonlineay.tex}{testonlineay.tex}， +%\href{run:./example/egonlineay.pdf}{egonlineay.pdf}。 -\qd{注意:对于作者年制，这里有4篇文献都是noauthor，有两篇有年份可以轻易分开，还有两篇没有年份存在歧义，所以在标注中用了[n.d.]加a和b分开，但在参考文献表中，各个版本的biblatex表现是不同的，其中3.4版因为进行newbibmacro*\{date+extrayear\}的定义时候，首先判断iffieldundef\{\textbackslash thefield\{datelabelsource\}year\}，当不存在datelabelsource的值+year的域时，就不再添加了。如果需要加extrayear也可以修改出来，但其实并无必要。这与标注中用的newbibmacro*\{cite:labelyear+extrayear\}(在authoryear.cbx文件中)的定义是不一样的。更多的内容详见 -\ref{sec:dateinlabel}节。\par} +\qd{注意:对于作者年制，这里有4篇文献都是noauthor，有两篇有年份可以轻易分开，还有两篇没有年份存在歧义，所以在标注中用了[n.d.]加a和b分开，但在参考文献表中，各个版本的biblatex表现是不同的，其中3.4版因为进行newbibmacro*\{date+extrayear\}的定义时候，首先判断iffieldundef\{\textbackslash thefield\{datelabelsource\}year\}，当不存在datelabelsource的值+year的域时，就不再添加了。如果需要加extrayear也可以修改出来，但其实并无必要。这与标注中用的newbibmacro*\{cite:labelyear+extrayear\}(在authoryear.cbx文件中)的定义是不一样的。} \subsection{测试:学位论文thesis、专利文献patent} 学位论文thesis文献专利文献patent文献测试，参见: 顺序编码制: -\href{run:./example/egthesispatent.tex}{egthesispatent.tex}， -\href{run:./example/egthesispatent.pdf}{egthesispatent.pdf}。 +\href{run:./example/testthesispatent.tex}{testthesispatent.tex}， +%\href{run:./example/egthesispatent.pdf}{egthesispatent.pdf}。 作者年制: -\href{run:./example/egthesispatentay.tex}{egthesispatentay.tex}， -\href{run:./example/egthesispatentay.pdf}{egthesispatentay.pdf}。 +\href{run:./example/testthesispatentay.tex}{testthesispatentay.tex}， +%\href{run:./example/egthesispatentay.pdf}{egthesispatentay.pdf}。 -\qd{注意:专利文献\{刘加林1993--\}的location定义了中国，GB/T 7714-2015中其实并不需要该域，但这里并没有去掉，先放着也许以后标准修改后可能用的着。如果要去掉，那么将bib文件中该条目的location去掉就行了。} +\qd{注意:专利文献\{刘加林1993--\}的location定义了中国，但从GB/T 7714-2015中给出的示例看其实并不需要该域，但这里并没有去掉。因为GB/T 7714-2015中给出的著录格式包括了出版项但没有示例，尽管这里的location是专利地域，但也可以作为出版项来考虑。未来国标完善后再做处理。} \subsection{测试:报告report、手册manual和档案、未出版物unpublished} 报告report、手册manual和档案、未出版物unpublished文献测试，参见: 顺序编码制: -\href{run:./example/egreport.tex}{egreport.tex}， -\href{run:./example/egreport.pdf}{egreport.pdf}。 +\href{run:./example/testreport.tex}{testreport.tex}， +%\href{run:./example/egreport.pdf}{egreport.pdf}。 作者年制: -\href{run:./example/egreportay.tex}{egreportay.tex}， -\href{run:./example/egreportay.pdf}{egreportay.pdf}。 +\href{run:./example/testreportay.tex}{testreportay.tex}， +%\href{run:./example/egreportay.pdf}{egreportay.pdf}。 -\subsection{测试:会议文集proceedings和会议文集中析出的文献inproceedings及汇编collection和汇编中的析出文献incollection} +\subsection{测试:会议文集proceedings和会议文集中析出的文献inproceedings} proceedings和inproceedings及collection和incollection文献测试，参见: 顺序编码制: -\href{run:./example/egprcdorinprcd.tex}{egprcdorinprcd.tex}， -\href{run:./example/egprcdorinprcd.pdf}{egprcdorinprcd.pdf}。 +\href{run:./example/testproceedings.tex}{testproceedings.tex}， +%\href{run:./example/egprcdorinprcd.pdf}{egprcdorinprcd.pdf}。 作者年制: -\href{run:./example/egprcdorinprcday.tex}{egprcdorinprcday.tex}， -\href{run:./example/egprcdorinprcday.pdf}{egprcdorinprcday.pdf}。 - -\subsection{测试: 双语文献}\label{sec:doublelang:test} - -双语文献的两种实现方法，一是基于set的动态方法，二是基于related的动态方法，参见: -\href{run:./example/egaligngb7714-2015ay.tex}{egaligngb7714-2015ay.tex}， -\href{run:./example/egaligngb7714-2015ay.pdf}{egaligngb7714-2015ay.pdf}。 - -\subsection{测试: gbalign选项}\label{sec:align:test} -gbalign选项主要控制顺序编码制序号标签三种对齐方式， -分别是: +\href{run:./example/testproceedingsay.tex}{testproceedingsay.tex}， +%\href{run:./example/egprcdorinprcday.pdf}{egprcdorinprcday.pdf}。 -右对齐，参见: -\href{run:./example/egalignright.tex}{egalignright.tex}， -\href{run:./example/egalignright.pdf}{egalignright.pdf}。 -左对齐，参见: -\href{run:./example/egalignleft.tex}{egalignleft.tex}， -\href{run:./example/egalignleft.pdf}{egalignleft.pdf}。 +\subsection{测试:汇编collection和汇编中的析出文献incollection} -项对齐，参见: -\href{run:./example/egaligngb7714-2015.tex}{egaligngb7714-2015.tex}， -\href{run:./example/egaligngb7714-2015.pdf}{egaligngb7714-2015.pdf}。 +proceedings和inproceedings及collection和incollection文献测试，参见: -\subsection{测试: gbpub选项}\label{sec:opt:gbpub} -gbpub选项测试参见: +顺序编码制: +\href{run:./example/testcollection.tex}{testcollection.tex}， +%\href{run:./example/egprcdorinprcd.pdf}{egprcdorinprcd.pdf}。 -顺序编码制（作者年制类似）: +作者年制: +\href{run:./example/testcollectionay.tex}{testcollectionay.tex}， +%\href{run:./example/egprcdorinprcday.pdf}{egprcdorinprcday.pdf}。 -\href{run:./example/eggbpubtrue.tex}{eggbpubtrue.tex}， -\href{run:./example/eggbpubtrue.pdf}{eggbpubtrue.pdf}。 -\href{run:./example/eggbpubfalse.tex}{eggbpubfalse.tex}， -\href{run:./example/eggbpubfalse.pdf}{eggbpubfalse.pdf}。 -\subsection{测试: gbnoauthor选项和online条目仅存url信息} +\subsection{测试: online条目仅存url信息} \label{sec:opt:noauthor} online条目信息严重缺失问题测试参见: -\href{run:./example/eggbnoauthortrue.tex}{eggbnoauthortrue.tex}， -\href{run:./example/eggbnoauthortrue.pdf}{eggbnoauthortrue.pdf}。 - -\href{run:./example/eggbnoauthorfalse.tex}{eggbnoauthorfalse.tex}， -\href{run:./example/eggbnoauthorfalse.pdf}{eggbnoauthorfalse.pdf}。 - -gbnoauthor选项测试参见: - -\href{run:./example/eggbnoauthortrueay.tex}{eggbnoauthortrueay.tex}， -\href{run:./example/eggbnoauthortrueay.pdf}{eggbnoauthortrueay.pdf}。 - -\href{run:./example/eggbnoauthorfalseay.tex}{eggbnoauthorfalseay.tex}， -\href{run:./example/eggbnoauthorfalseay.pdf}{eggbnoauthorfalseay.pdf}。 +顺序编码制:\href{run:./example/testonlyurl.tex}{testonlyurl.tex}， +%\href{run:./example/eggbnoauthortrue.pdf}{eggbnoauthortrue.pdf}。 -\subsection{测试: gbnamefmt选项} -\label{sec:opt:namefmt} -姓名默认情况下字母大写的，即 gbnamefmt=uppercase，设置 gbnamefmt=lowercase 可以不处理保持原始的大小写，设置 gbnamefmt=none 则使用 biblatex标准样式的处理方式，参见: +作者年制:\href{run:./example/testonlyurlay.tex}{testonlyurlay.tex}， +%\href{run:./example/eggbnoauthorfalse.pdf}{eggbnoauthorfalse.pdf}。 -gbnamefmt=lowercase 情况： -\href{run:./example/eggbnamefmta.tex}{eggbnamefmta.tex}， -\href{run:./example/eggbnamefmta.pdf}{eggbnamefmta.pdf}。 - -gbnamefmt=none 情况： -\href{run:./example/eggbnamefmtb.tex}{eggbnamefmtb.tex}， -\href{run:./example/eggbnamefmtb.pdf}{eggbnamefmtb.pdf}。 \subsection{测试: beamer类} @@ -1127,39 +1577,42 @@ beamer类中的参考文献测试，参见: \href{run:./example/egbeameray.tex}{egbeameray.tex}， \href{run:./example/egbeameray.pdf}{egbeameray.pdf}。 -\subsection{测试: 上标和非上标等不同的标注格式}\label{sec:cite:cmd:test} +%\subsection{测试: 上标和非上标等不同的标注格式}\label{sec:cite:cmd:test} +%\begin{refsection} +%不带页码的引用(顺序编码制上标，方括号包围；作者年制行内，括号包围): +%\begin{itemize} +% \item 见文献\cite{Peebles2001-100-100}。 +%\end{itemize} +% +%不带页码的引用(顺序编码制非上标，方括号包围；作者年制行内，括号包围): +%\begin{itemize} +% \item 在文献\parencite{Miroslav2004--}中。 +%\end{itemize} +% +%带页码的引用(标准命令，默认样式; 增加命令，GB/T 7714-2015样式): +%\begin{itemize} +% \item \cite[见][49页]{蔡敏2006--}\parencite[见][49页]{Miroslav2004--}。 +% \item \pagescite{Peebles2001-100-100}\pagescite[][201-301]{Peebles2001-100-100} +%\end{itemize} +% +%已有作者只需要年份和页码的情况(命令yearpagescite)，作者年制(上标)，顺序编码制(与pagescite作用相同); +%已有作者只需要年份的情况(命令yearcite): +%\begin{itemize} +% \item 见赵耀东\yearpagescite[][205]{赵耀东1998--}和Simon\yearpagescite[][15]{Simon2001--}的文献。 +% \item 见赵耀东\yearcite{赵耀东1998--} +% \item 见赵耀东(\cite*{赵耀东1998--}) +% \item 见赵耀东(\citeyear{赵耀东1998--}) +%\end{itemize} +% +%\printbibliography[heading=subbibliography,title=【gb7714-2015顺序编码制上标和非上标标注测试】] +%\end{refsection} + +\subsection{测试: 传统和新增条目类型的兼容性} +\label{sec:entrytype:compatibility} \begin{refsection} -不带页码的引用(顺序编码制上标，方括号包围；作者年制行内，括号包围): -\begin{itemize} - \item 见文献\cite{Peebles2001-100-100}。 -\end{itemize} - -不带页码的引用(顺序编码制非上标，方括号包围；作者年制行内，括号包围): -\begin{itemize} - \item 在文献\parencite{Miroslav2004--}中。 -\end{itemize} - -带页码的引用(标准命令，默认样式; 增加命令，GB/T 7714-2015样式): -\begin{itemize} - \item \cite[见][49页]{蔡敏2006--}\parencite[见][49页]{Miroslav2004--}。 - \item \pagescite{Peebles2001-100-100}\pagescite[][201-301]{Peebles2001-100-100} -\end{itemize} - -已有作者只需要年份和页码的情况(命令yearpagescite)，作者年制(上标)，顺序编码制(与pagescite作用相同); -已有作者只需要年份的情况(命令yearcite): -\begin{itemize} - \item 见赵耀东\yearpagescite[][205]{赵耀东1998--}和Simon\yearpagescite[][15]{Simon2001--}的文献。 - \item 见赵耀东\yearcite{赵耀东1998--} - \item 见赵耀东(\cite*{赵耀东1998--}) - \item 见赵耀东(\citeyear{赵耀东1998--}) -\end{itemize} - -\printbibliography[heading=subbibliography,title=【gb7714-2015顺序编码制上标和非上标标注测试】] -\end{refsection} +测试某些bib文件给出的mastersthsis，phdthsis，www，electronic，standard，techreport，conference条目类型，测试本样式增加的newspaper类型。更多条目类型的测试见： +\href{run:/example/testentrytypes.tex}{testentrytypes.tex}。 -\subsection{测试: phdthsis等条目类型的兼容性}\label{sec:entrytype:compatibility} -\begin{refsection} -测试某些bib文件给出的mastersthsis，phdthsis，www，electronic，standard，techreport，conference条目类型，测试本样式增加的newspaper类型。 \begin{itemize} \item newspaper:\cite{张田勤2000--} \item standard:\cite{全国文献工作标准化委员会第七分委员会1986--,国家标准局信息分类编码研究所1988-59-92} @@ -1174,9 +1627,10 @@ beamer类中的参考文献测试，参见: \printbibliography[heading=subbibliography,title=【兼容phdthsis等条目类型】] \end{refsection} -\subsection{测试: 当责任者等需要判断中英文的信息中存在编组时的处理} +\subsection{测试: 中英文判断信息中存在编组时的处理} \begin{refsection} -当责任者等需要判断中英文的信息中存在编组时的处理\cite{IFLAI1977b--,IFLAI1977--} +当责任者等需要判断中英文的信息中存在编组时的处理 +\cite{IFLAI1977b--,IFLAI1977--} \cite{r27-BenHadjAlaya-FekiA.2008-1-5,中国企业投资协会2014--,中国企业投资协会2015--} \printbibliography[heading=subbibliography,title=【中英文判断信息中存在编组的测试】] @@ -1184,18 +1638,20 @@ beamer类中的参考文献测试，参见: -\subsection{测试: 处理参考文献信息中\&等特殊字符}\label{sec:entrytype:compatibility} +\subsection{测试: 处理参考文献信息中\&等特殊字符} +\label{sec:entrytype:compatibility} \begin{refsection} 文献中\cite{ref-replace-char}的booktitle域中含有\%，\&，\#符号，样式文件自动处理使其符合tex代码规则。 \printbibliography[heading=subbibliography,title=【处理参考文献信息中\&等特殊字符】] \end{refsection} -\subsection{测试: 处理作者年制article中卷信息缺省的标点}\label{sec:article:novol} +\subsection{测试: 处理作者年制article中卷信息缺省的标点} +\label{sec:article:novol} \begin{refsection} 文献\cite{刘彻东1998-38-39}\cite{亚洲地质图编目组1978-194-208} \cite{高光明1998-60-65} -\printbibliography[heading=subbibliography,title=【author-year style:article without volume】] +\printbibliography[heading=subbibliography,title=【author-year style: article without volume】] \end{refsection} \subsection{测试: 标题中有\textbackslash LaTeX\{\}等名称时的情况}\label{sec:with:latex} @@ -1206,1156 +1662,15 @@ beamer类中的参考文献测试，参见: \end{refsection} - - -\section{样式文件设计、实现、应用}\label{sec:biblatex:mech} -biblatex相当完善和强大，笔者开发样式文件过程中仅使用了biblatex提供的一小部分功能，更多功能其实都没有涉及到。可以说，biblatex作为参考文献问题的一个完整解决方案是名副其实的。笔者在设计样式文件时应用biblatex宏包功能的思路和实现总结如下: - -\subsection{基本思路} - -考虑到我国引用参考文献通常是中英文混合的情况，因此不考虑针对中文的本地化处理，而是在英文本地化的基础(英文的本地化字符串设置文档是english.lbx)上添加一些中文要求的本地化字符串来使用。而为了区分使用中英文的字符串，对参考文献条目中数据域内容进行中英文判断，若是中文则使用中文字符串，若是英文则使用英文字符串。 - -这里的中英文判断主要是在tex中的判断，利用对域中的信息进行检测，当信息的第一个字符是CJK字符时，判断该域的信息是中文的，否则是英文的。 - -在作者年制中不同语种文献分集时也有一个中英文判断，主要是利用动态数据修改的方法。利用perl正则表达式判断作者和标题域中是否有中文信息(可以用排除法即匹配不是英文数字标点的字符通常是中文字符，当然最直接的是用unicode的中文字符范围匹配)，有的话设置cn，否则为en。事实上这种判断可以进一步扩展，利用强大的perl正则表达式，对所有的关键域进行判断，并在一些域中设置标识，用于tex输出时进行判断，而避免直接使用上述CJK字符判断函数。 - -\subsection{利用字符流解析或者xstring宏包的函数}\label{sec:cjkjudge} -\begin{enumerate} -\item cjk字符判断 -\begin{texlist} -%定义判断中文字符的函数，用于判断作者等信息是否由中文字符构成 -%2E00-2E7F 追加标点 -%2E80-2EFF cjk部首补充 -%2FF0-2FFF 表意文字描述符 -%3000-303F cjk符号和标点 -%3300-33FF cjk兼容 -%3400-4DBF cjk统一表意符号扩展 -%4E00-9FBF cjk统一表意符号 -%中文范围4E00-9FA5 -\providetoggle{ifCJKforgbt} -\def\testCJKfirstchar#1#2&{% -\ifnumgreater{`#1}{"2E7F}{\toggletrue{ifCJKforgbt}}{\togglefalse{ifCJKforgbt}}% -}% - -%利用edef展开或xstring抽取第一个字符判断 -%现在采用xstring方法，避免抽取的是编组符号 -\def\testCJKfirst#1{% -%\edef\tempa{#1}%可以替换下面两句，但失去忽略多余编组功能 -\exploregroups% -\StrChar{#1}{1}[\tempa]% -\expandafter\testCJKfirstchar\tempa&} -\end{texlist} - -\item 卷期范围解析 -\begin{texlist} -%用于解析连续出版物，2个卷期的情况 -%\def\multivolumeparsetoparts#1/#2{\def\multivolumefirst{#1}\def\multivolumesecond{#2}} -%\def\multinumberparsetoparts#1/#2{\def\multinumberfirst{#1}\def\multinumbersecond{#2}} -%范围起止间隔符号还是用-，而不是与date相同的/，因为有合期期刊的问题，需要用到/符号 -\newcommand{\multivolparser}[1]{% - \IfSubStr{#1}{-}% - {\StrBefore{#1}{-}[\multivolfirst]\StrBehind{#1}{-}[\multivolsecond]}% - {\def\multivolfirst{#1}\def\multivolsecond{}}% -} - -\newcommand{\multinumberparser}[1]{% - \IfSubStr{#1}{-}% - {\StrBefore{#1}{-}[\multinumberfirst]\StrBehind{#1}{-}[\multinumbersecond]}% - {\def\multinumberfirst{#1}\def\multinumbersecond{}}% -} - -%这里利用李志奇的范围数据解析函数，修改后用来处理卷volume的范围。 -%他的这个函数是通用的，只能在使用数据前使用，如果多次使用前一次得到的数据就会被冲掉 -%这里的范围起止判断符号还是用-，而不是与date相同的/，因为有合期期刊的问题，需要用到/符号 -%\def\gbt@parse@range#1{% -% \edef\gbt@tmpa{#1}% -% \expandafter\gbt@parse@rangei\gbt@tmpa-\@empty} -%\def\gbt@parse@rangei#1-#2\@empty{% -% \global\def\gbt@range@first{#1}% -% \def\gbt@tmpa{#2}% -% \ifx\gbt@tmpa\@empty% -% \global\def\gbt@range@second{}% -% \else% -% \gbt@parse@rangeii#2\@empty% -% \fi} -%\def\gbt@parse@rangeii#1-#2\@empty{% -% \def\gbt@tmpa{#2}% -% \ifx\gbt@tmpa\@empty% -% \global\def\gbt@range@second{#1}% -% \else% -% \gbt@parse@rangeii#2\@empty% -% \fi} - -%这里写的number的解析函数，与上面的卷解析函数是类似的。 -%\def\multinumberparser#1{% -% \edef\gbnumbertmp{#1}% -% \expandafter\multinumberparsetoparts\gbnumbertmp-\@empty} -%\def\multinumberparsetoparts#1-#2\@empty{% -% \def\multinumberfirst{#1}% -% \def\gbnumbertmp{#2}% -% \ifx\gbnumbertmp\@empty% -% \def\multinumbersecond{}% -% \else% -% \multinumberparsetopartsb#2\@empty% -% \fi} -%\def\multinumberparsetopartsb#1-#2\@empty{% -% \def\gbnumbertmp{#2}% -% \ifx\gbnumbertmp\@empty% -% \def\multinumbersecond{#1}% -% \else% -% \multinumberparsetopartsb#2\@empty% -% \fi} -\end{texlist} - -\end{enumerate} - -\subsection{标点和空格的特点和机制} - \begin{enumerate} - \item 标点符号设置比如:renewrobustcmd*\{\textbackslash bibinitperiod\}\{\} 和renewcommand*\{\textbackslash revsdnamepunct\}\{\}等用于全局修改标点。 - \item 如isdot/adddot，adddot将原样(逐字，如实)句点转换为缩写点在有利用printtext输入原样字符的时候很重要比如[s.n.] 中，比如title末尾。 - \item 利用newunit输出的标点，需要后面遇到printfield等命令有内容才输出标点，这是标点的异步处理机制。 - \item setunit*的作用是前面printtext等没有输出时候就不输出，见4.11.7.3 节的应用以及出版项缺省时的代码处理。 - \item 标点和空格的调试方法:有时引入多余的空格和标点后很难快速处理，那么需要调试，调试的第一步是注释掉多余的代码，实现无多余空格或标点情况(一种快速方法是直接在一个printtext输出各相关域)，然后一步步恢复原来的代码，直到找到多余空格或标点产生的原因，最后根据原因作出修改。 - \item 多余空格的引入，可能来自于如下方面(下面是已经遇到的，可能还有更多) - \begin{itemize} - \item 行末空格引入，解决方法:把相关的代码行结尾用\%符号注释。 - \item mkbibparens等命令引入，解决方法:利用printtext\{(\}，printtext\{)\}来代替 - \item nopunct等命令引入，这种引入的空格使用unspace命令还消除不了，解决方法:避免使用nopunct命令，而在标点设置时多做判断，只有有内容时才设置标点，而不是过分依赖biblatex提供的标点异步处理机制。 - \end{itemize} - - \item 短横线相关的字符，参考: unicode 表 - - \begin{itemize} - \item 0x2d:hyphen :\char"2D，直接输入键盘短横线得到\verb|-|，即为连字符 - \item 0x2010:hyphen :\char"2010 - \item 0x2011:non breaking hyphen :\char"2011 - \item 0x2012:figure dash :\char"2012 - \item 0x2013:en dash :\char"2013，直接输入两个键盘短横线得到\verb|--| - \item 0x2014:em dash :\char"2014，中文全角的一段破折号线，可以用三个短横线得到\verb|---| - \item 0x2212:mathematical minus :\char"2212 - \end{itemize} - biblatex中页码范围中的间隔符是\verb|\bibrangedash|，默认则是en dash。可以通过设置如下命令做修改: - \begin{texlist} - \DefineBibliographyExtras{english}{\renewcommand*{\bibrangedash}{-}}% 将页码间隔符替换为hypen连字符 - \end{texlist} - 而日期成分之间的间隔符则是\verb|\bibdatesep|，默认是hyphen，即连字符。 - - \item 使用printtext等命令确保异步处理机制不被破坏，典型的例子为，专利的公告日期(对于3.7以上版本)使用了biblatex的内容宏，但还需要将其用printtext包围起来，比如: - \begin{texlist} - % - % 专利的公告日期、或报纸的日期的输出宏 - % 20160701，v1.0，新增加 - % 20180405，为biblatexv3.10版本，出现多出点bug做处理，Hu Zhenzhen - % - % 原理方法:加上printtext避免破坏异步标点机制 - % - \newbibmacro*{newsdate}{%% - \printtext{\blx@isodate{}{}}%% - } - \end{texlist} - - \item beamer中标题后面的标点情况，beamer对bibmacro\{title\}做了patch以实现特殊的效果。比如: - \begin{texlist} - \pretocmd{\abx@macro@title} - {\ifcsundef{abx@name@labelname}{}{\let\bbx@tempa\labelnamepunct}% - \bbx@tempa\newblock\unspace\usebeamercolor[fg]{bibliography entry title}}{}{} - \apptocmd{\abx@macro@title} - {\ifcsundef{abx@field@title}{}{\ifpunct{}{\midsentence\newunitpunct}} - \newblock\unspace\usebeamercolor[fg]{bibliography entry note}}{}{} - \end{texlist} - 该patch详见beamerbaselocalstructure.sty文件。需要注意\verb|abx@field@title|，在biblatex中是有newbibmacro\{title\}产生的。注意到在apptocmd做的patch中，midsentence命令隐藏了其前面的标点并重新做标点最终，因此其后的newunitpunct命令必将输出标点，因此无论如何标题后面必然会出现一个newunitpunct控制的标点，这个标点一般情况下是可以用的，但是对于有些文献类型比如inbook，析出文献标题后面没有标点只有//，因此需要将该标点去掉，所以需要反处理该patch。 - 通过测试表明，无论是在title前再做pretocmd或者在title后再做apptocmd 都会产生问题，多个的apptocmd的机制大体是前一个做完后，后一个在其基础上处理，而apptocmd主要做的是封装，因此前一个产生的效果无法消除。但通过思考发现，使用patchcmd 可以对前面的效果产生影响，它不是封装而是一种替换，所以可以将前面封装的效果去掉。比如: - \begin{texlist} - % - % 文献标题后的标点问题 - % 20180405，v1.0k，为texlive2017以上版本中的beamer兼容性做的处理，Hu Zhenzhen - % - % 原理方法:如下代码处理texlive2017以上版本中，beamer中文献的标题后出现两个点的情况: - % texlive2017以上的beamer中对macro{title}做了patch，正常情况下不会出现两个点的情况，但由于 - % 之前为了处理texlive2015，2016下的title格式添加了adddot，导致出现两个点的情况，而且也影响 - % 析出文献的//符号的输出，因此再次对macro{title}做patch消除beamer中做apptocmd时添加的\newunitpunct - \ifboolexpr{% - test{\iftoggle{iftlfive}} - or - test{\iftoggle{iftlsix}} - }{}% - {%texlive 2017对应iftlseven以上版本 - \DeclareFieldFormat{title}{#1}% - \DeclareFieldFormat[article,patent,thesis,unpublished]{title}{#1} - \AtBeginDocument{% - \@ifclassloaded{beamer} - {\patchcmd{\abx@macro@title}{\newunitpunct}{}{}{}}{}} - } - \end{texlist} - - \end{enumerate} - - -\subsection{动态数据修改} -利用biber在处理数据源时的动态处理，可以处理一些数据，比如设置一些域的值，用于进一步的判断和应用。 - -\subsubsection{基本原理和方法}\label{sec:dynamic:modify} -biber动态数据处理，详见biblatex说明文档Dynamic Modification of Data一节和bbx文件中DeclareSourcemap的内容。 - \begin{enumerate} - \item map的作用，对条目逐条进行处理 - \item final作用，当不成立map终止。 - \item append的作用，给域添加信息 - \item origfieldvalue来源 - \item overwite选项有无的作用，无overwite时，只要域原有信息，那么就不再map，有overwite时，则进行覆盖。\bc{注意:使用append的时候也需要overwite选项}。 - \item biblatex3.4以后的版本可以使用foreach选项，而3.0版只能一个域一个域的处理，意味着每一个域处理都要写一个map 步。 - \item date域仅作为解析用，不出现在bbl文件中，所以在bbx内部进行日期判断的时候要注意，不使用date 域而要用由其解析出来的year 等域进行判断，而且当date域的内容不符合解析格式要求时，自动忽略掉，那么信息有可能丢失，因此当有不符合解析格式的日期信息时应放到year 域中。 - \item 动态数据处理中利用正则表达式可以用来处理特殊字符，对于参考文献信息中一些特殊字符比如\&等，除了利用jabref软件的biblatex 可以自动转换外，利用动态数据修改也可以做一定的处理，比如对一些容易出现这种字符的域进行处理，使其内容符合tex源文件书写规则，即在特殊字符前加上斜杠。注意利用正则表达式处理\%，\#时直接在regexp中写字符没有问题，但是对于\&字符就存在问题，所以对于该字符使用十六进制表示方法\verb|\x26|。 比如: - - - - \begin{texlist} - %for texlive >2016 - \DeclareStyleSourcemap{ - \maps[datatype=bibtex]{ - \map[overwrite, foreach={title,booktitle,journaltitle,journal,publisher,address,location,institution,organization}]{ - \step[fieldsource=\regexp{$MAPLOOP}, match=\regexp{([^\\])\#}, replace=\regexp{$1\\\#}] - } - \map[overwrite, foreach={title,booktitle,journaltitle,journal,publisher,address,location,institution,organization}]{ - \step[fieldsource=\regexp{$MAPLOOP}, match=\regexp{([^\\])\%}, replace=\regexp{$1\\\%}] - } - \map[overwrite, foreach={title,booktitle,journaltitle,journal,publisher,% - address,location,institution,organization}]{ - \step[fieldsource=\regexp{$MAPLOOP}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - } - } - - %for texlive 2015 - \DeclareStyleSourcemap{ - \maps[datatype=bibtex]{ - \map[overwrite]{%title,booktitle,journaltitle,journal,publisher,address,location,institution,organization - \step[fieldsource={title}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={booktitle}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={journaltitle}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={journal}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={publisher}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={address}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={location}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={institution}, match=\regexp{([^\\])\x26}, replace=\regexp{$1\\\x26}] - } - \map[overwrite]{ - \step[fieldsource={booktitle}, match=\regexp{([^\\])\#}, replace=\regexp{$1\\\#}] - } - \map[overwrite]{ - \step[fieldsource={booktitle}, match=\regexp{([^\\])\%}, replace=\regexp{$1\\\%}] - } - } - } - \end{texlist} - - \end{enumerate} - -\subsubsection{数据模型} - 下面介绍biblatex数据模型与动态数据处理的关系。 - - biblatex提供了数据模型定义功能，这在真正需要定义一些新的条目类型和域时是用得到的。但实际上，从本样式实践的经验看，为了biblatex 的兼容性考虑，没有必要使用数据模型定义功能去费力地定义新的条目类型，反而直接利用动态数据处理来将bib 中的一些类型转换成biblatex 支持的类型会更方便，其中要做一定的区分可以利用一些域的信息进行判断，比如note域等于news 或standard。 - \begin{enumerate} - \item biblatex默认做的别名处理其实是用DeclareDriverSourcemap做的，这是驱动层的映射。在本样式中，因为usera域是在用户层的映射中做的，所以biblatex做的默认别名处理还不够，还需要在用户层首先处理usera域。而因为DeclareDriverSourcemap 中会增加一些不需要的信息，比如thesis类型中的typer域在GB/T7714标准中是并不需要的，这可以利用DeclareSourcemap，DeclarestyleSourcemap(\bc{注意texlive2016 的biblatex3.4 仅支持1 个styleSourcemap，而biblatex3.7则已经支持多个styleSourcemap})先进行映射，这样就避开了DeclareDriverSourcemap。 或者在增加DeclareDriverSourcemap，将标准样式中的默认DeclareDriverSourcemap增加的信息去掉(详见gb7714-2015ay.bbx中的处理和说明)。 - \item 数据模型在blx-dm.DEF中，可以看到standard有条目类型定义，但域和约束没有定义，而biblatex标准样式默认做的别名处理中的其它一些条目比如electronic等是有域和约束定义的。 - \item 标准样式standard.BBX中的DeclareBibliographyAlias\{*\}\{misc\} 将一些数据模型中没有定义的条目直接用misc条目的驱动处理，这不是驱动层的数据源映射，只是利用其驱动进行输出。有一个问题是DeclareBibliographyAlias\{newspaper\}\{article\}是否可以实现？还是要定义数据模型？从实践结果看是不需要定义数据模型的，并且驱动的别名处理等价于驱动层映射。比如: - 做了用户层映射后: - \begin{texlist} - \DeclareSourcemap{ - \maps[datatype=bibtex]{%增加文献标识符如[M],[J]等，下面首先生成这一信息 - \map{ - \pertype{newspaper}%增加一个新闻报纸的类型newspaper - \step[fieldset=usera, fieldvalue={N}]%因为没有专门的驱动，这句的目的是定义一个usera域，方便映射为article 后判断 - \step[fieldset=note, fieldvalue=news] - } - } - } - \end{texlist} - - 做别名处理: - \begin{texlist} - \DeclareBibliographyAlias{newspaper}{article}%定义驱动别名，以替代驱动层映射 - \end{texlist} - - 能达到驱动层或样式层中条目类型转换所实现的效果。 - \begin{texlist} - \DeclareStyleSourcemap{ - \maps[datatype=bibtex]{ - \map{%尝试未定义数据模型的newspaper类型映射为article，newspaper完全是针对gb7714的新类型，在biblatex 中完全没有定义 - %但从实践看，并没有什么影响，映射过来就可以了。 - \step[typesource=newspaper, typetarget=article, final] - } - } - } - \end{texlist} - - \item 从实践看，数据模型中完全没有定义的条目类型newspaper也可以进行数据源映射。 - \end{enumerate} - -\subsubsection{用于关联条目的动态修改的命令封装及关联条目格式}\label{sec:data:mdf:forrelated} - -实现动态的条目关联，可以利用动态数据修改的方法。要对多个条目实现关联，那么需要多次数据映射，biblatex3.7及以上版本可以存在多个DeclareStyleSourcemap，因此做关联的封装命令就是基于此: - -\begin{texlist} - \newcommand{\defdoublelangentry}[2]{% - \edef\entrykeya{#1} - \edef\entrykeyb{#2} - \DeclareStyleSourcemap{ - \maps[datatype=bibtex]{ - \map{ - \step[fieldsource=entrykey, match=\entrykeya, final] - \step[fieldset=related, fieldvalue=\entrykeyb] - } - } - } - } -\end{texlist} - -命令defdoublelangentry有两个输入参数，第一个是主条目，第二个是与主条目关联的条目的列表。多次使用该命令，即可实现多次数据映射，当然因为DeclareStyleSourcemap只能存在于导言区，因此defdoublelangentry也只能存在于导言区。 - -关联条目之间用命令relateddelim分隔，但实际上因为related宏输出时，不知道是何原因考虑的是主条目的关联条目之间的分隔，这在双语文献中是有问题的，需要在主条目后也进行分隔，因此对该宏修改如下: - -\begin{texlist} -\renewbibmacro*{related}{% - \ifboolexpr{ test {\iffieldundef{related}} or test {\ifrelatedloop} } - {} - {\usebibmacro{begrelated}% - \def\bbx@tempa{}% - \setcounter{bbx:relatedtotal}{0}% - \def\do##1{% - \entrydata{##1}{% - \ifrelatedloop - {} - {\stepcounter{bbx:relatedtotal}% - \gappto{\bbx@tempa}{##1,}}}}% - \docsvfield{related}% - \restorefield{related}{\bbx@tempa}% - \ifnumgreater{\value{bbx:relatedtotal}}{0} - {\listcsxadd{bbx:relatedloop}{\strfield{entrykey}}% - \iffieldundef{clonesourcekey} - {} - {\listcsxadd{bbx:relatedloop}{\strfield{clonesourcekey}}}% - \setcounter{bbx:relatedcount}{0}% - \def\do{% - \stepcounter{bbx:relatedcount}% - \ifnumgreater{\value{bbx:relatedcount}}{0}%为使主条目与关联条目做分隔，这里做修改，从1改为0 - {\ifcsundef{relateddelim\strfield{relatedtype}} - {\printtext{\relateddelim}} - {\printtext{\csuse{relateddelim\strfield{relatedtype}}}}} - {}}% - \ifbibmacroundef{related:\strfield{relatedtype}} - {\appto{\do}{\usebibmacro{related:default}}} - {\appto{\do}{\usebibmacro*{related:\strfield{relatedtype}}}}% - \iffieldformatundef{related:\strfield{relatedtype}} - {\def\bbx@tempa{related}} - {\def\bbx@tempa{related:\strfield{relatedtype}}}% - \iffieldformatundef{relatedstring:\strfield{relatedtype}} - {\def\bbx@tempb{relatedstring:default}} - {\def\bbx@tempb{relatedstring:\strfield{relatedtype}}}% - \printtext[\bbx@tempa]{% - \usebibmacro{begrelatedloop}% - \iffieldundef{relatedstring} - {\ifboolexpr{ - test {\ifnumgreater{\value{bbx:relatedtotal}}{1}} - and - test {\ifbibxstring{\thefield{relatedtype}s}} - } - {\printtext[\bbx@tempb]{% - \bibstring[\mkrelatedstring]{\thefield{relatedtype}s}}} - {\iffieldbibstring{relatedtype} - {\printtext[\bbx@tempb]{% - \bibstring[\mkrelatedstring]{\thefield{relatedtype}}}} - {}}} - {\iffieldbibstring{relatedstring} - {\printtext[\bbx@tempb]{% - \bibstring[\mkrelatedstring]{\thefield{relatedstring}}}} - {\printfield[\bbx@tempb]{relatedstring}}}% - \docsvfield{related}% - \usebibmacro{endrelatedloop}}}% - {}% - \usebibmacro{endrelated}}} -\end{texlist} - -\subsection{标注(引用)标签} -引用标签的生成机制，即责任者截短时的歧义消除问题，见说明文档4.11.4 Name Disambiguation 节。 - \begin{enumerate} - \item uniquename的作用，用于姓名间的歧义消除。 - \item uniquelist的作用，用于姓名列表间的歧义消除。 - \end{enumerate} - - -关于这两个选项的参数设置，可以在样式中设置，也可以在宏包加载时设置，\bc{注意宏包加载时的设置会覆盖样式中的设置}。 - -还要注意，说明文档中uniquelist的默认选项是false，这是错误的，从实践看是true，从biblatex.sty文件的代码看也是如此，比如: -\begin{texlist} -\DeclareBibliographyOption[boolean]{uniquelist}[true]{% - \ifcsdef{blx@opt@uniquelist@#1} - {\letcs\blx@uniquelist{blx@opt@uniquelist@#1}} - {\blx@err@invopt{uniquelist=#1}{}}} -\DeclareTypeOption[boolean]{uniquelist}[true]{% - \ifcsdef{blx@opt@uniquelist@#1} - {\letcs\blx@uniquelist{blx@opt@uniquelist@#1}} - {\blx@err@invopt{uniquelist=#1}{}}} -\DeclareEntryOption[boolean]{uniquelist}[true]{% - \ifcsdef{blx@opt@uniquelist@#1} - {\letcs\blx@uniquelist{blx@opt@uniquelist@#1}} - {\blx@err@invopt{uniquelist=#1}{}}} -\def\blx@opt@uniquelist@false{0} -\def\blx@opt@uniquelist@true{1} -\def\blx@opt@uniquelist@minyear{2} -\end{texlist} -无论选项是否给出，上面定义选项中的代码都会自动执行，当选项不给出，则自动调用默认的参数(因为代码中直接使用了输入参数，当没有输入参数，自然就会使用默认参数)来进行处理，显然这里是true。 - -\subsubsection{标签中的标点和间隔符号}\label{sec:label:fmt} -文献表中的标签和正文中的标注标签都有标点和间隔符号问题，但两者可能存在一定的差异，不同版本的biblatex中也可能不同，但新的版本中通常是可以用一个相同的钩子来实现的，比如作者年制中作者和年份之间的标点: -\begin{texlist} -\renewcommand*{\nameyeardelim}{\addcomma\space} -\end{texlist} - -\subsection{日期格式控制}\label{sec:date:fmt} -随着biblatex的更新，日期格式控制更趋完善。加上biblatex3.8a中biber解析出日期中月份和天数都不带引导的0，比如6月直接解析为6，而不像以前那样解析为06，所以需要特别的注意。因此对于新版本，有些日期比如online的发布日期，访问日期等，采用专门的格式edtf控制，而老版本则仍然使用原来定义的输出宏。比如: - -\begin{texlist} -\defversion{3.7}{date}{ - \DeclareFieldFormat{urldate}{##1} - \renewbibmacro*{urldate}{% - \addspace\printtext{[}\printurldate\printtext{]}}%能用高层命令+选项尽量用命令(比如这里的\printurldate)，而不用\blx@edtfdate这种更底层的命令 - - \newbibmacro*{newsdate}{%%新增加一个新闻日期 - \blx@edtfdate{}{}% - } - - \newbibmacro*{modifydate}{%新增加一个带括号的日期，用于表示电子资源的更新和修改日期，而公告日期则按日期格式 - \iffieldundef{year}{% - \iffieldundef{endyear}{\iffieldundef{eventyear}{}{\printtext{(}\printeventdate\printtext{)}}}% - {\printtext{(}\printenddate\printtext{)}}% - }{\iffieldequalstr{year}{}{%因为year存在，但为空 - }{\printtext{(}\blx@edtfdate{}{}\printtext{)}}% - }% - }% -} - -\defversion{3.4}{date}{ - \renewbibmacro*{urldate}{% - \addspace\printtext{[}\printfield{urlyear}% - \iffieldundef{urlmonth}{}{\bibrangedash\printfield{urlmonth}}% - \iffieldundef{urlday}{}{\bibrangedash\printfield{urlday}}\printtext{]}} - - \newbibmacro*{newsdate}{%%新增加一个新闻日期 - \iffieldundef{year}{}{\printfield{year}% - \iffieldundef{month}{}{\bibrangedash\printtext{\thefield{month}}% - \iffieldundef{day}{}{\bibrangedash\printfield{day}}}}% - } - - \newbibmacro*{modifydate}{%新增加一个带括号的日期，用于表示电子资源的更新和修改日期，而公告日期则按日期格式 - \iffieldequalstr{year}{}{%替换\iffieldundef{year}，因为year总是存在，但为空 - \iffieldundef{endyear}{% - \iffieldundef{eventyear}{}{\printtext{\mkbibparens{\printtext{\printfield{eventyear}}% - \iffieldundef{eventmonth}{}{\bibrangedash\thefield{eventmonth}}% - \iffieldundef{eventday}{}{\bibrangedash\printfield{eventday}}}}% - }% - }{% - \iffieldundef{endyear}{}{\printtext{\mkbibparens{\printtext{\printfield{endyear}}% - \iffieldundef{endmonth}{}{\bibrangedash\thefield{endmonth}}% - \iffieldundef{endday}{}{\bibrangedash\printfield{endday}}}}% - }% - }% - }% - {% - \iffieldundef{year}{}{\printtext{\mkbibparens{\printtext{\printfield{year}}% - \iffieldundef{month}{}{\bibrangedash\thefield{month}}% - \iffieldundef{day}{}{\bibrangedash\printfield{day}}}}% - }% - }% - }% -} - -\iftoggle{iftlfive}%%根据texlive/biblatex版本选择 - {\switchversion{3.4}{date}}% - {\iftoggle{iftlsix}% - {\switchversion{3.4}{date}}% - {\switchversion{3.7}{date}}% - } -\end{texlist} - -\subsubsection{文献表条目标签中的日期格式}\label{sec:dateinlabel} -主要用于authoryear样式，在authoryear样式中有一个mergedate选项，使用该选项可以进行更多的标签日期格式控制。其中主要是重定义了date+extradate(3.8版，以前的版本叫date+extrayear). - -其中有两点需要注意: - -1. printdateextra，printlabeldateextra，这样的命令在biblatex.sty中是找不到的，因为biblatex实际定义的如下的命令: -\begin{texlist} -{\protected\def\blx@imc@printlabeldate{\csuse{mkdaterange#1}{label}} - \protected\def\blx@imc@printlabeldateextra{\csuse{mkdaterange#1extra}{label}}} -\end{texlist} - -然后由如下命令，解析为printdateextra，printlabeldateextra: -\begin{texlist} -\blx@regimcs{\printlabeldate \printlabeltime \printlabeldateextra \stripzeros \forcezerosy \forcezerosmdt \mkyearzeros \mkmonthzeros \mkdayzeros \mktimezeros} -\end{texlist} - -biblatex很多命令都有类似的方式。 - -2. 日期的数据来源由DeclareLabeldate定义选择。 -日期的的具体格式，则由宏包选项控制。比如labeldate=ymd来控制。(3.5版以上，以前的是datelabel选项) - -\subsection{作者格式控制}\label{sec:name:fmt} -\zhongdian{【注意】：texlive2015中的biblatex版本是3.0，texlive2016中biblatex的版本是3.4，新版本对于名字域打印有了较大变化(即不同版本的biblatex对于DeclareNameFormat的输入参数处理有所不同，如例\ref{eg:name:variables}所示)，所以需做相应的修改，为此在biblatex中首先进行版本判断，然后根据版本不同分别进行设置。} - - \begin{codetex}{texlive2016中biblatex3.4版Name域格式输入参数的修改}{eg:name:variables} - for biblatex version 3.0 - #1 The last names. - #2 The last names, given as initials. - #3 The first names. - #4 The first names, given as initials. - #5 The name prefixes, - #6 The name prefixes, given as initials. - #7 The name affixes, - #8 The name affixes, given as initials. - for biblatex version 3.4 - \namepartfamily - \namepartfamilyi - \namepartgiven - \namepartgiveni - \namepartprefix - \namepartprefixi - \namepartsuffix - \namepartsuffixi - \end{codetex} - 样式文件中的处理见\ref{sec:name:fmt:out}节。 - -\subsubsection{作者信息输出与格式控制}\label{sec:name:fmt:out} -作者信息的输出最高一层是在驱动中: -\begin{texlist} -\usebibmacro{author/editor+others/translator+others} -\end{texlist} - -其中当存在作者时，由如下宏输出: -\begin{texlist} -\renewbibmacro*{author} -\end{texlist} - -其中作者列表又由如下命令输出: -\begin{texlist} -\printnames{author} -\end{texlist} - -printnames这种命令的输出格式通常由相应输出域的域格式控制，这里则是author域控制: -\begin{texlist} -\DeclareNameAlias{author}{sortname}%for author year style - -\DeclareNameAlias{author}{default}%for numeric style -\end{texlist} - -其中sortname，default域格式又是: -\begin{texlist} -\DeclareNameAlias{sortname}{family-given/given-family} - -\DeclareNameAlias{author}{default} -\DeclareNameAlias{default}{given-family} -\end{texlist} - -其中的关键是given-family和family-given两个域格式使用name:family-given和name:family-given宏进行输出。 -真实的作者姓名格式在这两个宏中，因此做一定的处理。注意其中的输入参数为： -{namepartfamily}，{namepartgiveni}，{namepartprefix}，{namepartsuffix}（使用名的首字母缩写）或 -{namepartfamily}，{namepartgiven}，{namepartprefix}，{namepartsuffix}（不使用缩写）。 - -\begin{texlist} - %biblatex3.3版后(比如texlive2016中的3.4版)的使用方式 - \renewbibmacro*{name:given-family}[4]{%利用family-given定义given-family - \ifuseprefix - {\usebibmacro{name:delim}{##3##1}% - \usebibmacro{name:hook}{##3##1}% - \ifdefvoid{##3}{}{% - \ifcapital - {\mkbibnameprefix{\MakeCapital{##3}}\isdot} - {\mkbibnameprefix{##3}\isdot}% - \ifprefchar{}{\bibnamedelimc}}% - \ifdefvoid{##2}{\mkbibnamefamily{\MakeCapital{##1}}}{\mkbibnamefamily{\MakeUppercase{##1}}}\isdot - \ifdefvoid{##2}{}{\revsdnamepunct\bibnamedelimd\mkbibnamegiven{\MakeUppercase{##2}}\isdot}%\MakeCapital - \ifdefvoid{##4}{}{\bibnamedelimd\mkbibnamesuffix{##4}\isdot}} - {\usebibmacro{name:delim}{##1}% - \usebibmacro{name:hook}{##1}% - \ifdefvoid{##2}{\mkbibnamefamily{\MakeCapital{##1}}}{\mkbibnamefamily{\MakeUppercase{##1}}}\isdot - % - \ifboolexpe{% - test {\ifdefvoid{##2}} - and - test {\ifdefvoid{##3}}} - {} - {\revsdnamepunct}% - \ifdefvoid{##2}{}{\bibnamedelimd\mkbibnamegiven{\MakeUppercase{##2}}\isdot}%\MakeCapital - \ifdefvoid{##3}{}{\bibnamedelimd\mkbibnameprefix{##3}\isdot} - \ifdefvoid{##4}{}{\bibnamedelimd\mkbibnamesuffix{##4}\isdot}} - } - \renewbibmacro*{name:family-given}[4]{% - \usebibmacro{name:given-family}{##1}{##2}{##3}{##4}} - - %biblatex3.3版前(比如texlive2015中的3.0版)的使用方式 - \renewbibmacro*{name:last-first}[4]{% - \ifuseprefix - {\usebibmacro{name:delim}{##3##1}% - \usebibmacro{name:hook}{##3##1}% - \ifblank{##3}{}{% - \ifcapital - {\mkbibnameprefix{\MakeCapital{##3}}\isdot} - {\mkbibnameprefix{##3}\isdot}% - \ifpunctmark{'}{}{\bibnamedelimc}}% - %\mkbibnamelast{#1}\isdot - \ifblank{##2}{\MakeCapital##1}{\mkbibnamelast{\MakeUppercase{##1}}}\isdot%\MakeUppercase %\mkbibnamelast{\MakeUppercase{#1}} %\MakeSentenceCase - %注意上一句\MakeCapital后面如果再跟一个{}包含#1，则没有效果，可能是包在里面少了一层展开 - %因为机构名通常包括在{}内，所以要多展开一次才行，所以这里去掉#1 外面的{} - %\mkbibnamelast{\MakeUppercase{#1}}\isdot - %\ifblank{#4}{}{\bibnamedelimd\mkbibnameaffix{#4}\isdot}%这句放到后面 - \ifblank{##2}{}{\revsdnamepunct\bibnamedelimd\mkbibnamefirst{\MakeUppercase{##2}}\isdot}% - \ifblank{##4}{}{\addcomma\addspace\bibnamedelimd\mkbibnameaffix{##4}\isdot}} - {\usebibmacro{name:delim}{##1}% - \usebibmacro{name:hook}{##1}% - %\mkbibnamelast{#1}\isdot %3.9.1 Generic Commands and Hooks，对姓重新处理，如下句: %\mkbibnamelast{\MakeUppercase{#1}} - \ifblank{##2}{\MakeCapital##1}{\mkbibnamelast{\MakeUppercase{##1}}}\isdot %大写，参考4.6.4 Miscellaneous Commands，\MakeUppercase %\MakeSentenceCase - %\mkbibnamelast{\MakeUppercase{#1}}\isdot - %\ifblank{#4}{}{\bibnamedelimd\mkbibnameaffix{#4}\isdot}%这句放到后面 - \ifblank{##2##3}{}{\revsdnamepunct}% - \ifblank{##2}{}{\bibnamedelimd\mkbibnamefirst{\MakeUppercase{##2}}\isdot}% - \ifblank{##3}{}{\bibnamedelimd\mkbibnameprefix{##3}\isdot}% - \addcomma\addspace% - \ifblank{##4}{}{\addcomma\addspace\bibnamedelimd\mkbibnameaffix{##4}\isdot}% - } - } - - \renewbibmacro*{name:first-last}[4]{% - \usebibmacro{name:last-first}{##1}{##2}{##3}{##4}} -\end{texlist} - - - - -\subsection{样式文件设计途径} - biblatex的核心-参考文献样式文件的设计，更详细内容见 - \href{https://github.com/hushidong/biblatex-solution-to-latex-bibliography}{LaTeX 文档中文参考文献的 biblatex 解决方案}。 - \begin{enumerate} - \item driver的作用:条目驱动，修改一些顺序，略去一些输出和标点 - \item micro的作用:输出宏，修改需要的输出内容 - \item format的作用:域打印格式，修改一些斜体，强调样式等。 - \item command的作用:一些设置和命令 - \item biblatex.sty/def和各bbx/cbx文件中的代码 - \end{enumerate} - -\subsubsection{文献表条目内容组织的原理以及问题查找的方法} -biblatex是利用tex语句控制文献内容组织，因此我们可以坚定一点就是，对于文献内容组织一定不是神秘的，是可以分析清楚的，当出现问题的时候，通过一步步的分析是能解决好的。 - -如前所述，根据宏包设置，使用biber解析完参考文献信息后，就需要利用样式中的各种定义来输出文献表。我们从某一条参考文献来看问题。某一类型的参考文献输出由该类型的driver控制，driver中控制各种bibmacro来组织内容输出，bibmacro利用各种fieldformat，command来控制域的格式和标点，当出现一些特殊的问题时，我们可以顺着这样的思路来查找。 - -下面我们举例来说明本样式的作者年制中，当作者缺省时，利用title判断中英文出错的问题。这个问题本质上由于前面说过的，当作者缺省时，把title作为标签后，会把title域清除，因此再利用title域信息判断中英文，自然无法正常工作。我们来看看这是怎么一个过程: - -这是一个作者缺省的book条目，在gb7714-2015ay样式不使用佚名方式的情况下报错，主要是testCJKfirst函数报错。这个函数主要用在作者，出版项等这些信息输出时的中英文判断。因为作者缺省，因此作者输出时就没有判断，而出错只能是在出版项中。我们把book的driver中macro输出一项一项注释掉并测试发现，当作者输出相关的macro存在时存在错误，注释掉则没有问题。于是深入来分析: - -在book类的driver简化为如下三项输出: -\begin{texlist} -\DeclareBibliographyDriver{book}{% - \usebibmacro{bibindex}% - \usebibmacro{begentry}% - \usebibmacro{author/editor+others/translator+others}% - \setunit{\labelnamepunct}\newblock - \usebibmacro{maintitle+title}% - \newunit - \usebibmacro{publisher+location+date}% - \newunit\newblock - \usebibmacro{finentry}} -\end{texlist} - -其中usebibmacro\{author/editor+others/translator+others\}导致出错，该macro的思路是当存在author时输出author，没有时判断是否存在editor，存在则输出，不存在则判断是否存在translator，并进一步判断输出: -\begin{texlist} -\newbibmacro*{author/editor+others/translator+others}{% - \ifboolexpr{ - test \ifuseauthor - and - not test {\ifnameundef{author}} - } - {\usebibmacro{author}} - {\ifboolexpr{ - test \ifuseeditor - and - not test {\ifnameundef{editor}} - } - {\usebibmacro{editor+others}} - {\usebibmacro{translator+others}}}} -\end{texlist} - -显然这个例子中不存在author和editor，因此宏转到macro\{translator+others\}，我们来看这个宏: -\begin{texlist} -\newbibmacro*{translator+others}{% - \ifboolexpr{ - test \ifusetranslator - and - not test {\ifnameundef{translator}} - } - {\printnames{translator}% - \setunit{\printdelim{translatortypedelim}}% - \usebibmacro{translator+othersstrg}% - \clearname{translator}} - {}} -\end{texlist} - -这个宏来自biblatex.def，显然这个宏表明当translator不存在则不做任何事情，这种情况下是不会出错的，于是我们再找，发现这个宏在authoryear.bbx中重定义了。 -\begin{texlist} -\renewbibmacro*{translator+others}{% - \usebibmacro{bbx:translator}{translator+othersstrg}} - -\newbibmacro*{bbx:translator}[1]{% - \ifboolexpr{ - test \ifusetranslator - and - not test {\ifnameundef{translator}} - } - {...code for existed translator...}% - {\global\undef\bbx@lasthash - \usebibmacro{labeltitle}% - \setunit*{\printdelim{nonameyeardelim}}}% - \usebibmacro{date+extradate}} -\end{texlist} - -显然当translator不存在时，使用了labeltitle宏，再来看这个宏: -\begin{texlist} -\newbibmacro*{labeltitle}{% - \iffieldundef{label} - {\iffieldundef{shorttitle} - {\printfield{title}% - \clearfield{title}} - {\printfield[title]{shorttitle}}} - {\printfield{label}}} -\end{texlist} -从中可以看到，该宏把title域作为标签进行输出，并在输出后清除了title域，自然，在完成了整个author/editor+others/translator+others宏后，title域就不存在了，因此在后面的publisher+location+date宏中使用title域来进行中英文判断是必然会出错的，找到了问题所在，那么就有相应的方法，比如在动态数据修改时，把title信息存储到userd域中，然后publisher+location+date宏利用该域的信息进行判断这样就不会出现问题了。 - -\subsection{宏包选项增加} - -biblatex的宏包选项增加 - \begin{enumerate} - \item 在gb7714-2015.bbx文件中有四种常见的判断方式包括: - 版本的判断， - 宏包选项的判断， - 宏包选项控制的切换标记的判断， - 一般的域的是否定义或与字符串比较是否相同的判断。 - - 第一种判断，是直接根据已有的信息比如\verb|\abx@version|进行处理，该出的处理结果是直接展开的，可以用于后面的任意定义。 - - 第二种判断，是根据给出的宏包选项值或者不给出选项进行处理，例如定义的宏包选项gbalign ，这一选项是string 类型。在选项的执行代码中直接给出每一个选项值对应要执行的命令。比如： - \begin{texlist} - \DeclareBibliographyOption[string]{gbalign}[right]{% - \ifstrequal{##1}{left}{\setalignleft}{} - \ifstrequal{##1}{gb7714-2015}{\setaligngbstyle}{} - } - \end{texlist} - 这种情况下，特别要注意DeclareBibliographyOption 选项定义命令中给出的默认值right是在加载该选项但不给出值时的默认值，而不是将选项设置为该默认值。因此当加载时不给出gbalign选项时，不执行任何的语句，即不执行setalignleft，也不执行setaligngbstyle(因为不使用这两个命令的情况下项标签是右对齐的，这样也就是gbalign选项默认是右对齐的，只有设置宏包选项为left或gb7714-2015时才会因为setalignleft和setaligngbstyle命令二改变)。 - 如果给出选项gbalign，相当于gbalign=默认值，如果给出选项gbalign=指定值，那么值就是指定值，然后并执行DeclareBibliographyOption 的定义代码，根据值进行处理。 - - 第三种判断，根据宏包选项控制对切换标记进行设置，然后再代码中应用切换标记判断。比如gbpub 选项，这一选项类似于standard.bbx中定义的url 等选项。 - \begin{texlist} - \newtoggle{bbx:gbpub} - \DeclareBibliographyOption[boolean]{gbpub}[true]{% - %\settoggle{bbx:gbpub}{#1} %或采用下面这一句 - \ifstrequal{##1}{false}{\togglefalse{bbx:gbpub}}{\toggletrue{bbx:gbpub}}} - \end{texlist} - 默认可以利用切换标记bbx:gbpub进行任何的定义。但如果展开的层次是与这里定义的宏包选项同一层次的，那么切换标记会根据默认值是false 而展开。如果是下一层的展开（就是不需要在加载时展开的），那么会根据展开时切换标记bbx:gbpub的值进行展开。 - - 注意到在上述这一定义后面，使用了选项默认执行命令: - \begin{texlist} - \ExecuteBibliographyOptions{gbpub} - \end{texlist} - 这是宏包选项定义中的代码会立刻被执行，即bbx:gbpub的值设置为true。ExecuteBibliographyOptions 命令是用来执行选项的，如果不给出这一命令，且宏包加载选择中没有给出选项设置，那么toggle只有新建toggle 时的默认定义。还要注意这里的切换标记设置是立刻进行的，如果这里的定义不是设置切换标记，而是直接调用命令，比如上面的gbalign的情况，那么就需要该被调用命令是有定义的，即定义至少与宏包选项定义在同一展开层次，甚至先于宏包选项定义。 - - 还需要注意，如果给出了命令 - \begin{texlist} - \ExecuteBibliographyOptions{gbpub}%等价于下一条命令 - \ExecuteBibliographyOptions{gbpub=true} - \ExecuteBibliographyOptions{gbpub=false} - \end{texlist} - 等价于在宏包加载时给出选项。但是宏包加载选项设置可以覆盖这个命令的设置。 - - 如果在宏包加载时给出选项gbpub=false，那么bbx:gbpub的值设置为false。 - 如果在宏包加载时给出选项gbpub，gbpub=true，那么bbx:gbpub的值设置为true。 - - 第四种判断，利用iffieldundef和iffieldequalstr进行判断即可。 - - \item 总结起来，宏包选项的问题需要注意宏包选项的展开顺序。宏包选项的定义如果不使用ExecuteBibliographyOptions命令或者不在加载时设置，那么定义的代码是不执行的。因此如果其他代码中需要使用该宏包选项定义代码中的信息是无法正确获取的。而当使用ExecuteBibliographyOptions命令或者加载选项时，那么宏包选项代码会立即展开，其中需要使用的宏则需要有定义，即先于或与宏包选项定义处于同一展开层。 - - \begin{texlist} - %\newtoggle{bbx:gbpub} - %\DeclareBibliographyOption[boolean]{gbpub}[true]{% - % \settoggle{bbx:gbpub}{#1}} - %这种机制的标识判断，能用于usemacro使用，域格式定义中，但无法用来判断后定义macro - %定义宏和使用宏是两个不同的展开层级，而可以在定义macro中进行判断 - %\ExecuteBibliographyOptions{gbpub} - %但是使用这句默认设置可以用来定义macro - - %\DeclareBibliographyOption{gbpub}[true]{%应使用这种直接的机制 - %\ifstrequal{#1}{false}{\pubaddmacronewdefine}{\pubaddmacroredefine}} - - %特别注意DeclareBibliographyOption，而给出的默认值是在加载时没有选项没有给出值时的默认值。 - %当加载时不给出gbpub选项时，不执行ifstrequal判断语句，无任何加载。 - %如果给出选项gb，或者gb=true，那么ifstrequal判断仍然是假，执行的默认的加载\pubaddmacroredefine - %如果给出选项false，那么ifstrequal判断是真，执行的就是非默认的加载\pubaddmacronewdefine - %\ExecuteBibliographyOptions{gbpub}%这句报错是因为\pubaddmacroredefine没有定义，如果把定义放到前面那么应该是可以的。 - - %还是采用另一种方式可以较好的进行默认选项的处理 - \newtoggle{bbx:gbpub} - \DeclareBibliographyOption[boolean]{gbpub}[true]{% - %\settoggle{bbx:gbpub}{#1} %或采用下面这一句 - \ifstrequal{#1}{false}{\togglefalse{bbx:gbpub}}{\toggletrue{bbx:gbpub}}} - \ExecuteBibliographyOptions{gbpub} - - \end{texlist} - - \end{enumerate} - - -\subsection{文献表环境和打印输出} - biblatex宏包的参考文献表的打印 - \begin{enumerate} - \item 根据biblatex.sty文件中的\verb|\blx@bibliography|命令可以知道，定义的参考文献表的环境的开始代码在命令中\verb|\blx@bibliography| 中，结束代码在\verb|\blx@endbibliography|中，循环项代码在\verb|\blx@bibitem| 中的\verb|blx@item@\blx@theenv}|命令中。参考文献循环打印依靠\verb|\blx@listloop| 命令实现。 - \item 从\verb|\blx@listloop|可以知道，各条参考文献表的指引信息是混合在一起的并且以|字符为分隔。将混合的参考文献指引信息解析成单独的指引信息，并交给\verb|\blx@bibitem|命令处理。 - \item \verb|\blx@bibitem|首先开始一个编组，然后根据单独一条参考文献的指引信息，获取数据，执行判断，利用参考文献表环境定义的循环项代码对参考文献内容设置段落格式，最后结束编组。在定义gbalign=gb7714-2015 样式的段落格式时，采用了parshape 或者hangindent命令来实现，所以其中增加了一个par 命令以使其生效。 - \end{enumerate} - - -\subsection{biblatex版本以及样式的兼容性}\label{sec:blx:compatibility} -样式首先根据biblatex版本信息进行版本判断，然后做针对性的兼容处理。 -biblatex在texlive中的版本对应关系是: -texlive2015对应biblatex3.0; -texlive2016对应biblatex3.4，从3.2版开始修改了姓名机制(如\ref{sec:name:fmt}节所述); -texlive2017对应biblatex3.7; -2017年底又出了biblatex3.8a到3.10版。 - - \begin{enumerate} - \item biblatex版本判断 - - 原来是使用一个简单的字符流处理来解析版本信息，但容易出现问题。于是换成利用xstring宏包的命令来提取版本中的数字进行判断: - \begin{texlist} - %版本判断 - \providetoggle{iftexlivesix}%用于处理biblatex3.3开始改变的新的姓名机制 - \providetoggle{iftexliveseven}%用于处理biblatex3.7的兼容性 - \providetoggle{iftexliveeight}%用于处理biblatex3.8a的兼容性 - %\def\numparserta#1.#2a\relax{#1}%注意relax的重要性 - %\def\numparsertb#1.#2a\relax{#2} - %\def\numinteger{\expandafter\numparserta\abx@version\relax} - %\def\numdigital{\expandafter\numparsertb\abx@version\relax} - \StrChar{\abx@version}{3}[\numdigital] - %根据biblatex更新历史，当版本大于3.2开始，就用设置\toggletrue{iftexlivesix} - \ifnumcomp{\numdigital}{>}{2}{\toggletrue{iftexlivesix}}{\togglefalse{iftexlivesix}} - \ifnumcomp{\numdigital}{>}{6}{\toggletrue{iftexliveseven}}{\togglefalse{iftexliveseven}} - \ifnumcomp{\numdigital}{>}{7}{\toggletrue{iftexliveeight}}{\togglefalse{iftexliveseight}} - \end{texlist} - - - \item biblatex版本的一些兼容性处理 - - 宏包选项: - \begin{texlist} - firstinits=true,%for texlive2014,2015;biblatex <=3.2 - giveninits=true,%for texlive2016,2017;biblatex >=3.3 - labeldate=true,%for texlive2014,2015,2016,2017;biblatex <3.8 - labeldateparts=true,%for biblatex >=3.8a - \end{texlist} - - 命令: - \begin{texlist} - \printdateextralabel,%for texlive2014,2015,2016;biblatex <=3.4 - \printlabeldateextra,%for texlive2017;biblatex >=3.7 - \DeclareSortingScheme %for texlive2014,2015,2016,2017;biblatex <3.8 - \DeclareSortingTemplate %for biblatex >=3.8a - \end{texlist} - - \item 版本与兼容性的最终处理方法 - - 经过最终设计，下面给出的另一版本兼容性处理方式取代前面给出的处理方式，便于以后的扩展。这种方式自然兼容最新的版本，但老的版本的代码处理必须要到位，即因为biblatex版本升级增加了新的老版本时，对应该老版本的选择必须要实现，否则可能漏掉这些版本的处理。 - \begin{texlist} - %版本判断，当版本继续更新时，增加一个新的toggle用以处理新的旧版，最新版本永远用iftlatest - \providetoggle{iftlfive}%用于处理biblatex3.2之前的版本 - \providetoggle{iftlsix}%用于处理biblatex3.3开始改变的新的姓名机制后版本 - \providetoggle{iftlseven}%用于处理biblatex3.7的兼容性 - \providetoggle{iftleight}%用于处理biblatex3.8到3.9的兼容性 - \providetoggle{iftlatest}%用于最新版biblatex，目前是biblatex3.10，20180117 - \StrBefore{\abx@version}{.}[\numinteger]%以点区分整数和小数 - \StrBehind{\abx@version}{.}[\numdigital]%小数部分可能带字母所以需将其去掉，见下一行代码 - \IfInteger{\numdigital}{}{\StrGobbleRight{\numdigital}{1}[\numdigital]} - \togglefalse{iftlfive} - \togglefalse{iftlsix} - \togglefalse{iftlseven} - \togglefalse{iftleight} - \toggletrue{iftlatest} - \ifnumcomp{\numinteger}{=}{3}{ - \ifnumcomp{\numdigital}{<}{10}{\ifnumcomp{\numdigital}{>}{7}{\toggletrue{iftleight}\togglefalse{iftlatest}}{}}{}%>3.8 版本用iftleight=true表示 - \ifnumcomp{\numdigital}{=}{7}{\toggletrue{iftlseven}\togglefalse{iftlatest}}{}%3.7 版本用iftlseven=true表示 - \ifnumcomp{\numdigital}{<}{7}{\ifnumcomp{\numdigital}{>}{2}{\toggletrue{iftlsix}\togglefalse{iftlatest}}{}}{}%3.3-3.6 版本用iftlsix=true表示 - \ifnumcomp{\numdigital}{<}{3}{\toggletrue{iftlfive}\togglefalse{iftlatest}}{}%3.0-3.2 版本用iftlfive=true表示 - }{\ifnumcomp{\numinteger}{>}{3}{ - \blx@warning@noline{% - biblatex version is >= 4.x.\MessageBreak - if errors raised，Please contact biblatex-gb7714-2015 pkg author.}% - }{ \toggletrue{iftlfive}\togglefalse{iftlatest}%2.x版本统一用iftlfive=true表示 - \blx@warning@noline{% - biblatex version is <= 2.x.\MessageBreak - if errors raised，Please contact biblatex-gb7714-2015 pkg author.}% - }} - \newcommand\defversion[2]{\csdef{codeversion#1#2}}%定义不同版本的命令 - \newcommand\switchversion[2]{\csuse{codeversion#1#2}}%使用不同版本的命令 - -\defversion{3.0}{opt}{ - %biblatex3.3版前(比如texlive2015中的3.0版)的使用方式 - - %增加姓名大小写格式处理选项 - \DeclareBibliographyOption{gbnamefmt}[uppercase]{% - %\ifstrequal{##1}{gbuppercase}{}{}% - \ifstrequal{##1}{lowercase}{\execgblowercase}{}% - \ifstrequal{##1}{none}{\execnamedefault}{} - \ifstrequal{##1}{pinyin}{\execnamepinyin}{} - } - %\ExecuteBibliographyOptions{gbnamefmt} - - %增加标签对齐选项，right是默认的右对齐，left是左对齐，gb7714-2015无效，仍然为右对齐模式，因为舍弃了list类环境后出错。 - \DeclareBibliographyOption{gbalign}[right]{%texlive2015中的3.0版中的DeclareBibliographyOption选项没有类型说明 - \ifstrequal{##1}{right}{}{} - \ifstrequal{##1}{left}{\setalignleft}{} - \ifstrequal{##1}{gb7714-2015}{}{} - } - - %增加一个出版项自动处理控制选项，当true时使用出版者不详等信息补充缺失的出版信息。 - \newtoggle{bbx:gbpub} - \DeclareBibliographyOption{gbpub}[true]{% - %\settoggle{bbx:gbpub}{#1} %或采用下面这一句 - \ifstrequal{##1}{false}{\togglefalse{bbx:gbpub}}{\toggletrue{bbx:gbpub}}} - \ExecuteBibliographyOptions{gbpub} - - %增加一个处理佚名或noauthor的控制选项 - %因为在顺序编码制中，不需要使用，这里也增加，为了与作者年制的兼容性考虑。 - \DeclareBibliographyOption{gbnoauthor}[true]{}% - - \ExecuteBibliographyOptions{ - sorting=none, - useprefix=true, %名字的信息包括前缀 - firstinits=true, %名字有缩写，参考3.1.2.3 Internal - %giveninits=true, - date = year, %日期仅写到年 - maxnames = 3 , %设置名字最大数量 - minnames = 3 %设置缩减后的名字最小数量 - %uniquename = init - } -} - -\defversion{3.4}{opt}{ - % Alter settings that carry through from biblatex - %biblatex3.3版后(比如texlive2016中的3.4版)的使用方式 - - %增加姓名大小写格式处理选项 - \DeclareBibliographyOption[string]{gbnamefmt}[uppercase]{% - %\ifstrequal{##1}{gbuppercase}{}{}% - \ifstrequal{##1}{lowercase}{\execgblowercase}{}% - \ifstrequal{##1}{none}{\execnamedefault}{} - \ifstrequal{##1}{pinyin}{\execnamepinyin}{} - } - %\ExecuteBibliographyOptions{gbnamefmt} - - %增加标签对齐选项，right是默认的右对齐，left是左对齐，gb7714-2015是项对齐方式 - \DeclareBibliographyOption[string]{gbalign}[right]{% - \ifstrequal{##1}{left}{\setalignleft}{} - \ifstrequal{##1}{gb7714-2015}{\setaligngbstyle}{} - } - - %增加一个出版项自动处理控制选项，当true时使用出版者不详等信息补充缺失的出版信息。 - \newtoggle{bbx:gbpub} - \DeclareBibliographyOption[boolean]{gbpub}[true]{% - %\settoggle{bbx:gbpub}{#1} %或采用下面这一句 - \ifstrequal{##1}{false}{\togglefalse{bbx:gbpub}}{\toggletrue{bbx:gbpub}}} - \ExecuteBibliographyOptions{gbpub} - - %增加一个处理佚名或noauthor的控制选项 - %因为在顺序编码制中，不需要使用，这里也增加，为了与作者年制的兼容性考虑。 - \DeclareBibliographyOption[boolean]{gbnoauthor}[true]{}% - - \ExecuteBibliographyOptions{ - sorting=none, - useprefix=true, %名字的信息包括前缀 - %firstinits=true, %名字有缩写，参考3.1.2.3 Internal - giveninits=true, - date = year, %日期仅写到年 - maxnames = 3 , %设置名字最大数量 - minnames = 3 %设置缩减后的名字最小数量 - %uniquename = init - } -} - -\defversion{3.7}{opt}{ - %biblatex3.7版后(比如texlive2017中的3.7版)的使用方式 - - %增加姓名大小写格式处理选项 - \DeclareBibliographyOption[string]{gbnamefmt}[uppercase]{% - %\ifstrequal{##1}{gbuppercase}{}{}% - \ifstrequal{##1}{lowercase}{\execgblowercase}{}% - \ifstrequal{##1}{none}{\execnamedefault}{} - \ifstrequal{##1}{pinyin}{\execnamepinyin}{} - } - %\ExecuteBibliographyOptions{gbnamefmt} - - %增加标签对齐选项，right是默认的右对齐，left是左对齐，gb7714-2015是项对齐方式 - \DeclareBibliographyOption[string]{gbalign}[right]{% - \ifstrequal{##1}{left}{\setalignleft}{} - \ifstrequal{##1}{gb7714-2015}{\setaligngbstyle}{} - } - - %增加一个出版项自动处理控制选项，当true时使用出版者不详等信息补充缺失的出版信息。 - \newtoggle{bbx:gbpub} - \DeclareBibliographyOption[boolean]{gbpub}[true]{% - %\settoggle{bbx:gbpub}{#1} %或采用下面这一句 - \ifstrequal{##1}{false}{\togglefalse{bbx:gbpub}}{\toggletrue{bbx:gbpub}}} - \ExecuteBibliographyOptions{gbpub} - - %增加一个处理佚名或noauthor的控制选项 - %因为在顺序编码制中，不需要使用，这里也增加，为了与作者年制的兼容性考虑。 - \DeclareBibliographyOption[boolean]{gbnoauthor}[true]{}% - - \ExecuteBibliographyOptions{ - sorting=none, - useprefix=true, %名字的信息包括前缀 - %firstinits=true, %名字有缩写，参考3.1.2.3 Internal - giveninits=true, - date = year, %日期仅写到年 - urldate =edtf, %iso8601 - eventdate =edtf, - maxnames = 3 , %设置名字最大数量 - minnames = 3 %设置缩减后的名字最小数量 - %uniquename = init - } -} - -\defversion{3.10}{opt}{ - %biblatex3.10版后的使用方式 - - %增加姓名大小写格式处理选项 - \DeclareBibliographyOption[string]{gbnamefmt}[uppercase]{% - %\ifstrequal{##1}{gbuppercase}{}{}% - \ifstrequal{##1}{lowercase}{\execgblowercase}{}% - \ifstrequal{##1}{none}{\execnamedefault}{} - \ifstrequal{##1}{pinyin}{\execnamepinyin}{} - } - %\ExecuteBibliographyOptions{gbnamefmt} - - %增加标签对齐选项，right是默认的右对齐，left是左对齐，gb7714-2015是项对齐方式 - \DeclareBibliographyOption[string]{gbalign}[right]{% - \ifstrequal{##1}{left}{\setalignleft}{} - \ifstrequal{##1}{gb7714-2015}{\setaligngbstyle}{} - } - - %增加一个出版项自动处理控制选项，当true时使用出版者不详等信息补充缺失的出版信息。 - \newtoggle{bbx:gbpub} - \DeclareBibliographyOption[boolean]{gbpub}[true]{% - %\settoggle{bbx:gbpub}{#1} %或采用下面这一句 - \ifstrequal{##1}{false}{\togglefalse{bbx:gbpub}}{\toggletrue{bbx:gbpub}}} - \ExecuteBibliographyOptions{gbpub} - - %增加一个处理佚名或noauthor的控制选项 - %因为在顺序编码制中，不需要使用，这里也增加，为了与作者年制的兼容性考虑。 - \DeclareBibliographyOption[boolean]{gbnoauthor}[true]{}% - - \ExecuteBibliographyOptions{ - sorting=none, - useprefix=true, %名字的信息包括前缀 - %firstinits=true, %名字有缩写，参考3.1.2.3 Internal - giveninits=true, - date = year, %日期仅写到年 - urldate =iso, %iso8601，edtf - eventdate =iso, - maxnames = 3 , %设置名字最大数量 - minnames = 3 %设置缩减后的名字最小数量 - %uniquename = init - } -} - -\iftoggle{iftlfive}{\switchversion{3.0}{opt}}{}%biblatex<=3.2 -\iftoggle{iftlsix}{\switchversion{3.4}{opt}}{}%3.3<=biblatex<=3.6 -\iftoggle{iftlseven}{\switchversion{3.7}{opt}}{}%biblatex=3.7 -\iftoggle{iftleight}{\switchversion{3.7}{opt}}{}%3.8<=biblatex<=3.9 -\iftoggle{iftlatest}{\switchversion{3.10}{opt}}{}%biblatex最新3.10 - \end{texlist} - - \end{enumerate} - - - -\subsection{脚注或旁注文献} - 标注命令自定义，在脚注中引用文献，或者把引文放在脚注中或者旁注中 - \begin{enumerate} - \item 标注命令定义可以使用DeclareCiteCommand命令，设置上标，包围符号，标注前后内容等。针对GB/T7714-2015中关于引用标注的特殊要求，增加了一些方便实现要求的命令比如pagescite、yearpagescite等。 - \item 在footnote的脚注文本中使用footcite命令 - \item 在正文中使用footfullcite命令，见4.11.6 Mixing Programming Interfaces - \end{enumerate} - -\subsection{参考文献标题} - 参考文献标题修改并将标题加入目录中 - \begin{enumerate} - \item 利用defbibheading\{bibliography\}[\textbackslash bibname]\{\}重定义标题 - \item 使用bibliography外的其它标题样式比如bibintoc等 - \item 利用titlesec等宏包进行修改标题样式，利用其局部性可以调整生成多种样式。注意: 利用titlesec后，直接在defbibheading\{bibliography\}[\textbackslash bibname]\{\} 中放置居中命令centering无效。 - \end{enumerate} - - -\subsection{其它需要说明的问题} -下面的问题想到哪写到哪，没有特别的顺序: - -\begin{enumerate} - \item 因为采用xelatex编译，所以样式文件直接采用UTF-8编码，没有考虑GBK 编码。 - - \item \zhongdian{【Most Important】【注意】：当在顺序编码和作者年制的切换，或者biblatex版本切换时，如果使用出错，可先清理一下辅助文件，清理完后，重新编译即可。} - - \item 需要注意：当bibtex键中含有中文的时候，texlive2015中的biblatex3.0版的对参考文献条目的超链接会出现问题，而texlive2016中的biblatex3.4或以后的版本则没有问题。 - - \item GB/T 7714-2015中的作者年制要求参考文献按文种集合，且中文在前英文在后。主要通过定义DeclareSortingScheme\{nyt\}(biblatex3.7 以前版本) 或DeclareSortingTemplate\{nyt\}(biblatex3.8以后版本)，利用userb域排序实现。\bc{默认情况下，样式能基本正确的区分中文和英文文献并排序。当如果出现错误的情况，用户可以手动修改bib源文件，将userb 域设置成合适的字符串，用于排序，详见\ref{sec:usage:bbx}节的说明}。 - -%上一段2016-1114更新，下面这段是旧的说法， -%通过定义DeclareSortingScheme\{nyt\}，设置方向为direction=descending，可以实现中文在前英文在后但两个文种的文献各自也是降序的。还有一种变通的方法是，在录入bib文件时，在userb域填入用于排序的信息，比如需要排前面中文文献填cn，排后面的英文文献用en。这样因为修改后的排序格式nyt会在author域前先用userb进行排序，自然会把中文文献放在前面。 - - \item 关于出版地和出版者同时缺省的情况，GB/T 7714-2015中没有给出明确的说明，但英文给出了一个例子(见GB/T 7714-2015 附录A.3)而中文没有，英文的样式是[S.l. : s.n.]，这种形式本样式文件中没有给出，而直接用两者分开的形式，[S.l.] : [s.n.]，事实上这里作者认为没有必要把s.l.和s.n. 合起来，不仅与缺省两者之一的情况不统一，样式处理起来也增加不必要的麻烦。 - - \item 目前符合GB/T7714-2005或GB/T7714-2015参考文献著录规则的biblatex 样式有好几个实现，除本样式外，还有李志奇(icetea)\footnote{\url{http://bbs.ctex.org/forum.php?mod=viewthread&tid=74474}} 和沈周(szsdk)\footnote{\url{http://bbs.ctex.org/forum.php?mod=viewthread&tid=152561&extra=page\%3D1}} 分别提供的样式文件，效果是类似的。此外，Casper Ti. Vector提供的biblatex 样式caspervector也是不错的中文参考文献样式 - \footnote{\url{https://gitlab.com/CasperVector/biblatex-caspervector}}。 感谢各位作者的分享! - - \item 本文档根据GB/T 7714-2015提供的参考文献表著录格式示例做了测试和验证，详见第\ref{sec:eg:gb77142015}节。测试系统环境为: - \begin{itemize} - \item windows7x86+texlive 2014，采用xelatex编译; - - \item windows7x64+texlive 2015，采用xelatex编译; - - \item 虚拟机xp+texlive 2016，采用xelatex编译; - - \item Deepin linux-x64v15.3+texlive 2016，采用xelatex编译。 - - \item windows7x64+texlive 2017，采用xelatex编译; - \end{itemize} - -\end{enumerate} - - \section{总结与致谢} -通过对 GB/T 7714-2015 标准的分析，对 biblatex 的学习和理解，在 biblatex 标准标准样式基础上，设计完成了符合 GB/T 7714-2015 标准的biblatex参考文献样式。从测试实践看，基本能够满足使用要求，用户可以放心使用。遇到问题时，除了可以查看 +通过对 GB/T 7714-2015 标准的分析，对 biblatex 的学习和理解，在 biblatex 标准样式基础上，设计完成了符合 GB/T 7714-2015 标准的biblatex参考文献样式。从测试实践看，基本能够满足使用要求，用户可以放心使用。遇到问题时，除了可以查看 本文档说明外，也可以看样式文件代码，其中给出了详细注释，如果遇到无法解决的问题，请邮件联系作者。 %读者若查看样式文件内容可以看到作者对各目标要求所做的修改及，读者也可以根据自己的需求进行修改，作者设计样式文件的思路以及在设计过程中用到的一些biblatex宏包功能说明，详见第\ref{sec:biblatex:mech}节和LaTeX文档中文参考文献的biblatex解决方案的第2.7节。 -最后要感谢如下各位师长和朋友，正是在各位的帮助建议下，本样式不断升级逐渐完善。包括: moewew(biblatex 现在的维护者之一，给了不少有益的建议)、 李志奇(基于biblatex的符合GBT7714-2005的中文文献生成工具作者，笔者以前使用该工具，其代码对于设计本样式很有启发)、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、蔡伟 等等。当然还有更多这里没有列全的朋友们的热心帮忙，在此一并表示感谢! +最后要感谢如下各位师长和朋友，正是在各位的帮助建议下，本样式不断升级逐渐完善。包括: 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，提供了热心帮助，限于篇幅这里不再一一列举，在此一并表示感谢! \section{存在的问题和下一步工作} @@ -2377,17 +1692,23 @@ texlive2017对应biblatex3.7; %\item backref的格式也可以修改一下。 %没有要求处理，但修改了，2016-1114，修改英文本地化字符串为引用页面。 - \item shorthand的问题没有遇到，其应用可能需要进一步理解。 + %\item shorthand的问题没有遇到，其应用可能需要进一步理解。，主要是获取参考文献的部分信息进行统计和打印。该问题已经解决，参见biblatex-solution-to-latex-bibliography(20180525)。 \item 当专著同时存在作者和编者的时候，GB/T 7714-2015没有明确的规定，所以目前样式文件中以biblatex标准样式的方式处理，这种处理因为与本地化相关，直接应用可能不好看的，也许需要修改。 - \item 因为GB/T 7714-2015中给出的了一些著录格式，如果把这些著录格式作为一个严格标准，那么条目中只能出现其中规定的域，而往往在bib文件中可能存在一些另外的信息比如chapter等，而且从标准样式修改的驱动中也仍然带有这些域的处理，如果为了标准化规范化考虑，可以去掉国标中没有提到的域的信息，可能使得内容更为标准，这可以通过修改增加数据模型，数据源动态修改，驱动修改(驱动中目前存在较多的似乎用不到的域，而且意义不是非常明确，这个等到biblatex说明文档中文版完成后再结合它全面的进行梳理)三条路子做到，需要的话，可以在下一步实现(2017-0226)。 + \item 在各类文献的著录格式中，GB/T 7714-2015 对于出版项给出的就是出版地和出版者，但习惯上不同的类型还是存在差异的，比如专利文献出版项还应该再明确，比如在线资源常用organization表示而无出版地。这些有待进一步明确。 + + \item 当作者不明时，GB/T 7714-2015 给出的说法是用佚名和其它语言相应的词代替。英文给了一个例子是Anon，似乎是anonymity的缩写。这也有待进一步明确。v1.0l版后将之前用的noauthor换成Anon。 + + %\item 因为GB/T 7714-2015中给出的了一些著录格式，如果把这些著录格式作为一个严格标准，那么条目中只能出现其中规定的域，而往往在bib文件中可能存在一些另外的信息比如chapter等，而且从标准样式修改的驱动中也仍然带有这些域的处理，如果为了标准化规范化考虑，可以去掉国标中没有提到的域的信息，可能使得内容更为标准，这可以通过修改增加数据模型，数据源动态修改，驱动修改(驱动中目前存在较多的似乎用不到的域，而且意义不是非常明确，这个等到biblatex说明文档中文版完成后再结合它全面的进行梳理)三条路子做到，需要的话，可以在下一步实现(2017-0226)。添加了gbstrict选项后，该问题基本已经解决(20180525)。 \end{enumerate} \subsection{下一步工作} \begin{enumerate} - \item 到1.0i版为止，除了基本功能需求外，进一步完善了: GB7714风格的文献表标签项对齐设计，编组内信息的中英文判断，特殊或老的bibtex 条目类型支持，改善空格设计以满足断行要求，支持了宏包选项(url等)应用，增加了宏包选项用于GB7714风格实现控制(gbpub 等)，重新设计了版本兼容方式，以后的版本中将更容易兼容biblatex的升级。剩下的问题可能是一些文献具有特殊信息或者特殊情况时带来的适应性问题，这需要经过大量的测试来发现问题。各位朋友如果发现什么问题，请邮件联系，作者会非常感谢! + \item 到目前，无论是基本功能还是附加功能，biblatex-gb7714-2015样式包已经基本够用，剩下的问题可能是一些特殊情况时带来的适应性问题，这需要经过大量的测试来发现问题。如果在使用过程中发现什么问题，请邮件联系作者，非常感谢! + + % 到1.0i版为止，进一步完善了: GB7714风格的文献表标签项对齐设计，编组内信息的中英文判断，特殊或老的bibtex 条目类型支持，改善空格设计以满足断行要求，支持了宏包选项(url等)应用，增加了宏包选项用于GB7714风格实现控制(gbpub 等)，重新设计了版本兼容方式，以后的版本中将更容易兼容biblatex的升级。 %到1.0h版为止，进一步完善了样式宏包，该版本将是最后支持texlive2015的版本，以后版本的功能实现将基于最新texlive中biblatex 版本，而不再考虑texlive2015中3.0版的biblatex。 diff --git a/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex b/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex index f74cf4ee7b1..3824ac24269 100644 --- a/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex +++ b/Master/texmf-dist/doc/latex/biblatex-gb7714-2015/biblatex-gb7714-2015-preamble.tex @@ -1,30 +1,59 @@ \usepackage{expl3,etoolbox,ifthen,xstring} \usepackage{xltxtra,mflogo,texnames} -\usepackage{ctex} +\usepackage[zihao=5]{ctex} \ctexset{today=old} \let\kaiti=\kaishu \usepackage{xeCJKfntef} + +\usepackage{xcolor} +\definecolor{gbsteelblue}{RGB}{70,130,180} +\definecolor{gborange}{RGB}{255,138,88} +\definecolor{gbblue}{RGB}{23,74,117} +\definecolor{gbforestgreen}{RGB}{21,122,81} +\definecolor{gbyellow}{RGB}{255,185,88} +\definecolor{gbgrey}{RGB}{200,200,200} + +%一些字符串格式化命令 +\newcommand*{\verbatimfont}{\ttfamily} +\newrobustcmd*{\cnt}[1]{\mbox{\verbatimfont#1}} +\newrobustcmd*{\bibfield}[1]{\mbox{\verbatimfont#1}} +\newrobustcmd*{\opt}[1]{\mbox{\verbatimfont#1}} +\newrobustcmd*{\prm}[1]{% + \ifblank{#1} + {} + {\mbox{% + \ensuremath\langle + \normalfont\textit{#1}% + \ensuremath\rangle}}} + \usepackage[paperwidth=210mm,paperheight=290mm,left=20mm,right=20mm,top=25mm, bottom=15mm,showcrop ]{geometry}%定义版面showframe, + \usepackage[colorlinks=true,% -pdfstartview=FitH,linkcolor=blue,anchorcolor=violet,citecolor=magenta]{hyperref} %书签功能，选项去掉链接红色方框 -\usepackage{titleref} %标题引用 +pdfstartview=FitH,allcolors=blue]{hyperref} %书签功能，选项去掉链接红色方框 +%linkcolor=gbblue,anchorcolor=gbblue,citecolor=gbblue %linkcolor=black,linkcolor=green,blue,red,cyan, magenta, %yellow, black, gray,white, darkgray, lightgray, brown, %lime, olive, orange, red,purple, teal, violet. %CJKbookmarks,bookmarksnumbered=true, +\usepackage{titleref} %标题引用 + + %\usepackage[unit=cm,type=lowerleft,showframe=true,hshift=2cm,vshift=1.5cm]{fgruler} + + \usepackage{titlesec} %\titlespacing*{hcommandi}{hlefti}{hbefore-sepi}{hafter-sepi}[hright-sepi] \titlespacing*{\section}{0pt}{\baselineskip}{0.5\baselineskip} \titlespacing*{\subsection}{0pt}{0.5\baselineskip}{0.5\baselineskip} \titlespacing*{\subsubsection}{0pt}{0.5\baselineskip}{0pt} +\titlespacing{\paragraph}{2em}{0.5\baselineskip}{1em} -\setlength{\bibitemsep}{2pt} -\defbibheading{bibliography}[\bibname]{% -%\phantomsection%解决链接指引出错的问题，相当于加入了一个引导点 -%\addcontentsline{toc}{subsection}{#1} - \centering\subsubsection*{#1}}% +\setlength{\bibitemsep}{1pt} +%\defbibheading{bibliography}[\bibname]{% +%%\phantomsection%解决链接指引出错的问题，相当于加入了一个引导点 +%%\addcontentsline{toc}{subsection}{#1} +% \centering\subsubsection*{#1}}% %自定义下划红线和背景颜色 \usepackage{ulem} @@ -44,92 +73,98 @@ pdfstartview=FitH,linkcolor=blue,anchorcolor=violet,citecolor=magenta]{hyperref} \captionstyle{\centering} %\captionstyle{