JSDoc
জে. এস. ডি. ও. সি হল একটি মার্কআপ ভাষা যা জাভাস্ক্রিপ্ট সোর্স কোড ফাইলগুলি ব্যাখ্যা করতে ব্যবহৃত হয়। জে. এস. ডি. ও. সি সম্বলিত মন্তব্য ব্যবহার করে, প্রোগ্রামাররা তাদের তৈরি করা কোডের অ্যাপ্লিকেশন প্রোগ্রামিং ইন্টারফেস বর্ণনা করে ডকুমেন্টেশন যোগ করতে পারেন। এরপরে এইচটিএমএল এবং রিচ টেক্সট ফরম্যাটের মতো অ্যাক্সেসযোগ্য ফর্ম্যাটে ডকুমেন্টেশন তৈরি করতে বিভিন্ন সরঞ্জামের মাধ্যমে এটি প্রক্রিয়া করা হয়। জে. এস. ডি. ও. সি-র নির্দিষ্টকরণ সিসি বাই-এসএ 3-এর অধীনে প্রকাশিত হয়, যেখানে এর সহযোগী ডকুমেন্টেশন জেনারেটর এবং পার্সার লাইব্রেরি অ্যাপাচি লাইসেন্স 2-এর অধীনে মুক্ত সফ্টওয়্যার। ইতিহাস জে. এস. ডি. ও. সি-এর বাক্য গঠন এবং শব্দার্থবিদ্যা জাভাডক পদ্ধতির অনুরূপ, যা জাভাতে লেখা কোড নথিভুক্ত করার জন্য ব্যবহৃত হয়। জে. এস. ডি. ও. সি জাভাডক থেকে আলাদা, কারণ এটি জাভাস্ক্রিপ্টের গতিশীল আচরণ পরিচালনা করার জন্য বিশেষায়িত। জাভাস্ক্রিপ্ট নথিভুক্ত করার জন্য জাভাডকের মতো বাক্যবিন্যাস ব্যবহার করে একটি প্রাথমিক উদাহরণ 1999 সালে জাভাতে লিখিত জাভাস্ক্রিপ্ট রান-টাইম সিস্টেম নেটস্কেপ/মোজিলা প্রকল্প রাইনো দিয়ে প্রকাশিত হয়েছিল। এটিতে জাভাস্ক্রিপ্ট ক্ষমতার উদাহরণ হিসাবে একটি খেলনা "জেএসডোক" এইচটিএমএল জেনারেটর অন্তর্ভুক্ত ছিল, যা 1.3 পর্যন্ত সংস্করণ করা হয়েছিল। "জে. এস. ডি. ও. সি"-এর সমস্ত প্রধান প্রজন্মের নেতৃত্বে ছিলেন মাইকম্যাথ (মাইকেল ম্যাথিউস)। তিনি 2001 সালে কানাডিয়ান প্রোগ্রামার গ্যাব্রিয়েল রিডের সহযোগিতায় পার্ল ভাষায় লেখা একটি সহজ পদ্ধতি JSDoc.pm দিয়ে শুরু করেছিলেন। এটি একটি সিভিএস সংগ্রহস্থলে সোর্সফোর্জে হোস্ট করা হয়েছিল। জে. এস. ডি. ও. সি 1.0 (2007)-এর মাধ্যমে তিনি জাভাস্ক্রিপ্টে (আবার রাইনো-র জন্য) সিস্টেমটি পুনর্লিখন করেন এবং জে. এস. ডি. ও. সি 2.0 (2008) সম্প্রসারণের পরে "জে. এস. ডি. ও. সি-টুলকিট" নামটি অর্জন করেন। এমআইটি লাইসেন্সের অধীনে প্রকাশিত, এটি গুগল কোডে একটি সাবভার্সন সংগ্রহস্থলে হোস্ট করা হয়েছিল। 2011 সালের মধ্যে তিনি সিস্টেমটিকে জে. এস. ডি. ও. সি 3-এ রূপান্তরিত করেছেন এবং ফলাফলটি গিটহাব-এ উপস্থাপন করেছেন। এটি এখন Node.js-এ চলে। জে. এস. ডি. ও. সি ট্যাগ আধুনিক জে. এস. ডি. ও. সি-তে ব্যবহৃত কিছু জনপ্রিয় টীকা ট্যাগ হলঃ {। শ্রেণী = "উইকিটেবল"! ট্যাগ! ! বিবরণ।-। @author।। ডেভেলপারের নাম।-। @constructor। একটি ফাংশনকে কনস্ট্রাক্টর হিসাবে চিহ্নিত করে।-। @deprecated।। একটি পদ্ধতিকে অবচিত হিসাবে চিহ্নিত করে।-। @exception।। @throws এর প্রতিশব্দ।-। @exports।। মডিউল দ্বারা রপ্তানি করা একজন সদস্যকে সনাক্ত করে।-। @param।। একটি পদ্ধতি পরামিতি নথিভুক্ত করে; কোঁকড়া ধনুর্বন্ধনীগুলির মধ্যে একটি ডেটাটাইপ সূচক যুক্ত করা যেতে পারে।-। @private। ইঙ্গিত করে যে একজন সদস্য ব্যক্তিগত।-। @returns। নথিগুলির একটি রিটার্ন মান।-। ।-। @throws। একটি পদ্ধতি দ্বারা নিক্ষেপ করা একটি ব্যতিক্রম নথি।-। @version। একটি বৃত্তের প্রতিনিধিত্বকারী একটি লাইব্রেরির সংস্করণ নম্বর প্রদান করে। */শ্রেণী বৃত্ত {/* * * বৃত্তের একটি উদাহরণ তৈরি করে। * * @author: moi * @param {সংখ্যা} r বৃত্তের কাঙ্ক্ষিত ব্যাসার্ধ। */কনস্ট্রাক্টর (r) {/* * @private */this.radius = r/* @private */this.circumference = 2 * Math.PI * r}/* * * একটি ব্যাস থেকে একটি নতুন বৃত্ত তৈরি করে। * * @param {সংখ্যা} ডি বৃত্তের কাঙ্ক্ষিত ব্যাস। * @return {বৃত্ত} নতুন বৃত্ত বস্তু। */স্ট্যাটিক থেকে ব্যাস (d) {রিটার্ন নিউ সার্কেল (d/2)}/* * * বৃত্তের পরিধি গণনা করে। * * @deprecated 1.1.0 থেকে; বৃত্তের পরিধির পরিবর্তে * @return {সংখ্যা} ব্যবহার করুন। */ক্যালকুলেটসারকামফেরেন্স () {রিটার্ন 2 * Math.PI * this.radius}/* * * বৃত্তের পূর্ব-গণনা করা পরিধি প্রদান করে। * * @return {সংখ্যা} বৃত্তের পরিধি। * @since 1.1.0 */গেটসারকামফেরেন্স () {রিটার্ন this.circumference}/* * * বৃত্তের একটি স্ট্রিং উপস্থাপনা খুঁজুন। * * @override * @return {স্ট্রিং} এই বৃত্তের মানব-পাঠযোগ্য উপস্থাপনা। */থেকে স্ট্রিং () {রিটার্ন '[${this.radius} ব্যাসার্ধ সহ একটি বৃত্তাকার বস্তু। ] '}}/* * * একটি বৃত্ত মুদ্রণ করে। * * @param {সার্কেল} সার্কেল */ফাংশন প্রিন্ট সার্কেল (সার্কেল) {/* * @this {সার্কেল} */ফাংশন বাউন্ড () {console.log (এই)} bound.apply (সার্কেল)} লক্ষ্য করুন যে ট্যাগগুলি আসলে বাদ দেওয়া যেতে পারেঃ ইসিএমএসিন্ট্যাক্স তাদের পরিচয় স্পষ্ট করার জন্য যথেষ্ট, এবং জেএসডোক এটি ব্যবহার করে। স্বয়ংক্রিয়ভাবেও অনুমান করা যেতে পারে। জেএসডোক গুগলের ক্লোজার লিন্টার এবং ক্লোজার কম্পাইলার ব্যবহার করে। পরেরটি তার আউটপুট জাভাস্ক্রিপ্টকে অনুকূল করতে প্রকারের তথ্য বের করে। টাইপস্ক্রিপ্ট জে. এস. ডি. ও. সি টাইপ অ্যানোটেশন সহ জাভাস্ক্রিপ্ট ফাইলগুলির জন্য টাইপ চেকিং করতে পারে। মাইক্রোসফ্ট এক্সটেনসিবল ট্যাগ সহ একটি নতুন টিএসডোক ভাষা নির্দিষ্ট করেছে। জনপ্রিয় সম্পাদক সাবলাইম টেক্সট ডকব্লকার বা ডক্সিডক্সিজেন প্লাগইনের মাধ্যমে জে. এস. ডি. ও. সি-কে সমর্থন করে জে. এস. ডি. ও. সি বাক্যবিন্যাসটি অ্যাপ্রেস বই ফাউন্ডেশনস অফ অ্যাজাক্সে বিস্তারিতভাবে বর্ণনা করা হয়েছে। ইন্টেলিজে আইডিইএ, নেটবিন্স, ভিজ্যুয়াল স্টুডিও কোড এবং রুবিমাইন জেএসডোক সিনট্যাক্স বোঝে। ইক্লিপ্স-ভিত্তিক আপ্টানা স্টুডিও স্ক্রিপ্টডক সমর্থন করে। মোজাইল, মোজিলা ইনলাইন সম্পাদক JSDoc.pm ব্যবহার করে। হেলমা অ্যাপ্লিকেশন কাঠামো জে. এস. ডি. ও. সি ব্যবহার করে। জে. এস. ডি. ও. সি ব্যবহার করে স্প্রাউটকোর ডকুমেন্টেশন তৈরি করা হয়েছিল। ভিজ্যুয়াল স্টুডিও, ওয়েবস্টর্ম এবং অন্যান্য অনেক ইন্টিগ্রেটেড ডেভেলপমেন্ট এনভায়রনমেন্ট বা টেক্সট এডিটরস জেএসডোক মন্তব্যের উপর ভিত্তি করে কোড কম্প্লিশন এবং অন্যান্য সহায়তা প্রদান করে। ওপেন সোর্স অ্যাটম এডিটর অ্যাটম-ইজি-জেএসডোক প্লাগইনের মাধ্যমে জেএসডোককে সমর্থন করে। আরও দেখুন ডকুমেন্টেশন জেনারেটরের তুলনা গুগল ক্লোজার টুলস রেফারেন্স বাহ্যিক লিঙ্ক বিনামূল্যে ডকুমেন্টেশন জেনারেটর জাভাস্ক্রিপ্ট প্রোগ্রামিং টুল