À propos des fichiers CITATION

Vous pouvez ajouter un fichier CITATION.cff à la racine d’un dépôt pour informer d’autres utilisateurs de la façon dont vous souhaitez qu’ils citent votre travail. Le format du fichier de citation est un texte brut avec des informations de citation lisibles par l’utilisateur et par ordinateur.

Exemple de fichier 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"

L’invite de citation GitHub sur votre dépôt affiche l’exemple de contenu CITATION.cff dans ces formats :

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

Notez que l’exemple ci-dessus produit une citation logicielle (c’est-à-dire, type @software BibTeX plutôt que @article).

Pour plus d’informations, consultez le site web sur le format de fichier de citation.

Lorsque vous ajoutez un fichier CITATION.cff à la branche par défaut de votre dépôt, un lien est automatiquement ajouté à la page d’accueil du dépôt dans la barre latérale droite, avec l’intitulé « Citer ce dépôt ». Cela permet aux autres utilisateurs de citer facilement votre projet de logiciel en utilisant les informations que vous avez fournies.

Capture d’écran montrant la page d’accueil d’un dépôt. Le lien « Citer ce dépôt » dans la barre latérale droite est mis en évidence avec un encadré orange foncé et un menu déroulant avec les détails de la citation est développé en dessous.

Citer quelque chose d’autre que le logiciel

Si vous préférez que les informations de citation GitHub soient liées à une autre ressource, telle qu’un article de recherche, vous pouvez utiliser la substitution preferred-citation dans CFF avec les types suivants.

Ressource	Type CFF	Type BibTeX	Annotation APA
Article de journal	`article`	`@article`	Non applicable
Book	`book`	`@book`	Non applicable
Livret (lié mais non publié)	`pamphlet`	`@booklet`	Non applicable
Article/document de conférence	`conference-paper`	`@inproceedings`	[Document de conférence]
Compte-rendu de conférence	`conference`, `proceedings`	`@proceedings`	Non applicable
Jeu de données	`data`, `database`	`@misc`	[Jeu de données]
Article de magazine	`magazine-article`	`@article`	Non applicable
Manuelle	`manual`	`@manual`	Non applicable
Divers/générique/autre	`generic`, tout autre type CFF	`@misc`	Non applicable
Article de journal	`newspaper-article`	`@article`	Non applicable
Logiciel	`software`, `software-code`, `software-container`, `software-executable`, `software-virtual-machine`	`@software`	[Logiciel informatique]
Rapport/rapport technique	`report`	`@techreport`	Non applicable
Publication annulée	`unpublished`	`@unpublished`	Non applicable

Fichier CITATION.cff étendu décrivant le logiciel, mais liant à un article de recherche comme citation préférée :

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

L’exemple de fichier CITATION.cff ci-dessus génère les sorties suivantes dans l’invite de citation 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 d’un jeu de données

Si votre dépôt contient un jeu de données, vous pouvez définir type: dataset au niveau supérieur de votre fichier CITATION.cff pour produire une sortie de chaîne de citation de données dans l’invite de citation GitHub.

Autres fichiers de citation

La fonctionnalité de citation GitHub détectera également un petit nombre de fichiers supplémentaires souvent utilisés par les communautés et les projets pour décrire comment ils aimeraient que leur travail soit cité.

GitHub établira un lien vers ces fichiers dans l’invite Citer ce dépôt, mais ne tentera pas de les analyser dans d’autres formats de citation.

# 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

Formats de citation

Nous prenons actuellement en charge les formats de fichiers APA et BibTex.

Vous recherchez d’autres formats de citation ? GitHub utilise une bibliothèque Ruby pour analyser les fichiers CITATION.cff. Vous pouvez demander des formats supplémentaires dans le dépôt ruby-cff, ou contribuer vous-même.

À propos des fichiers CITATION

Dans cet article