कोड बेस खोजना

प्रॉडक्ट की खास जानकारी

Bazel का कोड खोज और सोर्स ब्राउज़िंग इंटरफ़ेस, वेब पर काम करने वाला एक टूल है. इसका इस्तेमाल, Bazel के सोर्स कोड रिपॉज़िटरी को ब्राउज़ करने के लिए किया जाता है. इन सुविधाओं का इस्तेमाल करके, अलग-अलग रिपॉज़िटरी, शाखाओं, और फ़ाइलों के बीच नेविगेट किया जा सकता है. आपके पास इतिहास, बदलाव, और गड़बड़ी की जानकारी देखने का विकल्प भी होता है.

शुरू करना

कोड खोजने और सोर्स ब्राउज़ करने वाले इंटरफ़ेस को ऐक्सेस करने के लिए, अपने वेब ब्राउज़र में https://source.bazel.build खोलें.

मुख्य स्क्रीन दिखेगी. इस स्क्रीन में ये कॉम्पोनेंट होते हैं:

1. ब्रेडक्रंब टूलबार. यह टूलबार, आपको रिपॉज़िटरी में मौजूद आपकी मौजूदा जगह दिखाता है. साथ ही, किसी दूसरी जगह पर तुरंत जाने की सुविधा देता है. जैसे, किसी दूसरी रिपॉज़िटरी पर या रिपॉज़िटरी में मौजूद किसी दूसरी जगह पर, जैसे कि फ़ाइल, शाखा या कमिट पर.

2. डेटा स्टोर करने की उन जगहों की सूची जिन्हें ब्राउज़ किया जा सकता है.

स्क्रीन पर सबसे ऊपर, खोज बॉक्स मौजूद है. खास फ़ाइलों और कोड को खोजने के लिए, इस बॉक्स का इस्तेमाल किया जा सकता है.

डेटा स्टोर करने की जगहों के साथ काम करना

कोई रिपॉज़िटरी खोलना

कोई रिपॉज़िटरी खोलने के लिए, मुख्य स्क्रीन पर उसके नाम पर क्लिक करें.

इसके अलावा, किसी खास रिपॉज़िटरी को ब्राउज़ करने के लिए, ब्रेडक्रंब टूलबार का इस्तेमाल किया जा सकता है. यह टूलबार, आपको रिपॉज़िटरी में आपकी मौजूदा जगह दिखाता है. साथ ही, किसी दूसरी जगह पर तुरंत जाने की सुविधा देता है. जैसे, किसी दूसरी रिपॉज़िटरी या रिपॉज़िटरी में मौजूद किसी दूसरी जगह पर, जैसे कि फ़ाइल, शाखा या कमिट.

डेटा स्टोर करने की जगह बदलें

किसी दूसरे डेटा स्टोर करने की जगह पर स्विच करने के लिए, ब्रेडक्रंब टूलबार से डेटा स्टोर करने की जगह चुनें.

किसी तय रिपोर्ट में डेटा स्टोर करने की जगह देखना

किसी खास कमिट में मौजूद रिपॉज़िटरी देखने के लिए:

1. डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
2. ब्रेडक्रंब टूलबार में जाकर, शाखा मेन्यू खोलें.
3. दिखने वाले सबमेन्यू में, समीक्षा करें पर क्लिक करें.
4. वह कमिट चुनें जिसे आपको देखना है.

इंटरफ़ेस अब उस रिपॉज़िटरी को वैसा ही दिखाता है जैसा वह उस कमिट के समय था.

कोई शाखा, कमिट या टैग खोलना

डिफ़ॉल्ट रूप से, कोड खोज और सोर्स ब्राउज़िंग इंटरफ़ेस, डिफ़ॉल्ट शाखा के लिए एक रिपॉज़िटरी खोलता है. कोई दूसरी शाखा खोलने के लिए, ब्रेडक्रंब टूलबार में, शाखा/कमिट/टैग मेन्यू पर क्लिक करें. ऐसा करने पर, एक सबमेन्यू खुलेगा. इसमें, शाखा के नाम, टैग के नाम या खोज बॉक्स का इस्तेमाल करके शाखा चुनी जा सकती है.

• शाखा के नाम का इस्तेमाल करके कोई शाखा चुनने के लिए, शाखा चुनें. इसके बाद, शाखा के नाम पर क्लिक करें.
• टैग के नाम का इस्तेमाल करके कोई शाखा चुनने के लिए, टैग चुनें. इसके बाद, टैग के नाम पर क्लिक करें.
• कमिट आईडी का इस्तेमाल करके ब्रांच चुनने के लिए, समीक्षा करना चुनें. इसके बाद, कमिट आईडी पर क्लिक करें.
• कोई ब्रांच खोजने, कमिट या टैग करने के लिए, संबंधित आइटम चुनें और खोज बॉक्स में खोज के लिए कोई शब्द टाइप करें.

फ़ाइलों के साथ काम करना

मुख्य स्क्रीन से डेटा स्टोर करने की जगह चुनने पर, स्क्रीन में उस डेटा स्टोर करने की जगह का व्यू दिखने लगता है. अगर कोई README फ़ाइल मौजूद है, तो इसका कॉन्टेंट स्क्रीन पर दाईं ओर मौजूद फ़ाइल पैनल में दिखता है. ऐसा न करने पर, डेटा स्टोर करने की जगह की फ़ाइलों और फ़ोल्डर की सूची दिखेगी. स्क्रीन की बाईं ओर, रिपॉज़िटरी की फ़ाइलों और फ़ोल्डर का ट्री व्यू दिखता है. इस ट्री का इस्तेमाल करके, खास फ़ाइलों को ब्राउज़ और खोला जा सकता है.

ध्यान दें कि किसी रिपॉज़िटरी को देखते समय, ब्रेडक्रंब टूलबार में अब तीन कॉम्पोनेंट होते हैं:

• रिपॉज़िटरी मेन्यू, जिसमें अलग-अलग रिपॉज़िटरी चुनी जा सकती हैं
• शाखा/कमिट/टैग मेन्यू, जिसमें से खास शाखाएं, टैग या कमिट चुनी जा सकती हैं
• फ़ाइल पाथ बॉक्स, जो मौजूदा फ़ाइल या फ़ोल्डर का नाम और उसका पाथ दिखाता है

फ़ाइल खोलें

किसी फ़ाइल को खोलने के लिए, उसकी डायरेक्ट्री पर ब्राउज़ करके उसे चुनें. फ़ाइल पैनल में मौजूद फ़ाइल के कॉन्टेंट को दिखाने के लिए, डेटा स्टोर करने की जगह का व्यू अपडेट होता है. साथ ही, यह ट्री पैनल में डेटा स्टोर करने की जगह में इसकी जगह दिखाता है.

फ़ाइल में किए गए बदलाव देखना

फ़ाइल में किए गए बदलावों को देखने के लिए:

1. डेटा स्टोर करने की जगह के व्यू से, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, BLAME पर क्लिक करें.

फ़ाइल पैनल अपडेट हो जाता है, ताकि यह पता चल सके कि फ़ाइल में किसने और कब बदलाव किए.

बदलाव का इतिहास देखना

किसी फ़ाइल में हुए बदलावों का इतिहास देखने के लिए:

1. डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, इतिहास पर क्लिक करें. बदलाव का इतिहास पैनल दिखता है, जिसमें इस फ़ाइल के लिए किए गए बदलाव दिखते हैं.

कोड की समीक्षाएं देखना

Gerrit कोड की समीक्षाओं के लिए, टूल को सीधे 'बदलाव का इतिहास' पैनल से खोला जा सकता है.

किसी फ़ाइल की कोड समीक्षा देखने के लिए:

1. डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, इतिहास पर क्लिक करें. बदलाव के इतिहास वाला पैनल दिखेगा, जिसमें इस फ़ाइल की कमेंट दिखेंगी.
3. किसी कमिट पर कर्सर घुमाएं. आपको ज़्यादा बटन (तीन वर्टिकल बिंदु) दिखेगा.
4. ज़्यादा बटन पर क्लिक करें.
5. कोड की समीक्षा देखें को चुनें.

Gerrit कोड की समीक्षा करने वाला टूल, नई ब्राउज़र विंडो में खुलता है.

किसी खास कमिट पर फ़ाइल खोलना

किसी तय तय किए गए तरीके से फ़ाइल खोलने के लिए:

1. डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें.
2. सबसे ऊपर दाएं कोने में मौजूद, इतिहास पर क्लिक करें. बदलाव के इतिहास वाला पैनल दिखेगा, जिसमें इस फ़ाइल की कमेंट दिखेंगी.
3. किसी कमिट पर कर्सर घुमाएं. आपको देखें बटन दिखेगा.
4. देखें बटन पर क्लिक करें.

किसी फ़ाइल की तुलना किसी दूसरे कमिट से करना

किसी दूसरी फ़ाइल की तुलना करने के लिए:

1. डेटा स्टोर करने की जगह के सेक्शन में जाकर, फ़ाइल चुनें. दो अलग-अलग कमिट की तुलना करने के लिए, पहले उस कमिट पर फ़ाइल खोलें.
2. किसी कमिट पर कर्सर घुमाएं. आपको DIFF बटन दिखेगा.
3. DIFF बटन पर क्लिक करें.

फ़ाइल पैनल अपडेट हो जाता है, ताकि दोनों फ़ाइलों की तुलना एक साथ की जा सके. दो में से सबसे पुराना कमिट हमेशा बाईं ओर होता है.

'बदलाव का इतिहास' पैनल में, दोनों कमिट को हाइलाइट किया जाता है. साथ ही, एक लेबल से पता चलता है कि कमिट को बाईं ओर दिखाया गया है या दाईं ओर.

किसी भी फ़ाइल में बदलाव करने के लिए, बदलाव के इतिहास वाले पैनल में कमिट पर कर्सर घुमाएं. इसके बाद, अंतर की बाईं या दाईं ओर मौजूद कमिट को खोलने के लिए, लेफ़्ट या राइट बटन पर क्लिक करें.

क्रॉस रेफ़रंस ब्राउज़ करना

सोर्स रिपॉज़िटरी को ब्राउज़ करने का एक और तरीका, क्रॉस रेफ़रंस का इस्तेमाल करना है. ये रेफ़रंस, किसी सोर्स फ़ाइल में अपने-आप हाइपरलिंक के तौर पर दिखते हैं.

क्रॉस रेफ़रंस की पहचान आसानी से करने के लिए, सबसे ऊपर दाएं कोने में मौजूद क्रॉस रेफ़रंस पर क्लिक करें. यह विकल्प, किसी फ़ाइल में मौजूद सभी क्रॉस रेफ़रंस के नीचे अंडरलाइन दिखाता है.

ध्यान दें: अगर क्रॉस रेफ़रंस धूसर है, तो इसका मतलब है कि उस फ़ाइल के लिए क्रॉस रेफ़रंस उपलब्ध नहीं हैं.

क्रॉस रेफ़रंस पैनल खोलने के लिए, क्रॉस रेफ़रंस पर क्लिक करें. इस पैनल में दो सेक्शन होते हैं:

• डेफ़िनिशन सेक्शन, जिसमें रेफ़रंस तय करने वाली फ़ाइल या फ़ाइलों की सूची होती है
• रेफ़रंस सेक्शन, जिसमें उन फ़ाइलों की सूची होती है जिनमें पहचान फ़ाइल भी दिखती है

दोनों सेक्शन में फ़ाइल का नाम दिखता है. साथ ही, इसमें रेफ़रंस वाली लाइन या लाइन दिखती हैं. क्रॉस रेफ़रंस पैनल से कोई फ़ाइल खोलने के लिए, पंक्ति संख्या वाली एंट्री पर क्लिक करें. फ़ाइल, पैनल के नए सेक्शन में दिखती है. इससे, ओरिजनल फ़ाइल को देखते हुए, फ़ाइल को ब्राउज़ करना जारी रखा जा सकता है.

क्रॉस रेफ़रंस पैनल का इस्तेमाल करके, क्रॉस रेफ़रंस ब्राउज़ करना जारी रखा जा सकता है, ठीक वैसे ही जैसे फ़ाइल पैनल में होता है. ऐसा करने पर, पैनल में ब्रेडक्रंब ट्रेल दिखता है. इसका इस्तेमाल, अलग-अलग क्रॉस रेफ़रंस के बीच नेविगेट करने के लिए किया जा सकता है.

कोड खोजना

स्क्रीन पर सबसे ऊपर मौजूद खोज बॉक्स का इस्तेमाल करके, खास फ़ाइलों या कोड स्निपेट को खोजा जा सकता है. खोज हमेशा डिफ़ॉल्ट ब्रांच पर सेट होती हैं.

सभी खोजें, डिफ़ॉल्ट रूप से RE2 रेगुलर एक्सप्रेशन का इस्तेमाल करती हैं. अगर आपको रेगुलर एक्सप्रेशन का इस्तेमाल नहीं करना है, तो खोज के लिए इस्तेमाल किए गए शब्दों को डबल कोट ( " ) में डालें.

ध्यान दें: किसी खास फ़ाइल को तुरंत खोजने के लिए, पीरियड के सामने बैकस्लैश जोड़ें या पूरे फ़ाइल नाम को कोटेशन में रखें.

foo\.java
"foo.java"

यहां दिए गए फ़िल्टर का इस्तेमाल करके, खोज के नतीजों को बेहतर बनाया जा सकता है.

अन्य सहायता

किसी समस्या की शिकायत करने के लिए, स्क्रीन के सबसे ऊपर दाएं कोने में मौजूद सुझाव/राय दें या शिकायत करें बटन पर क्लिक करें. इसके बाद, दिए गए फ़ॉर्म में अपना सुझाव/राय दें या शिकायत करें.