From 5ba4dcd8c4443a2cd0398897b5c5a7322a66db88 Mon Sep 17 00:00:00 2001 From: Xiangdong Zeng Date: Mon, 17 Jul 2023 21:29:22 +0800 Subject: [PATCH] Update README.md (#138) - Remove redundant `\begin{latex} ... \end{latex}` - Add `bib` tag for code blocks. - Clean up newlines to avoid spaces between Chinese characters. --- README.md | 65 +++++++++++++++++++++---------------------------------- 1 file changed, 25 insertions(+), 40 deletions(-) diff --git a/README.md b/README.md index 193d17e..d680820 100644 --- a/README.md +++ b/README.md @@ -1,12 +1,10 @@ # GB/T 7714—2015 BibTeX Style - [![CTAN](https://img.shields.io/ctan/v/gbt7714.svg)](https://ctan.org/pkg/gbt7714) [![GitHub release](https://img.shields.io/github/release/zepinglee/gbt7714-bibtex-style/all.svg)](https://github.com/zepinglee/gbt7714-bibtex-style/releases/latest) [![GitHub commits](https://img.shields.io/github/commits-since/zepinglee/gbt7714-bibtex-style/latest.svg)](https://github.com/zepinglee/gbt7714-bibtex-style/commits/master) [![Build](https://github.com/zepinglee/gbt7714-bibtex-style/workflows/build/badge.svg)](https://github.com/zepinglee/gbt7714-bibtex-style/actions) - ## Introduction The `gbt7714` package provides a BibTeX implementation for the China's @@ -21,58 +19,46 @@ and English) for each biblilography entry. - Email: zepinglee AT gmail DOT com - License: LaTeX Project Public License 1.3c or later - ## 简介 -GB/T 7714—2015 《信息与文献 参考文献著录规则》是中国的参考文献推荐标准。 国内的绝大部分学术期刊、学位论文都使用了基于该标准的格式。 -本宏包是国标的 BibTeX 实现,主要有以下特性: +GB/T 7714—2015《信息与文献 参考文献著录规则》是中国的参考文献推荐标准。国内的绝大部分学术期刊、学位论文都使用了基于该标准的格式。本宏包是国标的 BibTeX 实现,主要有以下特性: + - 兼容 `natbib` 宏包。 -- 支持“顺序编码制”和“著者-出版年制”两种风格。 +- 支持 “顺序编码制” 和 “著者-出版年制” 两种风格。 - 自动识别语言并进行相应处理。 - 提供了简单的接口供用户修改样式。 - 同时提供了 2005 版的 `.bst` 文件。 - ## 版本 v2.0 的重要修改 -从 v2.0 版本开始(2020-03-04),用户必须在文档中使用 `\bibliographystyle` 命令选择参考文献样式, -如 `gbt7714-numerical` 或 `gbt7714-author-year`。 -在早期的版本中,选择文献样式的方法是将 `numbers` 或 `super` 等参数传递给 `gbt7714`, -而不能使用 `\bibliographystyle`。 -这跟标准的 LaTeX 接口不一致,所以将被弃用。 - +从 v2.0 版本开始(2020-03-04),用户必须在文档中使用 `\bibliographystyle` 命令选择参考文献样式,如 `gbt7714-numerical` 或 `gbt7714-author-year`。在早期的版本中,选择文献样式的方法是将 `numbers` 或 `super` 等参数传递给 `gbt7714`,而不能使用 `\bibliographystyle`。这跟标准的 LaTeX 接口不一致,所以将被弃用。 ## 使用方法 以下是 `gbt7714` 宏包的一个简单示例。 + ```latex -\begin{latex} - \documentclass{ctexart} - \usepackage{gbt7714} - \bibliographystyle{gbt7714-numerical} - \begin{document} - \cite{...} - ... - \bibliography{bibfile} - \end{document} -\end{latex} +\documentclass{ctexart} +\usepackage{gbt7714} +\bibliographystyle{gbt7714-numerical} +\begin{document} + \cite{...} + ... + \bibliography{bibfile} +\end{document} ``` 1. 在导言区调用宏包 `gbt7714`; - 2. 使用 `\bibliographystyle` 选择参考文献的样式; - 3. 在正文中 `\cite` 文献; - 4. 使用 `\bibliography` 命令生成参考文献表。 - ## 注意事项 1. `bib` 数据库应使用 UTF-8 编码。 -2. 使用著者-出版年制参考文献表时,中文的文献**必须**在 `key` 域填写 -著者姓名的拼音,才能按照拼音排序,比如: -``` +2. 使用著者-出版年制参考文献表时,中文的文献**必须**在 `key` 域填写著者姓名的拼音,才能按照拼音排序,比如: + +```bib @book{capital, author = {马克思 and 恩格斯}, key = {ma3 ke4 si1 & en1 ge2 si1}, @@ -80,17 +66,15 @@ GB/T 7714—2015 《信息与文献 参考文献著录规则》是中国的参 } ``` -同一处引用多篇文献时,应将各篇文献的 key 一同写在 `\cite` 命令中, -如 `\cite{knuth84,lamport94,mittelbach04}`。 -如遇连续编号,可以自动转为起讫序号并用短横线连接。 +同一处引用多篇文献时,应将各篇文献的 key 一同写在 `\cite` 命令中,如 `\cite{knuth84,lamport94,mittelbach04}`。如遇连续编号,可以自动转为起讫序号并用短横线连接。 若需要标出引文的页码,可以标在 `\cite` 的可选参数中,如 `\cite[42]{knuth84}`。 更多的引用标注方法可以参考 `natbib` 宏包的使用说明。 -本宏包默认情况下可以自动识别文献语言,并自动处理文献类型和载体类型标识, -但是在少数情况下需要用户手动指定,如: -``` +本宏包默认情况下可以自动识别文献语言,并自动处理文献类型和载体类型标识,但是在少数情况下需要用户手动指定,如: + +```bib @misc{citekey, langid = {japanese}, mark = {Z}, @@ -98,8 +82,8 @@ GB/T 7714—2015 《信息与文献 参考文献著录规则》是中国的参 ... } ``` -可选的语言有 `english`, `chinese`, `japanese`, `russian`。 +可选的语言有 `english`, `chinese`, `japanese`, `russian`。 ## 文献类型 @@ -125,8 +109,8 @@ GB/T 7714—2015 《信息与文献 参考文献著录规则》是中国的参 其他 | Z | `@misc` 注: -- 带 “\*” 的类型不是 BibTeX 的标准文献类型。 +- 带 “\*” 的类型不是 BibTeX 的标准文献类型。 ## 著录项目 @@ -159,15 +143,16 @@ GB/T 7714—2015 《信息与文献 参考文献著录规则》是中国的参 拼音(用于排序) | `key` 注: + - 其中带星号的不是 BibTeX/natbib 的标准著录项目。 -- 不支持的 BibTeX 标准著录项目有 `annote`, `chapter`, `crossref`, `month`, -`type`。 +- 不支持的 BibTeX 标准著录项目有 `annote`, `chapter`, `crossref`, `month`, `type`。 ## 参考文献著录标准 - [GB/T 7714—2015 信息与文献 参考文献著录规则](http://www.cessp.org.cn/uploads/1/file/public/201607/20160708142456_8mqgu0dpgk.pdf) ## 相关讨论 + - 陈浩元(标准起草人):[GB/T 7714 新标准对旧标准的主要修改及实施要点提示](http://bjxb.cessp.org.cn/ch/reader/view_abstract.aspx?file_no=20150411&flag=1) - 陈浩元(标准起草人):[GB/T 7714一2015 的新点、实施要点及其他](http://www.cessp.org.cn/uploads/1/file/public/201607/20160705202202_0airiqt165.pdf)(Slides) - 梁海:[知乎回答「GB/T 7714—2005 一些有关空格和标点符号的细节问题?」](https://www.zhihu.com/question/23371611/answer/24696880)