कमिट्स से एक चेंजलॉग ड्राफ्ट करें
Changelog draft दो बिंदुओं के बीच प्रथम-अभिभावक कमिटों को पढ़ता है, उन्हें समूहित करता है, अगले संस्करण का सुझाव देता है और आपको Markdown की प्रतिलिपि बनाने देता है। नोट में कहा गया है कि यह केवल एक मसौदा है। कुछ भी टैग, रिलीज़ या पुश नहीं किया गया है। आप संदेशों को साझा करने से पहले उनकी समीक्षा करें।
GitTree में काम करता है निःशुल्क: प्रत्येक स्थानीय Git सुविधा, बिना किसी खाते की आवश्यकता के।
इस पेज पर
शुरू करने से पहले
- चेंजलॉग ड्राफ्ट निःशुल्क योजना का हिस्सा है। दोनों समापन बिंदु पहले से ही कमिट होने चाहिए। जब तक वे नहीं होते तब तक संवाद कहता है Choose both committed endpoints।
- जिन संदेशों को आप समूहीकृत करना चाहते हैं उन्हें Conventional Commits (
feat:,fix:,feat!:) का अनुसरण करना चाहिए। सादे संदेशों को समीक्षा के लिए गिना जाता है. वे आविष्कृत श्रेणियाँ नहीं हैं।
इसे कहां खोजें
- कमिट का मेनू, या टैग का मेनू: Changelog draft.
Alt+L, या कमांड पैलेट।
| कार्रवाई | macOS | Windows और Linux |
|---|---|---|
| Changelog draft | ⌥L | Alt+L |
| कमांड पैलेट | ⌘⇧P | Ctrl+Shift+P |
कदम
चेंजलॉग ड्राफ्ट खोलें
उस कमिट का चयन करें जिससे सीमा समाप्त होनी चाहिए, या वह टैग जिसके लिए आप नोट्स लिख रहे हैं, और Changelog draft चुनें। आप
Alt+Lभी दबा सकते हैं. शीर्षक Changelog draft है. नोट कहता है Draft only. Review commit messages before sharing. Nothing is published.
चेंजलॉग ड्राफ्ट इस मेनू पर और टैग के मेनू पर है। स्टिल कमिट मेनू दिखाता है।GitTree प्रदर्शन भंडार के साथ इंटरफ़ेस। सीमा निर्धारित करें
From (excluded) वह कमिट या टैग है जिसे आपने पहले ही जारी कर दिया है। To (included) नई युक्ति है। स्कोप लाइन कहती है कि ड्राफ्ट प्रथम-अभिभावक इतिहास का उपयोग करता है। केवल मर्ज के माध्यम से आने वाली कमिटों को मर्ज कमिट द्वारा दर्शाया जाता है, एक-एक करके सूचीबद्ध नहीं किया जाता है।
ड्राफ्ट जनरेट करें
Generate draft दबाएँ. Stop पढ़े गए इतिहास को समाप्त करने के लिए कहता है। ड्राफ्ट Editable Markdown draft के अंतर्गत दिखाई देता है, जब कोई संस्करण प्रस्तावित किया जा सकता है तो Suggested version के साथ, और जब कोई संस्करण टैग बहिष्कृत समापन बिंदु पर इंगित करता है तो Baseline tag के साथ दिखाई देता है। Copy Markdown इसकी प्रतिलिपि बनाता है. Markdown copied प्रतिलिपि की पुष्टि करता है।
संपादित करें, फिर तय करें कि यह कहां जाता है
Edit the Markdown in the box. Replace draft with proposal puts the generated text back after you edit. If you change the endpoints, GitTree says the endpoints changed and your edited draft is preserved. Insert draft into release notes is offered when you are writing notes for a release. Closing after edits asks Discard edited draft? Copy first if you need the words.
अपेक्षित परिणाम
आपके पास क्लिपबोर्ड पर या रिलीज़-नोट्स फ़ील्ड में Markdown है। कोई टैग नहीं बनाया गया और कोई रिलीज़ प्रकाशित नहीं की गई। समूहों को किसी रिलीज़ में चिपकाने से पहले उन्हें पढ़ें। सादे संदेश, प्रत्यावर्तन और विलय को बुलाया जाता है ताकि आप उन्हें फिर से लिख सकें।
कमिटों को कैसे समूहीकृत किया जाता है
| समूह | वहां क्या रखा है |
|---|---|
| परिवर्तन तोड़ना | कमिटों को टूटने के रूप में चिह्नित किया गया है, जिसमें ! या BREAKING CHANGE पाद लेख शामिल है |
| विशेषताएं | करतब करता है |
| ठीक करता है | कमिट ठीक करें |
| प्रदर्शन | पूर्ण कमिट |
| अन्य | मान्यता प्राप्त प्रकार जो उपरोक्त में से कोई नहीं हैं, और संदेश जिन पर अभी भी ध्यान देने की आवश्यकता है |
काउंट लाइन Needs review है, जिसमें सादे संदेश, रिवर्ट, मर्ज और अनडिकोडेबल संदेश शामिल हैं। उन संख्याओं के कारण संस्करण को रोका जा सकता है। No commits in this range; no release is proposed का अर्थ है कि समापन बिंदु प्रत्येक कमिट को बाहर कर देते हैं।
सुझाया गया संस्करण कैसे चुना जाता है
सुझाव बहिष्कृत समापन बिंदु पर एक संस्करण टैग से शुरू होता है। संवाद कारण बताता है: ब्रेकिंग परिवर्तन एक प्रमुख संस्करण या एक छोटे संस्करण का सुझाव देते हैं जबकि प्रमुख शून्य है। विशेषताएँ नाबालिग का सुझाव देती हैं। अन्य मान्यता प्राप्त Conventional Commits एक पैच का सुझाव देते हैं। आप सुझाव को नजरअंदाज कर सकते हैं. Choose the next version after review तब प्रकट होता है जब GitTree किसी एक को नहीं चुनेगा।
git log --first-parent --pretty=format:%s v1.2.0..HEAD
git tag --points-at v1.2.0^{}टर्मिनल में समान सीमा बहिष्कृत कमिट से सम्मिलित टिप तक git log --first-parent है। GitTree आपके लिए git tag नहीं चलता। टैग बनाना टैग्स है। किसी होस्ट पर नोट्स प्रकाशित करना एक अलग रिलीज़ कार्रवाई है। टैग्स पर ट्यूटोरियल पाठ दिखाता है कि एक टैग किसी कमिट को कैसे नाम देता है।
कुछ भी प्रकाशित नहीं है
Copy Markdown केवल पाठ की प्रतिलिपि बनाता है। Insert draft into release notes एक फ़ील्ड भरता है। न तो कोई टैग बनाता है, न ही कोई GitHub रिलीज या पुश बनाता है। यदि प्रतिलिपि विफल हो जाती है, तो संवाद कहता है Could not copy. Select and copy the draft text. आपका संपादित ड्राफ्ट तब तक बॉक्स में रहता है जब तक आप इसे बदल नहीं देते या त्याग नहीं देते।
अगर कुछ गलत होता है
"दोनों कमिट समापन बिंदु चुनें।"
से या प्रति अभी तक कमिट नहीं है। दो कमिट चुनें, या एक टैग चुनें जो कमिट की ओर इशारा करता हो। जो शाखा नाम हल नहीं होता वह उत्पन्न नहीं होगा।
"बहिष्कृत समापन बिंदु पर कोई संस्करण टैग बिंदु नहीं है।"
इसमें बढ़ोतरी की कोई बात नहीं है. अगला संस्करण स्वयं चुनें, या पहले बहिष्कृत कमिट को टैग करें और फिर से जेनरेट करें।
"विभिन्न संस्करण टैग बहिष्कृत समापन बिंदु पर इंगित करते हैं। बेसलाइन संस्करण चुनें।"
उस कमिट पर एक से अधिक संस्करण टैग मौजूद हैं। अपना मतलब आधार रेखा चुनें. GitTree यह अनुमान नहीं लगा पाएगा कि कौन सा टैग उत्पाद संस्करण है।
"बेसलाइन एक प्रीरिलीज़ है। रिलीज़ चैनल और संस्करण चुनें।"
प्रीरिलीज़ टैग अगले स्थिर नंबर का संकेत नहीं देता है। चैनल और संस्करण चुनें, फिर ड्राफ्ट रखें।
"कॉपी नहीं किया जा सका। ड्राफ्ट टेक्स्ट को चुनें और कॉपी करें।"
क्लिपबोर्ड को अस्वीकार कर दिया गया था. बॉक्स में Markdown का चयन करें और इसे सिस्टम शॉर्टकट से कॉपी करें। मसौदा अभी भी वहीं है.
प्रश्न
क्या चेंजलॉग ड्राफ्ट एक रिलीज बनाता है?
नहीं, नोट कहता है कि कुछ भी प्रकाशित नहीं हुआ है। आप Markdown की प्रतिलिपि बनाएँ या इसे रिलीज़ नोट्स में डालें। आप स्वयं को टैग करें और प्रकाशित करें।
कौन से कमिट शामिल हैं?
बहिष्कृत समापन बिंदु से लेकर टिप तक का प्रथम-अभिभावक इतिहास। मर्ज की गई शाखा की कमिट को मर्ज कमिट द्वारा दर्शाया जाता है।
कोई सुझाया गया संस्करण क्यों नहीं है?
जब बेसलाइन टैग गायब हो, अस्पष्ट हो या प्रीरिलीज़ हो, जब सादे संदेश, रिवर्ट, मर्ज या अनडिकोडेबल संदेशों की समीक्षा की आवश्यकता होती है, या जब किसी संस्करण घटक को बढ़ाया नहीं जा सकता है, तो संवाद एक को रोक देता है।
क्या मेरे संपादन नई श्रेणी में बने रहेंगे?
हाँ जब तक आप उन्हें बदल नहीं देते। संवाद कहता है कि आपका संपादित ड्राफ्ट संरक्षित है। ड्राफ्ट को प्रस्ताव से बदलें और इसे नए पाठ से अधिलेखित करें।
क्या मुझे Conventional Commits का उपयोग करना होगा?
नहीं, सादे संदेश आवश्यकताओं की समीक्षा के अंतर्गत सूचीबद्ध हैं। जब विषय करतब, फिक्स और ब्रेकिंग-चेंज मार्कर का उपयोग करते हैं तो समूह और सुझाए गए संस्करण अधिक विशिष्ट होते हैं।