关于 CITATION 文件

你可以向存储库的根目录中添加一个 CITATION.cff 文件，让其他人知道你希望他们如何引用你的工作。引用文件格式是纯文本，包含人类和机器可读的引用信息。

示例 CITATION.cff 文件

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Lisa"
  given-names: "Mona"
  orcid: "https://orcid.org/0000-0000-0000-0000"
- family-names: "Bot"
  given-names: "Hew"
  orcid: "https://orcid.org/0000-0000-0000-0000"
title: "My Research Software"
version: 2.0.4
doi: 10.5281/zenodo.1234
date-released: 2017-12-18
url: "https://github.com/github-linguist/linguist"

你的存储库上的 GitHub 引用提示将以这些格式显示示例 CITATION.cff 内容

APA

Lisa, M., & Bot, H. (2017). My Research Software (Version 2.0.4) [Computer software]. https://doi.org/10.5281/zenodo.1234

BibTeX

@software{Lisa_My_Research_Software_2017,
  author = {Lisa, Mona and Bot, Hew},
  doi = {10.5281/zenodo.1234},
  month = {12},
  title = {{My Research Software}},
  url = {https://github.com/github-linguist/linguist},
  version = {2.0.4},
  year = {2017}
}

请注意，上面的示例生成一个软件引用（即 BibTeX 中的 @software 类型，而不是 @article）。

有关更多信息，请参阅引用文件格式网站。

当你向存储库的默认分支添加 CITATION.cff 文件时，将在右侧边栏的存储库登陆页面中自动添加一个链接，标签为“引用此存储库”。这使用户可以轻松引用你的软件项目，使用你提供的信息。

Screenshot showing the landing page for a repository. The "Cite this repository" link in the right sidebar is highlighted with a dark orange outline and a dropdown menu with the citation details is expanded underneath.

引用除软件之外的内容

如果你希望 GitHub 引用信息链接到其他资源，例如研究文章，则可以使用 CFF 中的 preferred-citation 覆盖，类型如下。

资源	CFF 类型	BibTeX 类型	APA 注释
期刊文章/论文	`文章`	`@article`	不适用
书籍	`书籍`	`@book`	不适用
小册子（装订但未出版）	`小册子`	`@booklet`	不适用
会议文章/论文	`会议论文`	`@inproceedings`	[会议论文]
会议记录	`会议`、`记录`	`@proceedings`	不适用
数据集	`数据`、`数据库`	`@misc`	[数据集]
杂志文章	`杂志文章`	`@article`	不适用
手册	`手册`	`@manual`	不适用
杂项/通用/其他	`通用`，任何其他 CFF 类型	`@misc`	不适用
报纸文章	`报纸文章`	`@article`	不适用
软件	`软件`、`软件代码`、`软件容器`、`软件可执行文件`、`软件虚拟机`	`@software`	[计算机软件]
报告/技术报告	`报告`	`@techreport`	不适用
未发布	`未发布`	`@unpublished`	不适用

扩展的 CITATION.cff 文件，用于描述软件，但链接到一篇研究文章作为首选引用

cff-version: 1.2.0
message: "If you use this software, please cite it as below."
authors:
- family-names: "Lisa"
  given-names: "Mona"
  orcid: "https://orcid.org/0000-0000-0000-0000"
- family-names: "Bot"
  given-names: "Hew"
  orcid: "https://orcid.org/0000-0000-0000-0000"
title: "My Research Software"
version: 2.0.4
doi: 10.5281/zenodo.1234
date-released: 2017-12-18
url: "https://github.com/github-linguist/linguist"
preferred-citation:
  type: article
  authors:
  - family-names: "Lisa"
    given-names: "Mona"
    orcid: "https://orcid.org/0000-0000-0000-0000"
  - family-names: "Bot"
    given-names: "Hew"
    orcid: "https://orcid.org/0000-0000-0000-0000"
  doi: "10.0000/00000"
  journal: "Journal Title"
  month: 9
  start: 1 # First page number
  end: 10 # Last page number
  title: "My awesome research software"
  issue: 1
  volume: 1
  year: 2021

上述示例 CITATION.cff 文件将在 GitHub 引用提示中生成以下输出

APA

Lisa, M., & Bot, H. (2021). My awesome research software. Journal Title, 1(1), 1. https://doi.org/10.0000/00000

BibTeX

@article{Lisa_My_awesome_research_2021,
  author = {Lisa, Mona and Bot, Hew},
  doi = {10.0000/00000},
  journal = {Journal Title},
  month = {9},
  number = {1},
  pages = {1--10},
  title = {{My awesome research software}},
  volume = {1},
  year = {2021}
}

引用数据集

如果你的存储库包含数据集，则可以在 CITATION.cff 文件的顶级设置 type: dataset，以在 GitHub 引用提示中生成数据引用字符串输出。

其他引用文件

GitHub 引用功能还将检测社区和项目经常使用的一些其他文件，以描述他们希望如何引用其工作。

GitHub 会在引用此存储库提示中链接到这些文件，但不会尝试将它们解析为其他引用格式。

# Note these are case-insensitive and must be in the root of the repository
CITATION
CITATIONS
CITATION.bib
CITATIONS.bib
CITATION.md
CITATIONS.md

# CITATION files for R packages are typically found at inst/CITATION
inst/CITATION

引用格式

我们目前支持 APA 和 BibTeX 文件格式。

是否正在寻找其他引用格式？GitHub 使用 Ruby 库来解析 CITATION.cff 文件。你可以在 ruby-cff 存储库中请求其他格式，或自行贡献。

关于 CITATION 文件

本文内容