JSDoc
जे. एस. डी. ओ. सी. एक मार्कअप भाषा है जिसका उपयोग जावास्क्रिप्ट स्रोत कोड फ़ाइलों की व्याख्या करने के लिए किया जाता है। जे. एस. डी. ओ. सी. युक्त टिप्पणियों का उपयोग करके, प्रोग्रामर अपने द्वारा बनाए जा रहे कोड के अनुप्रयोग प्रोग्रामिंग इंटरफेस का वर्णन करने वाले प्रलेखन को जोड़ सकते हैं। इसके बाद इसे एच. टी. एम. एल. और रिच टेक्स्ट फॉर्मेट जैसे सुलभ प्रारूपों में प्रलेखन तैयार करने के लिए विभिन्न उपकरणों द्वारा संसाधित किया जाता है। जे. एस. डी. ओ. सी. विनिर्देशन सी. सी. बी. वाई.-एस. ए. 3 के तहत जारी किया गया है, जबकि इसका सहयोगी प्रलेखन जनरेटर और पार्सर लाइब्रेरी अपाचे लाइसेंस 2 के तहत मुफ्त सॉफ्टवेयर है। जे. एस. डी. ओ. सी. का वाक्यविन्यास और शब्दार्थ जावादोक योजना के समान हैं, जिसका उपयोग जावा में लिखे गए कोड के दस्तावेजीकरण के लिए किया जाता है। जे. एस. डी. ओ. सी. जावादोक से अलग है, क्योंकि यह जावास्क्रिप्ट के गतिशील व्यवहार को संभालने के लिए विशिष्ट है। जावास्क्रिप्ट के दस्तावेजीकरण के लिए जावादोक जैसे वाक्यविन्यास का उपयोग करने वाला एक प्रारंभिक उदाहरण 1999 में नेटस्केप/मोज़िला परियोजना राइनो के साथ जारी किया गया था, जो जावा में लिखी गई जावास्क्रिप्ट रन-टाइम प्रणाली है। इसमें एक खिलौना "जे. एस. डी. ओ. सी". एच. टी. एम. एल. जनरेटर शामिल था, जिसे इसकी जावास्क्रिप्ट क्षमताओं के एक उदाहरण के रूप में 1.3 तक संस्करण किया गया था। जे. एस. डी. ओ. सी. की सभी मुख्य पीढ़ियों का नेतृत्व माइकमैथ (माइकल मैथ्यूज) कर रहे थे। उन्होंने 2001 में कनाडा के प्रोग्रामर गैब्रियल रीड के सहयोग से पर्ल में लिखी गई एक सरल प्रणाली JSDoc.pm के साथ शुरुआत की। इसे सीवीएस रिपॉजिटरी में सोर्सफोर्ज पर होस्ट किया गया था। जे. एस. डी. ओ. सी. 1 (2007) द्वारा उन्होंने जावास्क्रिप्ट में प्रणाली को फिर से लिखा (फिर से राइनो के लिए), और विस्तार के एक सेट के बाद जे. एस. डी. ओ. सी. 2 (2008) ने "जे. एस. डी. ओ. सी.-टूलकिट" नाम प्राप्त किया। एमआईटी लाइसेंस के तहत जारी किया गया, इसे गूगल कोड पर एक सबवर्जन रिपॉजिटरी में होस्ट किया गया था। 2011 तक उन्होंने इस प्रणाली को जे. एस. डी. ओ. सी. 3 में परिवर्तित कर दिया और परिणाम को गिटहब पर प्रस्तुत किया। यह अब Node.js पर चलता है। जे. एस. डी. ओ. सी. टैग आधुनिक जे. एस. डी. ओ. सी. में उपयोग किए जाने वाले कुछ अधिक लोकप्रिय एनोटेशन टैग हैंः {। class = "विकिटेबल"! टैग! ! ।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।। ।-।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।।। */वर्ग वृत्त {/* * * वृत्त का एक उदाहरण बनाता है। * * @author: moi * @param {संख्या} r वृत्त की वांछित त्रिज्या। */कन्स्ट्रक्टर (r) {/* * @private */this.radius = r/* @private */this.circumference = 2 * Math.PI * r}/* * * व्यास से एक नया वृत्त बनाता है। * * @param {संख्या} d वृत्त का वांछित व्यास। * @return {वृत्त} नई वृत्त वस्तु। */व्यास (d) से स्थिर {नया वृत्त लौटें (d/2)}/* * * वृत्त की परिधि की गणना करता है। * * @deprecated 1.1.0 से; वृत्त की परिधि के बजाय * @return {संख्या} का उपयोग करें। सर्कमफेरेन्स () {रिटर्न 2 * Math.PI * this.radius}/* * * वृत्त की पूर्व-संगणित परिधि लौटाता है। * * @return {संख्या} वृत्त की परिधि। * @since 1.1.0 */गेटसर्कमफेरेन्स () {रिटर्न this.circumference}/* * * वृत्त का एक स्ट्रिंग प्रतिनिधित्व ढूंढें। * * इस वृत्त का मानव-पठनीय प्रतिनिधित्व। */से स्ट्रिंग () {रिटर्न '[${this.radius} की त्रिज्या के साथ एक वृत्त वस्तु। ] '}}/* * * एक वृत्त छापता है। * * @param {सर्कल} सर्कल */फंक्शन प्रिंटसर्किल (सर्कल) {/* * @this {सर्कल} */फंक्शन बाउंड () {console.log (यह)} bound.apply (सर्कल)} ध्यान दें कि और टैग वास्तव में छोड़े जा सकते हैंः ईसीएमएसिंटैक्स उनकी पहचान को स्पष्ट करने के लिए पर्याप्त है, और जेएसडीओसी इसका उपयोग करता है। स्वचालित रूप से भी अनुमान लगाया जा सकता है। जे. एस. डी. ओ. सी. गूगल के क्लोजर लिंटर और क्लोजर कंपाइलर का उपयोग करता है। उत्तरार्द्ध अपने आउटपुट जावास्क्रिप्ट को अनुकूलित करने के लिए प्रकार की जानकारी निकालता है। टाइपस्क्रिप्ट जे. एस. डी. ओ. सी. टाइप एनोटेशन के साथ जावास्क्रिप्ट फ़ाइलों के लिए टाइप चेकिंग कर सकता है। माइक्रोसॉफ्ट ने विस्तार योग्य टैग के साथ एक नई टीएसडीओसी भाषा निर्दिष्ट की है। लोकप्रिय संपादक सबलाइम टेक्स्ट डॉकब्लॉकर या डॉक्सीडॉक्सीजेन प्लगइन के माध्यम से जे. एस. डी. ओ. सी. का समर्थन करता है जे. एस. डी. ओ. सी. वाक्यविन्यास का विस्तार से वर्णन अप्रेस पुस्तक फाउंडेशन ऑफ एजेक्स में किया गया है। इंटेलीजे आइडिया, नेटबीन्स, विजुअल स्टूडियो कोड और रूबीमाइन जेएसडीओसी वाक्यविन्यास को समझते हैं। ग्रहण-आधारित अप्टाना स्टूडियो स्क्रिप्टडॉक का समर्थन करता है। मोज़ाइल, मोज़िला इनलाइन संपादक JSDoc.pm का उपयोग करता है। हेल्मा एप्लीकेशन फ्रेमवर्क जे. एस. डी. ओ. सी. का उपयोग करता है। स्प्राउटकोर प्रलेखन जे. एस. डी. ओ. सी. का उपयोग करके बनाया गया था। विजुअल स्टूडियो, वेबस्टॉर्म और कई अन्य एकीकृत विकास वातावरण या पाठ संपादक जे. एस. डी. ओ. सी. टिप्पणियों के आधार पर कोड पूर्णता और अन्य सहायता प्रदान करते हैं। ओपन सोर्स एटम एडिटर एटम-ईज़ी-जेएसडॉक प्लगइन के माध्यम से जेएसडॉक का समर्थन करता है। प्रलेखन जनित्रों की तुलना भी देखें गूगल क्लोजर टूल्स संदर्भ बाहरी लिंक मुक्त प्रलेखन जनित्र जावास्क्रिप्ट प्रोग्रामिंग उपकरण