पिछले भागों के लिंक:
- भाग एक - परिचय, ग्राफिक आदिम कोड की एक चित्रमय प्रतिनिधित्व बनाने के लिए की जरूरत है
- भाग दो - कोड जनरेटर का एक चित्रमय प्रतिनिधित्व (मुख्य रूप से पायथन में किया गया) का कार्यान्वयन, माइक्रो मार्कअप भाषा
- भाग तीन - नई ग्राफिक्स सुविधाएँ
इस चित्रमय प्रतिनिधित्व का समर्थन करने वाले वातावरण का एक उदाहरण नीचे दी गई छवि में दिखाया गया है।
चित्रमय कोड समर्थन पर्यावरणलेख का चौथा भाग प्रलेखन प्रक्रिया का समर्थन करने पर केंद्रित होगा।
झाड़ी के आसपास
आइए देखें कि दस्तावेज के साथ काम करने के मामले में डेवलपर के पास क्या उपलब्ध है।
पायथन मॉड्यूल, वर्गों और कार्यों के लिए प्रलेखन लाइनों का समर्थन करता है। यह अच्छा है। टिप्पणियाँ कभी-कभी प्रलेखन के लिए भी उपयोग की जाती हैं।
डॉक्सिज़न और
स्फिंक्स जैसे प्रलेखन जनरेटर हैं। यह भी अच्छा है।
हालांकि, कभी-कभी आप थोड़ा अधिक चाहते हैं। ऐसे समय होते हैं जब किसी फ़ंक्शन या वर्ग का विवरण बहुत बड़ा हो जाता है और प्रलेखन लाइनें (या टिप्पणियां) अनावश्यक रूप से "प्रफुल्लित" होती हैं। गैर-निष्पादन योग्य लाइनों की संख्या निष्पादन योग्य लाइनों की संख्या को दबाने लगती है, जो धुंधले कोड के कारण पढ़ना मुश्किल बना सकती है। एक अन्य समस्या विभिन्न चार्ट है। आप पाठ में एक तैयार चित्र नहीं डाल सकते। आप केवल आरेख का विवरण सम्मिलित कर सकते हैं, उदाहरण के लिए, एक
प्लांट यूएमएल आरेख, लेकिन इस मामले में भी रेंडरिंग प्रदान करना आवश्यक है, जो सीधे प्रोग्राम पाठ में करना मुश्किल है।
समस्या का समाधान सरल है - एक अलग फ़ाइल में एक लंबा विवरण बचाने के लिए, और कोड में एक नोट छोड़ दें कि प्रलेखन है। एक ही फाइल को सही समय पर उचित रूप से प्रस्तुत किया जा सकता है। और कोड में निशान अधिमानतः इंटरैक्टिव होना चाहिए, अर्थात, माउस के एक क्लिक के साथ प्रलेखन को एक संक्रमण प्रदान करें। सिद्धांत रूप में, कार्यक्रम के पाठ में अंकन को व्यापक माना जा सकता है: यह एक URL हो सकता है, और स्रोत पाठ की एक अन्य फ़ाइल में कुछ जगह, और एक चित्र, और प्रलेखन के साथ एक बाहरी फ़ाइल हो सकती है।
एक बैकलिंक की कल्पना करना आसान है। मान लीजिए कि दस्तावेज़ीकरण प्रोग्राम के स्रोत कोड से एक वर्ग या कोड के एक विशिष्ट ब्लॉक का उल्लेख करता है। इस मामले के लिए, वांछित कोड के त्वरित परिवर्तन प्रदान करना भी अच्छा होगा।
हमें एक और महत्वपूर्ण परिदृश्य पर विचार करने की आवश्यकता है। मान लीजिए कि विकास के दौरान एक बाहरी प्रलेखन फ़ाइल बनाने की इच्छा थी। यह बहुत वांछनीय है कि संगठनात्मक प्रश्न - जहां स्टोर करना है, क्या कॉल करना है, कैसे प्रलेखन के लिए एक लिंक डालना है - स्वचालित रूप से यथासंभव हल किया जाना चाहिए ताकि कोई अनावश्यक बाधा न हो जो प्रलेखन बनाने के लिए धर्मी आवेग को रोक सकती है।
एक अलग चर्चा दस्तावेज़ीकरण फ़ाइलों के प्रारूप के सवाल के हकदार हैं। हाल ही में,
मार्कडाउन ने लोकप्रियता हासिल
की है , इसकी आलोचना के बावजूद (उदाहरण के लिए,
यहां )। कहते हैं कि जब आप प्रोजेक्ट पृष्ठ में प्रवेश करते हैं, तो जीथब स्वचालित रूप से मार्कडाउन प्रलेखन दिखाता है, जो बहुत सुविधाजनक है। ऐसा करने के लिए, आपको फ़ाइल नामकरण और स्थान पर एक बहुत ही सरल, सहज समझौते का पालन करने की आवश्यकता है। मार्कडाउन के साथ काम करने के उपकरण भी भरपूर हैं, इसलिए यह प्रारूप एक अच्छा उम्मीदवार है।
कोडिमेशन आईडीई में कार्यान्वयन
पाठ के साथ,
कोडिमेंशन आईडीई कोड के चित्रमय प्रतिनिधित्व का समर्थन करता है। IDE मार्कअप भाषा का भी समर्थन करता है। इसलिए, प्रलेखन के लिए लिंक प्रदर्शित करने के लिए एक नया ग्राफिक तत्व जोड़ने का कार्य काफी सरल है।
शुरू करने के लिए, हम एक कॉम्पैक्ट रूप में नई कार्यक्षमता के लिए आवश्यकताओं को तैयार करते हैं:
- फ्लाई-रेंडरिंग के साथ मार्कडाउन प्रारूप का समर्थन करें (देखें और संपादित करें)
- कोड के चित्रमय प्रतिनिधित्व में, CML मार्कअप भाषा का उपयोग करके प्रलेखन के लिए एक नए तत्व का समर्थन करें
- प्रलेखन के लिए ग्राफिक तत्व को तीन संस्करणों में काम करना चाहिए: केवल दूसरी जगह के लिए लिंक; अन्य स्थानों से लिंक के लिए केवल लंगर; और लिंक और लंगर
- लिंक एक फ़ाइल के लिए एक URL या बिंदु हो सकता है (संभवतः एक पंक्ति या लंगर संख्या के साथ) जिसे IDE प्रदर्शित करने में सक्षम है
- मार्कडाउन समर्थन संयंत्र में यूएमएल आरेख
- कोड की चित्रमय प्रस्तुति के लिए नई दस्तावेज़ीकरण फ़ाइलों और उनके लिंक के तेजी से निर्माण का समर्थन करें
- एक प्रोजेक्ट के लिए डॉक्यूमेंटेशन डॉक्यूमेंटेशन पॉइंट को बनाए रखें, यह कैसे करता है
मार्कडाउन और प्रतिपादन
कोडिमेशन IDE पाठ संपादक के एक घटक के रूप में
qutepart का उपयोग करता है, और qutepart, बदले में, बॉक्स के बाहर मार्कडाउन का समर्थन करता है: सिंटैक्स हाइलाइटिंग पहले से ही किया गया है। स्वचालित रेंडरिंग के लिए, आप अजगर फ़ाइलों के लिए उसी दृष्टिकोण का उपयोग कर सकते हैं। मुख्य क्षेत्र को दो भागों में विभाजित किया गया है। बाईं ओर मार्कडाउन टेक्स्ट है, और दाईं ओर रेंडरिंग है:
स्वचालित रेंडरिंग के साथ एडिटिंग मार्कडाउनप्रतिपादन, ज़ाहिर है, स्वचालित रूप से किया जाता है। आईडीई पाठ संपादन में एक ठहराव को परिभाषित करता है और यदि आवश्यक हो तो प्रतिपादन को अद्यतन करता है। मार्कडाउन दृश्य के लिए, एक पाठ संपादक के साथ बाईं ओर दबा हुआ है।
रेंडरिंग के लिए
मिस्ट्यून लाइब्रेरी का उपयोग करना सुविधाजनक था, जो आपको टेक्स्ट को HTML में जल्दी से बदलने की अनुमति देता है। तैयार HTML प्रदर्शन के लिए क्यूटी घटक को भेजा जाता है। प्लांट यूएमएल आरेख विवरणों को मान्यता जोड़ने के लिए मिस्ट्यून लाइब्रेरी भी काफी लचीली साबित हुई। चित्र को संबंधित भाषा के साथ कोड के एक ब्लॉक के रूप में जोड़ा जाता है, उदाहरण के लिए:
प्लांटयूएमएल आरेख मान्यताplantUML विभिन्न प्रकार के आरेखों का समर्थन करता है।
कोडिमेंशन के लिए, आरेख का वर्णन पारदर्शी है, अर्थात, इसका विश्लेषण नहीं किया जाता है, लेकिन प्लांटयूएमएल को प्रेषित किया जाता है। तदनुसार, सभी समर्थित प्रकार व्यूपोर्ट में प्रदर्शित किए जाएंगे। लेखन के समय, विभिन्न प्रकार के आरेखों के लिए plantUML ने निम्नलिखित आरंभ / समाप्ति टैग का समर्थन किया:
- @startuml / @enduml
- @startgantt / @endgantt
- @startsalt / @endalt
- @startmindmap / @endmindmap
- @startwbs / @endwbs
- @startditaa / @endditaa
- @startjcckit / @endjcckit
संपादन योग्य मार्कडाउन फ़ाइल में कई आरेख हो सकते हैं, साथ ही नेटवर्क से डाउनलोड किए गए चित्र भी हो सकते हैं। एक लगातार स्थिति तब होती है जब बहुत कम पाठ बदलते हैं, और ग्राफिक संसाधन अपरिवर्तित रहते हैं। हर बार एक ही चीज़ को पंप न करने और आरेख को पुन: उत्पन्न न करने के लिए, समान संसाधनों के कैश को लागू करना आवश्यक था।
क्यूटी लाइब्रेरी से, HTML का समर्थन करने वाले QTextBrowser घटक का उपयोग किया जाता है। दुर्भाग्य से, HTML की समर्थित बोली सीमित है, इसलिए अंतिम परिणाम को सही बनाने के लिए लगभग असंभव है। शायद यह दोष भविष्य में तय हो सकता है।
लिंक पर माउस क्लिक के प्रसंस्करण में भी हस्तक्षेप की आवश्यकता थी। निम्नलिखित में से कुछ लिंक में दिखाई दे सकते हैं:
- बाहरी संसाधन (http: // या https: // के साथ शुरू होता है)
- परियोजना रूट या वर्तमान फ़ाइल से एक रिश्तेदार पथ के साथ एक फ़ाइल (सुविधाजनक जब परियोजना निर्देशिका फ़ाइल सिस्टम के चारों ओर ले जाया जाता है)
- फ़ाइल c पूर्ण पथ
और अगर यह एक फ़ाइल है, तो आप इस फ़ाइल में एंकर के पहचानकर्ता (वैकल्पिक तत्व) या लाइन नंबर को निर्दिष्ट कर सकते हैं। दोनों मामलों में, फ़ाइल को वांछित स्थान पर स्क्रॉल करने के लिए अतिरिक्त जानकारी का उपयोग किया जाता है।
ग्राफिक तत्व
यह एक ग्राफिक तत्व को एक नई CML टिप्पणी का उपयोग करके दर्ज करने के लिए समझ में आता है, जो पहले से ही किया गया है, उदाहरण के लिए, समूहों के समान। सीएमएल विशेषताओं का समर्थन करता है, जो नए ग्राफिक तत्व के लिए भी आवश्यक है।
प्रलेखन के लिए एक लिंक कुछ मायनों में एक टिप्पणी के समान है - यह कार्यक्रम की एक निष्पादन योग्य रेखा नहीं है, लेकिन कुछ संदर्भ के बारे में अतिरिक्त जानकारी प्रदान करता है।
कोडिमेंशन आईडीई कई प्रकार की टिप्पणियों को पहचानता है: स्वतंत्र, अग्रणी और पार्श्व। प्रलेखन के लिए, टिप्पणियों के लिए स्वतंत्र और प्रमुख ग्राफिक तत्वों को उसी तरह बनाए रखना विवेकपूर्ण है। प्रलेखन के लिए पक्ष तत्व के साथ भ्रम है। मुद्दा यह है कि कोड के एक बहु-पंक्ति ब्लॉक के लिए पक्ष टिप्पणियां कैसे प्रस्तुत की जाती हैं। एक आयत को ब्लॉक के दाईं ओर खींचा जाता है, जो साइड कमेंट की सभी लाइनों को मैचिंग लाइन नंबरों के समर्थन के साथ कवर करता है। और अगर सीएमएल डॉक साइड टिप्पणी के बीच में मिला तो क्या करना है पूरी तरह से स्पष्ट नहीं है। दूसरी ओर, लिंक अभी भी किसी अन्य स्थान की ओर जाता है, इसलिए साइड सीएमएल डॉक्स के लिए समर्थन अनावश्यक लगता है - कोड ब्लॉक में एक विशेष लाइन का संदर्भ बहुत संकीर्ण है। कार्यों और कक्षाओं के लिए साइड CML डॉक्स के लिए समर्थन भी बेमानी लगता है। इसलिए, इस स्तर पर केवल स्वतंत्र और अग्रणी सीएमएल डॉक्स को लागू किया जाएगा। यह ध्यान देने योग्य है कि यदि भविष्य में पार्श्व सीएमएल डॉक्स का समर्थन करने के लिए एक उचित आवश्यकता है और एक अच्छा विचार है कि उन्हें कैसे प्रदर्शित किया जाए, तो यह कार्यक्षमता जोड़ी जा सकती है।
आइए चर्चा करें कि ग्राफिक तत्व में क्या दिखाया जाना चाहिए। जाहिर है, आपको तत्व के लिए पाठ की आवश्यकता है। टेक्स्ट डेवलपर द्वारा सेट किया गया है और आपको बताता है कि लिंक किस ओर इशारा करता है। यह पहले उल्लेख किया गया था कि एक क्लिक के साथ प्रलेखन को संक्रमण प्रदान करना वांछनीय है। ग्राफिक तत्व का पाठ उपयुक्त नहीं है, क्योंकि अन्य तत्वों के व्यवहार के बीच निरंतरता का सम्मान किया जाना चाहिए - माउस को क्लिक करके, ग्राफिक तत्व का चयन किया जाता है। हालांकि, समस्या को हल करना सरल है: आप एक आइकन जोड़ सकते हैं, उदाहरण के लिए, पाठ के बाईं ओर, और आइकन पर क्लिक करने से संक्रमण हो जाएगा।
अब CML डॉक टिप्पणी के लिए विशेषताओं की सूची स्पष्ट है:
- लिंक - दूसरी जगह के लिए लिंक
- एंकर - अन्य स्थानों से लिंक के लिए एंकर पहचानकर्ता
- शीर्षक - ग्राफिक तत्व में प्रदर्शित करने के लिए पाठ
- bg, fg, border - तत्व के अलग-अलग रंग, यदि इसे एक विशेष तरीके से हाइलाइट करने की आवश्यकता है
कम से कम दो विशेषताओं में से एक लिंक और एंकर मौजूद होना चाहिए। उनके बिना, इस तरह की सीएमएल डॉक्टर टिप्पणी बहुत मायने नहीं रखती है। अन्य विशेषताएँ वैकल्पिक हैं। पाठ बिल्कुल नहीं हो सकता है, और रंग मानक हो सकते हैं।
यहाँ CML डॉक और उसके चित्रमय प्रतिनिधित्व का उपयोग कर कोड का एक उदाहरण दिया गया है:
स्वतंत्र और प्रमुख सीएमएल डॉक्टर टिप्पणीप्रमुख और स्वतंत्र तत्वों के बीच का अंतर केवल वह होता है जहां कनेक्टर जाता है: या तो एक विशिष्ट ब्लॉक के लिए, या ब्लॉक के बीच कनेक्टर के लिए।
जब माउस कर्सर आइकन के ऊपर होता है, और तत्व में लिंक विशेषता होती है, तो कर्सर का आकार बदल जाता है, यह सुझाव देता है कि एक क्लिक किया जाएगा।
ग्राफिक तत्व संदर्भ मेनू का भी समर्थन करता है। रंगों सहित तत्व विशेषताओं को देखने या संपादित करने के लिए एक विकल्प उपलब्ध है, और एक तत्व को हटाने का विकल्प।
अन्य ग्राफिक तत्व
कोड के चित्रमय प्रतिनिधित्व में लगभग सभी अन्य तत्वों में दस्तावेज़ीकरण हो सकता है (अपवाद, उदाहरण के लिए, टिप्पणियाँ और दस्तावेज़ हैं)। इसलिए, उनके पास संदर्भ मेनू के माध्यम से एक प्रलेखन आइटम बनाने का एक तरीका है।
प्रलेखन के साथ काम करने के लिए संदर्भ मेनूकेवल दो विकल्प हैं। पहले "जोड़ें / संपादित करें डॉक्टर लिंक / एंकर ..." लिंक, एंकर और शीर्षक विशेषताओं को मैन्युअल रूप से दर्ज करने के लिए एक मोडल संवाद की ओर जाता है। यहां, डेवलपर को पूरी स्वतंत्रता है कि लिंक कहां भेजें, फाइल कहां रखें आदि।
दूसरा विकल्प अधिक दिलचस्प है। प्रदर्शन किए गए कार्यों के कारण आइटम का नाम लंबा है, "डॉक्टर फ़ाइल बनाएँ, लिंक जोड़ें और संपादन के लिए खोलें"। सभी कार्य बिना किसी इनपुट के स्वचालित रूप से किए जाते हैं, जो आपको संगठनात्मक मुद्दे को जल्दी हल करने की अनुमति देता है:
- निर्णय उस फाइल के बारे में किया जाता है जिसमें दस्तावेज स्थित होगा (हम नीचे विचार करेंगे)
- स्रोत पाठ में,
# cml 1 doc ... जोड़ें, जो दस्तावेज़ीकरण फ़ाइल की ओर # cml 1 doc ... करता है और इसमें उत्पन्न लंगर और पाठ है। एंकर डॉक <यादृच्छिक संख्या> के रूप में उत्पन्न होता है। फिक्स्ड टेक्स्ट: डॉक्यूमेंटेशन देखें - यदि दस्तावेज़ फ़ाइल पहले से मौजूद है, तो यह एक नए टैब में संपादन के लिए खुलता है
- यदि दस्तावेज़ीकरण फ़ाइल मौजूद नहीं है, तो इसे बनाया गया है, एक नए टैब में संपादन के लिए खोला गया है, और संपादन बफर में एक संक्षिप्त मदद जोड़ी गई है, जिसमें नए सम्मिलित
# cml 1 doc ... टिप्पणी को कैसे संदर्भित किया जाए।
फ़ाइल के बारे में निर्णय इस बात पर निर्भर करता है कि क्या परियोजना लोड है। यदि लोड किया जाता है, तो प्रोजेक्ट उप रूट में doc उपनिर्देशिका बनाई जाती है और फिर प्रोजेक्ट रूट से सोर्स टेक्स्ट फाइल के सापेक्ष पथ। फ़ाइल नाम को .md के साथ एक्सटेंशन को बदलकर बनाया गया है। उदाहरण के लिए, यदि कोई परियोजना स्थित है
/home/me/myProject
और प्रोजेक्ट फ़ाइल के लिए दस्तावेज़ जोड़ा जाता है
/home/me/myProject/src/utils.py
एक प्रलेखन फ़ाइल बनाई जाएगी
/home/me/myProject/doc/src/utils.md
इस प्रकार, स्रोत कोड के लिए प्रलेखन की संरचना स्रोत कोड की संरचना को दोहराती है, और यहां तक कि परियोजना में डॉक्टर उपनिर्देशिका पर एक त्वरित नज़र सहज ज्ञान युक्त नेविगेशन के लिए पर्याप्त होगा। योजना डिफ़ॉल्ट व्यवहार के लिए उचित लगती है, जो प्रलेखन के साथ काम को गति देने में मदद करती है।
यदि परियोजना लोड नहीं है, तो फ़ाइल के बगल में डॉक्टर उपनिर्देशिका बनाई जाती है, और इसमें फ़ाइल को .md के लिए बदल दिया जाता है। इस तरह के परिदृश्य की संभावना कम ही लगती है। अगर हम प्रलेखन के बारे में बात कर रहे हैं, तो यह निश्चित रूप से एक परियोजना पर एक काम है, और एक अलग फाइल पर नहीं।
बेशक, किसी भी समय आप स्वचालित रूप से उत्पन्न तत्वों को
# cml 1 doc ... पाठ संपादक में या आलेखीय प्रतिनिधित्व पर एक संवाद में संपादित करके बदल सकते हैं।
परियोजना प्रलेखन प्रारंभिक बिंदु
मुझे एक प्रारंभिक बिंदु की आवश्यकता क्यों है? मेरी राय में, यह उन लोगों के लिए परियोजना में प्रवेश करने की प्रक्रिया को सुविधाजनक बना सकता है जो पहले इसे खोलते हैं। उदाहरण के लिए, विकास टीम की संरचना के विस्तार के मामले में, या परियोजना के उपयोगकर्ताओं के लिए। कल्पना करें कि परियोजना में प्रलेखन है और इसमें बड़ी संख्या में फाइलें हैं। कहाँ से शुरू करें? प्रलेखन कैसे संरचित है? अटकलें लगाने और फिर उन्हें जांचने के बजाय, अनुशंसित प्रविष्टि बिंदु का स्पष्ट संकेत देना अधिक सुविधाजनक होगा।
यहां आप गितुब दृष्टिकोण को थोड़ा बढ़ा सकते हैं ताकि डिफ़ॉल्ट और विशिष्ट प्रलेखन संगठन विकल्प दोनों काम कर सकें। अगर कुछ नहीं कहा जाता है, तो हम प्रोजेक्ट रूट में README.md फ़ाइल की तलाश करेंगे। और परियोजना के गुणों को दूसरे क्षेत्र के साथ विस्तारित किया जा सकता है, जो प्रलेखन के शुरुआती बिंदु की एक विशिष्ट फ़ाइल को इंगित करता है।
परियोजना प्रलेखन खोलने के लिए दो विकल्प हैं। आईडीई मुख्य विंडो के टूलबार में मार्कडाउन आइकन के साथ एक बटन जोड़ा गया है। जब क्लिक किया जाता है, तो दस्तावेज़ फ़ाइल देखने के मोड में खोली जाएगी, यदि उपलब्ध हो। यदि कोई फ़ाइल नहीं है, तो प्रलेखन फ़ाइल का स्थान पेश किया जाएगा और पाठ के साथ संपादन मोड में एक नया टैब खुल जाएगा - एक स्टब। दूसरा विकल्प
कोडिमेंशन के स्वागत पृष्ठ का एक लिंक है, जो अन्य खुले टैब नहीं होने पर प्रदर्शित होता है। साथ के पाठ में परियोजना प्रलेखन के बारे में शब्द और प्रलेखन पाए जाने पर एक लिंक शामिल होगा। यह इस स्वागत योग्य पृष्ठ है कि उपयोगकर्ता ने पहली बार प्रोजेक्ट खोला है।
व्यवहार में परीक्षण
ऊपर वर्णित कार्यक्षमता को बिल्लियों पर परीक्षण किया गया था, अर्थात,
कोडिमेंशन आईडीई की परियोजना पर। अब इंस्टॉलेशन पैकेज में मार्कडाउन प्रारूप में तैयार किए गए दस्तावेज शामिल हैं। कार्यक्षमता के इस परीक्षण को पूरी तरह से पूर्ण नहीं माना जा सकता है, क्योंकि प्रलेखन अंतिम उपयोगकर्ता के लिए तैयार किया गया था, और कोड द्वारा नहीं। हालांकि, समग्र धारणा जो यह निकला वह काफी स्वीकार्य है।
प्रश्न खोलें
क्या मुझे साइड CML डॉक तत्वों के लिए समर्थन की आवश्यकता है? यदि हाँ, तो उन्हें कैसे आकर्षित करें, उदाहरण के लिए, ऐसे मामले के लिए:
a = 10
एक प्रलेखन लाइनों में सीधे plantUML आरेख विवरण पहचान सकता है। यदि ऐसा समर्थन किया जाता है, तो इन आरेखों को कोड के चित्रमय प्रतिनिधित्व पर कैसे प्रदर्शित किया जाए?
प्लांट यूएमएल आरेखों के निर्माण की सुविधा के लिए, कोई इस परिदृश्य के साथ कार्यक्षमता जोड़ सकता है:
- उपयोगकर्ता कोड के ग्राफिक प्रतिनिधित्व या किसी अन्य विंडो में प्रोजेक्ट पर राइट-क्लिक करता है (प्रोजेक्ट कक्षाओं की सूची, संरचित फ़ाइल सामग्री)
- संदर्भ मेनू में, plantUML प्रारूप में एक वर्ग विवरण उत्पन्न करने के लिए एक आइटम का चयन करता है
- उत्पन्न विवरण पाठ बफर में सहेजा गया है।
- उपयोगकर्ता मार्कडाउन दस्तावेज़ में पाठ सम्मिलित करता है और यदि आवश्यक हो तो इसे संशोधित करता है
इस तरह के परिदृश्य की अहमियत सवालों के घेरे में है, हालांकि इसे लागू करना तुच्छ है।
यदि आपके पास कोई विचार है, तो कृपया उन्हें टिप्पणियों में साझा करें।