प्रॉडक्ट की खास जानकारी
Bazel का कोड खोज और सोर्स ब्राउज़िंग इंटरफ़ेस, वेब पर काम करने वाला एक टूल है. इसका इस्तेमाल, Bazel के सोर्स कोड रिपॉज़िटरी को ब्राउज़ करने के लिए किया जाता है. इन सुविधाओं का इस्तेमाल करके, अलग-अलग रिपॉज़िटरी, शाखाओं, और फ़ाइलों के बीच नेविगेट किया जा सकता है. आपके पास इतिहास, बदलाव, और गड़बड़ी की जानकारी देखने का विकल्प भी होता है.
शुरू करना
कोड खोजने और सोर्स ब्राउज़ करने के इंटरफ़ेस को ऐक्सेस करने के लिए, अपने वेब ब्राउज़र में https://source.bazel.build खोलें.
मुख्य स्क्रीन दिखेगी. इस स्क्रीन में ये कॉम्पोनेंट होते हैं:
ब्रेडक्रंब टूलबार. यह टूलबार, आपको रिपॉज़िटरी में आपकी मौजूदा जगह दिखाता है. साथ ही, किसी दूसरी जगह पर तुरंत जाने की सुविधा देता है. जैसे, किसी दूसरी रिपॉज़िटरी या रिपॉज़िटरी में मौजूद किसी दूसरी जगह पर, जैसे कि फ़ाइल, शाखा या कमिट.
उन रिपॉज़िटरी की सूची जिन्हें ब्राउज़ किया जा सकता है.
स्क्रीन पर सबसे ऊपर, खोज बॉक्स होता है. इस बॉक्स का इस्तेमाल करके, खास फ़ाइलों और कोड को खोजा जा सकता है.
डेटा स्टोर करने की जगहों के साथ काम करना
कोई रिपॉज़िटरी खोलना
कोई रिपॉज़िटरी खोलने के लिए, मुख्य स्क्रीन पर उसके नाम पर क्लिक करें.
इसके अलावा, किसी खास रिपॉज़िटरी को ब्राउज़ करने के लिए, ब्रेडक्रंब टूलबार का इस्तेमाल किया जा सकता है. यह टूलबार, आपको रिपॉज़िटरी में आपकी मौजूदा जगह दिखाता है. साथ ही, किसी दूसरी जगह पर तुरंत जाने की सुविधा देता है. जैसे, किसी दूसरी रिपॉज़िटरी या रिपॉज़िटरी में मौजूद किसी दूसरी जगह पर, जैसे कि फ़ाइल, शाखा या कमिट.
रिपॉज़िटरी स्विच करना
किसी दूसरे डेटा स्टोर करने की जगह पर स्विच करने के लिए, ब्रेडक्रंब टूलबार से डेटा स्टोर करने की जगह चुनें.
किसी खास कमिट में मौजूद रिपॉज़िटरी देखना
किसी खास कमिट में मौजूद रिपॉज़िटरी देखने के लिए:
- डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
- ब्रेडक्रंब टूलबार में जाकर, शाखा मेन्यू खोलें.
- इसके बाद, दिखने वाले सबमेन्यू में, कमिट करें पर क्लिक करें.
- वह कमिट चुनें जिसे आपको देखना है.
इंटरफ़ेस अब उस रिपॉज़िटरी को वैसा ही दिखाता है जैसा वह उस कमिट के समय था.
कोई शाखा, कमिट या टैग खोलना
डिफ़ॉल्ट रूप से, कोड खोज और सोर्स ब्राउज़िंग इंटरफ़ेस, डिफ़ॉल्ट शाखा के लिए एक रिपॉज़िटरी खोलता है. कोई दूसरी शाखा खोलने के लिए, ब्रेडक्रंब टूलबार में, शाखा/कमिट/टैग मेन्यू पर क्लिक करें. ऐसा करने पर, एक सबमेन्यू खुलेगा. इसमें, शाखा के नाम, टैग के नाम या खोज बॉक्स का इस्तेमाल करके शाखा चुनी जा सकती है.
- शाखा के नाम का इस्तेमाल करके कोई शाखा चुनने के लिए, शाखा चुनें. इसके बाद, शाखा के नाम पर क्लिक करें.
- टैग के नाम का इस्तेमाल करके कोई शाखा चुनने के लिए, टैग चुनें. इसके बाद, टैग के नाम पर क्लिक करें.
- कमिट आईडी का इस्तेमाल करके कोई शाखा चुनने के लिए, कमिट करें चुनें. इसके बाद, कमिट आईडी पर क्लिक करें.
- कोई शाखा, कमिट या टैग खोजने के लिए, उससे जुड़ा आइटम चुनें और खोज बॉक्स में खोज के लिए कोई शब्द टाइप करें.
फ़ाइलों के साथ काम करना
मुख्य स्क्रीन से कोई रिपॉज़िटरी चुनने पर, स्क्रीन बदलकर उस रिपॉज़िटरी का व्यू दिखने लगता है. अगर README फ़ाइल मौजूद है, तो उसका कॉन्टेंट स्क्रीन की दाईं ओर मौजूद फ़ाइल पैनल में दिखता है. अगर ऐसा नहीं है, तो आपको रिपॉज़िटरी की फ़ाइलों और फ़ोल्डर की सूची दिखेगी. स्क्रीन की बाईं ओर, रिपॉज़िटरी की फ़ाइलों और फ़ोल्डर का ट्री व्यू दिखता है. इस ट्री का इस्तेमाल करके, खास फ़ाइलों को ब्राउज़ और खोला जा सकता है.
ध्यान दें कि किसी रिपॉज़िटरी को देखते समय, ब्रेडक्रंब टूलबार में अब तीन कॉम्पोनेंट होते हैं:
- रिपॉज़िटरी मेन्यू, जिसमें अलग-अलग रिपॉज़िटरी चुनी जा सकती हैं
- शाखा/कमिट/टैग मेन्यू, जिसमें से खास शाखाएं, टैग या कमिट चुनी जा सकती हैं
- फ़ाइल पाथ बॉक्स, जिसमें मौजूदा फ़ाइल या फ़ोल्डर का नाम और उसका पाथ दिखता है
फ़ाइल खोलें
किसी फ़ाइल को खोलने के लिए, उसकी डायरेक्ट्री पर ब्राउज़ करके उसे चुनें. फ़ाइल पैनल में फ़ाइल का कॉन्टेंट दिखाने के लिए, रिपॉज़िटरी का व्यू अपडेट होता है. साथ ही, ट्री पैनल में रिपॉज़िटरी में उसकी जगह भी दिखती है.
फ़ाइल में किए गए बदलाव देखना
फ़ाइल में किए गए बदलाव देखने के लिए:
- डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
- सबसे ऊपर दाएं कोने में मौजूद, गलतफ़हमी पर क्लिक करें.
फ़ाइल पैनल अपडेट हो जाता है, ताकि यह पता चल सके कि फ़ाइल में किसने और कब बदलाव किए.
बदलाव का इतिहास देखना
किसी फ़ाइल में हुए बदलावों का इतिहास देखने के लिए:
- डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
- सबसे ऊपर दाएं कोने में मौजूद, इतिहास पर क्लिक करें. बदलाव का इतिहास पैनल दिखता है, जिसमें इस फ़ाइल के लिए किए गए बदलाव दिखते हैं.
कोड की समीक्षाएं देखना
Gerrit कोड की समीक्षाओं के लिए, सीधे तौर पर बदलाव के इतिहास वाले पैनल से टूल खोला जा सकता है.
किसी फ़ाइल के लिए कोड की समीक्षा देखने के लिए:
- डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
- सबसे ऊपर दाएं कोने में मौजूद, इतिहास पर क्लिक करें. बदलाव का इतिहास पैनल दिखता है, जिसमें इस फ़ाइल के लिए किए गए बदलाव दिखते हैं.
- किसी कमिट पर कर्सर घुमाएं. आपको ज़्यादा बटन (तीन वर्टिकल बिंदु) दिखेगा.
- ज़्यादा बटन पर क्लिक करें.
- कोड की समीक्षा देखें को चुनें.
Gerrit कोड की समीक्षा करने वाला टूल, नई ब्राउज़र विंडो में खुलता है.
किसी खास कमिट पर फ़ाइल खोलना
किसी खास कमिट पर फ़ाइल खोलने के लिए:
- डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
- सबसे ऊपर दाएं कोने में मौजूद, इतिहास पर क्लिक करें. बदलाव का इतिहास पैनल दिखता है, जिसमें इस फ़ाइल के लिए किए गए बदलाव दिखते हैं.
- किसी कमिट पर कर्सर घुमाएं. आपको देखें बटन दिखेगा.
- देखें बटन पर क्लिक करें.
किसी फ़ाइल की तुलना किसी दूसरे कमिट से करना
किसी दूसरी फ़ाइल की तुलना करने के लिए:
- डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें. दो अलग-अलग कमिट की तुलना करने के लिए, पहले उस कमिट पर फ़ाइल खोलें.
- किसी कमिट पर कर्सर घुमाएं. आपको DIFF बटन दिखेगा.
- DIFF बटन पर क्लिक करें.
फ़ाइल पैनल अपडेट हो जाता है, ताकि दोनों फ़ाइलों की तुलना एक साथ की जा सके. दोनों में से सबसे पुराना कमिट हमेशा बाईं ओर होता है.
बदलाव के इतिहास वाले पैनल में, दोनों कमिट हाइलाइट किए जाते हैं. साथ ही, एक लेबल से यह पता चलता है कि कमिट बाईं ओर है या दाईं ओर.
किसी भी फ़ाइल में बदलाव करने के लिए, बदलाव के इतिहास वाले पैनल में कमिट पर कर्सर घुमाएं. इसके बाद, लेफ़्ट या राइट बटन पर क्लिक करके, डिफ़रेंस की बाईं या दाईं ओर मौजूद कमिट खोलें.
क्रॉस रेफ़रंस ब्राउज़ करना
सोर्स रिपॉज़िटरी को ब्राउज़ करने का एक और तरीका, क्रॉस रेफ़रंस का इस्तेमाल करना है. ये रेफ़रंस, किसी सोर्स फ़ाइल में अपने-आप हाइपरलिंक के तौर पर दिखते हैं.
क्रॉस रेफ़रंस की पहचान आसानी से करने के लिए, सबसे ऊपर दाएं कोने में मौजूद क्रॉस रेफ़रंस पर क्लिक करें. यह विकल्प, किसी फ़ाइल में मौजूद सभी क्रॉस रेफ़रंस के नीचे अंडरलाइन दिखाता है.
ध्यान दें: अगर क्रॉस रेफ़रंस धूसर है, तो इसका मतलब है कि उस फ़ाइल के लिए क्रॉस रेफ़रंस उपलब्ध नहीं हैं.
क्रॉस रेफ़रंस पैनल खोलने के लिए, क्रॉस रेफ़रंस पर क्लिक करें. इस पैनल में दो सेक्शन होते हैं:
- डेफ़िनिशन सेक्शन, जिसमें रेफ़रंस तय करने वाली फ़ाइल या फ़ाइलों की सूची होती है
- रेफ़रंस सेक्शन, जिसमें उन फ़ाइलों की सूची होती है जिनमें रेफ़रंस भी दिखता है
दोनों सेक्शन में फ़ाइल का नाम दिखता है. साथ ही, रेफ़रंस वाली लाइन या लाइनें भी दिखती हैं. क्रॉस रेफ़रंस पैनल से कोई फ़ाइल खोलने के लिए, पंक्ति संख्या वाली एंट्री पर क्लिक करें. फ़ाइल, पैनल के नए सेक्शन में दिखती है. इससे, ओरिजनल फ़ाइल को देखते हुए, फ़ाइल को ब्राउज़ करना जारी रखा जा सकता है.
फ़ाइल पैनल की तरह ही, क्रॉस रेफ़रंस पैनल का इस्तेमाल करके क्रॉस रेफ़रंस ब्राउज़ किए जा सकते हैं. ऐसा करने पर, पैनल में ब्रेडक्रंब ट्रेल दिखता है. इसका इस्तेमाल, अलग-अलग क्रॉस रेफ़रंस के बीच नेविगेट करने के लिए किया जा सकता है.
कोड खोजना
स्क्रीन पर सबसे ऊपर मौजूद खोज बॉक्स का इस्तेमाल करके, खास फ़ाइलों या कोड स्निपेट को खोजा जा सकता है. खोजें हमेशा डिफ़ॉल्ट शाखा के हिसाब से होती हैं.
सभी खोजों में, डिफ़ॉल्ट रूप से RE2 रेगुलर एक्सप्रेशन का इस्तेमाल किया जाता है. अगर आपको रेगुलर एक्सप्रेशन का इस्तेमाल नहीं करना है, तो खोज के लिए इस्तेमाल किए गए शब्दों को डबल कोट ( " ) में डालें.
ध्यान दें: किसी फ़ाइल को तुरंत खोजने के लिए, बिंदु के पहले बैकस्लैश जोड़ें या फ़ाइल के पूरे नाम को कोटेशन में डालें.
foo\.java
"foo.java"
यहां दिए गए फ़िल्टर का इस्तेमाल करके, खोज के नतीजों को बेहतर बनाया जा सकता है.
| फ़िल्टर करें | दूसरे विकल्प | जानकारी | उदाहरण |
|---|---|---|---|
| lang: | भाषा: | फ़ाइल की भाषा के हिसाब से एग्ज़ैक्ट मैच करें. | lang:java test |
| file: | filepath: path: f: |
||
| case:yes | खोज को केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) बनाएं. डिफ़ॉल्ट रूप से, खोज के नतीजे, केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) नहीं होते हैं. | case:yes Hello World | |
| class: | क्लास का नाम खोजें. | class:MainClass | |
| फ़ंक्शन: | func: | फ़ंक्शन का नाम खोजें. | function:print |
| - | खोज के नतीजों से शब्द को हटा देता है. | hello -world | |
| \ | ., \ या ( जैसे खास वर्णों को एस्केप करता है. | run\(\) | |
| "[term]" | लिटरल सर्च करें. | "class:main" |
अन्य सहायता
किसी समस्या की शिकायत करने के लिए, स्क्रीन के सबसे ऊपर दाएं कोने में मौजूद सुझाव/राय दें या शिकायत करें बटन पर क्लिक करें. इसके बाद, दिए गए फ़ॉर्म में अपना सुझाव/राय दें या शिकायत करें.