सामग्री पर जाएँ
CitationEasy

GitHub उद्धरण जनरेटर

GitHub रिपॉज़िटरी का URL चिपकाएँ और सॉफ़्टवेयर के लिए APA 7, MLA 9 और Chicago 18 में उद्धरण पाएँ, साथ में BibTeX और biblatex एंट्री। उपकरण रिपॉज़िटरी की CITATION.cff फ़ाइल पढ़ता है जब वह मौजूद हो — जिसमें Zenodo DOI और वह कृति भी शामिल है जिसे लेखक उद्धृत करने को कहते हैं — और जब न हो तब GitHub का रिपॉज़िटरी विवरण। हर फ़ील्ड संपादित किया जा सकता है। निःशुल्क, पंजीकरण आवश्यक नहीं।

सॉफ़्टवेयर का विवरण

यह उपकरण GitHub के API से रिपॉज़िटरी का सार्वजनिक विवरण पढ़ता है, और यदि उसमें CITATION.cff फ़ाइल है तो वह भी। केवल रिपॉज़िटरी का पता GitHub को भेजा जाता है।

लोग First Last या Last, First के रूप में। The pandas development team जैसा समूह पूरा रखा जाता है; अन्य समूह के नाम को ब्रेस में लपेटें: {Mozilla}।

ठीक वैसे ही जैसे डेवलपर लिखते हैं, बड़े अक्षरों समेत।

आपके उपयोग किए गए संस्करण की तारीख। न हो तो खाली छोड़ें।

रिपॉज़िटरी के लिए GitHub; जब रिलीज़ का DOI वहाँ हो तो Zenodo या कोई दूसरा अभिलेख।

आपके उद्धरण

कोई GitHub रिपॉज़िटरी खोजें, या सॉफ़्टवेयर का नाम लिखें, ताकि अपने उद्धरण देख सकें।

GitHub उद्धरण जनरेटर का उपयोग कैसे करें

  1. 1. रिपॉज़िटरी का पता चिपकाएँ और खोजें दबाएँ। कोई भी रूप चलता है: https://github.com/owner/repository, उसके भीतर किसी फ़ाइल का लिंक, या केवल owner/repository।
  2. 2. जाँचें कि क्या भरा गया है। CITATION.cff से आपको वे लेखक, शीर्षक, संस्करण, रिलीज़ की तारीख और DOI मिलते हैं जो डेवलपर्स ने चुने हैं। उसके बिना GitHub केवल खाते का नाम और नवीनतम रिलीज़ जानता है — यदि परियोजना असली लेखक सूचीबद्ध करती है तो उन्हें जोड़ें।
  3. 3. DOI रखें। जब रिलीज़ Zenodo या किसी दूसरे अभिलेख पर संग्रहीत हो, तो उसका DOI स्थायी होता है, और हर शैली GitHub पते की जगह उसे पसंद करती है।
  4. 4. अपने उद्धरण कॉपी करें। यदि CITATION.cff किसी पेपर को उद्धृत करने को कहती है, तो उसके उद्धरण सॉफ़्टवेयर के उद्धरणों के बाद दिखते हैं — कई परियोजनाएँ दोनों माँगती हैं।

CITATION.cff फ़ाइल आपको क्या देती है

CITATION.cff रिपॉज़िटरी की जड़ में रखी एक छोटी YAML फ़ाइल है, जो Citation File Format (संस्करण 1.2.0) में बताती है कि सॉफ़्टवेयर को कैसे उद्धृत किया जाए। GitHub इसे पढ़कर “Cite this repository” बटन दिखाता है, जिसमें APA और BibTeX होते हैं, और यह उपकरण वही कुंजियाँ पढ़ता है:

CITATION.cff कुंजीइसमें क्या हैयह कहाँ जाता है
authorsलोग (family-names, given-names) या एक समूह (name)लेखक वाला तत्व
titleसॉफ़्टवेयर का नामतिरछे अक्षरों में शीर्षक, बड़े अक्षर जैसे लिखे हों वैसे
version, date-releasedवह रिलीज़ जिसे आप उद्धृत कर रहे हैंसंस्करण और तारीख
doi, identifiersDOI, अक्सर Zenodo सेलिंक — URL की जगह पसंद किया जाता है
repository-codeरिपॉज़िटरी का पताDOI न होने पर URL
preferred-citationकोई पेपर या दूसरी कृति जो उसकी जगह उद्धृत होउद्धरणों का दूसरा सेट

APA, MLA और Chicago में सॉफ़्टवेयर का उद्धरण

APA 7 (§10.10) सॉफ़्टवेयर को उसके संस्करण के साथ कोष्ठक में, शीर्षक के बाद विवरण [Computer software], फिर प्रकाशक और DOI या URL के साथ उद्धृत करता है — APA में GitHub का कोई उदाहरण नहीं है, इसलिए जब तक रिलीज़ कहीं और संग्रहीत न हो, GitHub प्रकाशक बनता है। MLA 9 प्रविष्टि को उसके मूल तत्वों से बनाता है: MLA Style Center का स्रोत कोड उद्धृत करने वाला लेख रिपॉज़िटरी के मालिक को लेखक मानता है, सॉफ़्टवेयर का बड़ा-छोटा अक्षर ठीक वैसा रखता है, संस्करण देता है, और URL से पहले GitHub को दूसरा कंटेनर बनाता है। Chicago 18 (§14.169) ग्रंथ सूची में सॉफ़्टवेयर को उसके डेवलपर के नाम पर सूचीबद्ध करता है, संस्करण और प्रकाशक के साथ। BibTeX में क्लासिक @misc का कोई संस्करण फ़ील्ड नहीं होता, इसलिए संस्करण एक नोट में जाता है; biblatex में वास्तविक @software प्रकार है।

GitHub उद्धरण उदाहरण

Citation File Format की अपनी विशिष्टता, जिसकी CITATION.cff में नौ लेखक, संस्करण 1.2.0, 9 अगस्त 2021 की रिलीज़ तारीख और एक Zenodo DOI सूचीबद्ध हैं:

APA 7वाँ संस्करण

संदर्भ सूची:

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

पाठ-अंतर्गत:

(Druskat et al., 2021)

MLA 9वाँ संस्करण और Chicago 18वाँ संस्करण

MLA उद्धृत रचना सूची:

Druskat, Stephan, et al. Citation File Format. Version 1.2.0, Zenodo, 9 Aug. 2021, https://doi.org/10.5281/zenodo.5171937.

Chicago पाद-टिप्पणी:

Stephan Druskat et al., Citation File Format, version 1.2.0 (Zenodo, 2021), https://doi.org/10.5281/zenodo.5171937.

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

Matplotlib की CITATION.cff उपयोगकर्ताओं से John D. Hunter के 2007 के पेपर को भी उद्धृत करने को कहती है। उपकरण वह पसंदीदा उद्धरण भी फ़ॉर्मेट करता है:

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

जब रिपॉज़िटरी में CITATION.cff न हो

CITATION.cff के बिना उपकरण GitHub के सार्वजनिक रिपॉज़िटरी विवरण का सहारा लेता है: शीर्षक के रूप में रिपॉज़िटरी का नाम, लेखक के रूप में मालिक का खाता, और नवीनतम रिलीज़ का टैग और तारीख, यदि हो। यह एक शुरुआती बिंदु है, पूरा उद्धरण नहीं — लेखकों को README या परियोजना की वेबसाइट में खोजें, और वही संस्करण उद्धृत करें जिसका आपने वास्तव में उपयोग किया। साइन इन किए बिना GitHub एक कनेक्शन से घंटे में 60 API अनुरोधों की अनुमति देता है, और एक खोज एक या दो अनुरोध लेती है; सीमा पहुँचने पर उपकरण बताता है कि वह कब रीसेट होगी, और आप फ़ॉर्म हाथ से भर सकते हैं। यदि आप रिपॉज़िटरी का रखरखाव करते हैं, तो CITATION.cff जोड़ने से उसके हर उद्धरण में एकरूपता आती है — जो प्रोग्राम GitHub पर नहीं हैं, उनके लिए सॉफ़्टवेयर और कोड उद्धरण जनरेटर काम आता है।

आम गलतियाँ

  • खाते का नाम लेखक के रूप में उद्धृत करना। “numpy” एक खाता है; लेखक वे लोग या टीम हैं जिन्हें परियोजना सूचीबद्ध करती है।
  • संस्करण छोड़ देना। कोड रिलीज़ के बीच बदलता है। वह संस्करण, रिलीज़ टैग या कमिट दें जिसका आपने उपयोग किया।
  • DOI होने पर GitHub URL का उपयोग करना। संग्रहीत रिलीज़ का DOI तब भी नहीं टूटता जब रिपॉज़िटरी स्थानांतरित हो।
  • पसंदीदा उद्धरण को अनदेखा करना। यदि डेवलपर्स अपना पेपर उद्धृत करने को कहते हैं, तो उसे उद्धृत करें — आम तौर पर सॉफ़्टवेयर के साथ।
  • सॉफ़्टवेयर नाम के बड़े अक्षर “सुधारना”। pandas, NumPy और scikit-learn को वैसे ही लिखा जाता है जैसे उनके डेवलपर लिखते हैं।

अक्सर पूछे जाने वाले प्रश्न

APA 7 में GitHub रिपॉज़िटरी को कैसे उद्धृत करें?
उसे सॉफ़्टवेयर के रूप में उद्धृत करें: लेखक, रिलीज़ का वर्ष, तिरछे अक्षरों में नाम, कोष्ठक में संस्करण, [Computer software], प्रकाशक और लिंक। बिना अभिलेख के प्रकाशक GitHub होता है और लिंक रिपॉज़िटरी का URL; Zenodo DOI होने पर प्रकाशक Zenodo होता है और लिंक DOI। पाठ में: (Druskat et al., 2021)।
CITATION.cff फ़ाइल क्या है?
रिपॉज़िटरी की जड़ में रखी एक सादी YAML फ़ाइल, जो बताती है कि सॉफ़्टवेयर को Citation File Format में कैसे उद्धृत करें। इसमें लेखक, शीर्षक, संस्करण, रिलीज़ की तारीख और DOI होते हैं, और यह उसकी जगह उद्धृत करने के लिए कोई पेपर भी सूचीबद्ध कर सकती है। GitHub इसे “Cite this repository” बटन में बदलता है।
सॉफ़्टवेयर को उद्धृत करें या उस पर लिखे पेपर को?
CITATION.cff में दिए डेवलपर्स की इच्छा का पालन करें। कई पेपर माँगते हैं, और Citation File Format गाइड बताती है कि सॉफ़्टवेयर को भी किसी अन्य शोध-उत्पाद की तरह श्रेय मिलना चाहिए, इसलिए दोनों को उद्धृत करना आम है — विधि के लिए पेपर, और जिस संस्करण को आपने चलाया उसके लिए सॉफ़्टवेयर।
GitHub रिपॉज़िटरी के लिए BibTeX एंट्री कैसे पाएँ?
यहाँ खोजें और एंट्री कॉपी करें: क्लासिक BibTeX के लिए @misc, जिसमें संस्करण एक नोट में होता है, या biblatex के लिए @software। दोनों सॉफ़्टवेयर का नाम दोहरे ब्रेस में रखते हैं ताकि उसके बड़े अक्षर बचे रहें।
क्या खोज के लिए GitHub खाता चाहिए?
नहीं। यह GitHub का सार्वजनिक API इस्तेमाल करता है और raw.githubusercontent.com से CITATION.cff फ़ाइल सीधे आपके ब्राउज़र से पढ़ता है, केवल रिपॉज़िटरी का पता भेजते हुए। साइन इन किए बिना GitHub प्रति कनेक्शन घंटे में 60 API अनुरोधों की अनुमति देता है, और एक खोज एक या दो लेती है।
यदि रिपॉज़िटरी निजी है या GitLab पर है तो?
खोज केवल सार्वजनिक GitHub रिपॉज़िटरी पढ़ती है। बाकी के लिए फ़ॉर्म में विवरण लिखें — उद्धरण उसी तरह फ़ॉर्मेट होते हैं — या सॉफ़्टवेयर और कोड उद्धरण जनरेटर का उपयोग करें।

संबंधित उपकरण

सॉफ़्टवेयर और कोड उद्धरण जनरेटरडेटासेट उद्धरण जनरेटरBibTeX क्लीनर और वैलिडेटरDOI खोजकAPA 7 में डेटा सेट का उद्धरण कैसे दें

उद्धरण जनरेटर में और