GitHub-Zitiergenerator
Fügen Sie die Adresse eines GitHub-Repositorys ein und erhalten Sie eine Zitierung der Software nach APA 7, MLA 9 und Chicago 18, dazu BibTeX- und biblatex-Einträge. Der Rechner liest die Datei CITATION.cff des Repositorys, wenn es eine gibt – einschließlich einer Zenodo-DOI und aller Werke, die die Autoren stattdessen zu zitieren bitten –, und sonst die Repository-Angaben von GitHub. Jedes Feld bleibt bearbeitbar. Kostenlos, ohne Anmeldung.
Angaben zur Software
Der Rechner liest die öffentlichen Angaben des Repositorys über die API von GitHub und, falls vorhanden, dessen Datei CITATION.cff. Nur die Adresse des Repositorys wird an GitHub gesendet.
Personen als Vorname Nachname oder Nachname, Vorname. Eine Gruppe wie The pandas development team bleibt als Ganzes erhalten; setzen Sie andere Gruppennamen in geschweifte Klammern: {Mozilla}.
Genau so, wie die Entwickler ihn schreiben, mit Großbuchstaben.
Das Datum der Version, die Sie verwendet haben. Lassen Sie es leer, wenn es keines gibt.
GitHub bei einem Repository; Zenodo oder ein anderes Archiv, wenn die Version dort eine DOI hat.
Ihre Zitate
Suchen Sie ein Repository oder geben Sie den Namen der Software ein, um Ihre Zitate zu sehen.
So verwenden Sie den GitHub-Zitiergenerator
- 1. Fügen Sie die Adresse des Repositorys ein und klicken Sie auf Suchen. Jede Form funktioniert: https://github.com/owner/repository, ein Link zu einer Datei darin oder einfach owner/repository.
- 2. Prüfen Sie, was ausgefüllt wurde. Aus einer CITATION.cff erhalten Sie die Autoren, den Titel, die Version, das Veröffentlichungsdatum und die DOI, die die Entwickler gewählt haben. Ohne eine solche Datei kennt GitHub nur den Kontonamen und die neueste Version. Ergänzen Sie die echten Autoren, wenn das Projekt sie nennt.
- 3. Behalten Sie die DOI. Ist die Version bei Zenodo oder einem anderen Archiv hinterlegt, ist ihre DOI dauerhaft, und jeder Stil bevorzugt sie gegenüber der GitHub-Adresse.
- 4. Kopieren Sie Ihre Zitate. Nennt die CITATION.cff ein Paper, das zu zitieren ist, erscheinen dessen Zitate nach denen der Software. Viele Projekte bitten um beides.
Was eine Datei CITATION.cff liefert
CITATION.cff ist eine kleine YAML-Datei im Stammverzeichnis eines Repositorys, die festlegt, wie die Software zu zitieren ist, im Citation File Format (Version 1.2.0). GitHub liest sie, um eine Schaltfläche „Cite this repository“ mit APA und BibTeX anzuzeigen, und dieser Rechner liest dieselben Schlüssel:
| CITATION.cff-Schlüssel | Inhalt | Wo es steht |
|---|---|---|
authors | Personen (family-names, given-names) oder eine Gruppe (name) | Das Autorenelement |
title | Der Name der Software | Kursiver Titel, Großschreibung wie angegeben |
version, date-released | Die Version, die Sie zitieren | Version und Datum |
doi, identifiers | Eine DOI, oft von Zenodo | Der Link, der der URL vorgezogen wird |
repository-code | Die Adresse des Repositorys | Die URL, wenn es keine DOI gibt |
preferred-citation | Ein Paper oder anderes Werk, das stattdessen zu zitieren ist | Ein zweiter Satz Zitate |
Software nach APA, MLA und Chicago zitieren
APA 7 (§10.10) zitiert Software mit ihrer Version in Klammern und der Beschreibung [Computer software] nach dem Titel, dann Herausgeber und DOI oder URL. APA hat kein GitHub-Beispiel, daher steht GitHub als Herausgeber, sofern die Version nicht anderswo archiviert ist. MLA 9 baut den Eintrag aus seinen Kernelementen auf. Der Beitrag des MLA Style Center zum Zitieren von Quellcode behandelt den Eigentümer des Repositorys als Autor, behält die Großschreibung der Software genau bei, nennt die Version und macht GitHub zu einem zweiten Container vor der URL. Chicago 18 (§14.169) führt Software in der Bibliografie unter ihrem Entwickler auf, mit Version und Verlag. In BibTeX hat das klassische @misc kein Versionsfeld, daher steht die Version in einer Notiz; biblatex hat einen eigenen @software-Typ.
Beispiele für GitHub-Zitate
Die Spezifikation des Citation File Format selbst, deren CITATION.cff neun Autoren, die Version 1.2.0, ein Veröffentlichungsdatum vom 9. August 2021 und eine Zenodo-DOI auflistet:
APA, 7. Auflage
Literaturverzeichnis:
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
Im Text:
(Druskat et al., 2021)
MLA, 9. Auflage, und Chicago, 18. Auflage
MLA, Zitierte Werke:
Druskat, Stephan, et al. Citation File Format. Version 1.2.0, Zenodo, 9 Aug. 2021, https://doi.org/10.5281/zenodo.5171937.
Chicago-Fußnote:
Stephan Druskat et al., Citation File Format, version 1.2.0 (Zenodo, 2021), https://doi.org/10.5281/zenodo.5171937.
Chicago-Bibliografie:
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}
}Die CITATION.cff von Matplotlib bittet außerdem darum, das Paper von John D. Hunter aus dem Jahr 2007 zu zitieren. Der Rechner formatiert auch diese bevorzugte Zitierung:
Eine bevorzugte Zitierung aus 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}
}Wenn ein Repository keine CITATION.cff hat
Ohne CITATION.cff greift der Rechner auf die öffentlichen Repository-Angaben von GitHub zurück: den Namen des Repositorys als Titel, das Konto des Eigentümers als Autor sowie Tag und Datum der neuesten Version, falls es eine gibt. Das ist ein Ausgangspunkt, keine fertige Zitierung. Suchen Sie die Autoren in der README-Datei oder auf der Website des Projekts und zitieren Sie die Version, die Sie tatsächlich verwendet haben. Ohne Anmeldung erlaubt GitHub 60 API-Anfragen pro Stunde von einer Verbindung aus, und eine Suche verbraucht ein oder zwei davon. Erreichen Sie das Limit, nennt der Rechner den Zeitpunkt des Zurücksetzens, und Sie können das Formular von Hand ausfüllen. Wenn Sie das Repository pflegen, macht eine CITATION.cff jede Zitierung konsistent. Der Zitiergenerator für Software und Code behandelt Programme, die nicht auf GitHub liegen.
Häufige Fehler
- Den Kontonamen als Autor angeben. „numpy“ ist ein Konto; die Autoren sind die Personen oder das Team, die das Projekt nennt.
- Die Version weglassen. Code ändert sich zwischen den Versionen. Geben Sie die Version, das Release-Tag oder den Commit an, den Sie verwendet haben.
- Die GitHub-URL verwenden, obwohl es eine DOI gibt. Die DOI einer archivierten Version bricht nicht, wenn ein Repository umzieht.
- Die bevorzugte Zitierung ignorieren. Bitten die Entwickler darum, ihr Paper zu zitieren, zitieren Sie es – meist zusammen mit der Software.
- Die Großschreibung eines Softwarenamens „korrigieren“. pandas, NumPy und scikit-learn werden so geschrieben, wie ihre Entwickler sie schreiben.
Häufig gestellte Fragen
- Wie zitiere ich ein GitHub-Repository nach APA 7?
- Zitieren Sie es als Software: die Autoren, das Jahr der Version, den Namen kursiv, die Version in Klammern, [Computer software], den Herausgeber und den Link. Ohne Archiv ist der Herausgeber GitHub und der Link die Repository-URL. Mit einer Zenodo-DOI ist der Herausgeber Zenodo und der Link die DOI. Im Text: (Druskat et al., 2021).
- Was ist eine Datei CITATION.cff?
- Eine einfache YAML-Textdatei im Stammverzeichnis eines Repositorys, die angibt, wie die Software zu zitieren ist, im Citation File Format. Sie nennt die Autoren, den Titel, die Version, das Veröffentlichungsdatum und die DOI und kann ein Paper benennen, das stattdessen zu zitieren ist. GitHub macht daraus die Schaltfläche „Cite this repository“.
- Soll ich die Software oder die Arbeit darüber zitieren?
- Folgen Sie den Wünschen der Entwickler in der CITATION.cff. Viele verlangen das Paper, und der Leitfaden zum Citation File Format weist darauf hin, dass Software wie jede andere Forschungsleistung Anerkennung verdient. Beides zu zitieren ist deshalb üblich: das Paper für die Methode, die Software für die Version, die Sie verwendet haben.
- Wie bekomme ich einen BibTeX-Eintrag für ein GitHub-Repository?
- Suchen Sie es hier und kopieren Sie den Eintrag: @misc für klassisches BibTeX mit der Version in einer Notiz oder @software für biblatex. Beide halten den Namen der Software in doppelten geschweiften Klammern, damit ihre Großschreibung erhalten bleibt.
- Braucht die Suche ein GitHub-Konto?
- Nein. Sie nutzt die öffentliche API von GitHub und liest die Datei CITATION.cff direkt aus Ihrem Browser von raw.githubusercontent.com; dabei wird nur die Adresse des Repositorys gesendet. Ohne Anmeldung erlaubt GitHub 60 API-Anfragen pro Stunde und Verbindung, und eine Suche verbraucht ein oder zwei davon.
- Was ist, wenn das Repository privat ist oder bei GitLab liegt?
- Die Suche liest nur öffentliche GitHub-Repositorys. Geben Sie für alles andere die Angaben in das Formular ein – die Zitate werden genauso formatiert – oder nutzen Sie den Zitiergenerator für Software und Code.