Generatore di citazioni GitHub
Incolla l'URL di un repository GitHub e ottieni una citazione del software in APA 7, MLA 9 e Chicago 18, oltre alle voci BibTeX e biblatex. Lo strumento legge il file CITATION.cff del repository quando ce l'ha — incluso un DOI Zenodo e qualsiasi lavoro che gli autori chiedono di citare al suo posto — e i dati del repository forniti da GitHub quando non ce l'ha. Ogni campo resta modificabile. Gratuito, senza registrazione.
Dati del software
Lo strumento legge i dati pubblici del repository dall'API di GitHub e il suo file CITATION.cff, se ne ha uno. Viene inviato solo l'indirizzo del repository, a GitHub.
Persone come Nome Cognome o Cognome, Nome. Un gruppo come The pandas development team viene mantenuto intero; racchiudi tra parentesi graffe ogni altro nome di gruppo: {Mozilla}.
Esattamente come lo scrivono gli sviluppatori, maiuscole comprese.
La data della versione che hai usato. Lasciala vuota se non c'è.
GitHub per un repository; Zenodo o un altro archivio quando la release ha un DOI lì.
Le tue citazioni
Cerca un repository, o inserisci il nome del software, per vedere le tue citazioni.
Come usare il generatore di citazioni GitHub
- 1. Incolla l'indirizzo del repository e premi Cerca. Va bene qualsiasi forma: https://github.com/owner/repository, un link a un file al suo interno, oppure solo owner/repository.
- 2. Controlla i dati compilati. Da un CITATION.cff ottieni gli autori, il titolo, la versione, la data di rilascio e il DOI scelti dagli sviluppatori. Senza un CITATION.cff, GitHub conosce solo il nome dell'account e l'ultima release: aggiungi gli autori reali se il progetto li indica.
- 3. Conserva il DOI. Quando la release è archiviata su Zenodo o in un altro repository, il suo DOI è permanente e ogni stile lo preferisce all'indirizzo di GitHub.
- 4. Copia le tue citazioni. Se il CITATION.cff indica un articolo da citare, le sue citazioni compaiono dopo quelle del software: molti progetti chiedono entrambe.
Che cosa offre un file CITATION.cff
CITATION.cff è un piccolo file YAML nella radice di un repository che indica come citare il software, nel Citation File Format (versione 1.2.0). GitHub lo legge per mostrare il pulsante "Cite this repository" con APA e BibTeX, e questo strumento legge le stesse chiavi:
| Chiave di CITATION.cff | Cosa contiene | Dove va |
|---|---|---|
authors | Persone (family-names, given-names) o un gruppo (name) | L'elemento autore |
title | Il nome del software | Titolo in corsivo, maiuscole come scritte |
version, date-released | La release che stai citando | Versione e data |
doi, identifiers | Un DOI, spesso da Zenodo | Il link — preferito all'URL |
repository-code | L'indirizzo del repository | L'URL quando non c'è un DOI |
preferred-citation | Un articolo o un altro lavoro da citare, al posto o in aggiunta | Un secondo gruppo di citazioni |
Citare il software in APA, MLA e Chicago
APA 7 (§10.10) cita il software con la sua versione tra parentesi e la descrizione [Computer software] dopo il titolo, poi l'editore e un DOI o un URL — APA non ha un esempio per GitHub, quindi GitHub fa da editore a meno che la release non sia archiviata altrove. MLA 9 costruisce la voce dai suoi elementi principali, e il post del MLA Style Center sulla citazione del codice sorgente considera il proprietario del repository come autore, mantiene le maiuscole del software esattamente come sono, indica la versione e rende GitHub un secondo contenitore prima dell'URL. Chicago 18 (§14.169) elenca il software sotto il suo sviluppatore nella bibliografia, con la versione e l'editore. Nel BibTeX, il @misc classico non ha un campo per la versione, quindi la versione va in una nota; biblatex ha un vero tipo @software.
Esempi di citazioni GitHub
La specifica del Citation File Format stessa, il cui CITATION.cff elenca nove autori, la versione 1.2.0, una data di rilascio del 9 agosto 2021 e un DOI Zenodo:
APA 7ª ed.
Elenco dei riferimenti:
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
Nel testo:
(Druskat et al., 2021)
MLA 9ª ed. e Chicago 18ª ed.
MLA, elenco delle opere citate:
Druskat, Stephan, et al. Citation File Format. Version 1.2.0, Zenodo, 9 Aug. 2021, https://doi.org/10.5281/zenodo.5171937.
Chicago, nota a piè di pagina:
Stephan Druskat et al., Citation File Format, version 1.2.0 (Zenodo, 2021), https://doi.org/10.5281/zenodo.5171937.
Chicago, bibliografia:
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}
}Il CITATION.cff di Matplotlib chiede di citare anche l'articolo del 2007 di John D. Hunter. Lo strumento formatta anche quella citazione preferita:
Una citazione preferita dal 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}
}Quando un repository non ha un CITATION.cff
Senza un CITATION.cff, lo strumento ricorre ai dati pubblici del repository forniti da GitHub: il nome del repository come titolo, l'account del proprietario come autore, e il tag e la data dell'ultima release, se c'è. È un punto di partenza, non una citazione completa: cerca gli autori nel README o nel sito del progetto, e cita la versione che hai effettivamente usato. Senza accedere, GitHub consente 60 richieste API all'ora da una connessione, e una ricerca ne usa una o due; se raggiungi il limite, lo strumento indica quando si azzera, e puoi compilare il modulo a mano. Se mantieni il repository, aggiungere un CITATION.cff rende coerenti tutte le citazioni che lo riguardano — il Generatore di Citazioni per Software e Codice copre i programmi che non sono su GitHub.
Errori comuni
- Citare il nome dell'account come autore. "numpy" è un account; gli autori sono le persone o il team che il progetto indica.
- Omettere la versione. Il codice cambia da una release all'altra. Indica la versione, il tag di release o il commit che hai usato.
- Usare l'URL di GitHub quando esiste un DOI. Il DOI di una release archiviata non si rompe quando un repository viene spostato.
- Ignorare la citazione preferita. Se gli sviluppatori chiedono di citare il loro articolo, citalo, di solito insieme al software.
- "Correggere" le maiuscole del nome di un software. pandas, NumPy e scikit-learn si scrivono come li scrivono i loro sviluppatori.
Domande frequenti
- Come si cita un repository GitHub in APA 7?
- Citalo come software: gli autori, l'anno della release, il nome in corsivo, la versione tra parentesi, [Computer software], l'editore e il link. Senza un archivio, l'editore è GitHub e il link è l'URL del repository; con un DOI Zenodo, l'editore è Zenodo e il link è il DOI. Nel testo: (Druskat et al., 2021).
- Che cos'è un file CITATION.cff?
- Un file YAML di testo semplice nella radice di un repository che indica come citare il software, nel Citation File Format. Elenca autori, titolo, versione, data di rilascio e DOI, e può indicare un articolo da citare al suo posto. GitHub lo trasforma nel pulsante "Cite this repository".
- Devo citare il software o l'articolo che lo descrive?
- Segui le indicazioni degli sviluppatori nel CITATION.cff. Molti chiedono l'articolo, e la guida al Citation File Format osserva che il software merita un riconoscimento come qualsiasi altro risultato di ricerca, quindi citare entrambi è comune: l'articolo per il metodo, il software per la versione che hai eseguito.
- Come ottengo una voce BibTeX per un repository GitHub?
- Cercalo qui e copia la voce: @misc per il BibTeX classico, con la versione in una nota, oppure @software per biblatex. Entrambe mantengono il nome del software tra doppie graffe, così le sue maiuscole sopravvivono.
- La ricerca richiede un account GitHub?
- No. Usa l'API pubblica di GitHub e legge il file CITATION.cff da raw.githubusercontent.com, direttamente dal tuo browser, inviando solo l'indirizzo del repository. Senza accedere, GitHub consente 60 richieste API all'ora per connessione, e una ricerca ne usa una o due.
- E se il repository è privato o su GitLab?
- La ricerca legge solo i repository pubblici di GitHub. Per tutto il resto, inserisci i dati nel modulo — le citazioni vengono formattate allo stesso modo — oppure usa il Generatore di Citazioni per Software e Codice.