Generador de citas de GitHub
Pega la URL de un repositorio de GitHub y obtén una cita del software en APA 7, MLA 9 y Chicago 18, además de entradas en BibTeX y biblatex. La herramienta lee el archivo CITATION.cff del repositorio cuando lo tiene —incluido el DOI de Zenodo y cualquier obra que los autores pidan citar en su lugar— y los datos públicos del repositorio en GitHub cuando no lo tiene. Cada campo sigue siendo editable. Gratis, sin registro.
Datos del software
La herramienta lee los datos públicos del repositorio desde la API de GitHub y su archivo CITATION.cff, si lo tiene. Solo se envía la dirección del repositorio, a GitHub.
Personas como Nombre Apellido o Apellido, Nombre. Un grupo, como The pandas development team, se mantiene completo; escribe entre llaves cualquier otro nombre de grupo: {Mozilla}.
Tal como lo escriben los desarrolladores, con sus mayúsculas.
La fecha de la versión que usaste. Déjala en blanco si no hay ninguna.
GitHub para un repositorio; Zenodo u otro archivo cuando la versión tiene un DOI allí.
Tus citas
Busca un repositorio o escribe el nombre del software para ver tus citas.
Cómo usar el generador de citas de GitHub
- 1. Pega la dirección del repositorio y pulsa Buscar. Vale cualquier formato: https://github.com/owner/repository, un enlace a un archivo dentro de él o simplemente owner/repository.
- 2. Revisa lo que se ha rellenado. Desde un CITATION.cff obtienes los autores, el título, la versión, la fecha de publicación y el DOI que eligieron los desarrolladores. Sin ese archivo, GitHub solo conoce el nombre de la cuenta y la última versión publicada: añade los autores reales si el proyecto los indica.
- 3. Conserva el DOI. Cuando la versión está archivada en Zenodo u otro repositorio, su DOI es permanente, y todos los estilos lo prefieren a la dirección de GitHub.
- 4. Copia tus citas. Si el CITATION.cff nombra un artículo que citar, sus citas aparecen después de las del software: muchos proyectos piden citar ambos.
Qué aporta un archivo CITATION.cff
CITATION.cff es un pequeño archivo YAML en la raíz de un repositorio que indica cómo debe citarse el software, en el Citation File Format (versión 1.2.0). GitHub lo usa para mostrar el botón «Cite this repository», con APA y BibTeX, y esta herramienta lee las mismas claves:
| Clave de CITATION.cff | Qué contiene | Dónde va |
|---|---|---|
authors | Personas (family-names, given-names) o un grupo (name) | El elemento de autor |
title | El nombre del software | Título en cursiva, con las mayúsculas tal como se escriben |
version, date-released | La versión que se cita | Versión y fecha |
doi, identifiers | Un DOI, a menudo de Zenodo | El enlace, que se prefiere a la URL |
repository-code | La dirección del repositorio | La URL cuando no hay DOI |
preferred-citation | Un artículo u otra obra que citar en su lugar | Un segundo conjunto de citas |
Citar software en APA, MLA y Chicago
APA 7 (§10.10) cita el software con su versión entre paréntesis y la descripción [Computer software] después del título, y luego el editor y un DOI o una URL. APA no tiene un ejemplo para GitHub, así que GitHub actúa como editor, salvo que la versión esté archivada en otro sitio. MLA 9 construye la entrada a partir de sus elementos básicos; la entrada del MLA Style Center sobre cómo citar código fuente trata al propietario del repositorio como autor, conserva exactamente las mayúsculas del software, indica la versión y hace de GitHub un segundo contenedor antes de la URL. Chicago 18 (§14.169) incluye el software en la bibliografía bajo su desarrollador, con la versión y el editor. En BibTeX clásico, @misc no tiene campo de versión, así que la versión va en una nota; biblatex tiene un tipo @software propio.
Ejemplos de citas de GitHub
La propia especificación Citation File Format, cuyo CITATION.cff enumera nueve autores, la versión 1.2.0, una fecha de publicación del 9 de agosto de 2021 y un DOI de Zenodo:
APA 7.ª edición
Lista de referencias:
Druskat, S., Spaaks, J. H., Chue Hong, N., Haines, R., Baker, J., Bliven, S., Willighagen, E., Pérez-Suárez, D., & Konovalov, O. (2021). Citation File Format (Version 1.2.0) [Computer software]. Zenodo. https://doi.org/10.5281/zenodo.5171937
En el texto:
(Druskat et al., 2021)
MLA 9.ª edición y Chicago 18.ª edición
Obras citadas en MLA:
Druskat, Stephan, et al. Citation File Format. Version 1.2.0, Zenodo, 9 Aug. 2021, https://doi.org/10.5281/zenodo.5171937.
Nota al pie en Chicago:
Stephan Druskat et al., Citation File Format, version 1.2.0 (Zenodo, 2021), https://doi.org/10.5281/zenodo.5171937.
Bibliografía en Chicago:
Druskat, Stephan, Jurriaan H. Spaaks, Neil Chue Hong, et al. Citation File Format. Version 1.2.0. Zenodo, 2021. https://doi.org/10.5281/zenodo.5171937.
biblatex
@software:
@software{druskat2021citation,
author = {Druskat, Stephan and Spaaks, Jurriaan H. and Chue Hong, Neil and Haines, Robert and Baker, James and Bliven, Spencer and Willighagen, Egon and Pérez-Suárez, David and Konovalov, Olexandr},
title = {{Citation File Format}},
version = {1.2.0},
date = {2021-08-09},
publisher = {Zenodo},
doi = {10.5281/zenodo.5171937},
url = {https://github.com/citation-file-format/citation-file-format}
}El CITATION.cff de Matplotlib pide citar también el artículo de John D. Hunter de 2007. La herramienta da formato también a esa cita preferida:
Una cita preferida de CITATION.cff
APA 7:
Hunter, J. D. (2007). Matplotlib: A 2D graphics environment. Computing in Science & Engineering, 9(3), 90–95. https://doi.org/10.1109/MCSE.2007.55
BibTeX:
@article{hunter2007matplotlib,
author = {Hunter, John D.},
title = {{Matplotlib: A 2D graphics environment}},
journal = {Computing in Science \& Engineering},
volume = {9},
number = {3},
pages = {90--95},
year = {2007},
doi = {10.1109/MCSE.2007.55}
}Cuando un repositorio no tiene CITATION.cff
Sin un CITATION.cff, la herramienta recurre a los datos públicos del repositorio en GitHub: el nombre del repositorio como título, la cuenta del propietario como autor y la etiqueta y la fecha de la última versión, si existe. Es un punto de partida, no una cita terminada: busca los autores en el README o en el sitio web del proyecto, y cita la versión que realmente usaste. Sin iniciar sesión, GitHub permite 60 solicitudes a la API por hora desde una misma conexión, y una búsqueda usa una o dos; si llegas al límite, la herramienta indica cuándo se restablece y puedes rellenar el formulario a mano. Si mantienes el repositorio, añadir un CITATION.cff hace que todas las citas sean coherentes: el Generador de citas de software y código cubre los programas que no están en GitHub.
Errores comunes
- Citar el nombre de la cuenta como autor. «numpy» es una cuenta; los autores son las personas o el equipo que indica el proyecto.
- Olvidar la versión. El código cambia entre versiones. Indica la versión, la etiqueta o el commit que usaste.
- Usar la dirección de GitHub cuando hay un DOI. El DOI de una versión archivada no se rompe cuando un repositorio cambia de lugar.
- Ignorar la cita preferida. Si los desarrolladores piden que cites su artículo, cítalo, normalmente junto al software.
- «Corregir» las mayúsculas del nombre de un software. pandas, NumPy y scikit-learn se escriben como lo hacen sus desarrolladores.
Preguntas frecuentes
- ¿Cómo cito un repositorio de GitHub en APA 7?
- Cítalo como software: los autores, el año de la versión, el nombre en cursiva, la versión entre paréntesis, [Computer software], el editor y el enlace. Sin archivo, el editor es GitHub y el enlace es la URL del repositorio; con un DOI de Zenodo, el editor es Zenodo y el enlace es el DOI. En el texto: (Druskat et al., 2021).
- ¿Qué es un archivo CITATION.cff?
- Un archivo YAML de texto plano en la raíz de un repositorio que indica cómo citar el software, en el Citation File Format. Incluye los autores, el título, la versión, la fecha de publicación y el DOI, y puede nombrar un artículo que citar en su lugar. GitHub lo convierte en el botón «Cite this repository».
- ¿Debo citar el software o el artículo sobre él?
- Sigue lo que pidan los desarrolladores en el CITATION.cff. Muchos piden el artículo, y la guía del Citation File Format señala que el software merece el mismo reconocimiento que cualquier otro resultado de investigación; por eso citar ambos es habitual: el artículo por el método y el software por la versión que ejecutaste.
- ¿Cómo obtengo una entrada BibTeX para un repositorio de GitHub?
- Búscalo aquí y copia la entrada: @misc para el BibTeX clásico, con la versión en una nota, o @software para biblatex. Ambas mantienen el nombre del software entre llaves dobles para que se conserven sus mayúsculas.
- ¿Necesita la búsqueda una cuenta de GitHub?
- No. Usa la API pública de GitHub y lee el archivo CITATION.cff desde raw.githubusercontent.com, directamente desde tu navegador, enviando solo la dirección del repositorio. Sin iniciar sesión, GitHub permite 60 solicitudes a la API por hora desde una misma conexión, y una búsqueda usa una o dos.
- ¿Qué pasa si el repositorio es privado o está en GitLab?
- La búsqueda solo lee repositorios públicos de GitHub. En cualquier otro caso, escribe los datos en el formulario —las citas se dan formato igual— o usa el Generador de citas de software y código.