Skip to main content

CITATION ファイルについて

ユーザーがソフトウェアを正しく引用できるように、CITATION ファイルをリポジトリに追加できます。

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}
}

上記の例では、"ソフトウェア" 引用 (つまり、@article ではなく BibTeX の@software 型) が生成されることにご注意ください。

詳しくは、「引用ファイル形式」 の Web サイトをご覧ください。

リポジトリの既定のブランチに CITATION.cff ファイルを追加すると、リポジトリのランディング ページで、右のサイドバーに "このリポジトリを引用する" というラベルでリンクが自動的に追加されます。 これにより、他のユーザーがあなたのソフトウェア プロジェクトを、あなたが提供した情報を使って簡単に引用できるようになります。

リポジトリのランディング ページのスクリーンショット。 右のサイドバーの "このリポジトリを引用する" リンクが濃いオレンジ色で囲まれています。また、その下で、引用の詳細が含まれるドロップダウン メニューが展開されています。

ソフトウェア以外のものを引用する

GitHub 引用情報を研究記事などの別のリソースにリンクする場合は、CFF の preferred-citation オーバーライドを次の種類で使うことができます。

リソースCFF 型BibTeX 型APA 注釈
ジャーナルの記事、または論文article@article該当なし
Bookbook@book該当なし
小冊子 (バインドされているが発行されていないもの)pamphlet@booklet該当なし
会議の記事または論文conference-paper@inproceedings[会議論文]
会議の議事録conferenceproceedings@proceedings適用なし
データ セットdatadatabase@misc[データセット]
雑誌の記事magazine-article@article該当なし
マニュアルmanual@manual該当なし
混合/汎用/その他generic、その他の CFF 型@misc該当なし
新聞記事newspaper-article@article該当なし
ソフトウェアsoftwaresoftware-codesoftware-containersoftware-executablesoftware-virtual-machine@software[コンピューター ソフトウェア]
レポート/技術レポートreport@techreport該当なし
未発行unpublished@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 ファイルの最上位レベルで、GitHub 引用プロンプトでデータ引用文字列の出力を生成するように type: dataset を設定できます。

その他の CITATION ファイル

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 リポジトリで追加の形式を要求することも、ご自分で投稿することもできます。