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.

Recorte de pantalla en el que se muestra la página principal del repositorio. El vínculo "Citar este repositorio" de la derecha se expande para mostrar los detalles y se resalta en color naranja.

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 anulación de preferred-citation en CFF con los siguientes tipos.

Recurso	Tipo CFF	Tipo BibTeX	Anotación APA
Artículo de revista	`article`	`@article`	No aplicable
Libro	`book`	`@book`	No aplicable
Folleto (encuadernado pero no publicado)	`pamphlet`	`@booklet`	No aplicable
Arículo de conferencia/revista	`conference-paper`	`@inproceedings`	[Artículo de conferencia]
Memorias de una conferencia

          `conference`, `proceedings` | `@proceedings` | No aplicable |

Archivo ampliado de CITATION.cff que describe el software, aunque enlaza a un artículo de investigación como 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 referencia

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.

Acerca de los archivos de CITATION

En este artículo