Skip to main content

Acerca de los archivos de CITATION

Puedes agregar un archivo de CITATION a tu repositorio para ayudar a que los usuarios citen tu software correctamente.

Acerca de los archivos de CITATION

Puede agregar un archivo CITATION.cff a la raíz de un repositorio para que otros usuarios sepan cómo le gustaría que citaran su trabajo. El formato de archivo de cita es texto simple con información de cita legible para humanos y máquinas.

Archivo CITATION.cff de ejemplo:

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"

La solicitud de cita de GitHub en el repositorio mostrará el contenido CITATION.cff de ejemplo en estos formatos:

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

Ten en cuenta que en el ejemplo anterior se genera una cita de software (es decir, tipo @software en BibTeX en lugar de @article).

Para más información, vea el sitio web Citation File Format.

Al agregar un archivo CITATION.cff a la rama predeterminada del repositorio, se agrega un vínculo automáticamente a la página de aterrizaje del repositorio en la barra lateral derecha, con la etiqueta "Citar este repositorio". Esto hace fácil que otros usuarios citen tu proyecto de software, utilizando la información que proporcionaste.

Captura de pantalla que muestra la página de aterrizaje de un repositorio. El vínculo "Citar este repositorio" de la barra lateral derecha está resaltado con un contorno naranja oscuro y un menú desplegable con los detalles de la cita se expande debajo.

Citar algo que no sea software

Si prefiere que la información de cita de GitHub se vincule a otro recurso como un artículo de investigación, puede utilizar la invalidación de preferred-citation en CFF con los siguientes tipos.

ResourceTipo CFFTipo BibTeXAnotación APA
Artículo de revistaarticle@articleNo aplicable
Bookbook@bookNo aplicable
Folleto (lligado pero no publicado)pamphlet@bookletNo aplicable
Arículo de conferencia/revistaconference-paper@inproceedings[Artículo de conferencia]
Memorias de una conferenciaconference, proceedings@proceedingsNo aplicable
Conjunto de datosdata, database@misc[Conjunto de datos]
Artículo de revistamagazine-article@articleNo aplicable
Manualmanual@manualNo aplicable
Misceláneo/genérico/otrogeneric, cualquier otro tipo de CFF@miscNo aplicable
Artículo de periódiconewspaper-article@articleNo aplicable
Softwaresoftware, software-code, software-container, software-executable, software-virtual-machine@software[Software de cómputo]
Reporte/reporte técnicoreport@techreportNo aplicable
Publicación anuladaunpublished@unpublishedNo aplicable

Archivo de CITATION.cff extendido que describe el software, pero vincula a un artículo de investigación como la cita preferida:

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

El archivo de ejemplo CITATION.cff anterior generará las siguientes salidas en la solicitud de cita de 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}
}

Citar un conjunto de datos

Si el repositorio contiene un conjunto de datos, puede establecer type: dataset en el nivel superior del archivo CITATION.cff para generar una salida de cadena de cita de datos en el mensaje de cita de GitHub.

Otros archivos de cita

La característica de cita de GitHub también detectará una cantidad pequeña de archivos adicionales que a menudo se utilizan en las comunidades y proyectos para describir cómo quieren que se cite su trabajo.

GitHub vinculará estos archivos en la solicitud Citar este repositorio, pero no intentará analizarlos en otros formatos de cita.

# 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

Formatos de cita

Actualmente, admitimos los formatos de archivo APA y BibTex.

¡Estás buscando formatos de cita adicionales? GitHub usa una biblioteca de Ruby para analizar los archivos CITATION.cff. Puede solicitar formatos adicionales en el repositorio ruby-cff o contribuir personalmente.