Generator Sitasi GitHub

Sitasi Anda

Cari repositori, atau masukkan nama perangkat lunak, untuk melihat sitasi Anda.

Cara Menggunakan Generator Sitasi GitHub

1. 1. Tempelkan alamat repositori dan tekan Cari. Bentuk apa pun dapat dipakai: https://github.com/owner/repository, tautan ke berkas di dalamnya, atau cukup owner/repository.
2. 2. Periksa apa yang sudah terisi. Dari CITATION.cff Anda mendapatkan penulis, judul, versi, tanggal rilis, dan DOI yang dipilih pengembang. Tanpa berkas itu, GitHub hanya mengetahui nama akun dan rilis terbaru — tambahkan penulis yang sebenarnya jika proyek mencantumkannya.
3. 3. Simpan DOI-nya. Ketika rilis diarsipkan di Zenodo atau repositori lain, DOI-nya bersifat permanen, dan setiap gaya lebih memilihnya daripada alamat GitHub.
4. 4. Salin sitasi Anda. Jika CITATION.cff menyebut makalah untuk dikutip, sitasinya muncul setelah sitasi perangkat lunak — banyak proyek meminta keduanya.

Apa yang Diberikan Berkas CITATION.cff

CITATION.cff adalah berkas YAML kecil di akar repositori yang menyatakan bagaimana perangkat lunak harus dikutip, dalam Citation File Format (versi 1.2.0). GitHub membacanya untuk menampilkan tombol "Cite this repository" dengan APA dan BibTeX, dan alat ini membaca kunci yang sama:

Mengutip Perangkat Lunak dalam APA, MLA, dan Chicago

APA 7 (§10.10) mengutip perangkat lunak dengan versinya dalam tanda kurung dan deskripsi [Computer software] setelah judul, lalu penerbit dan DOI atau URL — APA tidak memiliki contoh GitHub, jadi GitHub berperan sebagai penerbit kecuali rilisnya diarsipkan di tempat lain. MLA 9 menyusun entri dari elemen intinya, dan tulisan MLA Style Center tentang mengutip kode sumber memperlakukan pemilik repositori sebagai penulis, mempertahankan huruf kapital perangkat lunak persis seperti semula, mencantumkan versinya, dan menjadikan GitHub sebagai wadah kedua sebelum URL. Chicago 18 (§14.169) mencantumkan perangkat lunak di bawah pengembangnya dalam bibliografi, dengan versi dan penerbitnya. Dalam BibTeX, @misc klasik tidak memiliki bidang versi, sehingga versi ditaruh dalam catatan; biblatex memiliki tipe @software tersendiri.

Contoh Sitasi GitHub

Spesifikasi Citation File Format itu sendiri, yang CITATION.cff-nya mencantumkan sembilan penulis, versi 1.2.0, tanggal rilis 9 Agustus 2021, dan DOI Zenodo:

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

CITATION.cff milik Matplotlib juga meminta pengguna untuk mengutip makalah John D. Hunter tahun 2007. Alat ini juga memformat sitasi yang disarankan tersebut:

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

Ketika Repositori Tidak Memiliki CITATION.cff

Tanpa CITATION.cff, alat ini kembali ke detail repositori publik dari GitHub: nama repositori sebagai judul, akun pemilik sebagai penulis, dan tag serta tanggal rilis terbaru, jika ada. Itu titik awal, bukan sitasi yang sudah jadi — cari penulisnya di README atau situs web proyek, dan kutip versi yang benar-benar Anda gunakan. Tanpa masuk, GitHub mengizinkan 60 permintaan API per jam dari satu koneksi, dan satu pencarian memakai satu atau dua; jika Anda mencapai batas, alat ini memberi tahu kapan batas itu direset, dan Anda dapat mengisi formulir secara manual. Jika Anda memelihara repositori, menambahkan CITATION.cff membuat setiap sitasi terhadapnya menjadi konsisten — Generator Sitasi Perangkat Lunak & Kode membahas program yang tidak ada di GitHub.

Kesalahan Umum

• Menyebut nama akun sebagai penulis. "numpy" adalah sebuah akun; penulisnya adalah orang atau tim yang disebut proyek.
• Tidak mencantumkan versi. Kode berubah antar-rilis. Berikan versi, tag rilis, atau commit yang Anda gunakan.
• Memakai URL GitHub padahal ada DOI. DOI dari rilis yang diarsipkan tidak rusak ketika repositori pindah.
• Mengabaikan sitasi yang disarankan. Jika pengembang meminta Anda mengutip makalah mereka, kutiplah — biasanya bersama perangkat lunaknya.
• "Memperbaiki" huruf kapital nama perangkat lunak. pandas, NumPy, dan scikit-learn ditulis seperti cara pengembangnya menulisnya.

Pertanyaan yang Sering Diajukan

Bagaimana cara mengutip repositori GitHub dalam APA 7?

Kutip sebagai perangkat lunak: penulis, tahun rilis, nama dengan huruf miring, versi dalam tanda kurung, [Computer software], penerbit, dan tautannya. Tanpa arsip, penerbitnya adalah GitHub dan tautannya adalah URL repositori; dengan DOI Zenodo, penerbitnya adalah Zenodo dan tautannya adalah DOI. Dalam teks: (Druskat et al., 2021).

Apa itu berkas CITATION.cff?

Berkas YAML teks biasa di akar repositori yang memberi tahu orang cara mengutip perangkat lunak, dalam Citation File Format. Berkas ini mencantumkan penulis, judul, versi, tanggal rilis, dan DOI, dan dapat menyebut makalah untuk dikutip sebagai gantinya. GitHub mengubahnya menjadi tombol "Cite this repository".

Apakah saya harus mengutip perangkat lunaknya atau makalah tentangnya?

Ikuti keinginan pengembang dalam CITATION.cff. Banyak yang meminta makalahnya, dan panduan Citation File Format mencatat bahwa perangkat lunak layak mendapat kredit seperti keluaran riset lainnya, sehingga mengutip keduanya sudah lazim — makalah untuk metodenya, perangkat lunak untuk versi yang Anda jalankan.

Bagaimana cara mendapatkan entri BibTeX untuk repositori GitHub?

Cari di sini dan salin entrinya: @misc untuk BibTeX klasik, dengan versi dalam catatan, atau @software untuk biblatex. Keduanya mempertahankan nama perangkat lunak dalam kurung kurawal ganda agar huruf kapitalnya tetap terjaga.

Apakah pencarian memerlukan akun GitHub?

Tidak. Alat ini menggunakan API publik GitHub dan membaca berkas CITATION.cff dari raw.githubusercontent.com langsung dari browser Anda, dengan hanya mengirimkan alamat repositori. Tanpa masuk, GitHub mengizinkan 60 permintaan API per jam per koneksi, dan satu pencarian memakai satu atau dua.

Bagaimana jika repositorinya privat atau ada di GitLab?

Pencarian hanya membaca repositori GitHub publik. Untuk yang lain, ketik detailnya ke dalam formulir — sitasinya diformat dengan cara yang sama — atau gunakan Generator Sitasi Perangkat Lunak & Kode.