GitHub Kaynakça Oluşturucu

Atıflarınız

Bir depo arayın ya da yazılımın adını girin; atıflarınızı görün.

GitHub Kaynakça Oluşturucu Nasıl Kullanılır

1. 1. Deponun adresini yapıştırın ve Ara düğmesine basın. Her biçim kabul edilir: https://github.com/owner/repository, depodaki bir dosyanın bağlantısı ya da yalnızca owner/repository.
2. 2. Doldurulan bilgileri kontrol edin. Bir CITATION.cff dosyasından geliştiricilerin seçtiği yazarları, başlığı, sürümü, yayın tarihini ve DOI'yi alırsınız. Dosya yoksa GitHub yalnızca hesap adını ve en son sürümü bilir; proje gerçek yazarları listeliyorsa onları ekleyin.
3. 3. DOI'yi saklayın. Sürüm Zenodo ya da başka bir depoda arşivlenmişse DOI kalıcıdır ve her stil GitHub adresi yerine bunu tercih eder.
4. 4. Atıflarınızı kopyalayın. CITATION.cff bir makale atıfta bulunulmasını belirtiyorsa, o makalenin atıfları yazılımın atıflarından sonra görünür — birçok proje ikisini de ister.

CITATION.cff Dosyası Size Ne Sağlar

CITATION.cff, bir deponun kök dizinindeki küçük bir YAML dosyasıdır; yazılıma nasıl atıf yapılacağını Citation File Format biçiminde (sürüm 1.2.0) belirtir. GitHub bu dosyayı okuyarak APA ve BibTeX içeren bir "Cite this repository" düğmesi gösterir; bu araç da aynı anahtarları okur:

Yazılımı APA, MLA ve Chicago'da Kaynak Gösterme

APA 7 (§10.10) yazılımı, parantez içinde sürümü ve başlıktan sonra [Computer software] açıklamasıyla, ardından yayıncı ile bir DOI ya da URL ile gösterir — APA'da bir GitHub örneği yoktur, bu yüzden sürüm başka bir yerde arşivlenmediği sürece GitHub yayıncı olarak yer alır. MLA 9 girdiyi temel öğelerinden oluşturur; MLA Style Center'ın kaynak kodunu atıflandırma hakkındaki yazısı, deponun sahibini yazar sayar, yazılımın büyük harf kullanımını olduğu gibi korur, sürümü verir ve URL'den önce GitHub'ı ikinci bir kapsayıcı yapar. Chicago 18 (§14.169) yazılımı kaynakçada geliştiricisi altında, sürüm ve yayıncıyla birlikte listeler. BibTeX'te klasik @misc girdisinin sürüm alanı yoktur, bu yüzden sürüm bir nota yazılır; biblatex'in ise gerçek bir @software türü vardır.

GitHub Atıf Örnekleri

Citation File Format spesifikasyonunun kendisi; CITATION.cff dosyası dokuz yazar, sürüm 1.2.0, 9 Ağustos 2021 yayın tarihi ve bir Zenodo DOI'si listeler:

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

Matplotlib'in CITATION.cff dosyası, kullanıcılardan John D. Hunter'ın 2007 tarihli makalesine de atıf yapmalarını ister. Araç bu tercih edilen atfı da biçimlendirir:

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

Depoda CITATION.cff Yoksa

CITATION.cff yoksa araç GitHub'ın herkese açık depo ayrıntılarına başvurur: depo adını başlık olarak, hesap sahibini yazar olarak ve varsa en son sürümün etiketini ve tarihini kullanır. Bu bir başlangıç noktasıdır, tamamlanmış bir atıf değildir — yazarları README dosyasında ya da projenin web sitesinde arayın ve gerçekten kullandığınız sürümü gösterin. Oturum açmadan GitHub, bir bağlantıdan saatte 60 API isteğine izin verir; bir arama bir ya da iki isteği kullanır. Sınıra ulaşırsanız araç ne zaman sıfırlanacağını söyler ve formu elle doldurabilirsiniz. Depoyu siz yönetiyorsanız bir CITATION.cff eklemek, ona yapılan tüm atıfları tutarlı kılar; Yazılım ve Kod Kaynakça Oluşturucu GitHub'da olmayan programları kapsar.

Sık Yapılan Hatalar

• Hesap adını yazar olarak göstermek. "numpy" bir hesaptır; yazarlar, projenin adını verdiği kişi ya da ekiptir.
• Sürümü belirtmemek. Kod sürümler arasında değişir. Kullandığınız sürümü, etiketi ya da commit'i verin.
• DOI varken GitHub URL'sini kullanmak. Arşivlenmiş bir sürümün DOI'si, depo taşındığında bozulmaz.
• Tercih edilen atfı yok saymak. Geliştiriciler makalelerinin de kaynak gösterilmesini istiyorsa onu alıntılayın — genellikle yazılımla birlikte.
• Bir yazılım adının büyük harflerini "düzeltmek". pandas, NumPy ve scikit-learn, geliştiricilerinin yazdığı biçimde yazılır.

Sık sorulan sorular

Bir GitHub deposunu APA 7'de nasıl kaynak gösteririm?

Yazılım olarak gösterin: yazarlar, sürümün yılı, italik ad, parantez içinde sürüm, [Computer software], yayıncı ve bağlantı. Arşiv yoksa yayıncı GitHub, bağlantı ise depo URL'sidir; Zenodo DOI'si varsa yayıncı Zenodo, bağlantı ise DOI'dir. Metin içinde: (Druskat et al., 2021).

CITATION.cff dosyası nedir?

Bir deponun kök dizininde bulunan, insanlara yazılıma nasıl atıf yapacaklarını söyleyen düz metin bir YAML dosyasıdır; Citation File Format biçimindedir. Yazarları, başlığı, sürümü, yayın tarihini ve DOI'yi listeler; bunun yerine atıf yapılacak bir makaleyi de belirtebilir. GitHub bunu "Cite this repository" düğmesine dönüştürür.

Yazılımı mı yoksa onunla ilgili makaleyi mi kaynak göstermeliyim?

CITATION.cff dosyasındaki geliştirici isteğini izleyin. Birçoğu makaleyi ister ve Citation File Format kılavuzu, yazılımın diğer araştırma çıktıları gibi takdir edilmeyi hak ettiğini belirtir; bu nedenle ikisine birden atıf yapmak yaygındır — yöntem için makaleye, çalıştırdığınız sürüm için yazılıma.

Bir GitHub deposu için BibTeX girdisini nasıl alırım?

Buradan arayın ve girdiyi kopyalayın: klasik BibTeX için sürümün bir notta yer aldığı @misc, biblatex için ise @software. İkisi de yazılımın adını çift süslü parantez içinde tutar, böylece büyük harfleri korunur.

Arama için bir GitHub hesabı gerekir mi?

Hayır. Arama GitHub'ın herkese açık API'sini kullanır ve CITATION.cff dosyasını doğrudan tarayıcınızdan raw.githubusercontent.com adresinden okur; yalnızca depo adresini gönderir. Oturum açmadan GitHub, bağlantı başına saatte 60 API isteğine izin verir; bir arama bir ya da iki isteği kullanır.

Depo özelse ya da GitLab'daysa ne olur?

Arama yalnızca herkese açık GitHub depolarını okur. Diğer her durum için ayrıntıları forma yazın — atıflar aynı biçimde hazırlanır — ya da Yazılım ve Kod Kaynakça Oluşturucu aracını kullanın.