Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.

À propos des fichiers CITATION

Vous pouvez ajouter un fichier CITATION à votre référentiel pour aider les utilisateurs à citer correctement votre logiciel.

À 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.

RessourceType CFFType BibTeXAnnotation APA
Article de journalarticle@articleNon applicable
Bookbook@bookNon applicable
Livret (lié mais non publié)pamphlet@bookletNon applicable
Article/document de conférenceconference-paper@inproceedings[Document de conférence]
Compte-rendu de conférenceconference, proceedings@proceedingsNon applicable
Jeu de donnéesdata, database@misc[Jeu de données]
Article de magazinemagazine-article@articleNon applicable
Manuellemanual@manualNon applicable
Divers/générique/autregeneric, tout autre type CFF@miscNon applicable
Article de journalnewspaper-article@articleNon applicable
Logicielsoftware, software-code, software-container, software-executable, software-virtual-machine@software[Logiciel informatique]
Rapport/rapport techniquereport@techreportNon applicable
Publication annuléeunpublished@unpublishedNon 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.