JSDoc
જે. એસ. ડી. ઓ. સી. એ માર્કઅપ લેંગ્વેજ છે જેનો ઉપયોગ જાવાસ્ક્રિપ્ટ સોર્સ કોડ ફાઇલોને એનોટેટ કરવા માટે થાય છે. જે. એસ. ડી. ઓ. સી. ધરાવતી ટિપ્પણીઓનો ઉપયોગ કરીને, પ્રોગ્રામરો તેઓ બનાવી રહ્યાં છે તે કોડના એપ્લિકેશન પ્રોગ્રામિંગ ઇન્ટરફેસનું વર્ણન કરતા દસ્તાવેજો ઉમેરી શકે છે. ત્યારબાદ એચ. ટી. એમ. એલ. અને રિચ ટેક્સ્ટ ફોર્મેટ જેવા સુલભ સ્વરૂપોમાં દસ્તાવેજીકરણ તૈયાર કરવા માટે વિવિધ સાધનો દ્વારા પ્રક્રિયા કરવામાં આવે છે. જે. એસ. ડી. ઓ. સી. સ્પષ્ટીકરણ સી. બી. વાય.-એસ. એ. 3 હેઠળ બહાર પાડવામાં આવ્યું છે, જ્યારે તેની સહયોગી દસ્તાવેજીકરણ જનરેટર અને પાર્સર લાઇબ્રેરી અપાચે લાઇસન્સ 2 હેઠળ મફત સોફ્ટવેર છે. ઇતિહાસ જે. એસ. ડી. ઓ. સી. નું વાક્યરચના અને શબ્દાર્થ જાવડોક યોજના જેવું જ છે, જેનો ઉપયોગ જાવામાં લખાયેલા કોડના દસ્તાવેજીકરણ માટે થાય છે. જે. એસ. ડી. ઓ. સી. જાવાડોકથી અલગ છે, જેમાં તે જાવાસ્ક્રિપ્ટની ગતિશીલ વર્તણૂકને સંભાળવા માટે વિશિષ્ટ છે. જાવાસ્ક્રિપ્ટને દસ્તાવેજીકૃત કરવા માટે જાવાડોક જેવા વાક્યરચનાનો ઉપયોગ કરતું પ્રારંભિક ઉદાહરણ 1999માં નેટસ્કેપ/મોઝિલા પ્રોજેક્ટ રાઇનો સાથે બહાર પાડવામાં આવ્યું હતું, જે જાવામાં લખાયેલ જાવાસ્ક્રિપ્ટ રન-ટાઇમ સિસ્ટમ છે. તેમાં એક રમકડું "જે. એસ. ડી. ઓ. સી". એચ. ટી. એમ. એલ. જનરેટર સામેલ હતું, જે તેની જાવાસ્ક્રિપ્ટ ક્ષમતાઓના ઉદાહરણ તરીકે 1.3 સુધી વર્ઝનમાં હતું. "જે. એસ. ડી. ઓ. સી". ની તમામ મુખ્ય પેઢીઓનું નેતૃત્વ માઇકમેથ્સ (માઈકલ મેથ્યુઝ) દ્વારા કરવામાં આવતું હતું. તેમણે 2001માં કેનેડિયન પ્રોગ્રામર ગેબ્રિએલ રીડના સહયોગથી JSDoc.pm સાથે શરૂઆત કરી હતી, જે પર્લમાં લખાયેલી એક સરળ પદ્ધતિ હતી. તે સીવીએસ રીપોઝીટરીમાં સોર્સફોર્જ પર હોસ્ટ કરવામાં આવ્યું હતું. જે. એસ. ડી. ઓ. સી. 1 (2007) દ્વારા તેમણે સિસ્ટમને જાવાસ્ક્રિપ્ટમાં (ફરીથી રાઇનો માટે) ફરીથી લખી અને વિસ્તરણના સમૂહ પછી જે. એસ. ડી. ઓ. સી. 2 (2008) એ "જે. એસ. ડી. ઓ. સી.-ટૂલકિટ" નામ મેળવ્યું. એમઆઇટી લાઇસન્સ હેઠળ પ્રકાશિત, તે ગૂગલ કોડ પર સબવર્ઝન રીપોઝીટરીમાં હોસ્ટ કરવામાં આવ્યું હતું. 2011 સુધીમાં તેમણે આ સિસ્ટમને જે. એસ. ડી. ઓ. સી. 3 માં ફેરવી નાખી અને પરિણામને ગિટહબ પર હોસ્ટ કર્યું. તે હવે Node.js પર ચાલે છે. જે. એસ. ડી. ઓ. સી. ટૅગ્સ આધુનિક જે. એસ. ડી. ઓ. સી. માં ઉપયોગમાં લેવાતા કેટલાક વધુ લોકપ્રિય એનોટેશન ટૅગ્સ છેઃ {| class = "વિકિટેબલ"! ટેગ! ! વર્ણન |-| @author | | ડેવલપરનું નામ |-| @constructor | ફંક્શનને કન્સ્ટ્રક્ટર તરીકે ચિહ્નિત કરે છે |-| @deprecated | | પદ્ધતિને અપ્રચલિત તરીકે ચિહ્નિત કરે છે |-| @exception | | @throws |-| @exports | | માટે સમાનાર્થી | | મોડ્યુલ દ્વારા નિકાસ કરાયેલા સભ્યને ઓળખે છે |-| @param | | પદ્ધતિ પરિમાણને દસ્તાવેજ કરે છે; કર્લી કૌંસ વચ્ચે ડેટાટાઇપ સૂચક ઉમેરી શકાય છે |-| @private | સૂચવે છે કે સભ્ય ખાનગી છે |-| @returns | દસ્તાવેજો વળતર મૂલ્ય છે |-| @return | સમાનાર્થી |-| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | */વર્ગ વર્તુળ {/* * * * વર્તુળનું ઉદાહરણ બનાવે છે. * * @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}/* * * વર્તુળની સ્ટ્રિંગ રજૂઆત શોધો. * * @override * @return {શબ્દમાળા} આ વર્તુળની માનવ-વાંચી શકાય તેવી રજૂઆત. */toStᱨᱤᱝ () {રીટર્ન '[${this.radius} ની ત્રિજ્યા સાથેનો વર્તુળ પદાર્થ. ] '}}/* * * વર્તુળ છાપે છે. * * @param {વર્તુળ} વર્તુળ */કાર્ય પ્રિન્ટસર્કલ (વર્તુળ) {/* * @this {વર્તુળ} */વિધેય બંધાયેલ () {console.log (આ)} bound.apply (વર્તુળ)} નોંધ લો કે અને ટૅગ્સ હકીકતમાં અવગણવામાં આવી શકે છેઃ તેમની ઓળખ સ્પષ્ટ કરવા માટે ઇસીએમએસિંટેક્સ પૂરતું છે, અને જેએસડીઓસી તેનો ઉપયોગ કરે છે. આપમેળે પણ અનુમાન કરી શકાય છે. જે. એસ. ડી. ઓ. સી. ગૂગલના ક્લોઝર લિન્ટર અને ક્લોઝર કમ્પાઇલરનો ઉપયોગ કરે છે. બાદમાં તેના આઉટપુટ જાવાસ્ક્રિપ્ટને શ્રેષ્ઠ બનાવવા માટે પ્રકારની માહિતી કાઢે છે. ટાઇપસ્ક્રિપ્ટ જે. એસ. ડી. ઓ. સી. પ્રકારની ટિપ્પણીઓ સાથે જાવાસ્ક્રિપ્ટ ફાઇલો માટે પ્રકાર તપાસ કરી શકે છે. માઇક્રોસોફ્ટે એક્સ્ટેન્સિબલ ટેગ્સ સાથે નવી ટીએસડીઓસી ભાષા નિર્દિષ્ટ કરી છે. લોકપ્રિય સંપાદક સબલાઈમ ટેક્સ્ટ ડોકબ્લોકર અથવા ડોક્સીડોક્સીજેન પ્લગઇન દ્વારા જે. એસ. ડી. ઓ. સી. ને ટેકો આપે છે જે. એસ. ડી. ઓ. સી. વાક્યરચનાનું વર્ણન એપ્રેસ બુક ફાઉન્ડેશન ઓફ એજેક્સમાં કરવામાં આવ્યું છે. ઇન્ટેલીજે આઇડિયા, નેટબીન્સ, વિઝ્યુઅલ સ્ટુડિયો કોડ અને રુબીમાઈન જે. એસ. ડી. ઓ. સી. વાક્યરચના સમજે છે. એક્લિપ્સ-આધારિત અપ્ટાના સ્ટુડિયો સ્ક્રિપ્ટડૉકને સપોર્ટ કરે છે. મોઝાઇલ, મોઝિલા ઇનલાઇન એડિટર JSDoc.pm નો ઉપયોગ કરે છે. હેલ્મા એપ્લિકેશન માળખું જેએસડીઓસીનો ઉપયોગ કરે છે. સ્પ્રાઉટકોર દસ્તાવેજીકરણ જે. એસ. ડી. ઓ. સી. નો ઉપયોગ કરીને બનાવવામાં આવ્યું હતું. વિઝ્યુઅલ સ્ટુડિયો, વેબસ્ટોર્મ અને અન્ય ઘણા સંકલિત વિકાસ વાતાવરણ અથવા ટેક્સ્ટ એડિટર્સ જે. એસ. ડી. ઓ. સી. ટિપ્પણીઓના આધારે કોડ કમ્પ્લીશન અને અન્ય સહાય પ્રદાન કરે છે. ઓપન સોર્સ એટમ એડિટર એટમ-ઇઝી-જેએસડીઓસી પ્લગઇન દ્વારા જેએસડીઓસીને સપોર્ટ કરે છે. દસ્તાવેજીકરણ જનરેટરની સરખામણી પણ જુઓ ગૂગલ ક્લોઝર ટૂલ્સ સંદર્ભો બાહ્ય કડીઓ મફત દસ્તાવેજીકરણ જનરેટર જાવાસ્ક્રિપ્ટ પ્રોગ્રામિંગ ટૂલ્સ