GB/T 7714 双语参考文献系统，支持中英文术语自动切换。

同时支持 GB/T 7714—2015 和 GB/T 7714—2025（2026-07-01 实施）两个版本

特性

• ✅ 双版本支持：可选择 2015 或 2025 版本标准
• ✅ 自动检测文献语言（通过 language 字段、正则匹配汉字）
• ✅ 中英文术语自动切换（第X卷/v.X、期/no.、等/et al.）
• ✅ 支持顺序编码制（numeric）和著者-出版年制（author-date）
• ✅ 正确处理作者格式化（中文连写、英文姓大写+名首字母）
• ✅ 支持同作者同年文献消歧（a, b, c 后缀）
• ✅ 支持多引用合并（multicite 函数，支持带页码）
• ✅ 支持引用形式切换（上标/非上标/仅作者/仅年份）
• ✅ 支持带页码引用（supplement 参数）
• ✅ 支持点击引用跳转到参考文献列表
• ✅ 完整的文献类型标识
• ✅ 支持多个 BibTeX 文件

安装

#import "@preview/gb7714-bilingual:0.1.0": init-gb7714, gb7714-bibliography, multicite

使用方法

基本用法

#import "@preview/gb7714-bilingual:0.1.0": init-gb7714, gb7714-bibliography, multicite

// 使用 2025 版本（默认）
#show: init-gb7714.with("/ref.bib", style: "numeric", version: "2025")

正文中使用 @wang2010guide 引用文献。

#gb7714-bibliography()

注意：bib-file 路径必须以 / 开头，表示基于项目根目录的绝对路径。

选择标准版本

// 使用 GB/T 7714—2015
#show: init-gb7714.with("/ref.bib", style: "numeric", version: "2015")

// 使用 GB/T 7714—2025（默认）
#show: init-gb7714.with("/ref.bib", style: "numeric", version: "2025")

著者-出版年制

#show: init-gb7714.with("/ref.bib", style: "author-date", version: "2025")

这是一个引用 @smith2020。

#gb7714-bibliography()

多个 BibTeX 文件

// 使用多个 bib 文件
#show: init-gb7714.with(("/main.bib", "/extra.bib"), style: "numeric")

引用形式切换

// 默认上标形式
孔乙己提到#super[@smith2020]的重要发现

// 非上标形式（散文引用）
另见#cite(<smith2020>, form: "prose")的详细分析

// 仅作者
研究由#cite(<smith2020>, form: "author")完成

// 仅年份
该研究发表于#cite(<smith2020>, form: "year")年

带页码引用

// 简写形式
关于方法论的讨论见@liu2015[第 3 章]
具体实验步骤见@liu2015[126--129]

// 函数形式（可结合 form）
详见#cite(<kopka2004>, form: "prose", supplement: [第 5.2 节])

多引用合并

// 基本用法：同一作者的多篇文献会自动合并年份
#multicite("smith2020a", "smith2020b", "jones2019")
// Numeric: [1-3]（上标）
// Author-date: （Smith，2020a，2020b；Jones，2019）

// 带页码的合并引用
#multicite(
  (key: "smith2020a", supplement: [260]),
  "smith2020b",
  (key: "jones2019", supplement: [Table 2]),
)
// Numeric: [1：260, 2, 3：Table 2]
// Author-date: （Smith，2020a：260，2020b；Jones，2019：Table 2）

// 非上标形式
#multicite("smith2020a", "smith2020b", form: "prose")
// Numeric: [1-2]（非上标）

自定义渲染（高级）

// 使用 full-control 完全控制输出格式
#gb7714-bibliography(full-control: entries => {
  for e in entries [
    // 自定义编号格式
    (#e.order)#h(1em)
    // 使用带 label 的渲染结果（支持点击跳转）
    #e.labeled-rendered
    #parbreak()
  ]
})

// 或者完全自定义，访问原始字段
#gb7714-bibliography(full-control: entries => {
  for e in entries {
    let f = e.fields
    [
      [#e.order]
      #f.at("author", default: "").
      #emph(f.at("title", default: "")).
      #f.at("journal", default: ""),
      #f.at("year", default: "").
    ]
    parbreak()
  }
})

2015 与 2025 版本差异

BibTeX 文件格式

为获得最佳效果，建议在 BibTeX 条目中添加 language 字段：

@article{wang2010guide,
  title   = {科技论文中文摘要写作要点分析},
  author  = {王晓华 and 闫其涛 and 程智强 and 张睿},
  journal = {编辑学报},
  year    = {2010},
  language = {chinese}
}

@book{kopka2004guide,
  title     = {Guide to LATEX},
  author    = {Kopka, Helmut and Daly, Patrick W},
  publisher = {Addison-Wesley},
  year      = {2004},
  language = {english}
}

如果没有 language 字段，系统会通过检测标题/作者中的汉字自动判断语言。

API 参考

init-gb7714(bib-files, style: "numeric", version: "2025", doc)

初始化 GB/T 7714 双语参考文献系统。

• bib-files: BibTeX 文件路径或路径数组（路径必须以 / 开头）
  • 单文件："/ref.bib"
  • 多文件：("/main.bib", "/extra.bib")
• show-url: 是否显示 URL（默认 true）
• show-doi: 是否显示 DOI（默认 true）
• show-accessed: 是否显示访问日期（默认 true）
• style: 引用风格
  • "numeric": 顺序编码制，如 [1]
  • "author-date": 著者-出版年制，如（王，2020）
• version: 标准版本
  • "2015": GB/T 7714—2015
  • "2025": GB/T 7714—2025（默认）

gb7714-bibliography(title: auto, full-control: none)

渲染参考文献列表。

• title: 参考文献标题
  • auto（默认）：根据文献语言自动选择（“参考文献” 或 “References”），一级标题
  • none：不显示标题
  • 自定义内容：如 heading(level: 2)[References]
• full-control: 完全控制渲染的回调函数（高级用法）
  • 签名：(entries) => content
  • 使用此参数时，用户完全控制输出格式

get-cited-entries()

获取被引用的条目列表（低层 API，需在 context 中使用）。

返回数组，每个元素包含：

• key: 引用键
• order: 引用顺序
• year-suffix: 消歧后缀（如 “a”, “b”）
• lang: 语言（“zh” 或 “en”）
• entry-type: 条目类型
• fields: 原始字段字典
• parsed-names: 解析后的作者名
• rendered: 纯渲染结果（不含 label）
• ref-label: 用于跳转的 label 对象（需手动附加到内容中）
• labeled-rendered: 已附加 label 的渲染结果（推荐使用，或用 rendered + ref-label 自行组合）

multicite(..keys, form: none)

多引用合并函数。

• keys: 引用键列表，支持两种形式：
  • 字符串："smith2020"
  • 字典：(key: "smith2020", supplement: [260])
    • key: 引用键（必需）
    • supplement: 页码等附加信息（可选）
• form: 引用形式（命名参数）
  • none / "normal": 默认（顺序编码制上标，著者-出版年制整体括号）
  • "prose": 散文形式（顺序编码制非上标，著者-出版年制仅年份括号）

支持的条目类型

带 URL 或 DOI 的条目会自动添加 /OL 载体标识，如 [J/OL]。

项目结构

src/
├── core/           # 核心模块（状态、工具、语言检测）
├── versions/       # 版本配置（2015、2025）
├── renderers/      # 渲染器（期刊、书籍、会议等）
├── authors.typ     # 作者格式化
├── types.typ       # 文献类型标识
└── api.typ         # 公共 API
lib.typ             # 主入口

许可证

MIT